这页用于 按场景快速定位 HNWarehouse 的配置块。

---

想改默认投递目标仓库

看：config.yml

capture:
  manual-default-warehouse: main
  reward-default-warehouse: reward
  auto-collect-default-warehouse: main

---

想开关某种来源

看：config.yml

capture:
  manual-enabled: true
  reward-enabled: true
  auto-collect-enabled: false

---

想改自动保存频率

看：config.yml

storage:
  autosave-interval-seconds: 60

---

想减少短时间重复查看离线仓库的数据库读取

看：config.yml

storage:
  summary-cache-ttl-seconds: 3

说明：

• 单位秒
• 仅影响离线玩家摘要查询
• 写入后会主动失效缓存
• 设为 0 可理解为关闭这类缓存

---

想改仓库锁定视图的标题、按钮、材质或提示文案

看：config.yml

gui:
  access-display:
    purchase-required:
      action-button-title: "点击购买"
      action-button-hint: "左键尝试购买该仓库"
      action-material: "EMERALD_BLOCK"

    unlock-required:
      action-button-title: "点击解锁"
      action-button-hint: "左键尝试解锁该仓库"
      action-material: "TRIPWIRE_HOOK"

    restricted:
      locked-prompt: "当前无法访问该目标"
      visual-hint: "红色屏障 = 当前不可处理"

适合：

• 区分“未购买”和“未解锁”的视觉语义
• 调整锁定仓库的材质、颜色与按钮提示
• 给玩家更明确的操作引导

---

想让某个仓库锁定时仍然可见

看：warehouses/<id>.yml

access:
  visible-when-locked: true

---

想让某个权限无视仓库限制

看：warehouses/<id>.yml

access:
  bypass-permission: hnwarehouse.access.bypass

---

想做一次性购买

看：warehouses/<id>.yml

access:
  purchase:
    enabled: true
    requirements:
      - type: economy
        currency: gold
        amount: 500

---

想做一次性解锁

看：warehouses/<id>.yml

access:
  unlock:
    enabled: true
    requirements:
      - type: vanilla-item
        material: DIAMOND
        amount: 16

---

想做每次访问都检查的门槛

看：warehouses/<id>.yml

access:
  use-requirements:
    - type: permission
      permission: group.vip

---

想限制某页只接收 reward 来源

看：warehouses/<id>.yml

pages:
  page-1:
    allowed-sources:
      - reward

---

想让某页参与自动收纳

同时看两处：

全局开关

capture:
  auto-collect-enabled: true

页面开关与来源

pages:
  page-1:
    auto-collect: true
    allowed-sources:
      - auto-collect

---

想提高某页投递优先级

看：warehouses/<id>.yml

pages:
  page-1:
    priority: 200

数值越高，越先尝试投递。

---

想给页面加扩容条件

看：warehouses/<id>.yml

pages:
  page-2:
    expansion:
      enabled: true
      requirements:
        - type: placeholder
          placeholder: "%player_level%"
          operator: ">="
          value: "40"
          as: number

---

想让奖励仓库只收指定物品

看：item-admission.whitelist

item-admission:
  whitelist:
    - material: DIAMOND
    - identity:
        item-type: warehouse_token

---

想屏蔽某类物品进入仓库

看：item-admission.blacklist

item-admission:
  blacklist:
    - name-contains: 测试禁用
    - pdc:
        "hnwarehouse:forbidden": "true"

---

想使用不同类型条件

统一看这些 requirements 列表中的 type：

• economy
• vanilla-item
• core-item
• permission
• placeholder

可出现的位置：

• access.purchase.requirements
• access.use-requirements
• access.unlock.requirements
• pages.<page>.expansion.requirements

---

推荐搭配阅读

• 详细解释：看 配置说明
• 命令排查：看 命令说明
• 运维排查：看 数据存储与运维