ZZ公告

ZZAnnounce

ZZAnnounce 是 Ecosistema ZZ 为 Hytale 服务器提供的公告与通知模块。它为服务器工作人员提供了一套简洁、以 UI 为先的方式来管理欢迎消息、手动广播、定时通知、配置以及在 ZZ 生态系统内的审计历史。

ZZAnnounce 的功能

• 为首次加入的玩家和回归玩家创建持久的加入消息。
• 让工作人员在常规使用中无需手动编辑文件即可管理欢迎消息。
• 支持手动公告，用于快速发送全服通知。
• 支持定时公告，可随时间自动重复。
• 可在聊天框、屏幕或两者上显示公告。
• 支持持续时间、视觉样式、倒计时行为以及世界目标设定。
• 将公告数据存储在磁盘上，以便在服务器重启后保留。
• 跟踪已见玩家，以区分首次加入消息和重复加入消息。
• 使用 ZZCore 进行权限管理、文本处理、审计日志记录、模块注册和中心集成。
• 通过 ZZCore 文本系统支持按玩家语言解析，并提供后备语言。

命令与工作流程

/announce 打开 ZZAnnounce 的主管理面板。这是工作人员的主要入口点。管理员可以在此访问手动公告、定时公告、加入消息工具、配置以及与审计相关的流程。

/editor 打开加入消息编辑器。使用此编辑器可创建、编辑、保存或删除加入消息。加入消息可用于首次加入、重复加入、全局消息或特定世界的欢迎通知。

/conf 打开 ZZAnnounce 配置界面。使用此界面可调整默认公告行为、默认加入消息行为、输出模式、持续时间、样式以及相关的模块设置。

/reload 从磁盘重新加载 ZZAnnounce 配置、加入消息、已见玩家状态以及定时公告。在手动更改文件或更新模块数据后，此功能非常有用。

常规工作流程

1. 首先安装 ZZCore。
2. 在 ZZCore 之后安装 ZZAnnounce。
3. 启动 Hytale 服务器。
4. 打开 ZZCore 中心或运行 /announce。
5. 使用 /conf 配置默认公告行为。
6. 使用 /editor 创建或编辑欢迎消息。
7. 使用管理面板发送手动公告或创建定时公告。
8. 仅在需要从磁盘刷新文件时使用 /reload。

运行时文件与数据

• config/config.json 存储语言设置、默认持续时间、输出模式和常规模块行为。
• join-messages/ 存储可编辑的欢迎和加入消息文件。
• announcements/ 存储定时公告文件。
• data/ 存储辅助模块状态，包括已见玩家跟踪。
• 所有模块数据存储在 ZonaZeroMc/ZZAnnounce 下。

权限

zzannounce.admin 授予访问 ZZAnnounce 管理工具的权限，包括管理面板、编辑器、配置、重载流程、手动公告和定时公告。

zz.admin 在 ZZCore 权限可用时，作为全局 ZZ 生态系统管理员覆盖权限。

ZZAnnounce 不暴露普通玩家使用的权限节点。其可见的命令界面专为服务器工作人员和管理工作而设计。

安装

1. 先将 ZZCore.jar 复制到服务器 mods 文件夹中。
2. 在 ZZCore 之后，将 ZZAnnounce.jar 复制到同一个服务器 mods 文件夹中。
3. 启动或重启 Hytale 服务器。
4. 打开 ZZ 生态系统中心或运行 /announce。
5. 验证 ZZAnnounce 是否出现在生态系统界面中，并确认管理员权限是否正常工作。

兼容性

• 目标 Hytale 服务器版本：0.6.2。
• 支持的 ServerVersion 范围：>=0.6.2 <0.7.0。
• 需要 ZZCore 作为生态系统基础模块。

许可

版权所有。

未经作者书面许可，禁止重新分发、转贴、转售编辑或重新上传分支版本。

ZZ 团队