Language File
The language file at config/masuholograms/lang.json holds every message players see: lectern hologram messages, limit messages, click denials, the Hologram Book, /mh getbook, /mh editbook and the /mh guide text. It is generated with defaults on first startup.
After editing, run /mh reload to apply changes.
Admin output stays English
The output of the admin commands (/mh hologram, /mh line, /mh page, /mh feature, /mh list, /mh near, /mh stats, /mh reload and the others that need op level 2) is English and not in lang.json. The damage and healing popup texts are format keys in config.json, not in lang.json.
Format
All messages support:
- Color codes (
&a,&6,&#FF0000, gradients, etc.; see Colors & Formatting) - The
{prefix}placeholder, replaced with the value of theprefixkey in any message - The named placeholders listed per key below
An empty message ("") is not sent at all.
Message Keys
General
| Key | Default | Used When |
|---|---|---|
prefix |
&8[&b&lMasuHolograms&8] &7 |
Inserted wherever a message contains {prefix} |
noPermission |
{prefix}&cYou don't have permission to do that. |
A PERMISSION click action stops because the player lacks the permission |
mustBePlayer |
This command can only be used by players. |
The console runs /mh getbook or /mh editbook |
Lectern Holograms
| Key | Default | Placeholders |
|---|---|---|
lecternNoPermission |
&cYou don't have permission to place hologram books. |
|
lecternLimitReached |
&cYou've reached your hologram limit! ({count}/{limit}) |
{count}, {limit} |
lecternCreated |
&aHologram created above the lectern! ({count}/{limit}) |
{count}, {limit} |
lecternUnlimited |
unlimited |
The {limit} value shown to a player with the limit bypass permission |
lecternRemoved |
&7Lectern hologram removed. |
|
lecternEmptyBook |
&cThe book has no content to display. |
|
lecternBlocked |
&cThis lectern cannot show a hologram. |
|
lecternDisabled |
&cLectern holograms are disabled. |
lecternBlocked is sent when an admin hologram already has the name the lectern hologram would get. lecternDisabled is sent by /mh getbook while the lectern feature is turned off in config.json.
Lectern Hologram Lines
These are not chat messages but lines added to multi-page lectern holograms, under the book's lines.
| Key | Default | Placeholders |
|---|---|---|
lecternPageIndicator |
&8Page {page}/{pages} |
{page}, {pages} |
lecternNavigationFirst |
&8[&e Right-click &7-> Next Page &8] |
|
lecternNavigationMiddle |
&8[&e <- Left-click &8] &8[&e Right-click -> &8] |
|
lecternNavigationLast |
&8[&e <- Left-click Previous Page &8] |
The lines are written into the hologram when the book is placed; a changed text shows on lectern holograms placed after the reload.
Hologram Book
| Key | Default | Placeholders |
|---|---|---|
bookName |
&b✦ Hologram Book |
|
bookLore |
list of 5 lines, starting &7Write up to {lines} lines per page |
{lines} (maxLinesPerPage) |
bookReceived |
&aYou received a &b&l✦ Hologram Book&a! |
|
bookInventoryFull |
&cYour inventory is full! |
|
editBookNotHolding |
&cYou must hold a signed Hologram Book in your main hand. |
|
editBookConverted |
&aBook converted to editable! Edit it and re-sign when done. |
|
editBookHover |
&7Click to fill in the command! |
bookName and bookLore apply to books handed out after the change.
Guide
guide is a list of lines that /mh guide sends. In any line, {lines} becomes maxLinesPerPage and {editbook} becomes a clickable /mh editbook (hover text editBookHover).
"guide": [
"",
"&6&l========= Hologram Book Guide =========",
"",
"&e1. &fGet a hologram book with &b/mh getbook",
"&e2. &fWrite your content (up to {lines} lines per page)",
"&7 A new line only starts when you press &fEnter&7 - text that wraps naturally still counts as one line",
"&7 Color codes: &c&&cc &a&&ca &b&&cb &6&&c6 &d&&cd &e&&ce &fand more!",
"&7 Formatting: &l&&ll&r&7 bold, &o&&oo&r&7 italic, &n&&nn&r&7 underline",
"&e3. &fPlace the book on a lectern",
"&e4. &fA hologram appears above the lectern!",
"&e5. &fBreak the lectern to remove the hologram",
"",
"&6&lTips:",
"&7 • Multiple book pages = multi-page hologram with auto-navigation",
"&7 • Right-click hologram for next page, left-click for previous",
"&7 • Need to edit a signed book? Hold it and use {editbook}",
"",
"&6&l========================================"
]
Customization Example
{
"prefix": "&8[&bHolograms&8] ",
"noPermission": "{prefix}&cOnly VIPs can use this.",
"lecternCreated": "{prefix}&aYour hologram is up! &7({count}/{limit})",
"lecternLimitReached": "{prefix}&cYou already have {count} of {limit} holograms."
}
Notes
- Only include keys you want to override. A missing key, or a key set to
null, uses its default. - The file is written back on every load: missing keys are added with their defaults and unknown keys are removed. Files from before 1.3.0 contain admin keys such as
hologramCreatedorlineAdded; those were never used and are dropped when the file is rewritten. - If the file is not valid JSON, the error is logged, your file is left untouched and every message uses its default until you fix it and run
/mh reload. - Color codes are processed after the placeholders are filled in.