- 版权类型
- 原创
- 插件中文名称
- GhostLootLite
- 插件英文名称
- GhostLootLite
- 原帖地址
- 无
- 支持的核心(服务端)
- Spigot
- 语言支持
- 中文(简体)
- 前置组件
- 无
- 适配版本(Java)
- 1.20
插件简介
GhostLootLite 是一款面向 生存服 / RPG服 / 模组服 / 跑图探索服 的轻量级战利品宝箱插件。
你可以把 任意方块(原版箱子、木桶、投掷器,甚至模组新增的方块)绑定到某个「奖池」,玩家右键即可随机获得战利品。
- 物品库复用:一次保存,多个奖池引用,改一处全局生效
- 双抽取模式:权重抽取(扭蛋式)/ 独立概率(掉落表式)
- 可调抽取数量:每个奖池可设置每次开出 1-N 件物品
- 模组物品兼容:支持绑定模组方块、支持模组物品作为奖励,NBT完整保留
- 随机价格体系:每个物品可设置价格区间,开箱自动附加到物品Lore
- 冷却系统:全局/个人 + 独立计时/整点同步刷新
- 状态持久化:已搜刮状态、剩余物品、冷却记录均持久保存
- 全GUI可视化编辑:奖池编辑器 + 物品库浏览器,无需手写YAML
- 自动绑定规则:一条规则让某世界某材质自动使用指定奖池
核心特色
1)物品库设计:一次保存,多处复用
物品先保存到物品库(items.yml),奖池只引用物品ID。- 一个物品可被多个奖池同时引用
- 修改物品后,所有奖池同步生效,无需逐个修改
- 配套GUI浏览器,支持增删改查和快速发放
- 支持一键迁移:将旧版内联物品导入物品库
2)双抽取模式,适配不同玩法
WEIGHTED 权重模式(扭蛋/开箱式):- 每个物品拥有独立权重值,按权重比例抽取
- 支持 repeat:false 不可重复项(抽中后从候选池移除)
- 适合"每个宝箱只能开出少数几件东西"的场景
INDEPENDENT 独立概率(随机掉落表式):
- 每个物品独立按百分比 chance 判定是否掉落
- 所有物品同时参与判定,互相独立
- 适合"宝箱里可能同时掉出多件物品"的场景
3)可调抽取数量:每次开箱出几件由你定
每个奖池可独立设置 min-max 范围,每次开启时在该范围内随机决定实际产出数量。- 设置 1-1:每次必出 1 件(精准控制)
- 设置 3-5:每次随机出 3~5 件(惊喜感)
- 设置 1-10:小概率爆大量(适用于节日活动宝箱)
4)模组物品完整兼容
- 模组方块绑定:支持将模组新增的方块类型绑定到奖池,支持任何服务端已加载的方块材质
- 模组物品掉落:物品库支持存储任意模组物品(NBT数据完整保留,含属性标签、自定义名称、Lore等)
- 无需任何前置插件,原版/模组服均可直接使用
5)随机价格体系:物品自带价值标签
每个物品库条目可设置价格区间,开箱后系统自动将随机生成的价格附加到物品Lore(格式可自定义):
代码:
diamond_sword:
price:
min: 1000
max: 5000
显示效果:
- &7稀有掉落
- &7价格: &e2680
方便接入经济系统、玩家交易、市场定价参考。
6)冷却系统:全局/个人 + 独立/同步
| 作用域 | 说明 | 重置模式 | 说明 |
| GLOBAL | 全服共享一个冷却 | INDIVIDUAL | 从玩家打开时间开始计时 |
| PLAYER | 每个玩家独立冷却 | SYNCED | 按固定周期整点刷新(如每小时重置) |
7)宝箱状态持久化:已搜刮 + 内容保存
- 玩家打开后,宝箱标记为"已搜刮",标题变为"已搜刮"
- 剩余物品内容自动保存到文件
- 服务器重启后状态保持,不会出现"刷空了又刷新"的情况
8)全GUI可视化编辑:奖池/物品库
无需手写YAML,直接图形界面操作:9)自动绑定规则:一条规则全局生效
代码:
/loot autobind add * CHEST common -- 所有世界的所有箱子
/loot autobind add spawn mod_block rare -- 仅spawn世界绑定某模组方块
/loot autobind add world_nether BARREL boss -- 仅地狱世界的木桶
支持 * 表示所有世界,支持任何服务端可识别的方块类型。
插件预览
(- 奖池编辑器界面
- 物品库浏览器界面
- 玩家开宝箱效果
安装指南
前置要求:Spigot / Paper / Purpur / Folia 服务端 + Java 17+
快速上手(3分钟):
- /loot pool create common "普通宝箱" -- 创建奖池
- 手持要添加的物品,执行 /loot item create apple_1 -- 保存到物品库
- /loot pool add common apple_1 30 1-3 -- 加入奖池(30%概率,每次1-3个)
- 对着目标方块执行 /loot bind common -- 绑定完成
命令大全
主命令 /loot
| 命令 | 说明 |
| /loot help | 显示帮助菜单 |
| /loot reload | 重载所有配置和奖池 |
| /loot refresh all | 清空所有冷却记录 |
| /loot refresh [pool] | 清空指定奖池的冷却 |
| /loot bind [pool] | 绑定当前指向的方块到奖池 |
| /loot unbind | 解绑当前指向的方块 |
| /loot edit [pool] | 打开奖池编辑器 GUI |
| /loot autobind add [world|*] [material] [pool] | 添加自动绑定规则 |
| /loot autobind remove [world|*] [material] | 移除自动绑定规则 |
奖池管理 /loot pool
| 命令 | 说明 |
| /loot pool create [name] [display] | 创建新奖池,可选设置显示名 |
| /loot pool add [pool] [itemId] [chance] [amount] [repeat] | 添加物品到奖池,设置概率、数量、可重复 |
| /loot pool mode [pool] WEIGHTED|INDEPENDENT | 设置抽取模式 |
| /loot pool rolls [pool] [min] [max] | 设置每次开启的抽取次数范围 |
| /loot pool cooldown [pool] [seconds] GLOBAL|PLAYER INDIVIDUAL|SYNCED | 配置冷却:秒数 / 作用域 / 重置模式 |
| /loot pool list | 列出服务器上所有奖池 |
物品库管理 /loot item
| 命令 | 说明 |
| /loot item create [id] | 将手中物品保存到物品库 |
| /loot item update [id] | 用手中物品更新已有的库物品 |
| /loot item price [id] [min] [max] | 设置库物品的价格区间 |
| /loot item delete [id] | 删除库物品 |
| /loot item give [id] [player] [amount] | 给指定玩家物品(可指定数量) |
| /loot item gui | 打开物品库浏览器 GUI |
| /loot item preview [id] | 在单格 GUI 中预览库物品 |
| /loot item importpool [pool] | 将奖池内联物品迁移到物品库 |
配置示例
奖池配置
代码:
id: rare_chest
displayName: "&6稀有宝箱"
mode: WEIGHTED
rolls:
min: 2
max: 5
cooldown:
scope: PLAYER
reset: SYNCED
seconds: 3600
items:
entry_1:
library: diamond_sword
chance: 10.0
amount: "1-1"
repeat: false
物品库配置
代码:
diamond_sword:
price:
min: 1000
max: 5000
item:
type: DIAMOND_SWORD
meta:
display-name: "&b钻石剑"
lore:
- "&7稀有掉落"
功能总览
| 功能 | 说明 |
| 物品库系统 | 集中管理,GUI浏览,支持复用 |
| 双抽取模式 | WEIGHTED权重 / INDEPENDENT独立概率 |
| 可调抽取数量 | min-max 范围随机,支持1-N件 |
| 模组物品兼容 | 模组方块绑定 + 模组物品掉落,NBT完整保留 |
| 随机价格体系 | 价格区间 + 自定义Lore格式 |
| 冷却系统 | GLOBAL/PLAYER × INDIVIDUAL/SYNCED |
| 状态持久化 | 搜刮状态、剩余物品、冷却记录 |
| GUI编辑器 | 奖池编辑器、物品库浏览器 |
| 自动绑定 | 世界级 + 方块材质级规则 |
| 手动绑定 | 精确到单个方块 |
| 迁移工具 | 旧版内联物品 → 物品库 |
| 消息自定义 | 所有提示语可自由配置 |