发光吧,我的队友

发光吧,我的队友

让队友之间发光——并精确决定谁能看到该光效、在哪些实体上显示,以及定位条是否遵循相同的规则。

管理

Glow My Teammates

队友之间互相发光 —— 一个基于原版 /team 系统的服务端 Fabric 模组。无需客户端模组,无需自定义队伍管理,可在专用服务器、单人游戏和局域网中运行。

💡 它看起来是什么样的?

启用了发光的队伍中的成员会看到自己的队友被明亮的光晕勾勒出来,无论距离多远。非队友则看不到任何不同之处。发光效果由游戏原生渲染 —— 每个原版客户端都开箱即用地支持它。

✨ 特性

  • 按观察者发光 —— 每个玩家只能看到自己的队友发光,其他人看不到。
  • 按队伍选择启用 —— 一条命令即可为某个队伍启用发光;在你启用之前,原版行为不会有任何改变。
  • 生物也能发光 —— 开启 non_player_glow 后,已启用发光的队伍中的生物会为其队友发光(默认关闭)。
  • 定位栏过滤 —— 可选地,已启用发光的队伍中的观察者在定位栏上只能看到自己的队友。
  • 细粒度权限 —— 每条命令都由权限节点控制,兼容 LuckPerms。
  • 原版友好 —— 发光效果和实体的 Glowing 标签永远不会被改动。通过 /team remove 移除队伍会立即清理 —— 不会残留发光。

📦 前置要求

Minecraft 26.1 Minecraft 26.2 Minecraft 26.3
Fabric Loader >= 0.19.3 >= 0.19.3 >= 0.19.3
Fabric API >= 0.155.3+26.1.2 >= 0.157.0+26.2 >= 0.160.5+26.3

像任何 Fabric 模组一样安装:将 jar 放入服务器的 mods/ 文件夹。仅限服务端 —— 使用原版客户端的玩家无需安装任何东西即可连接。命令反馈在服务端翻译(英语和简体中文)。

🚀 快速开始

/team add red
/team join red @a
/teamglow team add red

完成 —— red 队伍的成员现在会互相发光了。

🛠️ 命令

每条命令都由 glow-my-teammates.command.* 下的权限节点控制(兼容 LuckPerms)。没有权限模组时,管理命令回退到 OP 等级 2;/teamglow status 对所有人可用。

命令 权限节点(回退) 描述
/teamglow status glow-my-teammates.command.status(所有人) 显示队伍发光是否已启用
/teamglow toggle glow-my-teammates.command.toggle(OP 2) 全局切换队伍发光
/teamglow team list glow-my-teammates.command.team(OP 2) 列出已启用发光的队伍
/teamglow team add <team> glow-my-teammates.command.team(OP 2) 为某个队伍启用发光(支持自动补全)
/teamglow team remove <team> glow-my-teammates.command.team(OP 2) 为某个队伍禁用发光(支持自动补全)
/teamglow config list glow-my-teammates.command.config(OP 2) 列出功能开关及其值
/teamglow config get <switch> glow-my-teammates.command.config(OP 2) 显示某个功能开关
/teamglow config set <switch> <true|false> glow-my-teammates.command.config(OP 2) 设置某个功能开关
/teamglow config reset <switch> glow-my-teammates.command.config(OP 2) 将某个功能开关重置为默认值

从 1.1.x 升级? 权限节点已合并 —— command.on / .off 变为 command.toggle,command.team.add / .remove / .list 变为 command.team。请更新任何 LuckPerms 授权;command.config 未变。

功能开关

开关 默认值 效果
non_player_glow false 已启用发光的队伍中的生物会为其队友发光。注意:此后每个脏实体数据包都会经过模组的逐包路径 —— 在生物密集的农场请保持关闭,除非你确实需要它。
locator_bar_teammates_only false 已启用发光的队伍中的观察者在定位栏上只能看到自己的队友;其他队伍的成员和任何无队伍者都会被隐藏。这也涵盖传输路径点的非玩家实体。已启用发光的队伍之外的观察者仍能看到所有人,保持不变。

⚙️ 配置

按世界存储在 <world>/glow-my-teammates.json(模式 [1, 1]):

{
  "enabled": true,
  "teams": ["red", "blue"],
  "configVersion": [1, 1],
  "config": {
    "locatorBarTeammatesOnly": false,
    "nonPlayerGlow": false
  }
}
  • 旧版配置在首次加载时自动迁移 —— 切勿手动编辑该文件。
  • 命令所做的修改以原子方式写入(临时文件 + 原子移动);写入失败会在聊天中报告,而不是静默丢失更改。

🤔 行为说明

  • 原版发光不受影响 —— 发光效果和实体的 Glowing 标签仍然有效;模组只是在其之上添加或清除自己的标志位。
  • /team remove <team> 会立即清理 —— 不会残留发光直到重新登录。
  • 第三人称下不会自我发光 —— 这是有意为之;玩家始终会收到针对自己的无发光变体。
  • 网络开销 —— 每次数据更新会为每个队友额外发送一个极小的数据包。对于小群体可以忽略不计;在大型服务器上,只为需要它的队伍保持启用发光。

📋 更新日志

发布说明和破坏性变更请参阅 CHANGELOG.md。