loot.yml：战利品池与容器

每局激活时生成容器内容。池决定抽什么，容器决定在哪生成、尺寸多大；多人同时打开同一容器会被互斥，避免重复取物。

池字段

路径	类型 / 范围	说明
pools.<id>.tier	LOW/MEDIUM/HIGH/CORE	应与投放区域危险度对应
entries[].material	Material	原版物品；与 mmoitems 二选一
entries[].mmoitems	TYPE:ID	MMOItems 物品；与 material 二选一
entries[].buff	buff ID，可选	必须存在于 buffs.yml
entries[].footprint	宽x高	网格占用，必须能放入目标容器
entries[].weight	正数	相对权重
entries[].amount-range	min-max	正整数范围，max ≥ min；非堆叠物通常 1-1

容器字段

路径	类型	说明	生效
containers.<id>.zone	zone ID	必须引用 zones.yml	热重载；进行中下一局
pool	pool ID	必须存在	同上
location	world,x,y,z	单一候选点	同上
locations[]	位置列表	多候选点；与 location 二选一	同上
size	宽x高	容器网格尺寸	同上

同一容器的候选位置用于每局选择；位置应在其 zone 内且不能与其他活动容器冲突。尺寸和 footprint 都遵循网格上限（宽最多 4、高最多 6）。

完整默认配置

pools:
  low-supplies:
    tier: LOW
    entries:
      - material: COOKED_BEEF
        footprint: 1x1
        weight: 45
        amount-range: 2-5
      - material: IRON_INGOT
        footprint: 1x1
        weight: 35
        amount-range: 2-6
      - material: SUGAR
        buff: speed
        footprint: 1x1
        weight: 20
        amount-range: 1-1
  medium-supplies:
    tier: MEDIUM
    entries:
      - material: GOLD_INGOT
        footprint: 1x1
        weight: 35
        amount-range: 2-5
      - material: CROSSBOW
        footprint: 2x2
        weight: 20
        amount-range: 1-1
      - material: BLAZE_POWDER
        buff: strength
        footprint: 1x1
        weight: 20
        amount-range: 1-1
      - mmoitems: CONSUMABLE:ARM_SPLINT
        footprint: 1x2
        weight: 25
        amount-range: 1-1
  high-armory:
    tier: HIGH
    entries:
      - material: DIAMOND
        footprint: 1x1
        weight: 30
        amount-range: 1-3
      - material: MAGMA_CREAM
        buff: resistance
        footprint: 1x1
        weight: 25
        amount-range: 1-1
      - mmoitems: CONSUMABLE:HEAD_MEDICINE
        footprint: 1x2
        weight: 25
        amount-range: 1-1
      - mmoitems: CONSUMABLE:LEG_SPLINT
        footprint: 1x2
        weight: 20
        amount-range: 1-1
  core-cache:
    tier: CORE
    entries:
      - material: NETHERITE_SCRAP
        footprint: 1x1
        weight: 25
        amount-range: 1-2
      - material: GHAST_TEAR
        buff: adrenaline
        footprint: 1x1
        weight: 20
        amount-range: 1-1
      - mmoitems: CONSUMABLE:ABDOMEN_KIT
        footprint: 1x2
        weight: 30
        amount-range: 1-1
      - mmoitems: CONSUMABLE:MEDKIT
        footprint: 2x2
        weight: 25
        amount-range: 1-1

containers:
  outskirts-cache:
    zone: low-outskirts
    pool: low-supplies
    location: world,-72,64,-72
    size: 4x3
  ruins-crate:
    zone: medium-ruins
    pool: medium-supplies
    location: world,72,64,-72
    size: 4x3
  factory-armory:
    zone: high-factory
    pool: high-armory
    locations:
      - world,-72,64,72
      - world,-60,64,60
      - world,-84,64,84
    size: 4x4
  core-vault:
    zone: core-center
    pool: core-cache
    locations:
      - world,0,64,0
      - world,8,64,8
      - world,-8,64,-8
    size: 4x5

常见错误与验证

• material 和 mmoitems 不要同时写；MMOItems 类型/ID 必须真实存在。
• footprint 大于容器会造成无法布局；权重不是百分比，无需加总为 100。
• /fkescape admin reload 后必须新开一局验证。逐个坐标打开容器，检查候选点、数量范围、网格占用与 buff/医疗品身份；两名玩家同时打开同一箱只应有一人获准。