viaStyle

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 列表中

安装

  1. 将 viastyle-<version>+mc1.21.10.jar 放入服务器的 mods/ 文件夹。
  2. 启动服务器。默认配置会生成在 config/viaStyle/viaStyle.toml。
  3. 根据需要编辑配置,然后在游戏内运行 /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。