卷轴与小游戏

辅助卷轴

辅助卷轴在强化 GUI 中使用，配置文件为：

contents/scrolls.yml

常见卷轴类型：

类型	行为
SUCCESS_RATE	为本次强化增加成功率。
PROTECTION	保护物品免受碎装等破坏性失败影响。
AMPLIFIER	调整失败惩罚行为，通常带有一定代价。

发放已配置的辅助卷轴：

/mmoupgrade give successscroll <scroll_id> [player] [amount]

当前实现也接受 ratescroll 作为别名。

直接强化卷

直接强化卷配置文件为：

contents/enhancement-scrolls.yml

这类卷轴通过从背包拖放到目标装备上使用。

示例：

scrolls:
  epic_scroll_10:
    type: MMOITEM
    mmo-id: "UPGRADE_SCROLL_10"
    target-level: 10
    allow-downgrade: false
    sound: "UI_TOAST_CHALLENGE_COMPLETE"

发放已配置的直接强化卷：

/mmoupgrade give scroll <scroll_id> [player] [amount]

当前实现也接受 enhancescroll 作为别名。

按住动作小游戏

可选的按住动作小游戏由 minigame.yml 控制。开启后，玩家需要按住潜行键，让指针保持在判定区域内，然后才进入最终强化成功率判定。

重要配置：

配置项	说明
hold-game.enabled	是否启用小游戏。
hold-game.time	游戏总时长，单位秒。
hold-game.difficulty	指针移动难度范围。
hold-game.hold-time-requirements	可能需要累计保持的时间。
hold-game.punishment	不在判定区时的进度扣除倍率。
hold-game.subtitle	资源包字体和图标 UI 设置。
offset-chars	用于精准 UI 定位的偏移字符。

示例：

hold-game:
  enabled: true
  time: 30
  difficulty: "35~60"
  hold-time-requirements:
    - 3
    - 4
  punishment: 0.2
  tip: "<gray>按住 <red><key:key.sneak> <gray>开始"

如果关闭小游戏，插件会直接进入普通成功率判定。