掉落方案目录

plugins/DungeonMaster/掉落方案/ 用来放全局掉落方案。多个副本可以共用同一套掉落池，不用每个本都再抄一遍。

接入方式

副本里在 奖励.yml 写：

掉落方案: 示例掉落方案

当前源码里，全局掉落方案和副本自己写的掉落池可以同时生效，不冲突。

推荐结构

ID: 示例掉落方案

掉落池:
  通常掉落:
    抽取次数: 2
    不重复: true
    品质: 普通
    物品列表:
      - 物品ID: DIAMOND
        数量: 1
        权重: 10
        显示名称: '&b钻石'
      - 物品ID: 空
        权重: 20

  稀有掉落:
    抽取次数: 1
    条件: "@dungeon.var.难度 != '简单'"
    品质: 传说
    物品列表:
      - 物品ID: NETHER_STAR
        数量: 1
        权重: 1
    保底:
      计数上限: 30
      保底物品: NETHER_STAR
      软保底起始: 20
      软保底增幅: 2.0

品质:
  普通:
    显示名称: '&f普通'
    颜色: WHITE
  传说:
    显示名称: '&6传说'
    颜色: GOLD

你真正会用到的字段

方案级

字段	作用
ID	方案 ID，副本靠它引用
掉落池	真正的掉落内容
品质 / 品质定义	掉落品质分组，两种写法源码都认
掉落特效	按品质播放特效，属于进阶功能

掉落池级

字段	作用
抽取次数	这个池一次抽几次
不重复	同一次抽取里不出重复条目
条件	整个池是否开放
品质	把这个池归到哪个品质页签
物品列表	掉落条目列表
保底	硬保底和软保底

条目级

字段	作用
物品ID	原版物品或第三方物品 ID
数量	固定数量或区间，比如 1、'2-5'
权重	权重越大越容易抽中
显示名称	预览和提示里显示的名字
条件	条目级条件，不满足就不参与抽取

物品 ID 写法

源码当前支持这些格式：

• DIAMOND
• mc:DIAMOND
• ni:自定义物品
• mm4:掉落名
• mm5:掉落名

空奖也支持：

• 空
• none
• empty
• 空奖

保底机制

• 计数上限 到了以后，直接必出 保底物品
• 软保底起始 之后，每次没出都会继续抬高保底物品权重
• 保底计数会走持久化，不是重启就没

和副本奖励.yml 的关系

这套目录适合放“整服共用的掉落逻辑”。

副本里的 奖励.yml 仍然适合管这些东西：

• 固定金币、经验、物品
• 分配模式
• 奖励脚本
• 少量只属于这个副本的临时掉落池

当前版本要注意的一点

实际发奖时，全局掉落方案是生效的。

但按现在源码，/dm preview 打开的预览界面主要读的是副本自己 奖励.yml 里的内容，全局掉落方案不一定会完整带进去。做服时别把预览界面当成全量校验结果。