HyAnnouncer - 公告 - 广播 - 音效

HyAnnouncer

一款功能强大的 Hytale 服务器公告系统，支持可配置的间隔时间、多种显示类型、世界/权限过滤、可点击链接以及占位符支持。

⚠️ 早期访问须知： Hytale 目前处于早期访问阶段，本模组也处于早期访问阶段。随着游戏的发展，内容可能会发生变化、出现故障或需要更新。我们正在积极维护和改进本模组。如果您遇到任何问题或有建议，请通过 Discord 联系我们——我们期待您的反馈！

✅ Hytale 0.5.6： 1.1.7 版本面向服务器 0.5.6+。您现有的 JSON 配置兼容 —— 放入新的 JAR 文件并执行 /ha reload 即可。

📚 完整文档

👉 查看完整 Wiki 文档

（有关详细的配置示例、所有占位符、颜色代码、高级功能、故障排除等更多信息，请访问我们的 Wiki！）

主要特性

• 定时公告：按可配置的间隔时间自动发送公告
• 基于 Cron 的调度：使用 cron 表达式（例如，每天中午）来安排公告
• 简单模式调度：使用持续时间字符串（10s, 5m, 1h, 2d）进行简便的基于间隔的调度
• 音效系统：为公告播放音效（标题/通知有默认音效）
• 高级卡顿保护：智能间隙保护防止服务器卡顿时公告刷屏
• 公告模式：轮转模式（一个全局间隔，一次轮转一条）
• 多种显示类型：聊天、标题和通知公告（分别配置）
• 交互式 GUI：用于管理公告的网页端 GUI（/ha gui）
• 欢迎消息：玩家加入时可自定义消息，并带有可点击链接
• 加入/离开消息：自定义加入/离开广播；压制默认的 Hytale 世界加入/离开消息
• 细粒度权限：通过 hyannouncer.command.* 节点管理员工指令 —— 无需 OP 权限
• 可点击链接：在公告中添加可点击的 URL（Discord、网站等）
• 世界与权限过滤：针对特定世界或玩家权限
• 占位符：用于玩家名称、世界信息、服务器统计信息、日期等的动态占位符
• 颜色代码：完整支持 Minecraft 风格颜色代码（& 和 § 符号）+ 十六进制颜色
• 优先级系统：在不使用随机顺序时，按优先级排列公告顺序

安装指南

1. 从 CurseForge 下载最新版本
2. 将 JAR 文件放入服务器的 mods 文件夹中
3. 启动/重启你的服务器（Hytale 0.5.6+，Java 25）
4. 配置将创建在 HyAnnouncer_tins/ 目录下
5. 编辑配置文件并使用 /ha reload 应用更改

GUI 系统

HyAnnouncer 包含一个交互式网页端 GUI，用于管理公告。通过 /ha gui 访问。

GUI 提供：

• 欢迎消息配置
• 加入/离开消息配置
• 聊天、标题和通知公告管理
• 计划操作管理（基于 cron 和持续时间）
• 启动/停止单个公告
• 启用/禁用公告
• 手动消息发送
• 包含命令和占位符的 Wiki 页面

权限（1.1.7+）

命令使用权限节点而非要求 OP。示例：

/perm group add moderator hyannouncer.command.use hyannouncer.command.broadcast hyannouncer.command.send hyannouncer.command.gui /perm group add admin hyannouncer.admin

OP (*) 权限仍然授予完全访问权限。

命令

• /ha 或 /hyannouncer 或 /announce - 主命令（显示帮助信息）
• /ha info - 显示模组信息、版本和 Discord 链接
• /ha reload - 重载所有配置文件（无需重启服务器）
• /ha test - 立即测试所有公告
• /ha broadcast <id> - 手动触发指定公告
• /ha list - 列出所有可用公告及其详细信息
• /ha gui - 打开用于管理公告的交互式 GUI
• /ha send / /ha sendplayer - 按需发送自定义消息
• /ha start / /ha stop - 控制单个公告
• /ha startsys / /ha stopsys - 控制整个公告系统

支持与文档

• 📖 完整 Wiki：https://tinsware.github.io/wiki/docs/hytale/mods/hyannouncer
• 💬 Discord：https://discord.gg/TCJAwsdqum

版本： 1.1.7 | 服务器： Hytale 0.5.6+

---