conditions.yml

conditions.yml applies global requirements to EXP gains. Combine it with anti-abuse modules to fully control when players receive rewards.

Core settings

Path	Default	Purpose
`conditions.<id>.enabled`	`false`	Toggle the condition block.
`conditions.<id>.cooldown`	`0`	Seconds between EXP grants tracked by the block.
`conditions.<id>.events`	List	EXP event identifiers covered by the condition.

Field	Description
`world-settings.enabled`	Enable world filtering.
`world-settings.whitelist`	Interpret `worlds` as whitelist (`true`) or blacklist (`false`).
`world-settings.worlds`	Names of allowed or blocked worlds.
`region-settings.enabled`	Use WorldGuard regions for filtering.
`region-settings.whitelist`	Treat the region list as whitelist (`true`) or blacklist (`false`).
`region-settings.regions`	Region IDs checked against players.

Field	Description
`time-settings.minecraft.enabled`	Limit EXP to certain Minecraft day phases (`DAY`, `NIGHT`, etc.).
`time-settings.minecraft.allow`	List of allowed phases.
`time-settings.real-time.enabled`	Restrict EXP by server clock time.
`time-settings.real-time.start` / `end`	Hours in 24h format.
`time-settings.real-time.time-zone`	Time zone used for the check.

Field	Description
`permission` / `group`	Require a specific permission node or custom group tag.
`player-states.afk-check`	Seconds before AFK players stop earning EXP.
`player-states.game-modes`	Allowed game modes; empty list allows all.
`player-states.min-health` / `min-hunger`	Minimum health or hunger before EXP is granted.

Field	Description
`economy-settings.enabled`	Require a Vault balance check.
`economy-settings.min-balance`	Minimum balance needed to earn EXP.
`economy-settings.cost-per-exp`	Cost charged per EXP point.
`level-settings.enabled`	Stop awarding EXP at or above a level.
`level-settings.max-level`	Hard cap when scaling is disabled.
`level-settings.scaling.enabled`	Reduce EXP instead of hard-stopping it.
`level-settings.scaling.start-level`	Level where scaling begins.
`level-settings.scaling.reduction-factor`	Multiplier applied at the max level.

Field	Description
`weather-settings.enabled`	Apply multipliers based on weather.
`weather-settings.weathers`	Entries formatted as `CONDITION:multiplier`.
`season-settings.enabled`	Use seasonal multipliers from supported plugins.
`season-settings.seasons`	Entries formatted as `SEASON:multiplier`.

Design tip

Use conditions for broad rules (time windows, AFK detection) and anti-abuse modules for targeted cooldowns or EXP caps.