逐字

逐字

功能齐全的开源聊天频道模组,带有 Discord Minecraft 的桥接功能!

游戏机制

Verbatim - Minecraft 高级聊天模组

Verbatim 是一个 Minecraft 服务端模组,旨在通过提供可配置的聊天频道、私聊、Discord 集成等功能来增强游戏内交流。它旨在提供一个灵活且强大的聊天系统,适用于各种服务器类型,尤其是以角色扮演或社区为核心的服务器。

功能特性

  • 可自定义的聊天频道:
    • 定义多个聊天频道,每个频道拥有唯一名称、显示前缀(例如 &a[G])和快捷方式(例如 g)。
    • 权限: 通过权限节点保护频道(如果可用则与 LuckPerms 集成,否则使用原版 OP 等级)。
    • 聊天范围: 设置每个频道的聊天范围(例如用于本地频道),或将其设为全局。
    • 颜色自定义: 配置频道名称、玩家名称、分隔符和消息的颜色。
    • 常驻频道: 指定玩家始终处于且无法离开的频道。
    • 成人内容警告: 可选择在玩家加入标记为“成人”的频道时显示警告。
    • 特殊的预制频道类型:
      • local:实现基于距离的消息淡化/模糊效果,并支持不同的后缀(例如 !! 表示喊叫,* 表示低语),这些后缀会影响消息的范围和样式。(特别感谢 MassiveChat 提供此创意!)
  • 私聊(DM)/ 私信(PM):
    • 向其他在线玩家发送私信。
    • 对最近收到的私聊进行快速回复。
  • 聊天前缀与快捷方式:
    • 使用前缀快速切换焦点或无需命令即可向特定频道/私聊发送消息(例如 g: 大家好! 发送至“global”频道并将其设为焦点)。
    • d: 前缀用于聚焦/回复最近的私聊。
  • Discord 集成:
    • 将游戏内聊天(特指指定的“global”频道)桥接到 Discord 频道。
    • 将 Discord 中的消息转发回游戏。
    • 可自定义游戏内显示的 Discord 消息前缀。
  • 持久化玩家设置:
    • 跨会话记住玩家已加入的频道及其聚焦的频道。
  • 配置:
    • 通过 TOML 文件(位于服务器 config 文件夹中的 verbatim-server.toml)进行大量配置。
    • 定义所有频道、默认频道、Discord 机器人令牌、频道 ID 及其他设置。
  • 管理员命令与实用工具:
    • 动态重载配置(通常需要 OP/权限)。

命令

大多数命令可通过 /channel 或 /verbatim:channel 访问。

  • /channels 或 /channel list
    • 列出所有可用的聊天频道以及你在其中的当前状态。
  • /channel focus <channelName>
    • 设置你当前活跃的输入频道。如果你尚未加入该频道(且拥有权限),此操作也会自动加入。
  • /channel join <channelName>
    • 加入特定频道以接收其消息。
  • /channel leave <channelName>
    • 离开已加入的特定频道。
  • /channel leave
    • 离开当前聚焦的频道(如果它不是“常驻”频道)。
  • /channel help
    • 显示包含可用 Verbatim 命令和聊天前缀的帮助信息。

私聊命令:

  • /msg <player> [message] 或 /tell <player> [message]
    • 向指定玩家发送私信。如果未提供消息,则将你的聊天聚焦于该玩家,以便后续发送消息。
  • /r [message]
    • 回复最近向你发送私信的玩家。如果未提供消息,则将你的聊天聚焦于该玩家。
  • /w <player> [message]
    • /msg 的别名。

聊天前缀(示例):

  • g: 你的消息 - 将“你的消息”发送至快捷方式为“g”的频道,并将其设为焦点。
  • d: 你的回复 - 将“你的回复”发送给最近私聊你的玩家,并将私聊焦点设为该玩家。
  • d:(不带消息)- 将私聊焦点设为最近私聊你的玩家(等同于不带消息的 /r)。

配置

Verbatim 通过 verbatim-server.toml 文件进行配置,该文件通常在模组首次运行后位于 Minecraft 服务器的 config 目录中。

需要配置的关键区域:

  • defaultChannelName:玩家默认进入的频道。
  • channels:一个列表,其中每个条目定义聊天频道的属性(名称、前缀、快捷方式、权限、范围、颜色等)。
  • Discord Integration:Discord 机器人的设置,包括机器人令牌、频道 ID、消息前缀以及启用/禁用该功能。

权限

如果服务器上安装了 LuckPerms,Verbatim 会尝试使用它进行权限检查。如果未找到 LuckPerms,则回退到原版 Minecraft 的操作员(OP)等级。

  • 频道访问: 频道权限在配置文件中每个频道的 permission 字段中定义(例如 verbatim.channel.staff)。如果设置了权限,玩家需要拥有该节点才能加入/在该频道中发言(除非该频道为 alwaysOn)。