The plugin supports a rich placeholder system to make configs dynamic and environment-aware.

Placeholders are used in commands, messages, item text, book content, menus, and storage config


Collectable Placeholders

These are automatically available when commands/messages run in the context of a collectable

Token Value
{namespace} Repository namespace (e.g. notes, fish)
{id} Collectable entry id within that namespace (e.g. torn_page)
{key} Full key namespace:id
{collectable_name_formatted} Display name with MiniMessage formatting
{collectable_name_plain} Plain display name without formatting
{repo_namespace} Alias for {namespace}
{allow_replay} "true"/"false" depending on config
{show_when_locked} "true"/"false" depending on config
{repo_name_formatted} Repository display name with formatting
{repo_name_plain} Repository display name plain

Player Placeholders

Resolved when a player context is available:

Token Value
{player} Player’s name
{uuid} Player UUID
{world} Current world name
{x} {y} {z} Player’s block coordinates
{location} Player location formatted as (x, y, z)
{block_location} Block position (blockX, blockY, blockZ)

Config Interpolation (${VAR})

In config files, you can interpolate variables in the form:

${VAR_NAME[:default]}

Resolution order:

  1. System environment variables
  2. JVM system properties
  3. Registered placeholder sources
  4. Provided default (after :)
  5. Otherwise, left unresolved