Translation System
The RPG Leveling plugin supports full translation and localization. All messages, notifications, commands, and GUI elements can be translated into your preferred language.How to Translate
Translation files are located at:messages.json file is automatically generated when the server starts for the first time. It contains all translatable text in the plugin with English as the default language.
Creating Your Translation
- Locate the messages.json file — After running the server once, find it at
mods/RPGLeveling/messages.json - Edit the translations — Open the file and translate each message value to your language
- Keep the keys unchanged — Only translate the text values, never modify the keys (e.g. keep
"level_up"as is, only change the message text) - Restart the server — After saving your changes, restart the server to apply the translations
Translation Guidelines
- Text Wrapping — If translated text doesn’t fit or wrap properly in the GUI/HUD, use shorter or alternative phrasing. The plugin doesn’t automatically adjust text size.
- Preserve Formatting — Some messages contain placeholders like
{level},{xp},{player}, etc. Keep these exactly as they are — they are replaced with actual values by the plugin. - Test Your Translation — After translating, test all features (commands, GUI, HUD, notifications) to ensure everything displays correctly.
Troubleshooting Translation Issues
If you encounter bugs or issues with your translation file:- Download the fresh messages.json — Get a clean copy from the latest release
- Delete your modified file — Remove your custom
mods/RPGLeveling/messages.json - Restart the server — The plugin will automatically generate a new default
messages.json - Re-apply your translations — Start fresh with your translations on the new file
messages.json or RPGLevelingConfig.json while the server is running will not apply until you restart.