• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
GhostLootLite —— 轻量级战利品宝箱插件 | 物品库设计 | 权重抽取 | 独立概率 | 宝箱冷却 | GUI编辑器 | 1.13-1.21+

原创 付费 GhostLootLite —— 轻量级战利品宝箱插件 | 物品库设计 | 权重抽取 | 独立概率 | 宝箱冷却 | GUI编辑器 | 1.13-1.21+ V1.0

请登录后获取
版权类型
原创
插件中文名称
GhostLootLite
插件英文名称
GhostLootLite
原帖地址
支持的核心(服务端)
  1. Spigot
语言支持
中文(简体)
前置组件
适配版本(Java)
  1. 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分钟):
  1. /loot pool create common "普通宝箱" -- 创建奖池
  2. 手持要添加的物品,执行 /loot item create apple_1 -- 保存到物品库
  3. /loot pool add common apple_1 30 1-3 -- 加入奖池(30%概率,每次1-3个)
  4. 对着目标方块执行 /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编辑器奖池编辑器、物品库浏览器
自动绑定世界级 + 方块材质级规则
手动绑定精确到单个方块
迁移工具旧版内联物品 → 物品库
消息自定义所有提示语可自由配置






作者
Ghost8476
查看
207
首次发布
最后更新

评分

0.00 星 0 次评分
后退
顶部 底部