Lootr 插件文档
概述
Lootr 是一款专为 Minecraft 服务器设计的插件,彻底革新了世界中战利品的分配方式。在原版 Minecraft 中,当玩家发现地牢宝箱并取走物品后,该宝箱对其他人来说就会变为空箱。Lootr 通过创建“实例化”战利品解决了这一问题。
当玩家打开 Lootr 宝箱时,插件会为该玩家生成一个独特的库存。其他玩家可以打开同一个物理宝箱,但会看到属于他们自己的独特物品集。这确保了在多人服务器上,无论谁先到达某个结构,所有玩家的探索体验都能保持回报丰厚。
核心功能
- 每位玩家拥有独立战利品:每位玩家从每个宝箱中获得的战利品都是独立的。
- 自动转换:插件会自动检测带有战利品表的原版箱子(如地牢、沙漠神殿和堡垒中的箱子),并将它们转换为 Lootr 宝箱。
- 库存持久化:如果玩家在 Lootr 宝箱中留下了物品,这些物品会被保存,并在玩家返回时等待他们领取。
- 全面防护:Lootr 宝箱受到保护,防止被破坏、被活塞移动或被漏斗掠夺,从而防止恶意破坏和稀有战利品的自动化采集。
- 视觉指示器:包含粒子系统,用于高亮显示玩家尚未开过的宝箱,使探索更加直观。
安装指南
- 下载
LootrPlugin.jar文件。 - 将 jar 文件放入服务器的
plugins文件夹中。 - 重启服务器以生成配置文件。
- (可选)自定义
plugins/LootrPlugin/config.yml中的设置。 - 使用
/lootr reload应用配置文件的任何更改。
版本支持
该插件现在针对 Paper API 版本 26.1.2。
变更内容:
- Maven 现针对
io.papermc.paper:paper-api:26.1.2.build.60-stable进行编译。 plugin.yml现声明api-version: '26.1.2'。
兼容性说明:
- 此代码库仅使用稳定的 Bukkit/Paper API,不包含 NMS 内部实现,因此非常适合在后续 26.x 服务器版本上运行。
- 对于未来版本(如 26.2.x 或 26.3.x)的实际兼容性,仍取决于 Paper 是否保持这些 API 的二进制兼容性。
- 仓库已更新,并使用当前发布的稳定版 26.1.2 Paper API 进行了验证。
补丁更新 - 2026年7月26日
本次补丁的变更
此次更新扩展了 Lootr 对容器的支持,并提高了与新版服务器 API 的兼容性。
新增容器支持
- Lootr 现在支持箱子、桶和矿车箱子。
- 打开这些容器现在使用与普通 Lootr 宝箱相同的每位玩家战利品流程和防护逻辑。
兼容性改进
- 添加了针对新版 Paper/Bukkit API 行为的兼容层。
- 更新了库存创建和音效播放处理,以更好地兼容现代服务器版本。
- 改进了战利品上下文处理,使战利品表的生成更加可靠。
- 现代化了管理员命令处理,避免使用旧的已弃用查找模式。
构建清单更新
- 在完成这些更改后,插件包已成功验证。
- 该项目现在更符合现代 Paper 兼容性预期,同时保留了现有功能。
Lootr Plugin Documentation
Overview
Lootr is a specialized Minecraft server plugin that revolutionizes how loot is distributed in your world. In standard Minecraft, when a player finds a dungeon chest, they take the items, and the chest becomes empty for everyone else. Lootr solves this problem by creating "instanced" loot.
When a player opens a Lootr chest, the plugin generates a unique inventory specifically for that player. Other players can open the same physical chest and will see their own unique set of items. This ensures that exploration remains rewarding for all players on a multiplayer server, regardless of who arrived at a structure first.
Key Functionalities
- Unique Loot for Every Player: Every player gets their own loot from every chest.
- Automatic Conversion: The plugin automatically detects vanilla chests with loot tables (like those in dungeons, desert temples, and bastions) and converts them into Lootr chests.
- Inventory Persistence: If a player leaves items in a Lootr chest, those items will be saved and waiting for them when they return.
- Comprehensive Protection: Lootr chests are protected from being broken, moved by pistons, or looted by hoppers to prevent griefing and automation of rare loot.
- Visual Indicators: Includes a particle system to highlight chests that a player hasn't looted yet, making exploration more intuitive.
Installation Guide
- Download the LootrPlugin.jar file.
- Place the jar file into your server's 'plugins' folder.
- Restart your server to generate the configuration files.
- (Optional) Customize the settings in 'plugins/LootrPlugin/config.yml'.
- Use '/lootr reload' to apply any changes made to the configuration.
Version Support
The plugin now targets the Paper API for version 26.1.2.
What was changed:
- Maven now compiles against
io.papermc.paper:paper-api:26.1.2.build.60-stable. plugin.ymlnow declaresapi-version: '26.1.2'.
Compatibility note:
- This codebase only uses stable Bukkit/Paper APIs and no NMS internals, so it is a strong candidate for running on later 26.x server builds.
- Actual compatibility for future builds such as 26.2.x or 26.3.x still depends on Paper keeping those APIs binary-compatible.
- The repository has been updated and validated against the currently published stable 26.1.2 Paper API.
Patch Update - July 26, 2026
What changed in this patch
This update expands Lootr’s container support and improves compatibility with newer server APIs.
New container support
- Lootr now supports chests, barrels, and minecart chests.
- Opening these containers now uses the same per-player loot flow and protection logic as regular Lootr chests.
Compatibility improvements
- Added a compatibility layer for newer Paper/Bukkit API behavior.
- Updated inventory creation and sound playback handling for better compatibility across modern server versions.
- Improved loot-context handling so loot tables are generated more reliably.
- Modernized admin command handling to avoid older deprecated lookup patterns.
Build and manifest updates
- The plugin package was verified successfully after these changes.
- The project is now better aligned with modern Paper compatibility expectations while preserving existing functionality.
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lootr Instancer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Lootr 插件文档
概述
Lootr 是一款专为 Minecraft 服务器设计的插件,彻底革新了世界中战利品的分配方式。在原版 Minecraft 中,当玩家发现地牢宝箱并取走物品后,该宝箱对其他人来说就会变为空箱。Lootr 通过创建“实例化”战利品解决了这一问题。
当玩家打开 Lootr 宝箱时,插件会为该玩家生成一个独特的库存。其他玩家可以打开同一个物理宝箱,但会看到属于他们自己的独特物品集。这确保了在多人服务器上,无论谁先到达某个结构,所有玩家的探索体验都能保持回报丰厚。
核心功能
- 每位玩家拥有独立战利品:每位玩家从每个宝箱中获得的战利品都是独立的。
- 自动转换:插件会自动检测带有战利品表的原版箱子(如地牢、沙漠神殿和堡垒中的箱子),并将它们转换为 Lootr 宝箱。
- 库存持久化:如果玩家在 Lootr 宝箱中留下了物品,这些物品会被保存,并在玩家返回时等待他们领取。
- 全面防护:Lootr 宝箱受到保护,防止被破坏、被活塞移动或被漏斗掠夺,从而防止恶意破坏和稀有战利品的自动化采集。
- 视觉指示器:包含粒子系统,用于高亮显示玩家尚未开过的宝箱,使探索更加直观。
安装指南
- 下载
LootrPlugin.jar文件。 - 将 jar 文件放入服务器的
plugins文件夹中。 - 重启服务器以生成配置文件。
- (可选)自定义
plugins/LootrPlugin/config.yml中的设置。 - 使用
/lootr reload应用配置文件的任何更改。
版本支持
该插件现在针对 Paper API 版本 26.1.2。
变更内容:
- Maven 现针对
io.papermc.paper:paper-api:26.1.2.build.60-stable进行编译。 plugin.yml现声明api-version: '26.1.2'。
兼容性说明:
- 此代码库仅使用稳定的 Bukkit/Paper API,不包含 NMS 内部实现,因此非常适合在后续 26.x 服务器版本上运行。
- 对于未来版本(如 26.2.x 或 26.3.x)的实际兼容性,仍取决于 Paper 是否保持这些 API 的二进制兼容性。
- 仓库已更新,并使用当前发布的稳定版 26.1.2 Paper API 进行了验证。
补丁更新 - 2026年7月26日
本次补丁的变更
此次更新扩展了 Lootr 对容器的支持,并提高了与新版服务器 API 的兼容性。
新增容器支持
- Lootr 现在支持箱子、桶和矿车箱子。
- 打开这些容器现在使用与普通 Lootr 宝箱相同的每位玩家战利品流程和防护逻辑。
兼容性改进
- 添加了针对新版 Paper/Bukkit API 行为的兼容层。
- 更新了库存创建和音效播放处理,以更好地兼容现代服务器版本。
- 改进了战利品上下文处理,使战利品表的生成更加可靠。
- 现代化了管理员命令处理,避免使用旧的已弃用查找模式。
构建清单更新
- 在完成这些更改后,插件包已成功验证。
- 该项目现在更符合现代 Paper 兼容性预期,同时保留了现有功能。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
评论 0
登录后参与评分
还没有评论,来抢沙发吧