Skip to main content

​
Chat placeholders (Essentials & more)

RPG Leveling fills chat format strings with level, XP, and class via %rpglevelling_*% or {rpglevelling_*} (curly form matches Essentials {player} / {message} style). Recommended for Essentials Plus–style configs: install Placeholder API (optional dependency; mod id HelpChat:PlaceholderAPI). RPG Leveling registers identifier rpglevelling so %rpglevelling_level% and similar tokens are resolved when your chat mod runs placeholders on the format string. Without it, RPG Leveling still patches built Message trees and reflects some PlayerChatEvent fields as a fallback-enough in many setups, but not a full substitute for string-level PAPI. Use this when you configure Essentials Plus or any mod with global / per-group chat format text. Step-by-step (Essentials Plus): Level display in chat formatting (Essentials Plus) - enable chat.enabled, edit mods/fof1092_EssentialsPlus/config.json → chat.groups, put Lv and class next to {player} (RPG tokens stay %rpglevelling_*%).

​
Supported tokens

Spell the prefix with two l characters: rpglevelling (not rpgleveling). Matching is case-insensitive (%RPGLEVELLING_LEVEL% and {RpgLevelling_Level} work the same). Each token works as %rpglevelling_…% or {rpglevelling_…} (no % inside braces). Examples: %rpglevelling_level% or {rpglevelling_level}; %rpglevelling_class% or {rpglevelling_class}. If the player has no class selected, class-related tokens resolve to empty (or 0 for tier where applicable).

​
Example: Essentials Plus–style chat format

A common goal is a line similar to:
  • %rpglevelling_*% - resolved by PlaceholderAPI (when installed) on the format string, and/or patched on the final Message by RPG Leveling.
  • {player}, {message}, etc. - defined by Essentials Plus (or whatever chat mod you use). Use the exact placeholders your chat mod documents for display name and message body.
Where to edit: for Essentials Plus, open mods/fof1092_EssentialsPlus/config.json and the chat.groups object (see Level display in chat formatting (Essentials Plus)). Other mods may use config.toml or different keys. Minimal JSON fragment (Essentials Plus shape - your groups keys must match permission groups):
Run /essentialsplus reload (or restart the server) after saving.

​
Other placeholders in the same string

RPG Leveling only supplies rpglevelling_* values. Other %...% tokens come from PlaceholderAPI and your chat mod. If %rpglevelling_*% stays literal, add Placeholder API and confirm RPG Leveling is loaded (expansion rpglevelling).

​
Troubleshooting

​
For mod developers

Other plugins can read the same data from RPGLevelingAPI (see API); the chat tokens above are a convenience for config strings, not a second API surface.