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

Raid file reference#

Each raids/<id>.yml describes one raid. The bundled raids/example.yml is intentionally a broad configuration reference.

Identity#

id: example
name: '<primary>Ancient Crypt</primary>'
description: '...'
enabled: true

Keep the ID stable because external files reference it.

entry#

Controls NORMAL vs MINIGAME, minigame persistence/reopen/auto behavior, lobby displays, join NPC/lobby NPC appearance and sign triggers.

participation#

Controls SOLO, PUBLIC, GROUP, COMPETITIVE, group provider, player/group limits, late join, leader-only queue, Ready Join waiting/countdown and vote rules.

loadout#

PLAYER or KIT, with kit: <id> when KIT is selected.

progression#

STANDARD or DISCOVERY; discovery can require any/all/percentage of players to enter a stage area.

players#

Death mode/lives/respawn, disconnect grace/reconnect, wipe behavior and post-finish return/gamemode delays.

environment#

Mode, instance source/loading, origin/lobby/spawn/spectator/exit, bounds, border, environment rules and regeneration.

Environment rules cover PvP, block break/place, explosions, item drop/pickup, hunger, outside damage to raid entities, mob drops/XP and command whitelist/blacklist.

requirements#

List of access requirements: permission, level, item, group size, prior raid completion and money.

availability#

Timezone/day/time-window rules for normal admission.

cooldowns#

Player/group/global cooldown rules with START or COMPLETE trigger.

stages#

Ordered stage definitions containing area, timeout, completion, objective, rewards, actions, waves, spawn groups and optional boss structures.

actions#

Raid lifecycle actions such as start/death/eliminated/reconnect/complete.

display#

Titles, actionbar, sounds, particles, bossbar and scoreboard.

rewards#

Scoring plus participation/failure/completion/first-clear/top-damage/MVP reward lists.

Editing safely#

For simple scalar values use /uraid edit <raid> <path> <value>. For nested lists/maps, copy the bundled examples and edit YAML with the server stopped or with a disciplined reload/validate workflow.