Skip to content

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 the prefix key 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 hologramCreated or lineAdded; 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.