Placeholders

These placeholders can be used in messages, item, actions, conditions, GUI elements, and other configurable parts of the plugin.

They are automatically replaced with real-time values when shown to the player.

Placeholder
Description

%prefix%

Plugin prefix (from config.yml, key: prefix)

%name%

Name of the current merchant

%distance%

Distance from the player to the merchant

%entity_type%

Type of the merchant entity (e.g., VILLAGER, WANDERING_TRADER, etc.)

%spawn_date%

Formatted spawn time of the merchant

%despawn_date%

Formatted despawn time of the merchant

%left_seconds%

Seconds remaining until the merchant despawns

%left_minutes%

Minutes remaining until despawn

%left_hours%

Hours remaining until despawn

%left_days%

Days remaining until despawn

%category_size%

Number of categories defined for the merchant

%categories%

Comma-separated list of category names

%loc_world%

Name of the world where the merchant is located

%loc_x%

X coordinate of the merchant’s location (integer)

%loc_y%

Y coordinate of the merchant’s location (integer)

%loc_z%

Z coordinate of the merchant’s location (integer)


✅ Notes:

  • All placeholders are context-aware — they will only work where relevant data exists.

  • You can combine placeholders freely in text.

  • %prefix% allows centralized prefix control via config.yml.

Last updated