
viaStyle
一个服务端模组,添加了本地、全局和员工聊天,玩家列表管理,彩色昵称,以及更多功能。
viaStyle
适用于 Minecraft 1.21.10 的服务端 Fabric 模组。用多频道设置替换原版聊天系统,并添加 Tab 列表样式、每玩家昵称颜色、私聊、提及、社交监视,以及可选与 LuckPerms、BlockBot、Carpet、PAPI 和 BanHammer 的集成。
无需客户端模组。
需求
- Minecraft 1.21.10
- Fabric Loader >= 0.16.12
- Fabric API
可选依赖(运行时自动检测):
- LuckPerms 前缀/后缀显示、基于权重的 Tab 排序、权限检查
- PlaceholderAPI (PAPI) 在格式字符串中使用
%placeholder%占位符 - BlockBot Discord 桥接
- fabric-carpet Scarpet 事件集成和 HUD 记录器检测
- melius-vanish(DrexHD)隐藏隐身玩家,不显示在建议和 Tab 列表中
安装
- 将
viastyle-<version>+mc1.21.10.jar放入服务器的mods/文件夹。 - 启动服务器。默认配置会生成在
config/viaStyle/viaStyle.toml。 - 根据需要编辑配置,然后在游戏内运行
/via reload或重启服务器。
配置
所有设置都位于 config/viaStyle/viaStyle.toml。该文件是可读的 TOML。缺失的键会在下次加载时填入默认值。所有设置也可以通过 /via admin 面板在运行时更改。
[local]
| 键 | 默认值 | 描述 |
|---|---|---|
| radius | 100.0 | 可见范围(方块) |
| trigger | (空) | 进入本地模式的前缀字符 空表示本地为默认频道 |
| prefix | [L] |
消息前添加的标签 |
| prefix_color | GREEN | 前缀标签颜色 |
| name_color | GRAY | 玩家名称颜色 |
| message_color | GRAY | 消息文本颜色 |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
完整消息模板 |
| noone_heard | false | 范围内没有玩家时通知发送者 |
| noone_heard_message | Nobody heard you. |
该情况下向发送者显示的文字 |
[global]
| 键 | 默认值 | 描述 |
|---|---|---|
| trigger | ! |
将消息路由到全局聊天的前缀字符 |
| prefix | [G] |
消息前添加的标签 |
| prefix_color | YELLOW | 前缀标签颜色 |
| name_color | WHITE | 玩家名称颜色 |
| message_color | WHITE | 消息文本颜色 |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
完整消息模板 |
[staff]
| 键 | 默认值 | 描述 |
|---|---|---|
| trigger | \ |
员工聊天的前缀字符 留空以禁用 |
| prefix | [Staff] |
消息前添加的标签 |
| prefix_color | RED | 前缀标签颜色 |
| name_color | WHITE | 玩家名称颜色 |
| message_color | DARK_RED | 消息文本颜色 |
| format | {timestamp}{prefix} {lp_prefix}{name}: {message} |
完整消息模板 |
[timestamp]
| 键 | 默认值 | 描述 |
|---|---|---|
| show_timestamp | false | 在每条消息前添加时间戳 |
| timestamp_format | HH:mm |
Java DateTimeFormatter 模式 |
| timestamp_color | DARK_GRAY | 时间戳颜色 |
[integrations]
| 键 | 默认值 | 描述 |
|---|---|---|
| use_placeholder_api | true | 启用 PlaceholderAPI 支持 |
| use_ban_hammer | true | 启用 BanHammer 集成 |
| use_luck_perms | true | 启用 LuckPerms 集成 |
| use_scarpet_events | false | 在每条聊天消息上触发 PLAYER_MESSAGE Scarpet 事件 |
[blockbot]
| 键 | 默认值 | 描述 |
|---|---|---|
| bridge_mode | auto |
auto 在加载 BlockBot 时启用桥接,none 禁用它 |
| global_channel | chat |
用于全局聊天中继的 BlockBot 频道名 |
| local_channel | (空) | 用于本地聊天的 BlockBot 频道 留空以禁用 |
| discord_format | [Discord] {message} |
当 passthrough 为 false 时应用的格式 |
| passthrough | true | true BlockBot 原生格式化 Discord 到 MC 的消息;false 由 viaStyle 应用 discord_format |
| discord_mention_ping | true | 扫描广播消息,并在提到玩家名称时触发游戏内 ping |
| discord_mention_mappings | (空) | 手动 MinecraftName:DiscordUserId 对,逗号分隔 |
[pm]
| 键 | 默认值 | 描述 |
|---|---|---|
| allow_self_message | false | 允许玩家向自己发送 /msg |
| sender_format | [PM -> {receiver}] {message} |
向发送者显示的格式 |
| receiver_format | [PM <- {sender}] {message} |
向接收者显示的格式 |
| color | LIGHT_PURPLE | 私聊消息颜色 |
[nickcolor]
| 键 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 昵称颜色系统的总开关 |
| in_chat | true | 在聊天消息中应用昵称颜色 |
| in_tab | true | 在 Tab 列表中应用昵称颜色 |
| in_nametag | true | 在头顶名称标签中应用昵称颜色 |
| nametag_show_lp_prefix | true | 在名称标签中包含 LuckPerms 前缀 |
| nametag_mode | display |
display TextDisplay 实体(完整 RGB);team 16 种原版颜色 |
| nametag_color_strategy | first |
如何从渐变中选择颜色:first 或 average |
| nametag_orphan_scan_enabled | true | 定期移除残留的 TextDisplay 实体 |
| nametag_orphan_scan_interval_ticks | 200 | 扫描间隔(刻) |
[tablist]
| 键 | 默认值 | 描述 |
|---|---|---|
| sort_mode | normal |
normal 较高 LP 权重排更下方;reverse 较高排更上方;none 禁用 |
| sort_spectators_to_bottom | false | 将旁观者排到所有其他玩家下方 |
[mentions]
| 键 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 在聊天中处理 @PlayerName 提及 |
| sound | true | 在被提及玩家的客户端播放声音 |
| bold | false | 在消息中将 @提及 加粗 |
| color | GOLD | 提及的高亮颜色 |
[language]
| 键 | 默认值 | 描述 |
|---|---|---|
| default_language | en |
UI 语言 en 或 ru |
[joinleave]
| 键 | 默认值 | 描述 |
|---|---|---|
| join_format | &a+ &r{name} |
玩家加入时的广播格式 |
| leave_format | &c- &r{name} |
玩家离开时的广播格式 |
| first_join_format | &6+ &r{name} &6joined for the first time! |
仅在首次加入时显示 |
[console]
| 键 | 默认值 | 描述 |
|---|---|---|
| log_global_to_console | true | 将全局聊天转发到服务器控制台 |
| log_local_to_console | true | 转发本地聊天 |
| log_staff_to_console | true | 转发员工聊天 |
| log_privates_to_console | true | 转发私聊消息 |
格式占位符
大多数格式字符串支持这些占位符:
| 占位符 | 值 |
|---|---|
{name} |
玩家显示名称 |
{message} |
消息内容 |
{prefix} |
频道前缀标签 |
{timestamp} |
时间戳(禁用时为空) |
{lp_prefix} |
LuckPerms 前缀 |
{lp_suffix} |
LuckPerms 后缀 |
所有格式字符串支持传统 & 颜色代码和十六进制颜色(&#RRGGBB)。昵称颜色值和 viaSuper 格式字符串支持 MiniMessage 风格标签(<red>、<bold>、<gr:#ff0000:#ffaa00>)。
功能
聊天频道
本地聊天仅在配置的半径内可见。全局聊天可到达每位玩家。员工聊天仅限拥有 viastyle.staff 权限节点的玩家。活动默认频道可通过 /chatmode 按玩家切换。
当启用 noone_heard 时,如果范围内没有其他玩家,发送者会收到一条私密提示。
私聊消息
/msg <player> <message>(别名 /m、/w)发送私聊消息。/reply(别名 /r)回复最后给你发消息的人。被忽略的玩家无法发送私聊。隐身玩家会被排除在建议之外。
@提及
在任何消息中输入 @PlayerName 可高亮它并在接收者客户端播放声音。使用部分匹配 @via 可匹配 viaMeowts。
安装 BlockBot 后,在游戏内输入 @MinecraftName 可解析为 Discord 用户 ID,以便 Discord 将其渲染为真实 ping。映射可在 discord_mention_mappings 中手动配置,或从传入的 Discord 消息自动填充。
忽略系统
/ignore <player> 切换忽略。被忽略玩家的消息和私聊会被静默丢弃。状态在重启后持久保存。
社交监视
/socialspy(需要 viastyle.socialspy)在服务器范围内拦截私聊消息。员工可以从任意距离监控本地和员工频道。
昵称颜色
玩家通过 /nickcolor <colour> 设置颜色。接受命名颜色、十六进制代码(#rrggbb)和渐变语法(#ff0000:#ffaa00)。存储在 config/viaStyle/nickcolors.json。
该颜色应用于聊天、Tab 列表和浮动 TextDisplay 名称标签。管理员可以使用 /nickcolor <player> <colour|reset> 设置或清除任何玩家的颜色。
nametag_mode = display 将名称标签渲染为 TextDisplay 实体(完整 RGB)。nametag_mode = team 使用记分板队伍(16 种原版颜色,兼容性更好)。
Tab 列表
viaStyle 每刻向每位玩家发送自定义页眉和页脚。模板位于 config/viaStyle/tablist.json。拥有活动 Carpet HUD 记录器(/log tps、/log mobcaps 等)的玩家会自动被排除在更新之外。
Tab 排序顺序由 sort_mode 控制,并在可用时使用 LuckPerms 权重。
加入 / 离开消息
原版加入和离开广播被替换为配置的格式。玩家首次加入时会广播单独的格式。
viaSuper
/viasuper [text] 发送戏剧性的标题/副标题广播。短词显示为大标题;较长的词(长度 >= viaSuperSubtitleLength)显示为副标题。viaSuperTitleFormat 和 viaSuperSubtitleFormat 支持 MiniMessage 格式化和渐变。
Discord 桥接(BlockBot)
安装 BlockBot 后,viaStyle 通过 ChatMessageEvent 将 Minecraft 聊天中继到 Discord,并以 sendRelayMessage 作为后备。现代和旧版 BlockBot API 包都会通过反射自动检测。
设置 passthrough = true(默认)让 BlockBot 原生处理 Discord 到 Minecraft 的格式化。设置 passthrough = false 以改用 viaStyle 的 discord_format。
BanHammer
加载 BanHammer 后,被封禁的玩家尝试聊天时会收到标准的 BanHammer 消息。
Carpet / Scarpet 集成
设置 useScarpetEvents = true 以对 viaStyle 处理的每条消息触发 Carpet 的 PLAYER_MESSAGE 事件。Scarpet 脚本可以拦截、修改或取消消息。Carpet HUD 记录器检测无论此设置如何都会运行。
命令
| 命令 | 权限 | 描述 |
|---|---|---|
/via reload |
viastyle.admin |
从磁盘重新加载配置 |
/via admin |
viastyle.admin |
打开游戏内管理面板 |
/msg <player> <message> |
任意 | 发送私聊消息 |
/reply <message> |
任意 | 回复最后一位私聊发送者 |
/chatmode |
任意 | 切换默认频道(本地 / 全局) |
/ignore <player> |
任意 | 切换忽略某玩家 |
/nickcolor [player] <colour|reset> |
viastyle.nickcolor / viastyle.admin |
设置或清除昵称颜色 |
/socialspy |
viastyle.socialspy |
切换社交监视 |
/viasuper [text] |
viastyle.admin |
广播标题/副标题消息 |
权限
| 节点 | 描述 |
|---|---|
viastyle.admin |
完全管理员访问:配置重载、管理面板、viasuper、设置其他玩家昵称颜色 |
viastyle.staff |
写入和读取员工聊天 |
viastyle.socialspy |
切换社交监视 |
viastyle.nickcolor |
设置自己的昵称颜色 |
Scarpet 脚本
在配置中启用 use_scarpet_events = true。viaStyle 会为每条消息触发 Carpet 的 PLAYER_MESSAGE 事件。脚本可以返回 'cancel' 以抑制消息,或返回修改后的字符串以替换内容。
tools/scarpet_generator.py 生成以下模板:
| 脚本 | 描述 |
|---|---|
viastyle_logger.sc |
将消息带时间戳记录到文件 |
viastyle_antispam.sc |
每玩家速率限制器 |
viastyle_filter.sc |
词汇拦截器 / 审查器 |
viastyle_discord.sc |
用于外部 Discord 机器人的队列文件中继 |
viastyle_welcome.sc |
加入时的 MOTD |
viastyle_commands.sc |
哈希前缀的聊天内命令(#help、#roll、#tps) |
viastyle_stats.sc |
每玩家消息和字数统计跟踪器 |
python tools/scarpet_generator.py --all --out /path/to/scripts
将生成的 .sc 文件复制到 <world>/scripts/ 并使用 /script load <name> 加载。
许可证
MIT。参见 LICENSE。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。