动能聊天

KineticChat

概述

KineticChat 是面向 Minecraft Forge 的多人游戏聊天系统重构模组。

它专为大型整合包、长期运行的服务器以及经常处理大量聊天或命令文本的玩家而设计。KineticChat 并非仅仅添加一些装饰性的聊天选项，而是扩展了 Minecraft 聊天系统的限制，并增加了持久化历史记录、导航、时间戳、消息合并、玩家头像以及专用的历史复制界面。

KineticChat 改变了什么

• 将聊天消息和命令的最大长度扩展到远超原版限制。
• 支持大量客户端聊天历史记录。
• 为单个玩家提供有上限的服务器端历史持久化。
• 添加可拖动的滚动条，快速浏览较长的聊天历史。
• 添加可选的毫秒级精度时间戳。
• 将连续重复的消息合并为单条记录，并显示重复计数器。
• 在聊天消息旁显示玩家皮肤头像。
• 提供专用的虚拟画布，用于浏览和复制聊天历史。
• 支持可选的服务器端聊天签名剥离。
• 将服务器游戏规则与仅客户端显示偏好分离。

为什么 KineticChat 是一个独立的模组

KineticChat 是一个可独立安装的功能模组，拥有自己的 Mod ID、代码库、配置、网络行为、客户端渲染改动和发布周期。

KineticCore 仅是一个必需的共享基础设施依赖项。 它提供配置注册、网络工具、GUI 基础设施以及统一的 Kinetic 配置入口等通用系统。

本页面描述的实际聊天功能由 KineticChat 自身实现，不包含在 KineticCore 中。

如果移除 KineticChat，其扩展的聊天限制、持久化历史、时间戳、消息堆叠、玩家头像、滚动条、复制画布以及其他聊天功能也将一并移除。

将 KineticChat 独立出来也让玩家和服主能够使用 Kinetic 聊天系统，而无需被迫安装不相关的 Kinetic 游戏模块，例如盔甲系统、信标机制、战斗测试、附魔、世界生成工具或实体清理系统。

主要功能

扩展的聊天和命令限制

原版 Minecraft 通常将聊天输入限制在相对较短的消息内。

KineticChat 允许服务器为聊天消息和命令配置大得多的最大长度。

KineticChat 的默认限制为：

16384 characters

在多人游戏中使用时，客户端和服务器应使用匹配的限制。

持久化聊天历史

KineticChat 可以跨会话保留玩家的聊天和输入历史。

服务器为每位玩家保留有上限的历史记录，而不是存储无限量的数据。

默认历史限制为：

10000 lines

可配置范围为：

100 - 100000 lines

还会应用单独的每位玩家存储预算，以防止历史记录无节制增长。

可拖动聊天滚动条

聊天界面右侧添加了一个滚动条。

玩家不再仅依赖鼠标滚轮，可以直接拖动滚动条来浏览极长的聊天历史。

这在一次会话中可能积累数百或数千条消息的服务器上尤其有用。

重复消息合并

连续相同的消息可以自动合并。

不再显示：

Server message
Server message
Server message
Server message

KineticChat 可以只显示一次消息，并附带重复计数。

这减少了以下内容造成的杂乱：

• 重复的系统消息
• 服务器通知
• 模组输出
• 重复的玩家消息
• 反复出现的警告

高精度时间戳

消息可以使用毫秒级精度显示本地时间戳：

[HH:mm:ss.SSS]

时间戳渲染是客户端偏好设置，不会修改原始服务器消息。

玩家头像

玩家消息可以直接在聊天历史中显示其皮肤头像。

KineticChat 使用玩家 UUID 信息进行皮肤查找，并在无法解析普通皮肤时包含回退行为。

聊天历史复制画布

KineticChat 包含一个用于复制聊天文本的专用历史查看器。

虚拟画布可以从聊天界面打开，允许玩家浏览更大的历史区域，而不受 Minecraft 常规聊天展示的限制。

它用于复制：

• 命令
• 服务器输出
• 坐标
• 调试信息
• 玩家消息
• 较长的配置或脚本文本

可选的聊天签名剥离

服务器可以选择在广播消息之前剥离聊天签名。

相应状态会被同步，使客户端能够按照当前服务器配置一致地处理相关的不安全聊天和举报 UI 行为。

此功能是可选的，可以独立禁用。

服务器和客户端配置

KineticChat 有意将权威服务器设置与本地显示偏好分离。

服务器控制的设置

服务器控制影响游戏玩法或网络行为的设置，包括：

• 最大聊天和命令长度
• 持久化历史存储
• 历史限制
• 聊天签名行为

编辑服务器权威设置需要权限等级 2。

仅客户端偏好

以下设置仅影响本地玩家的界面：

• 时间戳
• 可拖动滚动条
• 重复消息合并
• 玩家头像
• 本地聊天展示

更改这些选项不会修改所连接服务器的配置。

配置

主配置文件：

config/kineticcore/chat.toml

使用共享的 config/kineticcore/ 目录是因为 KineticCore 提供了通用配置框架。

这并不意味着 KineticChat 是 KineticCore 的一部分。实际的聊天实现包含在 KineticChat 模组中，仅在安装了 KineticChat 时才存在。

配置选项

设置	描述
Chat Enhancements	服务器权威的聊天长度、历史存储和签名设置。编辑需要权限等级 2。
Compact Chat (Stacking)	合并连续相同的消息并显示重复计数器。
Draggable Scrollbar	添加可拖动滚动条，用于浏览较长的聊天历史。
Show Player Avatars	在聊天消息旁显示玩家皮肤头像。
Max History Lines	每位玩家保留的最大历史行数。有效范围：100–100000。
Save Chat History	控制是否跨会话持久化新的聊天和输入历史。
Max Chat Length	聊天输入、数据包和命令接受的最大字符数。
Strip Chat Signatures	控制可选的服务器端聊天签名剥离。
Enable Timestamps	为显示的消息添加本地 [HH:mm:ss.SSS] 时间戳。
Chat Client Preferences	本地显示和交互设置，绝不会修改服务器规则。

聊天历史界面

控件	功能
Capture	打开虚拟聊天历史画布，用于滚动、选择和复制文本。
Back	离开历史画布，返回普通聊天界面。

默认配置

键	默认值
enable_chat_heads	true
enable_chat_history_saving	true
enable_compact_chat	true
enable_draggable_scrollbar	true
enable_timestamp	true
max_chat_history_lines	10000
max_chat_length	16384
strip_chat_signatures	true

数据路径

config/kineticcore/chat.toml

需求

• Minecraft Forge
• Java 17
• KineticCore：必需

依赖项

Mod ID	关系
kineticcore	必需