喧闹

喧闹

一个扩音器道具:向所有在线玩家发布公告,显示在屏幕顶部的横幅和聊天中。

实用

Clamor

为 Hytale 服务器打造的扩音器:向所有在线玩家发送公告,显示在屏幕顶部的横幅和聊天中。

Clamor 是一个服务器插件。一切都在服务器端运行,玩家无需安装任何东西。每条公告都会保存在每日历史文件和服务器日志中。

Clamor 支持英语、葡萄牙语、德语、西班牙语、法语、俄语和中文。每位玩家会以各自的游戏语言看到它,无需任何设置。

功能

📣 扩音器

  • 一件在工作台制作的物品,位于实用工具分类下,需要 2 个铜锭、1 个轻皮革和 2 个植物纤维。管理员还可以在创造模式物品栏的工具分类中找到它,或使用 /give Clamor_Megaphone。
  • 手持扩音器时,右键单击打开公告界面。该物品不会被消耗。
  • 它也是一件实用工具物品,类似火把:放在实用工具槽中并在 Z 轮盘中选择后,无论手持什么武器或工具,鼠标中键都能打开界面。

📢 公告

  • 最多 100 个字符,发送给所有在线玩家,显示在屏幕顶部的横幅中(指南针下方),发送者名字显示为金色,同时在聊天中以 [Megaphone] Name: text 形式显示,并伴有短音效。
  • 每条公告在屏幕上停留 8 秒,其余公告在队列中等待:界面会显示你的公告是否正在播出,或前面还有多少条,横幅会显示"+N in queue"。
  • 文本按原样发送:颜色、命令和表情符号不会生效。

⏱️ 免费,但有间隔

  • 每位玩家在两条公告之间需等待一个最小间隔,默认 5 分钟。界面会显示倒计时。设为 0 可关闭。
  • 队列默认最多容纳 50 条公告。队列满时,新公告会被拒绝,直到队列腾出位置。

🪙 公告收费(可选)

  • 管理员可以让每条公告在服务器经济系统中花费金钱:通过 VaultUnlocked,使用其中注册的任意经济系统和您选择的货币,或通过在自己的 API 中注册到 Clamor 的经济模组。
  • 玩家会在界面上看到价格和余额,并按各自语言的数字格式显示。余额不足时,不扣费也不发送公告。
  • 扣费绝不会重复进行,即使服务器中途崩溃。来自其他模组的公告永不收费。

📜 历史记录

  • 每条公告保存在 mods/Merlinz_Clamor/history/ 中的每日一个文件里,包含发送者、名称、文本和时间,同时也会写入服务器日志。

🔌 面向其他模组

  • 公开 API:其他模组可以将公告加入队列,以自己的名称作为发送者,且不受间隔限制。
  • 经济模组可以成为扣费提供者,并按每位玩家的语言写入价格。

🛠️ 管理员菜单

  • /clamor admin 打开一个游戏内管理员菜单,分为公告和扣费两个部分,每个选项占一行:名称、简短描述、当前生效值以及输入字段。保存会写入 config.json 并立即对所有人生效。
  • 横幅、扩音器界面和菜单与作者其他模组的外观一致:游戏的蓝色、金色细节以及带有扩音器的火漆印章。

前置要求

Hytale 服务器 0.7.x(Update 7)。已在 0.7.5 上测试
VaultUnlocked 可选:让公告可在其中注册的任意经济系统中收费。已使用 2.20.1 测试
拥有自己提供者的经济模组 可选:同样通过 Clamor API 实现

每个 Clamor 版本支持一个 Hytale 更新。Hytale API 每次更新都会变化,因此在对应新 Hytale 更新的 Clamor 版本发布之前,请不要将服务器更新到新的 Hytale 更新。

Clamor Hytale
1.0.0 0.7.x(Update 7),已在 0.7.5 上测试

安装

  1. 停止服务器。
  2. 将 Clamor-<version>.jar 放入服务器的 mods 文件夹。该文件夹中只保留一个 Clamor jar。
  3. 启动服务器。Clamor 会在 mods/Merlinz_Clamor/ 中创建其文件,控制台会显示 Clamor loaded。
  4. 将自己设为 OP(在控制台中执行 /op add <name>),然后在游戏中输入 /clamor 以检查已加载的版本。
  5. 若要对公告收费,请在 config.json(ChargeProvider)或管理员菜单中选择一个提供者。

请备份整个 mods/Merlinz_Clamor/ 文件夹:config.json、pending.json 和 history/。队列和每位玩家的间隔保存在内存中,无需备份。

命令

玩家无需使用命令:扩音器是一件物品。管理员命令如下。子命令还需要 /clamor 的权限。OP 拥有全部权限。

命令 作用 权限
/clamor 显示已加载的版本 merlinz.clamor.command.clamor
/clamor admin 打开管理员菜单 merlinz.clamor.command.clamor.admin
/clamor reload 无需重启即可重新加载 config.json merlinz.clamor.command.clamor.reload
/clamor kit 打开预览界面,展示窗口外观的每个部分。不改变任何内容 merlinz.clamor.command.clamor.kit

配置

mods/Merlinz_Clamor/config.json,通过 /clamor reload 或管理员菜单应用:

键 默认值 作用
AnnouncementIntervalSeconds 300 每位玩家在公告之间等待的秒数,从 0(关闭)到 86400(一天)
MaxWaitingAnnouncements 50 队列中可等待的公告数量(不含屏幕上正在显示的),从 1 到 1000
ChargeProvider None 谁为公告收费:None(免费)、VaultUnlocked,或由其他模组注册的提供者 id
ChargeCurrency 空 货币,仅在使用 VaultUnlocked 时有效。留空则使用经济系统的默认值
AnnouncementPrice 10 每条公告的价格,以货币单位计,从 0(免费)到 1,000,000,000,000
AnnouncementPrice 10 每条公告的价格,以货币单位计,从 0(免费)到 1,000,000,000,000

文件出错时会被拒绝,控制台会显示原因,之前的设置保持不变。启动时,出错的文件会阻止 Clamor 加载:原因显示在控制台中。

已知限制

  • 德语、西班牙语、法语、俄语和中文的翻译尚未经过母语者审校。服务器日志和配置文件错误始终为英语。
  • 队列和间隔保存在内存中:重启会清空队列,且无人需要等待。
  • VaultUnlocked 没有操作 id,因此因崩溃而中断的扣费无法安全重试:该公告会等待管理员在 pending.json 中检查,管理员菜单会显示有多少条此类公告。
  • 如果某个模组绑定了玩家的鼠标中键,则会接管该按键:扩音器仍可通过右键打开。

许可证

可在任意数量的服务器上免费使用,包括盈利性服务器。不得重新发布、再分发、出售或分发 Clamor 的修改版本。完整文本请参阅本页面的许可证。

Clamor 是一个非官方模组。它并非由 Hypixel 制作、认可或支持。


支持

Clamor 是免费的。如果它对您的服务器有帮助,您可以在 Ko-fi 上支持它的开发。谢谢!

Support Clamor on Ko-fi