Wiki Release: 2026.09.8 · UltimateRaids: 0.12.0 · Documentation branch: 1

Storage, restoration and recovery#

UltimateRaids persists more than static raid files because raids can temporarily hold inventories, create disposable worlds and owe final rewards to players who are offline.

Static definitions#

raids/
kits/
loot/
skills/
schedulers/
instances/templates/
instances/schematics/

KIT inventory escrow#

Before applying a KIT loadout, the plugin persists the original player inventory/state and marks it pending. The escrow is owned by the lobby/instance and is restored through normal leave/finish/fail/stop flow.

On recovery, pending online loadouts can be restored instead of being lost after a crash/reload.

Pending final rewards#

Final rewards can be persisted for players who could not receive them immediately. Recovery reloads pending final reward state and grants what can be delivered to online players.

Stale instance worlds#

INSTANCE worlds can be marked and scanned after startup. With recovery enabled, stale runtime worlds left after a crash can be removed safely instead of accumulating indefinitely.

Runtime cleanup delay#

INSTANCE deletion may be asynchronous. A raid can temporarily be in FINISHING/RESETTING while cleanup is still pending; signs/lobbies reflect these states.

Administration rule#

Do not delete recovery files or runtime instance folders just because a player reports an inventory/reward problem. First use status/debug and console recovery output to determine whether the plugin still owns a pending restoration.