灯塔伙伴

灯塔伙伴

适用于Minecraft 1.21.11、26.2和26.3的客户端Fabric模组。开启该模式后,你会看到服务器中同样开启该模式的其他玩家在发光。屏幕顶部的一个面板会显示他们的距离、游戏时长和已放置方块数。

杂项

Beacon Buddies

客户端 Fabric 模组,适用于 Minecraft 1.21.11、26.2 和 26.3。开启模式后,你将看到服务器上同样开启了该模式的其他玩家发光显示。屏幕顶部面板显示他们的距离、游戏时长和放置方块数。

它适用于任何服务器:无需在服务端安装任何东西,所有内容都通过一个小型 WebSocket 中继传输。

一位好友处于发光状态,Beacon Buddies 面板位于右上角,显示每位玩家的距离、会话、总时长和放置方块数

功能

  • 互见模式:你只能看到开启了该模式的玩家,也只有他们能看到你。其他所有人看不到任何特殊内容。
  • 发光:附近好友的穿墙轮廓,可使用 Minecraft 全部 16 种颜色之一。
  • HUD:一个面板,每位玩家一行(皮肤头部和用户名),每项统计一列。
    • 行顺序:你排第一(青色),然后是好友,从最近到最远。
    • 标题栏中的数字是好友数量。
    • 可调整行数,超出后显示“+N more”。
    • 位置可设为右上、左上或顶部居中。位于右上时,面板会下移到药水效果图标下方。
  • 距离(“Dist.” 列):对每位好友,50 格以内为绿色,200 格以内为黄色,更远为红色。不在同一维度则显示灰色“Other dim.”。
  • 游戏时长(“Session” 和 “Total” 列):你和你的好友。当前会话为青色,该服务器上的总时长为灰色。
  • 放置方块(“Blocks” 列):你在服务器上放置的方块数量以及好友的数量。
  • 团队聊天:服务器上所有开启该模式的玩家之间的独立聊天,消息最长 2048 个字符。Minecraft 服务器永远不会看到这些消息。
  • 设置菜单,带有 HUD 实时预览。
  • 每次加入服务器时,该模式都会自动关闭。

安装

  1. 为 Minecraft 1.21.11 安装 Fabric Loader 0.20.1 或更新版本。
  2. 将 Fabric API 放入你的 mods 文件夹。
  3. 将 Beacon Buddies 的 .jar 放入你的 mods 文件夹。

每位想要看到他人并被他人看到的玩家都需要安装此模组。

使用

按键 操作
J 开启 / 关闭模式
G 打开设置菜单
H 显示 / 隐藏 HUD

按键可在 选项 > 控制 中的“Beacon Buddies”分类下更改。

命令 操作
/buddies 显示模式状态
/buddies on、off、toggle 开启、关闭或切换模式
/buddies list 在聊天中列出你的好友及其距离

该模式仅适用于多人游戏(不适用于单人游戏或局域网)。

设置

所有设置均在菜单(G)中完成,并保存到 config/beaconbuddies.json:

左侧为设置菜单,右侧为面板预览

设置 默认值
显示 HUD 开
HUD 位置 右上
最大行数(3 到 15) 8
按距离着色 开
玩家头部 开
游戏时长 开
放置方块 开
发光颜色 白色

工作原理

客户端模组无法通过原版服务器与其他客户端通信,并且它只知道附近玩家。因此 Beacon Buddies 通过外部 WebSocket 中继(wss://beaconbuddies.habibiserver.dev/beaconbuddies)进行通信:

  1. 当你加入服务器时,模组会使用你的用户名、UUID 和服务器地址(例如 play.example.net:25565)连接到中继。玩家按服务器地址分组。
  2. 模式开启期间,每 0.5 秒发送一次你的位置和维度。
  3. 中继会向每位活跃玩家发送同一服务器上其他活跃玩家的列表。

位置仅保存在内存中:它们永远不会被保存或记录,并且在你断开连接时消失。

无假玩家

  • 已验证账户:连接时,中继会像正版服务器一样通过 Mojang 验证你的账户。模组会证明它已登录到其所声称的账户,而绝不会将你的令牌发送给中继。因此没有人能伪造玩家或冒充他人。不接受离线账户。
  • 仅限服务器玩家:模组只会显示位于你所处服务器玩家列表(Tab)中的好友及其团队聊天消息。

游戏时长

模式开启期间,模组会告诉中继你在线(每 30 秒一次)。中继据此计算出你的会话并存储它们:

  • 存储内容:服务器地址、UUID、用户名,以及每个会话的开始和结束时间。绝不存储 IP 或位置。
  • 谁可以访问:只有连接到同一服务器且开启该模式的玩家。没有公开访问权限。
  • 保留期限:超过 90 天的会话会自动删除。
  • 限制:只统计开启模式期间的时间。

这仅适用于安装了模组并开启该模式的玩家:服务器上的其他玩家永远不会被追踪。要删除你的历史记录,请在本仓库提交 issue 并附上你的 UUID。

放置方块

模组本身不统计任何内容:它每 30 秒向服务器询问你的原版统计信息(与统计菜单中的相同),并将每种方块的使用量相加。因此总数包括你在该服务器上放置的所有方块,甚至包括安装模组之前放置的。

你的总数会发送到中继,中继会将其与你的位置一起转发给你的好友。它保存在内存中,不会被保存。你只能看到安装了模组并开启该模式的玩家的方块数:客户端无法知道是谁放置了方块。

团队聊天

模式开启期间,聊天栏(T)上方会出现两个标签页。它们是两个独立的聊天,各自拥有自己的消息和历史记录:

  • 全局:服务器的普通聊天。
  • 团队:团队聊天。你输入的内容会发送给其他开启该模式的玩家,而不经过服务器。命令(/...)始终发送到服务器。

Replace this with a description

屏幕上显示的聊天(即使关闭时)是所选标签页的聊天。另一个标签页会显示未读消息数量,例如“Team (3)”。

消息通过中继传输,中继会立即转发而不保存。没有历史记录:开启模式时,你只能看到从那时起发送的消息。中继限制你每 5 秒最多发送 5 条消息。

须知

  • 位置可见:任何拥有 Minecraft 账户且知道服务器地址的人都可以看到在该服务器上开启该模式的玩家的位置,并读取团队聊天,即使不在该服务器上。只有在你对此不介意时才开启该模式。
  • 发光仅限附近玩家:发光只显示在你周围已加载的玩家上。更远的好友仍会显示在 HUD 中,并显示其距离。
  • 需要相同地址:使用两个不同地址(例如一个域名及其 IP)加入同一服务器的两位玩家将无法看到彼此。
  • 服务器规则:某些服务器可能禁止穿墙看到玩家,即使是朋友之间。使用前请检查规则。