Scrolls and Minigame

Support Scrolls

Support scrolls are used inside the upgrade GUI and are configured in:

contents/scrolls.yml

Typical scroll types:

Type	Behavior
SUCCESS_RATE	Adds success rate to the current attempt.
PROTECTION	Protects the item from destructive failure behavior.
AMPLIFIER	Changes failure penalty behavior, usually with a tradeoff.

Give a configured support scroll with:

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

The command also accepts ratescroll as an alias in the current implementation.

Direct Enhancement Scrolls

Direct enhancement scrolls are configured in:

contents/enhancement-scrolls.yml

They are used by dragging the scroll onto a target item in the player's inventory.

Example:

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

Give a configured direct enhancement scroll with:

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

The command also accepts enhancescroll as an alias in the current implementation.

Hold Minigame

The optional hold-action minigame is controlled by minigame.yml. When enabled, players must hold the sneak key to keep the pointer in the judgment area before the final upgrade roll.

Important options:

Option	Description
hold-game.enabled	Enables or disables the minigame.
hold-game.time	Total game time in seconds.
hold-game.difficulty	Difficulty range for pointer movement.
hold-game.hold-time-requirements	Possible required hold durations.
hold-game.punishment	Progress loss multiplier when outside the judgment area.
hold-game.subtitle	Resource-pack font and icon settings for the UI.
offset-chars	Offset font characters used for precise UI positioning.

Example:

hold-game:
  enabled: true
  time: 30
  difficulty: "35~60"
  hold-time-requirements:
    - 3
    - 4
  punishment: 0.2
  tip: "<gray>Hold <red><key:key.sneak> <gray>to start"

If the minigame is disabled, the plugin proceeds directly to the normal success-rate roll.