Wiki Release: 2026.09.8 · UltimateRaids: 0.12.0 · Documentation branch: 1
Global configuration and provider priorities#
UltimateRaids keeps global behavior in config.yml and provider priority in modules.yml. Individual raid gameplay belongs in raids/*.yml.
config.yml#
Colors and tag#
Colors.* defines MiniMessage color aliases used throughout plugin messages. Config.tag is the default URaids message prefix.
Language/timezone/debug#
Config:
language: EN
timezone: 'America/Sao_Paulo'
debug: false
The global timezone is also the fallback used by scheduling/availability logic when a local definition does not provide one.
Raid runtime#
raid:
max-active-instances: 64
keep-definition-snapshot: true
stop-active-on-disable: true
instance-debug: false
wave-debug: false
recover-stale-instances: true
recover-legacy-instance-prefixes: true
max-active-instancesprotects the server from unbounded concurrent runtimes.- definition snapshots keep runtime behavior stable while files are edited.
- stop-on-disable controls what happens when a raid definition is disabled while active.
- instance/wave debug are targeted diagnostic switches.
- stale-instance recovery handles disposable worlds left by crashes/unsafe reloads.
Recovery#
Config.recovery.enabled controls startup/reload recovery for pending loadouts/final rewards and stale runtime state.
Scheduler#
Config.scheduler.recovery-window-seconds controls scheduler recovery tolerance around restart.
Party#
Config.party.max-members limits the built-in temporary raid party size.
Rewards#
drop-overflow-itemscontrols what happens when granted items do not fit.log-failuresenables reward failure logging.
Component folders#
Config.extensions.folder and Config.addons.folder select where optional JAR extensions/addons are loaded.
modules.yml#
AUTO provider resolution walks category preferences from top to bottom. Current defaults:
Item#
NEXO, ITEMSADDER, CRAFTENGINE, ORAXEN, MMOITEMS, DEFAULT
Entity#
MYTHICMOBS, DEFAULT
Group#
UCLANS, INTERNAL
Economy#
VAULT
Schematic#
FASTASYNCWORLDEDIT, WORLDEDIT, DEFAULT
Border#
PACKETEVENTS, ENTITYWIZARD, PROTOCOLLIB, DEFAULT
Visual#
PACKETEVENTS, PROTOCOLLIB
An ID in this list is only a preference. The corresponding provider must actually be registered by the core or an installed extension.