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
pausenow works forwave,scrollandcolors. The generatedwave.jsonhaspause: 40, so the default wave now rests about 4 seconds between passes. For the old non-stop wave set"pause": 0inanimations/wave.jsonand run/mh reload. See Animations. - A line height of
0stays0instead 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
NONEstayNONE. See Click Actions. /mh line addflagrefusesDISABLE_UPDATINGandDISABLE_ACTIONS(they only work on the hologram)."permission": nullon 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/andconfig/masuholograms/lectern-tracker.json(and their.bak/.migratedcopies) 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
.migratedfiles back, and delete<world>/masuholograms/legacy-import.jsonbefore 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:
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 oldclickCooldownTicksof1is raised to5once (see Main Config).lang.jsonholds only messages players see. The old admin message keys never had an effect and are dropped when the file is written again;/mhadmin output is English. See Language File.
Commands
- Action numbers in
/mh page actionsand/mh page removeactionstart at 1, like line and page numbers. NEXT_PAGEandPREV_PAGEwrap around from the last page to the first and back./mh reloadis 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
#PLAYERlines. - 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.