Skip to main content

📜 卷轴系统

在 MMOItemsUpgrade 中，卷轴不仅是消耗品，更是平衡强化风险的核心。

📄 辅助卷轴配置案例 (scrolls.yml)​

你可以创建多个等级的辅助道具：

# 位于 contents/scrolls.yml
scrolls:
  # +5% 成功率的小卷轴
  basic_scroll:
    mmoitem: "CONSUMABLE:BASIC_SCROLL"
    type: SUCCESS_RATE
    bonus: 0.05
    
  # 10%~20% 随机加成的大卷轴
  mystery_scroll:
    mmoitem: "CONSUMABLE:MYSTERY_SCROLL"
    type: SUCCESS_RATE
    bonus-min: 0.10
    bonus-max: 0.20
    
  # 高级保护券：防止强化失败损坏装备
  holy_protection:
    mmoitem: "CONSUMABLE:HOLY_PROTECTION"
    type: PROTECTION
    
  # 强化放大器：保级但降成功率
  expert_amplifier:
    mmoitem: "CONSUMABLE:EXPERT_AMPLIFIER"
    type: AMPLIFIER
    success-penalty: 0.15  # 降低 15% 成功率作为保级的代币

💎 直接强化卷 (背包拖放)​

配置文件：contents/enhancement-scrolls.yml。 这是一种可以从背包直接拖放到装备上的特殊物品，其逻辑是“强制设为指定等级”。

配置案例​

# 位于 contents/enhancement-scrolls.yml
scrolls:
  # +7 强化卷：新手福利
  starter_plus_7:
    type: MMOITEM
    mmo-type: "CONSUMABLE"
    mmo-id: "STARTER_UPGRADE_7"
    target-level: 7
    allow-downgrade: false # 若武器已是 +8，使用此卷轴不会触发降级
    sound: "ENTITY_PLAYER_LEVELUP"
    particle: "VILLAGER_HAPPY"
    
  # +10 必成神卷
  godly_plus_10:
    type: MMOITEM
    mmo-type: "CONSUMABLE"
    mmo-id: "GODLY_UPGRADE_10"
    target-level: 10
    consume: true          # 使用后消耗卷轴
    sound: "UI_TOAST_CHALLENGE_COMPLETE"
    particle: "TOTEM_OF_UNDYING"

[!CAUTION] 直接强化卷会直接重置装备等级至 target-level，请务必设置 allow-downgrade: false 以防玩家误操作导致高等级装备变低。