TribeCraft Wiki · Release 2026.09.8
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-instances protects 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-items controls what happens when granted items do not fit.
  • log-failures enables 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.