EasyAnnounce

EasyAnnounce

Hytale 自动化服务器公告系统。包含欢迎消息、定时广播、投票提醒和 Discord 链接功能。支持十六进制颜色自定义、每条消息独立间隔设置，并具备热重载特性。

实用

EasyAnnounce

专为 play.hyfyve.net 的欧洲 Hytale 生存服务器打造

为你的 Hytale 服务器提供自动公告功能！欢迎消息、投票提醒、Discord 链接——全部可自定义。

快速开始

  1. 从 Releases 下载最新的 EasyAnnounce.jar
  2. 将其放入服务器的 mods 文件夹
  3. 重启服务器
  4. 编辑 mods/cryptobench_EasyAnnounce/config.json 以自定义设置
  5. 使用 /announce reload 应用更改

功能特性

  • 欢迎消息 - 玩家加入时发送问候
  • 定时公告 - 投票提醒、小贴士、Discord 链接
  • 十六进制颜色 - 通过 {#RRGGBB} 实现全 RGB 色彩支持
  • 每条公告独立间隔 - 每条消息拥有独立的计时器
  • 权限过滤 - 向特定玩家群体展示公告
  • 热重载 - 无需重启即可更改配置

命令

命令 功能
/announce reload 重载配置，无需重启
/announce status 查看当前运行状态
/announce list 列出所有公告
/announce toggle <id> 启用/禁用指定公告

配置

配置文件路径：mods/cryptobench_EasyAnnounce/config.json

配置文件包含两个主要部分：joinMessages（加入消息） 和 scheduledAnnouncements（定时公告）。

加入消息

当玩家连接到服务器时发送的消息。

"joinMessages": {
  "enabled": true,
  "prefix": "{#55FF55}[欢迎] ",
  "messages": [
    "第1行",
    "第2行"
  ]
}
字段 类型 描述
enabled 布尔值 true 发送消息，false 禁用
prefix 字符串 每条消息前添加的文本（可设为空字符串 ""）
messages 数组 消息列表——每个字符串代表新的一行

注意：

  • 使用 {player} 插入玩家名称
  • 使用空字符串 "" 创建空白行
  • 玩家加入时，所有消息按顺序发送

定时公告

向所有在线玩家广播的重复性消息。每条公告独立运行，拥有自己的计时器。

"scheduledAnnouncements": [
  {
    "id": "vote",
    "enabled": true,
    "intervalSeconds": 300,
    "prefix": "{#FFAA00}[投票] ",
    "message": "{#FFFFFF}为我们投票！",
    "permission": ""
  }
]
字段 类型 描述
id 字符串 此公告的唯一名称（用于命令）
enabled 布尔值 true 启用，false 禁用
intervalSeconds 数值 广播间隔（以秒为单位）
prefix 字符串 消息前添加的文本
message 字符串 公告文本
permission 字符串 仅拥有此权限的玩家可看到（空字符串表示所有人）

常用间隔：

秒数 时长
60 1 分钟
300 5 分钟
600 10 分钟
1800 30 分钟
3600 1 小时

完整配置示例

{
  "joinMessages": {
    "enabled": true,
    "prefix": "",
    "messages": [
      "{#55FF55}========================================",
      "{#FFFF55}   欢迎来到服务器，{player}！",
      "{#55FF55}========================================",
      "",
      "{#55FFFF}命令：",
      "{#FFFFFF}  /home {#AAAAAA}- 传送回家",
      "{#FFFFFF}  /tpa <player> {#AAAAAA}- 请求传送",
      "",
      "{#AAAAAA}玩得开心！"
    ]
  },
  "scheduledAnnouncements": [
    {
      "id": "vote",
      "enabled": true,
      "intervalSeconds": 300,
      "prefix": "{#FFAA00}[投票] ",
      "message": "{#FFFFFF}请到 {#55FF55} https://example.com/vote 为我们投票",
      "permission": ""
    },
    {
      "id": "discord",
      "enabled": true,
      "intervalSeconds": 600,
      "prefix": "{#7289DA}[Discord] ",
      "message": "{#FFFFFF}加入我们的 Discord！{#7289DA} https://discord.gg/example",
      "permission": ""
    },
    {
      "id": "staff-reminder",
      "enabled": true,
      "intervalSeconds": 900,
      "prefix": "{#FF5555}[工作人员] ",
      "message": "{#FFFFFF}记得检查举报信息！",
      "permission": "announce.staff"
    }
  ]
}

颜色

在消息中的任意位置使用 {#RRGGBB} 十六进制颜色代码：

颜色 代码 示例用途
绿色 {#55FF55} 成功消息
红色 {#FF5555} 警告
黄色 {#FFFF55} 高亮
金色 {#FFAA00} 前缀
青色 {#55FFFF} 信息
灰色 {#AAAAAA} 描述
白色 {#FFFFFF} 普通文本
Discord 蓝色 {#7289DA} Discord 链接

示例：

"{#FF5555}警告：{#FFFFFF} PvP 已启用！"

占位符

占位符 替换为
{player} 玩家用户名（仅限加入消息）

权限

权限 功能
announce.admin 访问 /announce 命令

每条公告自定义权限：

在任意公告中设置 "permission": "announce.vip"，即可仅向拥有该权限的玩家展示。

常见问题

问：如何更改公告的显示频率？

更改配置中的 intervalSeconds。例如：

  • 60 = 每 1 分钟
  • 300 = 每 5 分钟
  • 3600 = 每 1 小时

问：如何添加更多公告？

在 scheduledAnnouncements 数组中添加新对象：

{
  "id": "tip1",
  "enabled": true,
  "intervalSeconds": 120,
  "prefix": "{#55FF55}[提示] ",
  "message": "{#FFFFFF}在此输入你的提示！",
  "permission": ""
}

问：能否在不删除公告的情况下禁用它？

设置 "enabled": false 或使用 /announce toggle <id>

问：编辑配置后如何重载？

使用 /announce reload——无需重启！

问：能否只向工作人员展示公告？

设置 "permission": "announce.staff"，并将该权限赋予你的工作人员组。

许可证

MIT - 随意使用！