逐字逐句

逐字逐句

一个跨平台的服务器端聊天频道系统,具有可配置的频道、直接消息、基于距离的本地聊天以及 Discord 集成功能。

实用

Verbatim

加入我们的Discord!

Verbatim 是一款服务端聊天插件,提供可配置的聊天频道、私信、Discord集成等功能。它专为社区和角色扮演向服务器设计。

功能特性

  • 可自定义的聊天频道:
    • 多个聊天频道,可设置独特名称、显示前缀(例如 &a[G])和快捷指令(例如 g)。
    • 权限管理:通过权限节点保护频道(若安装 LuckPerms 则自动集成,否则使用原生权限系统)。
    • 聊天范围:按频道设置聊天范围(例如本地频道)或全局范围。
    • 颜色自定义:可配置频道名称、玩家名称、分隔符和消息的颜色。
    • 常驻频道:玩家始终在且无法退出的频道。
    • 成人内容警告:玩家加入标记为"成人"的频道时显示可选警告。
    • 特殊频道类型:
      • local:基于距离的消息渐隐/模糊行为,支持后缀模式。(灵感来自 MassiveChat!)
  • 私信(DM):
    • 向其他在线玩家发送私密消息。
    • 快速回复上一条收到的私信。
  • 聊天前缀与快捷指令:
    • 使用前缀快速切换焦点或发送消息(例如 g: 大家好!)。
    • 使用 d: 前缀聚焦/回复最后一条私信。
  • Discord集成:
    • 在游戏全局聊天与 Discord 频道之间双向桥接。
    • 可自定义 Discord 消息在游戏中显示的前缀。
  • 持久化玩家设置:
    • 跨会话保存已加入的频道和聚焦频道。
  • 昵称:
    • 设置自定义昵称,支持可选颜色代码(需权限)。

命令

频道命令

  • /channels/channel list — 列出所有可用聊天频道及您的加入状态。
  • /channel focus <channelName> — 设置当前输入频道(如需则自动加入)。
  • /channel join <channelName> — 加入一个频道以接收其消息。
  • /channel leave [channelName] — 退出频道。不指定名称则退出当前聚焦频道。
  • /channel help — 显示可用命令和前缀的帮助信息。

私信命令

  • /msg <player> [message]/tell <player> [message] — 发送私信或与某位玩家聚焦私信。
  • /r [message] — 回复或聚焦上一位向您发送私信的玩家。

其他命令

  • /list — 列出在线玩家。
  • /vlist — 以 Verbatim 格式列出在线玩家。
  • /nick [nickname] — 设置昵称。不加参数运行则清除。

管理员命令

  • /chlist <player|channel> — 列出某玩家的频道,或某频道的玩家。
  • /chkick <player> <channel> — 将玩家踢出频道。

聊天前缀

  • g: 你的消息在这里 — 发送到快捷指令为"g"的频道并聚焦它。
  • d: 你的回复在这里 — 发送并聚焦最后一位向您发送私信的玩家的私信。
  • d:(无消息)— 聚焦最后一位向您发送私信的玩家的私信。

本地频道后缀

使用 local 类型频道时,消息后缀会改变范围和样式:

后缀 动作 范围 示例
(无) 50 你好
! 大喊 75 小心!
!! 高喊 100 在这里!!
? 提问 50 有人吗?
* 低语 10 秘密消息*
$ 嘀咕 3 咕噜咕噜$
+ 角色扮演动作 50 挥手打招呼+
)) OOC(设定外) 50 离开5分钟))

消息会随着听众离发言者越远而渐隐为模糊圆点,最终在超出衰减范围后无法听见。

配置

Minecraft(NeoForge)

配置文件位于服务器 config 目录下的 verbatim-server.toml

Hytale

配置文件位于插件数据目录下的 verbatim-config.json

关键设置

  • defaultChannelName — 玩家加入时默认的频道。
  • channels — 频道定义列表(名称、前缀、快捷指令、权限、范围、颜色等)。
  • Discord 设置:机器人令牌、频道 ID、消息前缀、启用/禁用。

权限

Verbatim 优先使用 LuckPerms,否则回退到原生权限系统。

  • 频道访问:通过每个频道的 permission 字段设置(例如 verbatim.channel.staff)。
  • 聊天颜色: verbatim.chat.color — 允许在聊天中使用 & 颜色代码。
  • 聊天格式: verbatim.chat.format — 允许在聊天中使用 &l(粗体)、&o(斜体)。
  • 昵称: verbatim.nick — 允许使用 /nick
  • 管理员: verbatim.admin — 管理员命令(/chlist/chkick)。

LuckPerms 前缀与提示设置

  • 设置前缀: /lp user <username> meta setprefix <priority> "<prefix>"
    • 示例:/lp user Steve meta setprefix 100 "&c[Admin] "
  • 设置前缀提示: /lp user <username> meta set prefix_tooltip.0 "<text>"
    • 示例:/lp group admin meta set prefix_tooltip.0 "服务器管理员"
    • 支持 prefix_tooltip.0prefix_tooltip.9,用于多条提示。