Hyronic Mcmmo DocsLocalization
Translate or rewrite any mcMMO in-game text, change colors with three formats, and customize skill tooltips - without editing the jar.
Every piece of text mcMMO shows players - messages, skill names, tooltips, notifications - comes from a locale file. You can switch to a built-in translation, or override any individual line with your own wording and colors.
Choosing a language
mcMMO ships with many community translations. To switch, set General.Locale in
config.yml and restart:
General:
Locale: en_USCommon locale codes:
| Code | Language | Code | Language |
|---|---|---|---|
en_US | English (default) | ja_JP | Japanese |
de | German | ko | Korean |
es | Spanish | pl | Polish |
fr | French | pt_BR | Portuguese (Brazil) |
it | Italian | ru | Russian |
fi | Finnish | zh_CN | Chinese (Simplified) |
cs_CZ | Czech | zh_TW | Chinese (Traditional) |
The full set is in the locale folder on GitHub.
Community translations are volunteer-maintained and can lag behind new features. Any key a
translation is missing automatically falls back to en_US, so you'll never see a blank.
Overriding individual text
Don't edit the language files inside the jar. Instead, mcMMO generates an override file:
plugins/mcMMO/locales/locale_override.propertiesHow lookups work, in order:
- The key in
locale_override.properties(if you've defined it) - highest priority. - Otherwise the active language set by
General.Locale. - Otherwise
en_US.
This means you only copy the specific keys you want to change into the override file - never the whole file. Keys you don't override keep updating automatically with new mcMMO versions.
Don't paste an entire locale file into your override. If you do, you freeze every line at today's wording and silently miss all future text updates.
The master list of every key is the English file:
locale_en_US.properties.
Applying changes: restart the server, or run /mcmmoreloadlocale (alias
/mcreloadlocale, permission mcmmo.commands.reloadlocale). The reload command affects
locale only - config files still need a full restart.
If you ever see literal text like !Some.Key.Name! in chat, that key is missing from your
override and all locale files - usually a typo'd key in your override.
Colors and formatting
Locale values support three color formats, and you can freely mix them in one line.
1. Standard & codes
The familiar Minecraft codes:
| Code | Color | Code | Color | Code | Format |
|---|---|---|---|---|---|
&0 | Black | &8 | Dark Gray | &l | Bold |
&1 | Dark Blue | &9 | Blue | &n | Underline |
&2 | Dark Green | &a | Green | &o | Italic |
&3 | Dark Aqua | &b | Aqua | &m | Strikethrough |
&4 | Dark Red | &c | Red | &k | Obfuscated |
&5 | Dark Purple | &d | Light Purple | &r | Reset |
&6 | Gold | &e | Yellow | ||
&7 | Gray | &f | White |
mcMMO.Template.Prefix=&6(&amcMMO&6) &7{0}2. [[NAME]] color tokens
mcMMO's readable token format - each maps to a & code, so use whichever you prefer:
Skills.Overhaul.Header=[[DARK_AQUA]][[BOLD]]{0}Available tokens: [[BLACK]], [[DARK_BLUE]], [[DARK_GREEN]], [[DARK_AQUA]],
[[DARK_RED]], [[DARK_PURPLE]], [[GOLD]], [[GRAY]], [[DARK_GRAY]], [[BLUE]],
[[GREEN]], [[AQUA]], [[RED]], [[LIGHT_PURPLE]], [[YELLOW]], [[WHITE]],
[[BOLD]], [[UNDERLINE]], [[ITALIC]], [[STRIKE]], [[MAGIC]], [[RESET]].
3. &#RRGGBB hex colors
Full 24-bit color. Prefix a standard web hex code with &#:
My.Key=&#FF5500Orange text
My.Key2=&lBold then &#FF0000red then &r resetAll three formats also work inside the JSON tooltip keys below.
Customizing skill tooltips
When a player runs a skill command (e.g. /mining), mcMMO shows rich hover tooltips driven
by JSON.* keys. A few of the most useful:
| Key | Default | Purpose |
|---|---|---|
JSON.Type.Passive | &a&lPassive&r | "Passive" sub-skill label |
JSON.Type.Active | &4&lActive&r | "Active" sub-skill label |
JSON.Type.SuperAbility | &d&lSuper Ability&r | "Super Ability" label |
JSON.DescriptionHeader | &5Description: | Header above a description |
JSON.Locked | &8-=[LOCKED]=- | Shown for not-yet-unlocked sub-skills |
JSON.Hover.Rank | &e&lRank:&r &f{0} | Current rank ({0} = rank number) |
JSON.Hover.NextRank | &7&oNext upgrade at level {0} | Next-unlock hint |
Renaming a skill
Skill names come from <Skill>.SkillName keys (not JSON.*):
Mining.SkillName=Mining
Woodcutting.SkillName=WoodcuttingOverride these to rename a skill server-wide.
Per-sub-skill tip text
Each sub-skill's tooltip tip follows this pattern:
JSON.<Skill>.SubSkill.<SubSkill>.Details.TipsJSON.Acrobatics.SubSkill.Roll.Details.Tips=Hold sneak while falling to prevent up to twice the normal damage!Search the en_US file for the exact key of any sub-skill you want to reword.