Skip to content
HenryMM Gaming

HMTAPI

Turn your Minecraft server into a REST API.

HMTAPI exposes your Minecraft server over plain HTTP and answers with JSON. You decide what each endpoint contains in a small YAML config, and you can pull in live data from any PlaceholderAPI placeholder — player balance, rank, online status, or anything else another plugin exposes.

// GET /api/users/Notch
{
  "username": "Notch",
  "last_login": "2026/09/25 22:13:20",
  "balance": "1250.42"
}

What you get

Section titled “What you get”
  • A config, not code. Define endpoints in config.yml. No scripting, no database, no restarts.
  • Any data you want. Mix HMTAPI’s own placeholders with any PlaceholderAPI placeholder.
  • Server-wide and per-player endpoints. Serve global information, or information about one specific player.
  • Reload without restart. Update your config in-game and apply it immediately.
  • Your server stays responsive. API requests are handled separately and never block the main server thread.
  • Nothing extra to maintain. HMTAPI ships no third-party libraries and needs no external services.

Requirements

Section titled “Requirements”
Server Paper 26.3 or newer
Java 25
Required plugin PlaceholderAPI

PlaceholderAPI is a hard requirement. HMTAPI will not enable without it. HMTAPI targets api-version: 26.3 and will not load on older servers.

Get started

Section titled “Get started”
  1. Install PlaceholderAPI.
  2. Drop the HMTAPI jar into your plugins folder.
  3. Start the server once to generate plugins/HMTAPI/config.yml.
  4. Define your endpoints.
  5. Run /hmtapi reload in-game.
Terminal window
curl http://localhost:4567/api/users/Notch

Continue with Installation and then Configuring endpoints.

Documentation

Section titled “Documentation”
Page What it covers
Installation Requirements, install steps, first run
Configuration Every setting in config.yml
Endpoints Defining endpoints and the URLs they answer on
Placeholders Every value you can put in an endpoint
Commands Commands and permissions
Status codes What each HTTP response means
Security Exposing the API safely
Performance Timeouts, load and best practices
Troubleshooting Error messages and common problems

Credits

Section titled “Credits”

HMTAPI is a fork of APIMachine, developed in cooperation with HM Gaming for TitanSMP.

Section titled “Links”