Skip to content

Upgrading

To 1.3.2

1.3.2 reads 1.3.1 files unchanged. A flag name or a click type under actions that MasuHolograms does not know (a typo such as RIGHTT, or disable_actions in lower case, in a hand-edited file) is now kept in the file and written back on save instead of being dropped. It still does nothing, and the server log names it once per hologram when the holograms load, so check the log after upgrading for typos that 1.3.1 hid. See Storage & Backups.

To 1.3.1

1.3.1 reads 1.3.0 files unchanged. What looks or behaves differently:

  • Animation pause now works for wave, scroll and colors. The generated wave.json has pause: 40, so the default wave now rests about 4 seconds between passes. For the old non-stop wave set "pause": 0 in animations/wave.json and run /mh reload. See Animations.
  • A line height of 0 stays 0 instead of returning to the type default when the line changes; the next line overlaps it.
  • Click actions of a type no mod registers are kept in the file and work again when the mod is back. Actions that 1.3.0 already saved as NONE stay NONE. See Click Actions.
  • /mh line addflag refuses DISABLE_UPDATING and DISABLE_ACTIONS (they only work on the hologram).
  • "permission": null on a line no longer stops the hologram from loading.
  • <gradient:...> and <rainbow> work in lower case too, including in lectern books.

To 1.3.0

1.3.0 loads hologram files from 1.0.0 to 1.2.x unchanged; there is no conversion step for admin holograms. Read the points below before you replace the jar.

Lectern Holograms Move Into the World

Player-made lectern holograms and lectern-tracker.json now live in <world>/masuholograms/ instead of config/masuholograms/. On the first start of each world, the old files are imported once and renamed .migrated (never deleted). Admin holograms stay in config/masuholograms/holograms/ and are shared by every world. Details: Storage & Backups.

  • Resetting a world at the same time? Delete config/masuholograms/holograms/players/ and config/masuholograms/lectern-tracker.json (and their .bak / .migrated copies) before the first 1.3.0 start, or the new world imports the old lectern holograms once.
  • Going back to 1.2.x: 1.2.x does not read the world folder, so it shows no lectern holograms. Rename the .migrated files back, and delete <world>/masuholograms/legacy-import.json before you upgrade again so the old files are imported again.

Line Layout

Lines stack top-down in the order they are written, and icons, heads, entities and #PLAYER NPCs stand at the bottom of their own band. A 1.2.x hologram with such lines can appear higher than before: lower the hologram or its line heights. See Line Types.

#PLAYER lines now default to height 2.3 so the NPC's name tag stays clear of the text above. A line saved before 1.3.0 keeps its height 2.0; raise it with:

/mh line height <hologram> <page> <line> 2.3

Permissions

Without a permissions mod, operators (op level 2) now pass hologram and line permissions, PERMISSION click actions and the lectern limit and bypass nodes; before 1.3.0 these denied everyone. See Permissions.

Config and Messages

  • config.json: every key now has an effect. An old clickCooldownTicks of 1 is raised to 5 once (see Main Config).
  • lang.json holds only messages players see. The old admin message keys never had an effect and are dropped when the file is written again; /mh admin output is English. See Language File.

Commands

  • Action numbers in /mh page actions and /mh page removeaction start at 1, like line and page numbers.
  • NEXT_PAGE and PREV_PAGE wrap around from the last page to the first and back.
  • /mh reload is refused while a hologram could not be saved, so a newer state in memory is never replaced by an older file.

Optional Mods

  • Taterzens must be 1.9.6 to 1.9.x for #PLAYER lines.
  • Vault Hunters works at any version. A Vault Hunters placeholder that does not match the installed version turns itself off with one line in the log.