MysticNametags

# 🏷 MysticNameTags v1.2.6 *** ## ✨ Configuration, Admin Tools, and Nameplate Polish Update This update focuses on polishing the new Update 5 feature set from `v1.2.5` and rounding out the first batch of planned post-Update-5 improvements. > ℹ️ **Note:** This is the final planned feature pass for `1.2.6`. > Additional larger features will continue in `1.2.7`. *** ## 🛠 Admin Dashboard Improvements The Admin Dashboard has been expanded with better visibility into MysticNameTags configuration health. ### Dashboard Changes - Added dashboard health status output. - Added doctor/debug information directly into the dashboard. - Added storage, validation, and integration status summaries. - Added active nameplate preset visibility. - Added active glyph font visibility when packet glyph nameplates are enabled. - Improved integration visibility for nameplates, RPGLeveling, economy, permissions, and placeholders. *** ## 🩺 `/tagsadmin doctor` Added a new admin diagnostics command: ```text /tagsadmin doctor ``` The doctor command checks common configuration issues and reports useful warnings before they become confusing in-game behavior. ### Doctor Checks - Validates `tags.json`. - Reports duplicate or missing tag IDs. - Checks missing or malformed display values. - Checks invalid prices and purchasable settings. - Checks missing categories. - Checks default tag configuration. - Checks seasonal/event tag windows. - Checks unavailable seasonal tags. - Checks permission, economy, RPGLeveling, item, stat, placeholder, and playtime requirement concerns. - Warns when multiline nameplates are configured without glyph nameplates enabled. - Reports active nameplate preset behavior. - Reports active glyph font behavior. *** ## 📋 Tag Schema Support Added a `tag.schema.json` file for better tag configuration validation and editor support. ### Schema Coverage - Basic tag fields. - Prices and purchasable tags. - Permissions. - Categories. - Required owned tags. - Playtime requirements. - Stat requirements. - Legacy stat requirement fields. - Item requirements. - Placeholder requirements. - Unlock commands. - Seasonal/event tag fields. *** ## 🎛 Nameplate Presets Added configurable nameplate presets so server owners can choose common layouts without manually editing the raw format string. ### New Setting ```json "nameplatePreset": "CUSTOM" ``` ### Available Presets - `CUSTOM` - `COMPACT` - `TAG_ONLY` - `TWO_LINE` - `RPG` - `ENDLESS` When `nameplatePreset` is set to anything other than `CUSTOM`, it overrides `nameplateFormat`. *** ## 📅 Seasonal / Event Tags Added support for time-limited seasonal and event tags. ### New Tag Fields ```json { "season": "Winter 2026", "activeFrom": "2026-12-01", "activeUntil": "2027-01-01", "availabilityMessage": "This tag is only available during the Winter event." } ``` ### Seasonal Behavior - Tags can now have an availability window. - Unowned seasonal tags are hidden outside their active window. - Owned seasonal tags can still be equipped after the event ends. - Purchase/unlock attempts outside the active window return an unavailable result. - The UI can show availability windows, season labels, and custom availability messages. - Doctor reports seasonal tags that are currently outside their active window. *** ## 🔤 Glyph Font Selection Packet glyph nameplates now support selectable glyph font folders. ### New Setting ```json "experimentalGlyphFont": "default" ``` ### Available Glyph Fonts - `default` - `sans` - `serif` - `comic` - `cursive` - `impact` - `mono` - `thin` The `default` font uses the root glyph assets in: ```text Common/NPC/MysticNameTags ``` The named fonts use their matching folders, such as: ```text Common/NPC/MysticNameTags/sans Common/NPC/MysticNameTags/comic Common/NPC/MysticNameTags/serif ``` *** ## 🧪 Multiline Nameplate Notes Improved documentation and validation around multiline nameplates. MysticNameTags now recognizes multiple newline formats in `nameplateFormat`: ```text /n \n {nl} {newline}
``` > ⚠️ Native Hytale nameplates may still render as a single line. > Packet glyph nameplates remain the reliable path for multiline nameplates. *** ## 🛠 Fixes and Polish - Added safer normalization for `nameplatePreset`. - Added safer normalization for `experimentalGlyphFont`. - Improved unavailable tag handling in the tag UI. - Added custom seasonal unavailable messages. - Added unavailable/event badge support in the tag UI. - Improved seasonal requirement/help text. - Improved dashboard nameplate summary text. - Improved validation messaging for seasonal tags and glyph nameplates. - Improved schema wording for availability messages. *** ## ⚙️ Upgrade Notes Before updating, back up: ```text settings.json tags.json playerdata ``` After installing the new jar: 1. Restart the server. 2. Run `/tagsadmin doctor`. 3. Review any warnings or errors. 4. Check the Admin Dashboard health/debug section. 5. If using nameplate presets, confirm `nameplatePreset` is set correctly. 6. If using packet glyph nameplates, confirm `experimentalGlyphFont` is set to your preferred font. 7. If using seasonal tags, verify `activeFrom`, `activeUntil`, and `availabilityMessage`. > Larger follow-up features are planned to continue in `v1.2.7`.