战利品锁

你的战利品，你的规则。 Loot Lock 是一个开源的 Fabric 模组，用于按玩家过滤地面物品。服务端权威、多人游戏安全、零垃圾。

别再让你的背包变成腐肉和小麦种子的坟墓。Loot Lock 允许服务器上的每个玩家自行决定想要拾取哪些地面物品，并忽略其他一切。不再有每次洞穴探险后的背包俄罗斯方块。不再有每次袭击后把垃圾潜行丢进漏斗的十分钟苦工。

适用人群

生存模式玩家——厌倦了在繁殖鸡时捡鸡蛋，或者在清理草时捡小麦种子。

刷怪塔玩家——运行铁傀儡刷怪塔，只想要铁锭，不想捡掉落的 47 朵虞美人。

红石工程师——在生存模式下建造，想要一个只拾取红石粉、中继器和火把的配置文件，以保持电路工作区域整洁。

SMP 突袭小队——清理掠夺者前哨站时，一个玩家囤积所有弩，另一个只想要绿宝石。两者都能如愿以偿，在同一世界，同一时间。

整合包作者——需要一种干净、理智的方式来给予玩家背包控制权，而无需额外捆绑五个独立的实用模组。

任何曾因为了捡下界合金锭而误触一堆种子而对着屏幕怒吼的人。

模组功能

过滤功能

• 按玩家配置的配置文件，拥有独立规则，因此你的过滤不会影响其他任何人的游戏体验。
• 每个配置文件可设允许列表或拒绝列表模式。精确选择要拾取的物品，或精确选择要跳过的物品。
• 每个玩家拥有多个配置文件，用于快速切换。采矿配置、建筑配置、农耕配置。一键或一次按键即可切换。
• 将拒绝的物品留在地上或删除。删除模式包括安全确认和操作员选择退出功能。

游戏内界面

• 停靠面板，可从背包界面旁滑出，无需单独的全屏菜单绕路。
• 规则标签页，带有实时物品搜索、多选、拖放添加，以及一个带有柔和闪光效果的黄金边框放置目标区域，让你知道拖放已生效。
• 设置标签页，用于设置 HUD 提示、安全确认和内置按键绑定速查表。
• 内联配置文件重命名，点击配置文件药水即可，外加一键循环箭头和每个配置文件对应的颜色块。

反馈

• 被阻挡物品提示，简要告知你哪个物品被过滤掉了（可开关）。
• 配置文件切换提示，让你知道你刚刚切换到了哪个配置（可开关）。
• 开关提示，当 Loot Lock 开启或关闭时显示（可开关）。

多人游戏

• 服务端权威状态，带有正确的编辑同步。不会不同步。没有作弊性的客户端重写。
• 同样适用于原版客户端。 即使没有安装模组的玩家，如果服务器管理员通过命令管理他们的规则，他们也能受益。
• 与界面并列的完整命令覆盖，以你喜欢的方式管理规则。

快速开始

1. 将 Loot Lock 和 Fabric API 放入你的 mods 文件夹。
2. 启动游戏，加入你的世界，打开你的背包。
3. 点击配方书按钮旁边的小型 Loot Lock 按钮。停靠面板将在背包旁打开。
4. 打开规则标签页，输入文字搜索物品，选择一个过滤模式，点击添加已选，然后走到一些掉落物上验证。

这就是全部设置。无需编辑配置文件。

快捷键

在规则标签页内：

• Shift + 点击搜索结果可选择一段范围。
• Ctrl + 点击（macOS 为 Cmd + 点击）可添加或移除单行。
• 双击任意行可立即添加该物品。
• Alt + 点击任意背包格子，可直接添加该物品而无需打开搜索。
• 拖动一组物品到面板上，可直接将其放入你的规则列表。
• 拖动一组物品到关闭的 Loot Lock 按钮上，可无需打开面板即添加该物品。
• 全部清除会清空当前激活的配置文件，清除搜索会在搜索时出现在其位置。
• 以 # 开头的搜索会将结果限定为物品标签（#flowers、#seeds、#minecraft:wool）。添加一个标签行的方式与添加物品行相同，它会展开匹配该标签涵盖的所有物品。

进阶技巧

• 将循环 Loot 配置文件绑定到鼠标侧键。可在采矿、建筑和农耕配置之间即时切换，无需打开任何界面。
• 在一般游戏中使用拒绝列表模式，只列出少量要拒绝的物品（如鸡蛋、种子、腐肉）; 而进行像采矿这样只想要好东西的专注任务时，则使用允许列表模式。
• 将删除模式配置文件与刷怪塔配对使用，这样你的收集箱就永远不会被垃圾掉落物填满。
• 操作员可以在新玩家登录之前，使用 /lootlock 命令为他们预先配置配置文件。

控制绑定

Loot Lock 附带两个按键绑定，默认均为未绑定状态。可在 控制 > Loot Lock 中设置：

• 开关 Loot Lock 切换整个模组的启用状态，等同于点击停靠面板上的玩家开关。
• 循环 Loot 配置文件 按一下按键即可切换到下一个保存的配置文件。

命令

所有命令均以 /lootlock 为根。游戏内界面涵盖了以下所有内容，但如果你没有安装客户端模组，命令是唯一的路径。

通用命令

命令	功能
/lootlock	打印快速命令帮助。
/lootlock status	显示激活的配置文件、启用状态、模式、行为和规则数量。
/lootlock enable	在你拥有的所有配置文件中启用 Loot Lock（整体模组开关）。
/lootlock disable	在你拥有的所有配置文件中禁用 Loot Lock（整体模组开关）。
/lootlock profile list	列出你的配置文件并标记当前激活的。
/lootlock profile activate <名称>	按名称激活一个配置文件，然后显示状态。

配置文件和规则

命令	功能	备注
/lootlock profile create <名称>	创建一个具有默认设置的新配置文件。	名称会被修剪，且长度必须在 1 到 32 个字符之间。每个玩家最多 9 个配置文件。
/lootlock profile delete <名称>	按名称删除一个配置文件。	不能删除你最后一个配置文件。
/lootlock profile export <名称>	将指定名称的配置文件编码为一个可点击、复制到剪贴板的分享码。	请参阅下方的分享配置文件部分。
/lootlock profile import <代码>	解码一个以 ll1. 为前缀的分享码，并根据它创建一个新的配置文件。	名称冲突会自动添加 (2)、(3) 等后缀。
/lootlock mode denylist	将当前激活的配置文件过滤模式设置为拒绝列表。
/lootlock mode allowlist	将当前激活的配置文件过滤模式设置为允许列表。
/lootlock action leave	将拒绝物品的行为设置为将其留在地面上。
/lootlock action delete	显示删除模式的安全警告和确认说明。
/lootlock action delete confirm	将拒绝物品的行为设置为永久删除被拒绝的掉落物。	如果服务器策略不允许删除模式，则该操作被阻止。
/lootlock rule add <命名空间:物品>	向当前激活的配置文件中添加一个物品规则。	物品 ID 必须存在。
/lootlock rule add tag <命名空间:标签路径>	向当前激活的配置文件中添加一个物品标签规则，匹配该标签解析到的所有物品。	即使标签当前未加载也会保存；稍后通过数据包重载解析。
/lootlock rule remove <命名空间:物品>	从当前激活的配置文件中移除一个物品规则。
/lootlock rule remove tag <命名空间:标签路径>	从当前激活的配置文件中移除一个标签规则。
/lootlock rule list	列出当前激活配置文件中的规则。
/lootlock rule clear	在清除规则前显示确认提示。
/lootlock rule clear confirm	从当前激活的配置文件中移除所有规则。

操作员命令

需要操作员权限等级 2。

服务器策略位于 /lootlock policy 下。通用命令以及配置文件和规则表里的每个命令，也有一个操作员形式，前缀为 /lootlock player <目标>，该形式对另一个玩家的数据执行相同的子命令，而非命令发起者自己的数据。

命令	功能
/lootlock policy	显示当前服务器策略的值。
/lootlock policy allowDeleteRejectedItems true	允许玩家对被拒绝的物品使用删除模式。
/lootlock policy allowDeleteRejectedItems false	阻止删除模式并强制使用留地模式。
/lootlock player <目标> <子命令>	对 <目标> 而不是命令发起者执行任何以自己为目标的子命令。

<目标> 接受一个在线玩家名称（可按 Tab 补全）、一个服务器已缓存的离线名称、或一个原始 UUID 字面量，用于为从未加入过的玩家预先配置配置文件。在线目标在每次修改后会收到一个权威同步，以便他们的客户端无需重新加入即可反映更改。离线编辑会通过由 UUID 键控的延迟保存路径持久化，并在重启后仍然存在。

常见问题

能在原版客户端上工作吗？ 是的。服务器运行所有过滤逻辑。原版客户端无法打开停靠界面，但操作员可以使用 /lootlock 命令管理该玩家的配置文件，并且规则会在拾取时正常应用。

能处理模组物品吗？ 是的。规则存储为物品 ID（命名空间:物品），因此 Minecraft 能识别的任何东西，Loot Lock 都能过滤。

性能如何？ 过滤仅在服务器的拾取游戏刻运行，使用的是每个玩家的哈希键控规则集。每次拾取的开销是常数时间，与原版拾取逻辑相比可以忽略不计。

我需要编辑任何配置文件吗？ 不需要。一切均由玩家在游戏中配置，或由操作员在服务器上通过命令配置。客户端的提示偏好会自动持久保存。

数据存储在哪里？ 配置文件数据是服务端权威的，并按玩家的 UUID 与其他世界数据一同保存，因此它能在不同游戏会话和重新加入时持久存在。

兼容性

• Minecraft： 1.21.1
• 加载器： Fabric 0.19.3+
• Fabric API： 0.116.12+1.21.1 最低版本
• Java： 21+
• 环境： 专用服务器和集成服务器，无论是否安装客户端模组

依赖项

依赖项	版本	必需	用途
Fabric Loader	>=0.19.3	是	模组加载器
Fabric API	>=0.116.12+1.21.1	是	Fabric 钩子和 API
Mod Menu	>=11.0.4	否	从模组列表打开 Loot Lock 客户端偏好设置。配置文件和规则以及服务器策略通过打开背包中的 Loot Lock 面板在游戏内编辑

权限

policy 命令路径以及管理其他玩家配置文件需要操作员权限等级 2。没有操作员权限的玩家仍然可以通过界面或命令完全管理自己的配置文件。

分享配置文件

配置文件可以导出为一段简短的、可粘贴的分享码，并可以导入到任何安装了 Loot Lock 的世界中。

运行 /lootlock profile export <名称> 会得到一个可点击的字符串，例如 ll1.eJyrViouSU3MS1ezUjI0Mlay8suvtFKK1FFKzEsBigEAyiYItQ。在聊天中点击该代码，Minecraft 会将其复制到你的剪贴板。然后你可以将其粘贴到 Discord、Reddit 评论、整合包说明文件或任何其他地方。

你也可以在背包界面内进行导出和导入。打开 Loot Lock 面板，点击配置文件药水展开下拉菜单，点击任意配置文件行上的 E 小按钮，即可将该配置文件的分享码直接复制到剪贴板；或者点击“+ 新配置文件”下的“从代码导入”，打开一个粘贴提示框，接受一个 ll1. 开头的代码，并将其添加为新配置文件。

要通过聊天导入代码，运行 /lootlock profile import <代码>。解码器会在创建新配置文件之前验证前缀、有效载荷和每个字段。如果导入的名称与你已有的配置文件名冲突，新配置文件名称后会添加 (2)、 (3) 等后缀。错误会返回清晰的消息，而不是导致崩溃。

代码内包含和不包含的内容：

• 包含： 配置文件名称、过滤模式、拒绝物品的行为以及规则的完整有序列表（物品 ID 和以 # 为前缀的标签条目）。
• 不包含： 配置文件颜色、启用状态、配置文件 ID。导入器会生成一个新的 ID，并将颜色选择权留给导入者。

分享码本质上是公开的。请勿编码任何你不会粘贴到公共频道的内容。

开源

Loot Lock 在 MIT 许可证下开源。

如果 Loot Lock 在你漫长的生存旅程中拯救了你的理智，那么在 GitHub 上点个星标，或在 Ko-fi 上请喝杯咖啡，都将对我有莫大的帮助。