MessagesPlus

MessagesPlus

一款专为 Hytale 服务器设计的全方位聊天与消息插件，旨在增强玩家沟通和服务器公告功能，所有内容均可通过 JSON 完全自定义。

官方合作伙伴

我们与 Kinetic Host 达成合作，他们持续支持本模组的开发。这是一家价格实惠、服务优质的优秀主机商。

功能特性

• 自定义聊天格式：根据权限（群组）配置聊天格式，并支持优先级设置。
• 进出服务器消息：可自定义首次加入、加入和离开消息。自动屏蔽服务器默认加入消息，仅显示自定义内容。
• 定时公告：设置自动广播消息，并支持可配置的发送间隔。
• 十六进制颜色支持：完整支持 RGB 十六进制颜色（&#RRGGBB）和传统代码（&a、&l）。
• 富文本样式：支持加粗（&l）、斜体（&o）、下划线（&n）、删除线（&m）和随机字符（&k）。
• 热加载：无需重启服务器即可即时重新加载配置。
• 占位符：内置占位符支持，用于动态消息。

安装方法

手动安装

1. 下载：从 Releases 页面获取最新的 MessagesPlus-x.x.x.jar 文件。
2. 安装：将 JAR 文件放入 Hytale 服务器的 mods（或 plugins）目录。
3. 运行：启动服务器。默认配置文件将在插件数据目录中生成。

命令列表

主命令

别名：/messagesplus 或 /mp

子命令

1. 通用

• /mp reload：立即重新加载所有配置文件（welcome-leave.json、chat-format.json、scheduled.json）。

2. 定时管理

可直接在游戏内或控制台中管理自动广播消息。

• /mp schedule list：列出所有激活的定时消息及其 ID 和间隔。
• /mp schedule add <interval_seconds> <message>：添加新的定时消息。
  • 示例：/mp schedule add 300 &aDon't forget to join our Discord!
  • 注意：间隔以秒为单位。
• /mp schedule remove <id>：根据 ID（可通过 /mp schedule list 查找）移除定时消息。

配置说明

插件在其数据文件夹中生成以下配置文件：

1. chat-format.json

根据权限定义聊天格式。插件会从上到下检查格式规则，玩家拥有权限的首条规则将被应用。

{
  "owner": {
    "format": "&8[&cOwner&8] &c%playername%&8: &f%message%",
    "permission": "messagesplus.owner"
  },
  "admin": {
    "format": "&8[&cAdmin&8] &c%playername%&8: &f%message%",
    "permission": "messagesplus.admin"
  },
  "default": {
    "format": "&7%playername%: &7%message%"
  }
}

• 提示：将优先级较高的群组（如 Owner/Admin）放在文件顶部。

2. welcome-leave.json

配置玩家连接事件的消息。

{
  "first_join_message": "&eWelcome &b%playername%&e to the server for the first time!",
  "join_message": "&e%playername% &ejoined the game.",
  "leave_message": "&e%playername% &eleft the game.",
  "debug": false
}

• first_join_message：仅当玩家首次加入服务器时广播。
• join_message：为回归的玩家广播。
• leave_message：玩家断开连接时广播。

3. scheduled.json

存储定时公告内容。虽然可以手动编辑，但我们建议使用 /mp schedule 命令进行管理。

{
  "messages": [
    {
      "id": 1,
      "interval": 300,
      "text": "&aCheck out our website at example.com!",
      "lastSent": 123456789
    }
  ]
}

占位符

你可以在聊天格式、进出服务器消息和广播中使用以下占位符：

占位符	描述
%playername%	玩家用户名
%uuid%	玩家的唯一 ID
%world%	玩家当前所在世界的名称
%message%	聊天消息内容（仅限聊天格式）
%health%	（即将推出）玩家的生命值

颜色代码

传统颜色

使用 & 的标准 Minecraft 风格颜色代码。

• &0 黑色，&1 深蓝色，&2 深绿色，&3 深青色
• &4 深红色，&5 深紫色，&6 金色，&7 灰色
• &8 深灰色，&9 蓝色，&a 绿色，&b 青色
• &c 红色，&d 浅紫色，&e 黄色，&f 白色

格式样式

• &l 加粗
• &o 斜体
• &n 下划线
• &m 删除线
• &k 随机字符

十六进制颜色

使用现代 RGB 十六进制代码获得精确颜色。

• 格式：&#RRGGBB
• 示例：&#FF5555This is a custom red!

许可证

MIT 许可证