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.
%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 viaconfig.yml
.
Last updated