ZZAnnounce

ZZAnnounce

ZZAnnounce is the announcement and notification module of Ecosistema ZZ for Hytale servers. It gives server staff a clean, UI-first way to manage welcome messages, manual broadcasts, scheduled notices, configuration, and audit history from inside the ZZ ecosystem.

What ZZAnnounce Does

Creates persistent join messages for first-time players and returning players.
Lets staff manage welcome messages without manually editing files during normal use.
Supports manual announcements for quick server-wide notices.
Supports scheduled announcements that repeat automatically over time.
Can show announcements in chat, on screen, or both.
Supports duration, visual style, countdown behavior, and world targeting.
Stores announcement data on disk so it survives server restarts.
Tracks seen players to separate first-join messages from repeat-join messages.
Uses ZZCore for permissions, text handling, audit logging, module registration, and hub integration.
Supports per-player language resolution with fallback through the ZZCore text system.

Commands And Workflow

/announce
Opens the main ZZAnnounce admin panel. This is the primary entry point for staff. From here, admins can access manual announcements, scheduled announcements, join-message tools, configuration, and audit-related flows.

/editor
Opens the join-message editor. Use this to create, edit, save, or delete join messages. Join messages can be used for first joins, repeat joins, global messages, or world-specific welcome notices.

/conf
Opens the ZZAnnounce configuration UI. Use this to adjust default announcement behavior, default join-message behavior, output mode, duration, style, and related module settings.

/reload
Reloads ZZAnnounce configuration, join messages, seen-player state, and scheduled announcements from disk. This is useful after changing files manually or after updating module data.

Normal Workflow

Install ZZCore first.
Install ZZAnnounce after ZZCore.
Start the Hytale server.
Open the ZZCore hub or run /announce.
Configure your default announcement behavior with /conf.
Create or edit welcome messages with /editor.
Use the admin panel to send manual announcements or create scheduled announcements.
Use /reload only when you need to refresh files from disk.

Runtime Files And Data

config/config.json stores language settings, default duration, output mode, and general module behavior.
join-messages/ stores editable welcome and join-message files.
announcements/ stores scheduled announcement files.
data/ stores auxiliary module state, including seen-player tracking.
All module data is stored under ZonaZeroMc/ZZAnnounce.

Permissions

zzannounce.admin
Gives access to the ZZAnnounce administrative tools, including the admin panel, editor, configuration, reload flow, manual announcements, and scheduled announcements.

zz.admin
Acts as a global ZZ ecosystem admin override when ZZCore permissions are available.

ZZAnnounce does not expose a normal player-use permission node. Its visible command surface is designed for server staff and administration.

Installation

Copy ZZCore.jar into the server mods folder first.
Copy ZZAnnounce.jar into the same server mods folder after ZZCore.
Start or restart the Hytale server.
Open the ZZ ecosystem hub or run /announce.
Verify that ZZAnnounce appears in the ecosystem UI and that the admin permission works.

Compatibility

Target Hytale Server version: 0.6.2.
Supported ServerVersion range: >=0.6.2 <0.7.0.
Requires ZZCore as the ecosystem base module.

License

All Rights Reserved.

Redistribution, reposting, resale edits, or reuploading forks is not allowed without written permission from the author.

The ZZ Team