Chat Mod

模组

· 作者 official.andy

游戏内 MOTD,完全自定义的信息命令设置,定时广播,结合世界时钟的事件广播与倒计时 :)

0 本站下载 0 关注 更新于 4 天前

需要前置:Fabric API

最新 2.1.7 · 26.3 · Fabric

一键开服(送7天)
ChatMod Logo

ChatMod — 高级服务器消息与聊天

Chat Mod Sprites Texture Pack

ChatMod 是一款服务端 Fabric 模组,赋予管理员对服务器与玩家通信方式的完全控制权。自定义信息命令、自动广播、丰富的 MOTD、带有悬停和点击事件的交互式聊天、内联 Atlas 精灵图标、带声音的玩家标记、持久化聊天颜色、预定义物品、定时广播——所有功能均可通过 YAML 文件配置,无需重启服务器。

? 联系与支持

? 主要支持(推荐)

所有一般性问题、功能请求和非紧急错误报告,请发布在我们的 Discord 服务器 的相应频道中。 我们会积极监控并尽快回复,以便整个社区都能受益。

? 紧急私聊政策

您仅可在特定紧急情况下直接私聊我:

  • 允许原因: 您的服务器因本模组而崩溃或出现严重的、破坏游戏的关键错误。
  • 要求: 您必须是服务器所有者。
  • 时区: (CET/CEST) —— 布鲁塞尔时间
  • 私聊时间: 仅限 布鲁塞尔时间上午 10:00 – 晚上 10:00

无法保证即时回复。私聊是一种职业礼仪,而非理所当然的权利。感谢您的理解!


⚠️ 版本说明 — Atlas 精灵图标

Atlas 精灵图标功能([#SpriteName]、[#item]、[##item]、自定义占位符图标、玩家头像精灵)需要 Minecraft 1.21.9 或更高版本。 针对 1.21.5 至 1.21.8 的版本不包含这些功能。 所有其他功能在所有受支持的版本中均可用。


格式设置 — 全局通用

ChatMod 中的每条消息——包括广播、MOTD、信息文件和聊天——都支持相同的丰富格式语法。

语法 效果
&a, &b, &c … Minecraft 颜色代码
&#RRGGBB 十六进制颜色代码
&l &o &n &m &k &r 加粗、斜体、下划线、删除线、随机字符、重置
Text{悬停文本} 带有工具提示的可悬停文本
Text{悬停}<action:run_command,/cmd> 悬停 + 点击以运行命令
Text{悬停}<action:suggest_command,/cmd> 悬停 + 点击以建议命令
Text{悬停}<action:open_url,https://…> 悬停 + 点击以打开 URL
Text{悬停}<action:copy_to_clipboard,value> 悬停 + 点击以复制文本
行首的 &+ 在聊天中居中该行
字符串内的 &= 插入换行符
%player% %online_players% %time% %date% … 内置占位符
PlaceholderAPI 占位符 安装 PlaceholderAPI 后支持

? 广播

在 chatmod.yml 中设置自动循环的消息。每个广播条目支持四种显示类型。

类型 显示位置
CHAT 服务器聊天,所有玩家可见
ACTION_BAR 快捷栏上方
TITLE 屏幕中央,大字体
BOSSBAR 屏幕顶部 Boss 条

动作栏 (Action Bar)

  • 单行将在 duration_seconds 秒内保持可见(会自动重新发送,原版会在约 3 秒后清除它)。
  • 添加第二行以在标题区域显示副标题文本,同时显示在动作栏旁。
  • 添加更多行可按顺序循环显示它们,每行持续 duration_seconds。

标题 (Title) 每组最多支持 4 行:

  1. 主标题
  2. 副标题
  3. 动作栏文本 (可选)
  4. 在第 3 行激活期间替换副标题 (可选)

添加 lines1:、lines2: … 可在一个广播条目内循环多个标题画面,每个画面显示 duration_seconds。

Boss 条 (Boss Bar) 多行将作为单独的 Boss 条依次显示,每条持续 duration_seconds。

广播控制

broadcast_enabled: true
broadcast_interval_seconds: 300
randomize_broadcast: false   # true = 随机顺序而非顺序播放

基于玩家数量的间隔 — 根据在线玩家数自动调整广播间隔:

players_5_interval_seconds: 240
players_10_interval_seconds: 180
players_25_interval_seconds: 120

? MOTD

当玩家加入时,用个性化的消息欢迎他们。支持所有格式设置、占位符、悬停和点击事件以及 Atlas 精灵令牌。

motd_enabled: true
motd_messages:
  - lines:
      - "&+&b欢迎, %player%!"
      - "&7游戏时长: &e%playtime%  &7上次上线: &e%last_play_time%"

使用 /cm testmotd 预览而无需重新加入。


? 自定义信息命令

从 YAML 文件创建无限数量的自定义文本命令——/rules、/help、/discord、/info 或您选择的任何名称。ChatMod 将它们注册为真实的服务器命令,并支持每个文件的多个页面和命名部分。

创建一个新的:

/cm create rules

这将生成 config/chatmod_info/rules.yml,您可自由编辑,然后执行 /cm reload。

管理您的信息命令:

命令 作用
/rules 显示第 1 页(或名为 page1 的章节)
/rules 2 按编号显示第 2 页
/rules section_name 直接显示指定名称的章节
/rules work 开启或关闭该命令的功能
/rules permission 开启或关闭权限要求
/rules permission set chatmod.rules 设置所需的权限节点
/rules alias add r 添加 /r 作为别名
/rules alias remove r 移除该别名
/cm list 列出所有已注册的 info 命令

页面之间可以通过点击动作相互链接,从而轻松构建完整的多章节帮助菜单。


? 预定义与定时广播

在 predefined_broadcasts.yml 中定义可复用的命名广播,并通过命令发送或安排它们。

/cm bc event_soon             — 立即向所有玩家发送
/cm bcshow event_soon         — 先预览一下
/cm bclist                    — 查看所有可用的广播
/cm time 20m often 5 bc event_soon   — 在 20 分钟内分 5 次发送
/cm time 30m bcnow CHAT Hello everyone!  — 30 分钟后发送一次性文本

每个预定义的广播都支持四种显示类型(CHAT、ACTION_BAR、TITLE、BOSSBAR)、权限门控以及完整的格式化功能。

对于没有预定义条目的临时一次性消息:

/cm bcnow CHAT &aServer event starting now!
/cm bcnow TITLE &6Event! | &eGet to spawn!
/cm bcnow <player> CHAT &eYou have been selected!

? Atlas Sprite 图标 (仅限 1.21.9+)

在任何消息(聊天、MOTD、广播、info 文件)中内联渲染任何 Minecraft 纹理图集精灵。

语法 结果
[#diamond] 钻石物品精灵
[#grass_block] 草方块精灵
[#playerhead:Name] 指定玩家头像精灵
[#item] 你手中所持物品的精灵
[##item] 仅显示精灵,无物品名称
[#item:3] 预定义物品槽位 3 的精灵

Sprite 别名和原版纹理覆盖在 sprites.yml 中配置。你可以将任何令牌映射到自定义的图集路径——例如,使 [#chest] 显示圣诞箱子纹理。

Sprites 在所有上下文中均有效:聊天消息、MOTD、广播、info 文件、悬停提示以及作为持久化聊天的颜色前缀。


? 玩家身份令牌

在 ChatMod 格式支持的任何地方,将任何在线玩家引用为交互式内联元素。

语法 显示内容
[@Name] 格式化后的玩家名称,带有悬停个人资料和点击动作
[#@Name] 玩家头像精灵 + 格式化后的名称
[##@Name] 仅玩家头像精灵
[@%player%] 动态解析 —— 解析为查看该消息的玩家

悬停个人资料在 placeholders.yml 中定义,允许你根据不同的权限组定义不同的工具提示。管理员可以看到 UUID、延迟、世界和余额;普通玩家看到排名和余额。个人资料基于被命名玩家的权限进行选择,并支持包括 sprite 在内的完整 ChatMod 格式化。


?️ 玩家标记与提及

在聊天中输入 @PlayerName 或 PlayerName@ 来标记某人。他们会听到独特的提示音,并看到他们的名字被高亮显示。使用 @everyone 或 everyone@ 通知整个服务器(不同的声音,单独的权限)。

标签格式在 placeholders.yml 下的 player_tag_format 和 everyone_tag_format 中配置。


? 聊天功能

颜色与格式控制 — 两个独立的权限:

  • chatmod.chat.color — 允许在聊天中使用 &0–&f 和 &#RRGGBB 十六进制颜色
  • chatmod.chat.format — 允许在聊天中使用 &l、&o、&n、&m、&k、&r 格式代码

可以独立授予两者之一、全部或都不授予。

持久化聊天颜色 — 玩家为其所有聊天消息设置永久颜色:

/cm chatcolor aqua
/cm chatcolor #FF5500
/cm chatcolor b           ← 遗留代码简写

拥有 chatmod.chatcolor.others 权限的管理员也可以为其他玩家设置颜色。

Sprite 前缀 — 将图集 sprite 设置为你的聊天颜色前缀 (1.21.9+):

/cm chatcolor [#dirt]
/cm chatcolor [#diamond]
/cm chatcolor player      ← 使用你自己的玩家头像

内联物品显示 — 玩家可以使用 [item]、[#item](带图标)或 [##item](仅图标)在聊天中显示他们手持的物品。每种方式都有各自的权限节点。

内联 sprite 图标 — 在聊天中的任何位置输入 [#SpriteName] 以嵌入 sprite 图标。受 chatmod.chaticon 权限控制。

自定义占位符 — 在聊天中键入的快捷方式,扩展为带有悬停和点击事件的格式化交互文本。在 placeholders.yml 中定义。


? 预定义物品与 GUI

每页存储最多 54 个物品(无限页数)作为共享引用,通过 [item:N]、[#item:N] 或 [##item:N] 在聊天中显示。

通过可视化箱子 GUI 管理物品:

/cm items       ← 打开第 1 页
/cm items 2     ← 打开第 2 页

物品以完整的 NBT 数据形式存储,因此自定义名称、描述、附魔和其他所有属性都会原样保留。


? 自定义占位符

在 placeholders.yml 中定义你自己的键入快捷方式,玩家在聊天中输入后,ChatMod 会将其扩展为格式化的交互输出。

custom_placeholders:
  spawn:
    typed: '[spawn]'
    chatmod: '&bSpawn&r'
    hover: '&bClick to teleport to spawn.'
    icon: grass_block
    runcommand: /spawn

每个占位符都支持显示文本、悬停提示、点击动作(运行命令 / 建议命令 / 打开 URL),以及可选的 sprite 图标。可以使用权限节点来限制其使用。


⚙️ 配置

所有配置都在 config/chatmod/ 下的 YAML 文件中。无需重启游戏 — 编辑后使用 /cm reload 即可生效。

文件 包含内容
chatmod.yml MOTD、循环广播、间隔、随机化
predefined_broadcasts.yml 命名且可复用的广播条目
placeholders.yml 物品格式、标签格式、悬停配置、自定义占位符
messages.yml 所有面向玩家的系统消息
sprites.yml 精灵别名与原版纹理覆盖
config/chatmod_info/*.yml 每个自定义信息命令对应一个文件

当安装了 PlaceholderAPI 时,PlaceholderAPI 占位符(例如 %luckperms:prefix%)将在所有上下文中被解析。如果消息中不包含任何占位符,ChatMod 会跳过 API 调用,因此普通消息不会产生性能开销。


命令

命令 描述 权限
/cm reload 无需重启即可重载所有配置文件 chatmod.reload
/cm create <name> 创建新的信息命令 chatmod.create
/cm list 列出所有信息命令 chatmod.list
/cm testmotd 预览 MOTD chatmod.testmotd
/cm testbroadcast 触发下一次循环广播 chatmod.testbroadcast
/cm bc <name> 发送预定义的广播 chatmod.bc.sendnamed
/cm bcnow <type> <text> 发送临时广播 chatmod.bc.now
/cm bcnow <player> <type> <text> 向单个玩家发送广播 chatmod.bc.now
/cm bclist 列出预定义的广播 chatmod.bc.list
/cm bcshow <name> 预览预定义的广播 chatmod.bc.show
/cm time <duration> [often <n>] bc <name> 调度预定义的广播 chatmod.bc.sendnamed
/cm time <duration> [often <n>] bcnow <text> 调度临时广播 chatmod.bc.now
/cm chatcolor <value> 设置你自己的持久聊天颜色 chatmod.chatcolor.self
/cm chatcolor <value> <player> 设置其他玩家的聊天颜色 chatmod.chatcolor.others
/cm items [page] 打开预定义物品 GUI chatmod.items
/tag <player> [message] 标记玩家并附带可选消息 chatmod.tag.command

权限

点击展开所有权限节点

聊天

节点 授予
chatmod.chat.color 聊天中的颜色代码(&0–&f,十六进制)
chatmod.chat.format 聊天中的格式化代码(&l, &o, &n, &m, &k, &r)
chatmod.chatitem 聊天中手持物品的名称 [item]
chatmod.chatitem.number 预定义物品名称 [item:N]
chatmod.chatitem.icon 精灵 + 名称 [#item]
chatmod.chatitem.icon_only 仅精灵 [##item]
chatmod.chaticon 聊天中的精灵图标 [#SpriteName]
chatmod.player.tag 使用 @Name 标记玩家
chatmod.player.tag.everyone 标记 @everyone

聊天颜色

节点 授予
chatmod.chatcolor.self 设置自己的聊天颜色
chatmod.chatcolor.others 设置其他玩家的聊天颜色
chatmod.chatcolors 所有命名颜色和十六进制颜色(通配符)
chatmod.chatcolor.<name> 特定颜色(例如 chatmod.chatcolor.aqua)
chatmod.chatcolor.RRGGBB 特定十六进制颜色(例如 chatmod.chatcolor.ff5500)
chatmod.chatcolor.sprites 任何精灵作为聊天颜色前缀
chatmod.chatcolor.sprite.<name> 特定精灵前缀(例如 chatmod.chatcolor.sprite.dirt)
chatmod.chatcolor.sprite.player 自身玩家头颅作为聊天颜色前缀

广播

节点 授予
chatmod.bc.now 发送和调度临时广播
chatmod.bc.sendnamed 发送和调度预定义的广播
chatmod.bc.list 列出预定义的广播
chatmod.bc.show 预览预定义的广播
chatmod.broadcast.<name> 使用受权限限制的特定广播

管理员

节点 授予
chatmod.reload 重载所有配置文件
chatmod.testmotd 测试 MOTD
chatmod.testbroadcast 触发循环广播
chatmod.create 创建信息文件
chatmod.list 列出信息命令
chatmod.items 打开预定义物品 GUI(只读)
chatmod.items.edit 通过 GUI 编辑预定义物品
chatmod.items.format 编辑聊天名称前缀/后缀格式
chatmod.name.modify 管理信息文件设置(工作区、别名、权限)
chatmod.tag.command 使用 /tag 命令
chatmod.modinfo 访问 /cm 帮助页面

信息命令

节点 授予
chatmod.info.<name> 访问受权限限制的特定信息命令

内部(请勿手动授予)

节点 授予
chatmod.internal.page 导航 /cm 帮助页面
chatmod.internal.display 通过点击操作显示信息文件内容

整合包政策

  • ✅ 你可以将 ChatMod 包含在任何整合包中。
  • ❌ 该整合包不得出售。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源