LootBeams (Fabric)

LootBeams (Fabric)

LootBeams 是一款客户端 Fabric 模组，会在世界中掉落的物品上方绘制可自定义的信标式光束和悬浮名称标签，让你从远处也能轻松发现珍贵战利品。

这是由 Elise (shiroroku) 开发的原 Forge 模组的新版 Fabric 移植。

功能

• 物品强调色：光束会根据物品属性动态匹配颜色，包括：
• 自定义 NBT 颜色和自定义物品名称格式
• 药水液体颜色和染色皮革盔甲的颜色
• 物品稀有度等级（普通、少见、稀有、史诗）
• 按材料匹配色盘（钻石、下界合金、绿宝石、金、铁、铜、紫水晶、红石、青金石、海晶石等）
• 垂直延伸与透明度渐变：光束从物品实体顶部平滑延伸，并带有自然的垂直透明度渐变，让掉落的 3D 物品模型清晰可见、不被遮挡。
• 悬浮名称标签：可选显示掉落物品上方的标签，展示物品名称和堆叠数量；也支持仅在注视物品时显示。
• 筛选选项：可设置为显示所有物品、仅装备（武器、盔甲、工具）、仅稀有物品，或指定白名单/黑名单物品 ID。
• 仅客户端：服务器无需安装。可在单人游戏中使用，也能在连接原版或模组化多人服务器时正常运行。

配置

LootBeams 可以通过以下两种方式配置：

1. 游戏内界面（OneConfig）

如果模组列表中安装了OneConfig，LootBeams 会在视觉效果分类下添加交互式配置页面。你可以启用或关闭主开关，调整光束高度、半径、不透明度、渲染距离，以及实时配置名称标签，无需重启游戏。

注意：首次安装后，模组默认处于禁用状态。请在游戏内打开 OneConfig 启用模组并调整偏好设置。

2. 配置文件

设置也保存在本地文件中：

config/lootbeams.json

主要配置项包括：

• enabled：启用或关闭渲染的主开关。
• all_items：是否为每个掉落物品渲染光束（true/false）。
• only_rare：仅为稀有度高于普通的物品渲染光束。
• only_equipment：仅为武器、工具和盔甲渲染光束。
• beam_radius：控制光束的粗细和大小。
• beam_height：光束总高度的倍率。
• beam_alpha：光束的最大不透明度。
• render_distance：光束和名称标签的最大渲染距离（方块）。
• render_nametags：切换是否在掉落物品上方显示悬浮名称标签。
• render_nametags_onlook：仅在注视物品时显示名称标签。
• render_stackcount：在物品名称旁显示堆叠数量。
• color_overrides：按物品 ID 设置自定义十六进制颜色覆盖值。
• whitelist / blacklist：精确筛选物品 ID 注册名。

鸣谢与许可

• 原 Forge 模组由Elise (shiroroku)开发。
• Fabric 移植版由ManorDev开发并维护。
• 基于MIT 许可证授权。
• 源代码见GitHub。