Skip to main content

PlaceholderAPI

Endpoint: GET /api/placeholder

Resolves PlaceholderAPI placeholders via HTTP. Available only on the Bukkit platform (requires PlaceholderAPI as a soft dependency).

Query Parameters

Parameter Required Description
placeholder Yes The PlaceholderAPI placeholder to resolve (e.g., %player_name%)
player No Player name to resolve the placeholder for
uuid No Player UUID to resolve the placeholder for

If neither player nor uuid is provided, the placeholder is resolved for the console (null player).

Response

Content-Type: text/plain

Steve

Rate Limiting

This endpoint uses the rate-limit.placeholder configuration:

rate-limit:
  placeholder:
    requests: 180
    per: 30s

Example Usage

curl "http://your-server:8080/api/placeholder?placeholder=%25player_name%25&player=Steve"

Important Notes

  • The placeholder must be URL-encoded (%25 for %).
  • This endpoint runs on the main server thread to safely access PlaceholderAPI.
  • Works with any PlaceholderAPI expansion installed on your server.
  • Only available on Bukkit/Spigot/Paper (not on Velocity or BungeeCord).

No comments to display

Back to top