Repair Minigame

MMOItemsRepair includes an optional repair action minigame.

When enabled, clicking the repair button starts a timing segment. The player must click at the right moment to determine the repair result.

Enable

repair:
  minigame:
    enabled: true

When disabled, clicking the confirm button repairs immediately if the item and materials are valid.

Settings

repair:
  minigame:
    enabled: false
    animation-speed: 3
    timeout-ticks: 200
    strong-repair-amount: 50
    weak-repair-amount: 20
    pattern-size: 12
    strong-symbol-count: 2
    weak-symbol-count: 2
    cursor-symbol: "&e🔨"
    strong-symbol: "&a■"
    weak-symbol: "&6■"
    empty-symbol: "&7■"
    subtitle: "&eFocus!"

animation-speed controls pointer movement speed in ticks. Lower values are faster.

timeout-ticks controls how long the player has before the minigame fails.

strong-repair-amount is the repair percent applied when the player hits a strong repair segment.

weak-repair-amount is the repair percent applied when the player hits a weak repair segment.

pattern-size controls the length of the displayed timing bar.

strong-symbol-count controls how many strong repair segments are generated.

weak-symbol-count controls how many weak repair segments are generated.

Result Titles

repair:
  minigame:
    display:
      strong:
        title: "&a✓ Perfect Repair!"
        subtitle: "&7Item repaired {repair}%"
      weak:
        title: "&6✓ Common Repair"
        subtitle: "&7Item repaired {repair}%"
      fail:
        title: "&c✗ Repair Failed!"
        subtitle: "&7Wrong timing, repair failed"
      timeout:
        title: "&c✗ Timeout Failed!"
        subtitle: "&7Response time too long"

Available placeholder:

{repair}

Material Consumption

When the minigame starts, the repair materials are consumed. If the player fails or times out, the repair does not apply.

This makes the minigame a risk based repair mechanic.