角色扮演对话

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

🎭 角色扮演聊天界面 Forge 模组

适用于 Minecraft 的 FiveM 风格聊天频道与 HUD 覆盖层

这是一个服务端模组（需要配套的客户端组件），它将 Minecraft 默认的聊天界面替换为时尚的、受 GTA/FiveM 启发的 HUD。消息以带有样式和图标标记的框体形式显示，并带有滑入和淡出动画——非常适合角色扮演服务器使用。

✨ 功能特性

- 自定义聊天覆盖层 — 用带有样式的 HUD 覆盖层（彩色框体、图标、标签）替换原版聊天界面
- 超过 10 个聊天频道 — 每个频道都有自己独特的图标、颜色和标签
- 仅限工作人员使用的频道 — staff 和 system 频道仅限于管理员（权限等级 2）使用
- 流畅的动画效果 — 消息滑入并在可配置的持续时间后淡出
- 可滚动的聊天记录 — 打开聊天界面可滚动浏览最多 500 条历史消息
- 服务器可配置的 HUD — 服务器可以通过数据包将 HUD 布局设置直接推送到客户端
- 系统消息拦截 — 服务器系统消息会自动应用样式并通过 HUD 显示

💻 安装方法

1. 从发布页面下载 .jar 文件。
2. 将其放入 服务器 和 客户端 的 mods/ 文件夹中。
3. 启动服务器 —— 模组会自动注册其配置和网络频道。

📟 聊天频道

以下命令可用于通过 HUD 发送带有样式的消息。大多数命令对所有玩家开放；staff 和 system 频道需要 权限等级 2。

命令	标签	权限
`/staff`	STAFF	OP（等级 2）
`/system`	SYSTEM	OP（等级 2）
`/police`	POLICE	所有人
`/ems`	EMS	所有人
`/gov`	GOV	所有人
`/twt`	TWITTER	所有人
`/ad`	ADVERTISEMENT	所有人
`/announce`	ANNOUNCE	所有人
`/ooc`	OOC	所有人
`/robbery`	ROBBERY	所有人
`/anon`	ANONONYMOUS	所有人
`/event`	EVENT	所有人
`/me`	`[消息显示在头顶]`	所有人
/clear chats	用于删除消息	OP（等级 2）

> 注意： 对于 /twt 和 /ooc 频道，发送者的名字会自动添加在消息前面，显示格式为 频道 | 用户名 | 消息。

> 你可以使用 /cleat chats all/group/player 命令来更方便地管理你的聊天频道！

🔧 原始 HUD 命令

/hud

向所有玩家发送一个原始标记字符串。需要权限等级 0（任何玩家均可使用），但主要面向管理员或插件使用。请参阅下方的 [标记格式](#markup-format) 部分。

🔨 标记格式

HUD 使用一种基于标签的简单标记语言，从原始字符串中解析。标签位于消息开头，并使用方括号括起来。

[emoji=][label=][box][color=#RRGGBB] 你的消息内容

标签	描述
`[emoji=]`	要显示的图标。可用键值：`staff`、`police`、`gov`、`twitter`、`system`、`announce`、`ooc`、`robbery`、`anon`
`[label=]`	在消息前显示的频道标签（例如 `POLICE`）
`[box]`	在消息后面绘制一个彩色背景框
`[color=#RRGGBB]`	背景框颜色。支持十六进制（`#2E6BFF`）或颜色名称
`[bg=#RRGGBB]`	`[color=…]` 的别名

颜色名称

blue、red、green、yellow、purple、gray、black、white、twitter

示例

[emoji=police][label=POLICE][box][color=#2E6BFF] 中央银行有警官倒下！

📚 HUD 布局与配置

服务器可以随时通过 HudConfigPacket 网络数据包将 HUD 显示设置推送给客户端。以下数值均可配置：

字段	默认值	描述
`offsetX`	`8`	距离锚点边缘的水平偏移量（像素）
`offsetY`	`8`	距离锚点边缘的垂直偏移量（像素）
`width`	`240`	HUD 面板的宽度（120–260 像素）
`lineHeight`	`18`	每行文本的高度（12–40 像素）
`gap`	`4`	消息之间的间距（0–30 像素）
`maxEntries`	`8`	同时可见的最大消息数（1–20）
`lifeMs`	`9000`	消息完全可见的持续时间（毫秒）
`fadeMs`	`1200`	`lifeMs` 到期后的淡出动画时长（毫秒）
`showIcon`	`true`	是否显示频道图标
`iconSize`	`14`	图标大小（像素）（8–32）

HUD 默认锚定在左上角。聊天界面关闭时，消息向下增长；聊天界面打开时，消息显示在聊天输入栏上方。每条新消息都会播放一个滑入动画。

📩 聊天记录

当聊天屏幕打开时，你可以滚动浏览最近 500 条消息：

按键	操作
鼠标滚轮	滚动 ±2 条
Page Up	向上滚动 10 条
Page Down	向下滚动 10 条
Home	跳至最早的消息
End	跳至最新的消息

🏆 作者

- m4r1os — 原始概念与开发
- MNV — 开发
- SaralisDev — 开发与设计