Phantom Loot
Phantom Loot 是一个轻量级的服务端 Fabric 模组,为每位玩家提供独立的战利品库存,对应每个可开启容器位置。战利品由容器的战利品表生成,按玩家存储,并在重启后保留。玩家只需使用原版客户端即可。无需在客户端安装任何内容。
模组功能
当玩家打开一个拥有战利品表的容器时,Phantom Loot 会拦截交互并显示虚拟库存,而非共享的物理库存:
- 按玩家独立的虚拟战利品: 每位玩家在同一容器位置获得独立的库存。一位玩家的战利品绝不会影响另一位玩家的战利品。
- 战利品表集成: 内容由容器分配的战利品表及战利品表种子生成,因此数据包和世界生成无需额外设置即可正常工作。
- 支持的容器: 单格箱子、双格箱子、 barrels(木桶)、潜影盒和漏斗。双格箱子合并为一个虚拟库存,并保持正确的左/右顺序。
- 物理验证: 被阻挡的箱子无法打开,且盖子没有空间展开的潜影盒也无法打开,这与原版行为一致。
- 确定性种子: 战利品掷骰使用基于玩家 UUID、维度、容器位置和战利品表派生的种子进行,确保玩家为其存储的战利品获得的掷骰结果稳定。
- 异步生成: 战利品掷骰在虚拟线程上运行,从而在生成过程中不会阻塞服务器主线程。
- 持久化存储: 生成的战利品按玩家和容器位置保存在服务器的保存数据中,并能在服务器重启后幸存。对虚拟库存所做的任何更改都会写回该玩家存储的战利品中。
- 自动过期: 若超过 30 天未访问,存储的战利品将过期,过期的条目大约每小时清理一次。
- 范围验证: 仅当玩家处于同一层级、仍保持连接且距离容器 8 格以内时,虚拟库存才会保持打开状态。
- 原版副作用: 打开箱子、木桶和潜影盒时,仍会正常授予“打开”统计数据;在原版的机制下,仍会激怒附近的猪灵。
- 零依赖: 模组仅使用 Fabric Loader 和原版映射。不需要 Fabric API,也不需要任何客户端文件。
没有战利品表的容器不会被拦截,其行为与原版完全一致。
支持版本
| 模组版本 |
Minecraft |
Fabric Loader |
Java |
| 1.0.0 |
1.21 至 1.21.11 |
0.19.2 及更高版本 |
21 及更高版本 |
| 1.0.0 |
26.1, 26.1.1, 26.1.2 |
0.19.2 及更高版本 |
25 及更高版本 |
| 1.0.0 |
26.2 |
0.19.3 及更高版本 |
25 及更高版本 |
| 1.0.0 |
26.3 |
0.19.5 及更高版本 |
25 及更高版本 |
请下载与您的服务器 Minecraft 版本匹配的文件。所有文件均共享模组版本 1.0.0。
安装
- 为您的 Minecraft 版本在服务端安装 Fabric Loader。
- 将匹配的 Phantom Loot jar 文件放入服务端的
mods 文件夹中。
- 启动或重启服务器。无需配置步骤。
- 玩家使用普通原版客户端加入游戏。客户端无需安装任何模组。
要在游戏中使用该模组,请通过数据包或世界生成将战利品表分配给容器,然后正常打开容器。当玩家首次打开某个容器位置时,其战利品会被生成。再次打开同一位置将显示其已保存的内容,直至过期。
配置
| 设置项 |
描述 |
| 配置文件 |
不存在配置文件。所有行为均为自动,无需进行任何配置。 |
| 存储位置 |
战利品存储在服务器的保存数据中,键名为 phantomloot_phantom_loot,并通过正常的服务器保存周期进行保存。 |
| 过期时间 |
存储的战利品在超过 30 天未访问后过期。过期条目由每小时执行的清理操作移除。这些值为固定值。 |
命令
| 命令 |
描述 |
| 无 |
Phantom Loot 不添加任何命令或权限。打开战利品容器即为全部界面。 |
要求
- Fabric Loader(请参阅上方表格以获取各 Minecraft 版本的最低要求)
- 支持目标 Minecraft 版本的 Java 版本
- 专用或集成服务器环境。该模组标记为仅限服务端。
许可证
版权所有 (c) 2026 TOPG-V。保留所有权利。
未经版权持有者明确事先许可,您不得复制、修改、分发、 sublicens、发布、出售、重新分发、纳入其他项目或以其他方式使用本项目的源代码或资产。
可通过以下任一方式明确授予许可:
GitHub:
电子邮件: viktor.koniushenko@gmail.com
许可必须由 TOPG-V 直接给予。未收到回复不构成许可。
Phantom Loot
Phantom Loot is a lightweight server-side Fabric mod that gives every player their own independent loot inventory for each lootable container position. Loot is generated from the container's loot table, stored per player, and persists across restarts. Players only need a vanilla client. Nothing has to be installed on the client.
What the mod does
When a player opens a container that has a loot table, Phantom Loot intercepts the interaction and shows a virtual inventory instead of the shared physical one:
- Per-player virtual loot: each player receives a separate inventory for the same container position. One player's loot never affects another player's loot.
- Loot table integration: contents are generated from the container's assigned loot table and loot table seed, so datapacks and world generation work without any extra setup.
- Supported containers: single chests, double chests, barrels, shulker boxes, and hoppers. Double chests are combined into one virtual inventory with the correct left/right ordering.
- Physical validation: chests that are blocked cannot be opened, and shulker boxes whose lid has no room to open cannot be opened, matching vanilla behavior.
- Deterministic seeding: loot is rolled with a seed derived from the player UUID, the dimension, the container position, and the loot table, so a player's roll is stable for their stored loot.
- Asynchronous generation: loot rolls run on virtual threads so the server thread is never blocked while generating.
- Persistent storage: generated loot is saved per player and per container position in the server's saved data and survives server restarts. Any change made inside the virtual inventory is written back to that player's stored loot.
- Automatic expiration: stored loot expires after 30 days without access, and expired entries are pruned about once per hour.
- Range validation: the virtual inventory stays open only while the player is in the same level, is still connected, and is within 8 blocks of the container.
- Vanilla side effects: opening chests, barrels, and shulker boxes still awards the normal open statistics and still angers nearby piglins where vanilla does so.
- Zero dependencies: the mod uses only Fabric Loader and vanilla mappings. No Fabric API is required, and no client-side files are needed.
Containers without a loot table are not intercepted and behave exactly like vanilla.
Supported versions
| Mod version |
Minecraft |
Fabric Loader |
Java |
| 1.0.0 |
1.21 through 1.21.11 |
0.19.2 and newer |
21 and newer |
| 1.0.0 |
26.1, 26.1.1, 26.1.2 |
0.19.2 and newer |
25 and newer |
| 1.0.0 |
26.2 |
0.19.3 and newer |
25 and newer |
| 1.0.0 |
26.3 |
0.19.5 and newer |
25 and newer |
Download the file whose Minecraft version matches your server. All files share the mod version 1.0.0.
Installation
- Install Fabric Loader for your Minecraft version on the server.
- Place the matching Phantom Loot jar file into the server's
mods folder.
- Start or restart the server. No configuration step is required.
- Players join with a normal vanilla client. No mod installation is needed on the client.
To use the mod in game, assign loot tables to containers through datapacks or world generation, then open the container normally. The first time a player opens a container position, their loot is generated. Reopening the same position shows their saved contents until it expires.
Configuration
| Setting |
Description |
| Configuration file |
There is no configuration file. All behavior is automatic and there is nothing to configure. |
| Storage location |
Loot is stored in the server's saved data under the key phantomloot_phantom_loot and is saved by the normal server save cycle. |
| Expiration |
Stored loot expires after 30 days without access. Expired entries are removed by an hourly prune. These values are fixed. |
Commands
| Command |
Description |
| None |
Phantom Loot adds no commands and no permissions. Opening a loot container is the entire interface. |
Requirements
- Fabric Loader (see the table above for the minimum version per Minecraft version)
- A Java version supported by the target Minecraft version
- A dedicated or integrated server environment. The mod is marked server-side only.
License
Copyright (c) 2026 TOPG-V. All Rights Reserved.
You may not copy, modify, distribute, sublicense, publish, sell, redistribute, incorporate into another project, or otherwise use this project's source code or assets without explicit prior permission from the copyright holder.
Permission may be granted explicitly through either:
GitHub:
Email: viktor.koniushenko@gmail.com
Permission must be given directly by TOPG-V. The absence of a response does not constitute permission.
评论 0
登录后参与评分
还没有评论,来抢沙发吧