Messages Language Mapping

File: mods/Zuxaw_RPGLeveling/MessagesLanguageMapping.json This file contains all translatable text strings for the plugin. It was renamed from messages.json in version 0.2.0.

Overview

The file supports full localization and includes messages for:

Stat names and descriptions - Health, Stamina, Damage, Defense, etc.
HUD messages - Level, XP progress, zone names
GUI labels and buttons - Stat allocation, navigation, confirmations
Error messages - Invalid commands, permission errors
Notification messages - Level up, stat allocation, system messages
Command descriptions and responses - Help text, feedback messages

Translation Support

The plugin uses this file to support multiple languages. You can create a full translation by editing all text strings in this file.

Supported Languages

Any language can be supported by editing the text strings. Common translations include:

English (default)
French
Spanish
German
Portuguese
Russian
Japanese
Chinese
And more…

File Structure

The file is organized into logical sections:

{
  "Version": "0.2.0",
  "Stats": {
    "Health": "Health",
    "Stamina": "Stamina",
    "Damage": "Damage",
    "Defense": "Defense",
    ...
  },
  "HUD": {
    "Level": "Level",
    "XP": "XP",
    "Zone": "Zone",
    ...
  },
  "GUI": {
    "Title": "Stats",
    "AllocateButton": "Allocate",
    "ResetButton": "Reset",
    ...
  },
  "Commands": {
    ...
  },
  "Notifications": {
    ...
  }
}

Common Message Keys

Stat Names

{
  "Health": "Health",
  "Stamina": "Stamina",
  "Mana": "Mana",
  "Damage": "Damage",
  "Defense": "Defense",
  "Mining": "Mining",
  "Woodcutting": "Woodcutting",
  "StaminaRegenSpeed": "Stamina Regen Speed",
  "StaminaConsumption": "Stamina Consumption",
  "Ammo": "Ammo",
  "Oxygen": "Oxygen"
}

Stat Descriptions

{
  "HealthDesc": "Increases maximum health",
  "StaminaDesc": "Increases maximum stamina",
  "DamageDesc": "Increases damage to NPCs",
  "DefenseDesc": "Reduces damage taken (%, max 80%)",
  "MiningDesc": "Increases damage to stone/ore blocks",
  "WoodcuttingDesc": "Increases damage to wood blocks"
}

HUD Messages

{
  "Level": "Level",
  "XP": "XP",
  "Zone": "Zone",
  "LevelProgress": "{current} / {required}",
  "ZoneLevel": "Zone {id} (Lvl {min}–{max})"
}

GUI Labels

{
  "StatsGUITitle": "Stats",
  "AllocateButton": "Allocate",
  "ResetButton": "Reset",
  "AvailablePoints": "Available: {points}",
  "MaxReached": "Max reached"
}

Notifications

{
  "LevelUp": "Level Up! You are now level {level}",
  "StatAllocated": "Allocated {points} point(s) to {stat}",
  "StatsReset": "Stats reset successfully",
  "MaxLevel": "You have reached the maximum level!"
}

Command Messages

{
  "CommandHelp": "/lvl - Open stats GUI",
  "CommandInfo": "/lvl info - Show your level and stats",
  "NoPermission": "You don't have permission to use this command",
  "InvalidArgument": "Invalid argument: {arg}"
}

Example Translation (French)

Here’s an example of a partial French translation:

{
  "Version": "0.2.0",
  "Stats": {
    "Health": "Santé",
    "Stamina": "Endurance",
    "Mana": "Mana",
    "Damage": "Dégâts",
    "Defense": "Défense",
    "Mining": "Minage",
    "Woodcutting": "Bûcheronnage"
  },
  "HUD": {
    "Level": "Niveau",
    "XP": "XP",
    "Zone": "Zone"
  },
  "Notifications": {
    "LevelUp": "Niveau supérieur! Vous êtes maintenant niveau {level}",
    "StatAllocated": "{points} point(s) alloué(s) à {stat}",
    "StatsReset": "Statistiques réinitialisées avec succès"
  }
}

Placeholders

Many messages support placeholders that are replaced with dynamic values:

Placeholder	Description	Example
`{level}`	Player level	”You are now level 50”
`{points}`	Stat points	”Available: 15 points”
`{stat}`	Stat name	”Allocated to Damage”
`{current}`	Current XP	”1250 / 2000”
`{required}`	Required XP	”1250 / 2000”
`{min}`	Min level	”Zone 2 (Lvl 25–50)“
`{max}`	Max level	”Zone 2 (Lvl 25–50)“
`{id}`	Zone/instance ID	”Zone 3”

Creating a Translation

To create a full translation:

Copy the default MessagesLanguageMapping.json file
Translate all text strings to your target language
Keep the JSON structure intact (don’t change keys, only values)
Test in-game to ensure all messages display correctly
Share your translation with the community!

Formatting Tips

Keep placeholders intact - {level}, {points}, etc. must remain as-is
Maintain similar length - Very long translations may not fit in UI elements
Use consistent terminology - Use the same word for “level”, “stat”, etc. throughout
Test thoroughly - Check HUD, GUI, commands, and notifications

Getting Started

Guides

Classes & Passives

Usage

Mod Content

Configuration

Troubleshooting

For Developers

Changelog

Messages Language Mapping

Messages Language Mapping

Overview

Translation Support

Supported Languages

File Structure

Common Message Keys

Stat Names

Stat Descriptions

HUD Messages

GUI Labels

Notifications

Command Messages

Example Translation (French)

Placeholders

Creating a Translation

Formatting Tips

See Also

​Messages Language Mapping

​Overview

​Translation Support

​Supported Languages

​File Structure

​Common Message Keys

​Stat Names

​Stat Descriptions

​HUD Messages

​GUI Labels

​Notifications

​Command Messages

​Example Translation (French)

​Placeholders

​Creating a Translation

​Formatting Tips

​See Also

Messages Language Mapping

Overview

Translation Support

Supported Languages

File Structure

Common Message Keys

Stat Names

Stat Descriptions

HUD Messages

GUI Labels

Notifications

Command Messages

Example Translation (French)

Placeholders

Creating a Translation

Formatting Tips

See Also