Mystic Essentials 1.0.2 — Notifications, Mentions & Custom Content

Mystic Essentials 1.0.2 introduces a unified notification system, configurable player mentions, advanced channel management, a shared ItemView API, playtime tracking, improved AFK zones, server-list decoration, and the optional licensed CustomContent framework.

Compatible with Hytale Server >=0.5.0 <0.6.0; built and tested against 0.5.6.

Unified notifications

• Added /notifications and /notifs with notification history, unread tracking, filters, actions, and player preferences.
• Added chat, action-bar, toast, title, sound, banner, and history delivery surfaces.
• Added low, normal, important, and critical priority profiles.
• Added targeted audiences for players, permissions, worlds, channels, staff, nearby players, and addon-provided guild/party/region resolvers.
• Critical notices can bypass player suppression for maintenance and emergency warnings.
• /broadcast and /alert now support categories, priorities, audiences, titles, subtitles, sounds, durations, actions, and explicit delivery surfaces.
• Teleport requests and update notices now integrate with notification history and actions.

Player mentions

• Added exact-name @PlayerName mentions with case-insensitive matching.
• Handles trailing punctuation while ignoring partial names, URLs, email addresses, and item data.
• Added /mentions and /mentionsettings for personal delivery settings, mention scope, block lists, and do-not-disturb.
• Added configurable sender, same-target, per-minute, and recipient-sound cooldowns.
• Added permission-gated @everyone, @online, @staff, @channel, and addon-provided relationship scopes.
• Staff override and cooldown bypass permissions remain separate.

Chat channels

• Added compact and expanded channel member rosters.
• Added owner, channel moderator, staff, member, and listener roles.
• Added configurable role tags, server ranks, recent text activity, and addon-provided voice activity.
• Temporary-channel owners and moderators can lock channels, mute or remove members, change participation, promote moderators, and transfer ownership.
• Added configurable ownership-transfer acceptance and expiration.
• Added owner-disconnect grace periods with moderator/oldest-member succession or channel closure.
• Added ownership and moderator API events plus audit records.

Item sharing and ItemView

• Reworked chat item links around immutable, server-created snapshots.
• Added quality, rarity, tier, grade, category, statistics, modifiers, requirements, lore, durability, source, and custom sections.
• Empty sections are automatically omitted.
• Added original-tooltip access from the details panel.
• Added /iteminspect, /itemview, /itemlinks, and /recentitems workflows.
• Added a public ItemInspectionService and provider API so other mods can contribute data without replacing the shared UI.
• Split item presentation settings into modules/chat/item-view.json.

CustomContent — licensed optional module

CustomContent combines CustomGUIs, HUD overlays, and the CustomDialogs builder. It is disabled by default and requires a valid module.customcontent license.

Access requirements:

1. Join the Hyzion Discord and become a partner.
2. Purchase an eligible Hyzion Patreon membership.
3. Sign in with Discord at the Hyzion license portal to link the same account.
4. Run /mystic license and register the displayed server licensing ID.
5. Place the downloaded license.mclicense in mods/MysticEssentials/.
6. Enable "customcontent": true, run /mystic license reload, then /mystic reload.

A missing, expired, invalid, or server-mismatched license disables only CustomContent. Mystic Essentials and the server continue to start normally.

CustomContent features include:

• Declarative .gui.html windows and HUDs.
• Rows, columns, grids, panels, scrolling layouts, buttons, inputs, dropdowns, items, images, progress bars, and player portraits.
• Runtime sizing, anchoring, styling, actions, requirements, input interpolation, and live placeholder refresh.
• Built-in command, message, broadcast, navigation, close, and HUD actions.
• CustomDialogs builder with QuestLines export and NPC assignment.
• Safe import from standalone QuestLinesDialog and QuestLinesGUI data.
• Three generated example layouts.
• Runtime asset checks and build-time validation to prevent malformed UI documents from disconnecting clients.

Playtime and player list

• Added total, active, idle, and current-session playtime accounting.
• Added formatted, raw-seconds, and whole-hours placeholders.
• Mystic placeholders are automatically exposed through PlaceholderAPI under both %mystic_*% and %mysticessentials_*%.
• Added retry handling when PlaceholderAPI loads after Mystic Essentials.
• Added configurable Server Players list decoration with LuckPerms prefixes/suffixes, nicknames, and AFK markers.
• Player-list markup is safely stripped because the client roster supports plain text only.

Teleportation and AFK

• Added /tp world <player> <world> for sending players to another world’s spawn.
• Teleport request notifications now include /tpaccept actions and history expiration.
• AFK zones now use their X/Z footprint at every height.
• Added safe landing scans with configurable attempts, headroom, vertical range, blocked floor blocks, and blocked fluids.
• Roofed and underground AFK rooms now prefer their interior floor instead of the highest surface.
• Failed safety searches leave the player in place instead of risking a bad teleport.

UI and command improvements

• Migrated runtime Custom UI text to TextSpans, enabling supported color and style markup throughout menus and HUDs.
• Improved dynamic command suggestions for players, worlds, kits, warps, pending requests, and other contextual values.
• Added vanish-aware player suggestions.
• Added a build-time validator for required Hytale Common.ui component parameters.
• Updated UI identifiers and runtime checks to reduce cross-mod selector collisions and missing-asset disconnects.

Developer API

New services include:

• NotificationService
• ItemInspectionService
• PlaytimeService
• CustomUiService
• Mention-scope registration
• Notification audience resolvers and filters
• Channel ownership/moderator events
• Channel voice-presence providers

Upgrade notes

• Back up mods/MysticEssentials/ before upgrading.
• Replace the existing jar with MysticEssentials-1.0.2.jar.
• New configuration files are generated automatically, including:
  • modules/core/notifications.json
  • modules/chat/mentions.json
  • modules/chat/item-view.json
• Review the new playerList block in the main configuration.
• CustomContent remains off until explicitly enabled and licensed.
• Review new permissions for licensing, mentions, notifications, channel rosters, CustomContent, and cross-world teleporting.