ChatFormatMod

模组

· 作者 official.andy

请专业地格式化你的聊天内容,并安装一个能完全支持 Chat Mod 的模组 :)

0 本站下载 0 关注 更新于 2 个月前

需要前置:Fabric API

最新 1.0.0 · 26.3 · Fabric

一键开服(送7天)
ChatFormatMod Logo

ChatFormatMod — 基于权限的聊天格式化、昵称、标签与玩家资料

作为 Chat Mod 的配套模组构建。 与之无缝协作 —— ChatMod 负责物品显示、精灵贴图、悬停事件、广播和 MOTD;ChatFormatMod 接管聊天行布局、昵称、装饰性标签、自定义等级以及玩家资料。所有 ChatMod 的格式化语法在每个格式字符串中均得到完全支持。


功能介绍

ChatFormatMod 赋予服务器管理员对每位玩家聊天消息外观的完全控制权,依据是玩家的权限。管理员拥有不同于 VIP 的聊天样式,而 VIP 又拥有不同于普通成员的样式 —— 所有这些均可通过简单的 YAML 文件定义,且无需重启服务器。

此外,玩家可以设置彩色的显示昵称、选择在其名字旁边显示的装饰性标签、填写个人资料,并拥有自定义的等级前缀和后缀 —— 这一切都绑定在基于权限的系统上,并开箱即用集成 LuckPerms。


特性

? 基于权限的聊天样式

在 formats.yml 中定义任意数量的聊天格式样式。系统会应用玩家拥有的第一个匹配权限节点的样式。空的权限节点将作为适用于所有人的默认回退样式。

styles:
  - id: admin
    permission: "chatmod.admin"
    format: "&c%custom_rank%&r &ö%displayname%&ö %tag% &7»&r %message%"

  - id: vip
    permission: "chatmod.vip"
    format: "&6[VIP]&r &ö%displayname%&ö %tag% &7»&r %message%"

  - id: default
    permission: ""
    format: "&ö%displayname%&ö %tag% &7»&r %message%"

每个格式字符串都支持完整的 ChatMod 令牌集 —— 颜色代码、十六进制颜色、{悬停文本}、<action:…> 点击事件、[item]、[#SpriteName]、[@Name]、&= 换行符、&+ 居中,以及所有 ChatMod 和 PlaceholderAPI 占位符。


?️ 昵称 /nickname /nick

玩家可以设置彩色的显示昵称。权限控制他们确切可以做什么。

用法:

/nickname <nick>               — 设置你自己的昵称
/nickname reset                — 移除你的昵称
/nickname <nick> <player>      — 设置其他玩家的昵称(需要 .others 权限)
/nickname reset <player>       — 移除其他玩家的昵称(需要 .others 权限)

昵称不能为空。如果玩家尝试设置的昵称仅包含颜色代码而没有可见文本,则该操作将被拒绝。

重复保护: 两个 可见 文本相同(不区分大小写,去除所有代码)的昵称被视为重复。如果纯文本 Testing 已被占用,那么 &1Testing 和 &aTesting 都会被阻止 —— 除非玩家持有 chatmod.nick.duplicate 权限,该权限允许已存在名称的颜色变体共存。

权限 授予
chatmod.nick 使用 /nickname 命令
chatmod.nick.color 在昵称中使用颜色代码 (&0–&f)
chatmod.nick.hexa 在昵称中使用十六进制颜色 (&#RRGGBB)
chatmod.nick.format 在昵称中使用格式化代码 (&l, &o, &n …)
chatmod.nick.length.<n> 最大可见字符长度 —— 最高层级的节点生效
chatmod.nick.length.unlimited 无长度限制
chatmod.nick.others 设置或重置其他玩家的昵称
chatmod.nick.bypass.taken 绕过所有昵称唯一性检查
chatmod.nick.duplicate 允许已占用可见名称的颜色变体

? 装饰性标签 /tags

玩家打开图形界面并选择一个装饰性标签以显示在其名字旁边。标签在 tags.yml 中定义,每个标签都有自己独立的权限节点。当前激活的标签作为 %tag% 插入到格式字符串中。

tags:
  - id: pvp
    permission: "chatmod.tag.pvp"
    display: "&c[PvP]&r"
    description: "准备好战斗了!"

? 自定义等级

在 custom_ranks.yml 中定义等级层级。系统会应用玩家拥有的第一个匹配权限节点的等级,并在格式字符串中暴露为三个占位符:

占位符 内容
%custom_rank% 前缀 + 后缀组合
%prefix% 仅等级前缀
%suffix% 仅等级后缀

? 玩家资料 /profile

管理员可以在 profile_fields.yml 中定义任意数量的资料字段 —— 性别、代词、国家、游戏风格或其他任何内容。玩家通过图形界面填写这些信息。资料值通过 %profile:fieldId% 占位符出现在聊天中,当被授予 chatmod.profile.view.others 权限时,其他玩家也可以查看这些资料。

字段支持预定义的选项列表(通过左/右键点击循环切换)和自由文本输入(玩家在聊天中输入值)。


? 自动链接检测

聊天中输入的 URL 会自动转换为可点击的、带样式的链接。完全可配置:

link_detection_enabled: true
link_shorten: true   # https://www.example.com/page → example.com/page
link_format: "&b&n%link%{Open links responsibly}"

{…} 悬停语法与 ChatMod 在所有地方使用的语法相同 —— 大括号之间的内容将作为链接的悬停文本显示。


? 自定义加入与离开消息

用您自己的格式化版本替换原版的加入和离开消息。原版消息会被正确抑制,因此玩家不会看到两次。

joined_the_game: "&e%player% joined the game"
joined_for_first_time: true
joined_for_first_time_format: "&e%player% joined the game for the first time!"
joined_after_name_change: "&e%player% joined the game &7(name changed)"
left_the_game: "&e%player% left the game"

全新安装注意事项: 当模组被安装在已有服务器的环境中时,它会读取 Minecraft 自带的 usercache.json 文件来识别所有曾经加入过的玩家。这些玩家均被视为回归玩家——即使模组的自身数据文件此前尚不存在,任何长期玩家也不会看到“首次加入”的提示消息。


聊天格式占位符

以下占位符可在 formats.yml 格式字符串、加入/离开消息以及 ChatFormatMod 解析文本的任何位置中使用:

占位符 值
%displayname% 昵称(如果已设置)或真实的 Minecraft 用户名
%player% 始终为真实的 Minecraft 用户名
%tag% 当前激活的外观标签显示,若未设置则为空
%custom_rank% 合并后的等级前缀与后缀
%prefix% 仅等级前缀
%suffix% 仅等级后缀
%message% 玩家发送的消息内容(在格式字符串中为必填项)
%profile:fieldId% 个人资料字段的值,例如 %profile:gender%

所有 ChatMod 内置占位符(如 %online_players%、%date%、%time% 等)以及 PlaceholderAPI 占位符也会自动被解析。


? 标签页列表与其他模组集成(PlaceholderAPI)

ChatFormatMod 的所有数据均以 chatformatmod 命名空间下的 PlaceholderAPI 占位符形式暴露。任何支持 PlaceholderAPI 的模组——包括标签页列表模组、记分板模组、名牌标签模组——都可以直接获取昵称、等级、标签和个人资料字段。

占位符 值
%chatformatmod:nick% 带有 § 颜色代码的昵称,若无则显示真实用户名
%chatformatmod:nick_plain% 去除所有颜色代码后的纯文本昵称
%chatformatmod:displayname% nick 的别名
%chatformatmod:prefix% 等级前缀,例如 §c§lAdmin §r
%chatformatmod:suffix% 等级后缀
%chatformatmod:rank% 前缀与后缀组合
%chatformatmod:prefix_nick% 前缀 + 昵称
%chatformatmod:nick_suffix% 昵称 + 后缀
%chatformatmod:prefix_nick_suffix% 前缀 + 昵称 + 后缀全部组合
%chatformatmod:tag% 当前激活的外观标签显示文本,若未设置则为空
%chatformatmod:style% 当前激活的格式风格 ID,例如 admin
%chatformatmod:profile:fieldId% 按 ID 获取任意个人资料字段的值
%chatformatmod:profile_gender% gender 个人资料字段的简写
%chatformatmod:profile_country% country 个人资料字段的简写

示例 — 标签页列表中显示的玩家名称:

%chatformatmod:prefix_nick_suffix%

示例 — 名牌标签模组(头顶上方显示前缀 / 中间显示名称 / 下方显示后缀):

Above:  %chatformatmod:prefix%
Name:   %chatformatmod:nick%
Below:  %chatformatmod:suffix%  %chatformatmod:tag%

所有占位符中的颜色代码均以 § 开头的传统代码形式返回,这是所有标签页列表和名牌标签模组普遍支持的格式。您无需进行任何转换——只需将占位符放入您的配置文件中即可直接使用。

需要安装 Placeholder API 才能使其他模组中的这些占位符生效。当检测到 PlaceholderAPI 存在时,它们会自动注册;如果未安装,ChatFormatMod 仍会正常运行,仅用于聊天格式化功能不受影响。


管理员命令

命令 描述 权限
/chatformat reload 重新加载所有 ChatFormatMod 配置 chatmod.admin.reload
/chatformat debug <player> 显示当前激活的风格、昵称、标签和等级 chatmod.admin.debug
/nickname <nick> 设置自己的昵称 chatmod.nick
/nickname reset 重置自己的昵称 chatmod.nick
/nickname <nick> <player> 设置其他玩家的昵称 chatmod.nick.others
/nickname reset <player> 重置其他玩家的昵称 chatmod.nick.others
/tags 打开外观标签选择器图形界面 chatmod.tags
/profile 打开自己的个人资料图形界面 chatmod.profile
/profile <player> 查看其他玩家的个人资料 chatmod.profile.view.others

别名:/cf 对应 /chatformat,/nick 对应 /nickname。


配置文件

所有文件均位于 config/chatformatmod/ 目录下。编辑后请使用 /chatformat reload 命令重载——无需重启服务器。

文件 包含内容
chatformatmod.yml 全局开关、链接检测、加入/离开消息
formats.yml 按权限划分的聊天格式风格
custom_ranks.yml 等级前缀/后缀定义
tags.yml 外观标签定义
profile_fields.yml 玩家个人资料字段定义
messages.yml 所有面向玩家的游戏内系统文本

玩家数据(昵称、激活的标签、个人资料值)按世界存储在 <world>/chatformatmod_playerdata.json 中。


依赖项

模组 是否必需?
Fabric API ✅ 必需
ChatMod ⭐ 强烈推荐
LuckPerms ✅ 必需(用于按权限区分格式风格)
Fabric Permissions API ✅ 必需
Placeholder API ? 可选 —— 启用 PAPI 占位符及标签页列表集成

ChatFormatMod 并不硬性依赖 ChatMod 进行编译——即使未安装 ChatMod,它也能独立运行并优雅降级(颜色代码会被剥离为纯文本,无悬停/点击事件)。不过,这两个模组是作为配套设计的,一起使用时效果最佳。


整合包政策

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源