聊天交互插件

聊天互动插件

Hytale 聊天插件，包含全局/本地聊天、私信、管理员工具、可配置的本地聊天半径、可选的聊天锁定模式（白名单）以及可配置的周期性聊天模式提醒。

---

运行要求（依赖）

• ChatInteractions 运行无需任何必要依赖。
• TinyMessage / TinyMsg（可选）：如果安装，可在聊天中启用更好的颜色和格式。只需将 tinymessage-*.jar 放入 mods/ 文件夹即可。

---

功能

• 全局和本地聊天频道

• 本地聊天按距离半径过滤（同一世界）

• 使用 /msg 发送私信（消息完全粉色显示）。可通过 /chatdisable msg 禁用私信。

• 管理员命令清空聊天（全局 + 本地）

• 管理员命令检查/调试聊天变量（模式、锁定、管理员/OP、提醒、Ping）

• 管理员专用的本地半径设置（重启后保持）

• 按频道禁用聊天：/chatdisable global|local|msg（别名：/cdb）

• 聊天管理员白名单：聊天禁用时仅聊天管理员可以发言；他们还可以使用 /chatdisable 和 /chatwarning（即使没有管理员/OP 权限）

• 周期性聊天模式提醒（按玩家）：

  • 发送私密提醒，告知玩家当前处于本地或全局模式
  • 安装了 TinyMessage/TinyMsg 时全彩显示
  • 未安装 TinyMessage 时使用干净的纯文本回退
  • 可通过 /chatwarning / /cw 配置间隔时间（或禁用）

• 可选的 TinyMessage/TinyMsg 支持，用于更好的颜色/格式

---

安装

1. 构建插件，获取生成的 .jar 文件。

2. 将插件 .jar 文件移动到：

   • mods/

3. （可选，推荐）安装 TinyMessage/TinyMsg：

   • 将 tinymessage-*.jar 移动到 mods/

4. 重启服务器。

安装了 TinyMessage/TinyMsg 后，聊天的颜色和格式会更好看。

---

工作原理

• 玩家加入时，默认聊天频道为本地。

• 本地聊天仅发送给：
  • 处于同一世界的玩家
  • 在配置的半径（方块数）范围内

• 通过 /chatdisable global|local|msg（别名：/cdb）禁用聊天时，仅聊天管理员可以发送该频道的消息（全局/本地/私信）。

• /chatdisable msg 仅阻止私信（/msg）。

• 重要安全说明： /chatdisable（/cdb）需要管理员/OP 权限（控制台允许）。聊天管理员即使没有管理员/OP 权限也可执行。

• 周期性聊天提醒（可选）：：

  • 每位玩家可每隔 X 分钟收到私密提醒消息。
  • 聊天管理员可以使用 /cw <分钟> 更改间隔时间或禁用提醒，即使没有管理员/OP 权限。管理员/OP 也可以执行。

"迷你"教程

---

命令

所有人（无需权限）

• /g

  • 切换到全局聊天频道。

• /l

  • 切换到本地聊天频道（基于距离）。

• /msg <玩家> <消息...>

  • 向其他玩家发送私密消息（完全粉色）。
  • 示例：/msg player2 hi how are you?

---

工作人员命令（管理员/OP；控制台允许）

除非另有说明，以下所有命令均需管理员/OP 权限。聊天管理员即使没有管理员/OP 权限也可以使用 /chatdisable 和 /chatwarning。

• /localradius <数字>

  • 仅限管理员/OP。
  • 设置本地聊天半径（方块数）。
  • 默认值为 50。
  • 该值在重启后保存/持久化。
  • 示例：/localradius 80

• /clearchat

  • 仅限管理员/OP。
  • 清空所有在线玩家的游戏聊天（全局 + 本地）。
  • 别名：/cc

• /chatdebug

  • 显示与服务器聊天相关的调试信息/变量（可用于验证当前设置/状态）。
  • 别名：/cdg

• /chatdisable global|local|msg

  • 按频道切换聊天锁定（全局、本地或私信）。
  • 管理员/OP 或聊天管理员可使用。
  • 别名：/cdb
  • 示例：/chatdisable global、/chatdisable local、/chatdisable msg

• /chatadmin

  • 仅限管理员/OP（控制台允许）。
  • 管理聊天管理员白名单（聊天禁用时仍可发言的玩家）。
  • 变体：
  • /chatadmin add (<玩家> 或 <UUID>)
    • 为选定玩家添加聊天管理员权限（允许在聊天禁用时发言）。
    • 示例：/chatadmin add PlayerName
    • 示例：/chatadmin add 123e4567-e89b-12d3-a456-426614174000
  • /chatadmin remove (<玩家> 或 <UUID>)
    • 移除选定玩家的聊天管理员权限。
  • /chatadmin list
    • 列出当前拥有聊天管理员权限的所有玩家（及其 UUID）。

• /chatwarning <分钟>

  • 管理员/OP 和聊天管理员可执行（聊天管理员无需管理员/OP 权限）。
  • 配置周期性聊天模式提醒（私密提醒）。
  • <分钟> 是间隔时间（分钟）。
  • 使用 0 可禁用提醒。
  • 别名：/cw
  • 示例：
    • /cw 5（每 5 分钟发送一次）
    • /cw 0（禁用）

---

权限/访问

本插件使用以下访问级别：

• 所有人（零权限）：

  • /g、/l、/msg

• 管理员/OP（以及控制台）：

  • 所有其他命令需要此权限

• 聊天管理员（白名单）：

  • 即使没有管理员/OP 权限，也可使用 /chatdisable（/cdb）和 /chatwarning（/cw）
  • 聊天禁用时，仅聊天管理员可以发言

此外：

• **聊天管理员（白名单）**通过 /chatadmin add/remove/list 进行管理。

---

持久化（本地半径 / 聊天管理员 / 提醒间隔）

设置会保存到配置文件中，并在重启后保持。

默认回退路径：./plugins/com.example_ChatInteractions/localglobalchat.properties

存储键示例：

• localRadius=50
• chatAdmins=<uuid1>,<uuid2>,...
• chatWarningMinutes=5

---

备注

• 本地聊天过滤：

  • 同一世界
  • 距离 ≤ 配置的半径

• 如果安装了 TinyMsg，插件会自动使用（否则使用干净的纯文本）。