Migrating from UnlimitedNametags
On this page4 sections
/nametag import unt converts the nametags of UnlimitedNametags (UNT) into AdvancedNametags
templates. It reads plugins/UnlimitedNameTags/settings.yml (or plugins/UnlimitedNametags/), so
keep that file in place; UNT itself does not need to be enabled. Current and older UNT formats are
understood.
Steps
- Install AdvancedNametags and PacketEvents, start the server once. Remove or disable UNT so the two plugins do not both hide and draw nametags.
- Preview:
/nametag import unt. Nothing is changed yet: chat shows how many nametags can be imported and the first notes, andplugins/AdvancedNametags/unt-import-report.txthas the full converted YAML, every note and theconfig.ymlsettings that match your old global options. - Import:
/nametag import unt confirm(or click [Import now]).nametags.ymlis backed up asnametags.yml.bak-<date>-<time>, the templates are appended undertemplates:and the plugin reloads. - Copy the suggested settings from the report into
config.ymlif you want them, then/nametag reload. - Check the result on yourself:
/nametag try <id>and/nametag info <you>.
What is converted
| UNT | AdvancedNametags |
|---|---|
each entry of nameTags | a template with the same id (unt-<id> if the id is already used); characters outside a-z 0-9 _ - become - |
order of nameTags (first match wins) | priority 1000, 990, 980... in the same order |
permission | permission; none or empty becomes permission: none (everyone) |
displayGroups / linesGroups and their yOffset | lines, stacked from the highest group down |
text lines and their when | text and show-if (&&/and split into several conditions) |
ITEM / BLOCK groups | type: item / type: block rows; itemDisplayMode → display; itemModel → model:<key>; nexoId → model:nexo:<id> |
scale, billboard, background (colour, opacity, shadowed, seeThrough) | scale, billboard, background: "#AARRGGBB", shadow, see-through |
animations rotate, bob, pulse_scale, wiggle, orbit, dvd_bounce | spin, float, breathe, sway, orbit, orbit with speed and amount converted |
glow fixed, rainbow, gradient, reference (glowAnimations) | glow: "#colour", rainbow, wave ... colors=... |
%player_name%, %player_displayname%, %player_ping%, %player_health%, %player_max_health%, %player_level%, %player_food_level%, %player_world% | {player}, {displayname}, {ping}, {health}, {max_health}, {level}, {food}, {world} |
behavior.viewDistance, visibility.sneakOpacity, showCurrentNameTag, throughWallMode: SEE_THROUGH, disableDefaultNameTag: false, placeholdersReplacements | suggested visibility.max-distance, sneak.opacity, self-view.default, display.see-through, vanilla-nametag.hide, placeholders.replacements (in the report) |
What is not converted
Each case is listed as a note in the report:
whenconditions that use OR (||,or):show-iflines need every condition, so the condition is dropped. Split such a line into two lines with different conditions.- Conditions that cannot be parsed, and relational conditions (they are evaluated for the nametag's owner only; per-viewer text is not supported).
- Rotations around the X or Z axis (they become a spin around Y),
customModelData(use item models), glow on text groups (only item and block rows glow) and unknown animation types.
After the import
- Priorities. Imported templates start at priority 1000, above the bundled rank templates
(
templates/ranks.yml, up to 200). An imported nametag withpermission: nonetherefore applies to everyone, ranks included. Lower its priority to0, or deletetemplates/ranks.ymlif UNT's designs replace it. - UNT text is usually written with
&codes; they keep working (placeholders.legacy-colors), and you can move to MiniMessage at your pace. - Nothing is lost: run the import again after fixing
settings.yml, or restore the backup ofnametags.yml.