league.yaml
File: config/brecher_trainers/league.yaml — generated from the defaults the mod writes when the file does not exist yet.
Brecher Trainers - League System Configuration
Edit this file to customize the league system behavior.
Invalid reloads are rejected and the currently installed snapshot is retained.
| Key | Default | Type | Description |
|---|---|---|---|
schema_version | 2 | integer | League configuration schema version. Current releases write 2; an unversioned file is migrated from schema 1, keeping a league.yaml.schema-1.bak backup. Allowed: a positive whole number; unknown future schemas are refused. |
deployment_mode | STANDALONE | string | STANDALONE for a single server. On a proxy network, exactly one backend is PROXY_AUTHORITY (it owns and changes gyms) and every other backend is PROXY_SATELLITE. Cannot be changed by a live reload. Allowed: STANDALONE, PROXY_AUTHORITY or PROXY_SATELLITE. |
catalog_identity | "default" | string | Name of the tier catalog. It is part of the catalog hash shown by /league info and must be identical on every proxy backend. Allowed: 1–64 characters; must not be "default" in a proxy mode. |
accepted_previous_catalog_hash | "" | string | Temporary: allow one intentional proxy catalog migration (legacy CRC32 or SHA-256) |
General Settings
| Key | Default | Type | Description |
|---|---|---|---|
league_enabled | true | boolean | Enable player tiers and tier-gated offers |
Registration Requirements
| Key | Default | Type | Description |
|---|---|---|---|
min_trainers | 2 | integer | Minimum trainer spawners required for registration |
min_pokemon | 12 | integer | Minimum total Pokemon across all trainers |
min_average_level | 30 | integer | Minimum average Pokemon level |
min_unique_species | 8 | integer | Minimum unique Pokemon species |
require_leader | true | boolean | Require a leader spawner for registration |
Rewards
| Key | Default | Type | Description |
|---|---|---|---|
first_clear_multiplier | 2.0 | number | Reward multiplier for first clear |
creator_dividend | 0.1 | number | Percentage of reward given to gym creator (0.0 - 0.5) |
max_multiplier | 5.0 | number | Maximum total reward multiplier cap |
League-Specific Settings
Tinker League: OP-curated official gyms with fixed rewards Frontier League: Player-created gyms with dynamic scaling
| Key | Default | Type | Description |
|---|---|---|---|
tinker_base_reward | 1000 | integer | Fixed LP for Tinker League gyms |
frontier_base_reward | 100 | integer | Base LP for Frontier League gyms |
frontier_min_multiplier | 0.8 | number | Minimum allowed Frontier multiplier |
frontier_max_multiplier | 1.2 | number | Maximum allowed Frontier multiplier |
Percentile Tier Multipliers (for Frontier gyms)
| Key | Default | Type | Description |
|---|---|---|---|
top_tier_multiplier | 1.2 | number | Top 20% (percentile 0.8-1.0) |
upper_mid_multiplier | 1.1 | number | Upper-mid (percentile 0.6-0.8) |
middle_multiplier | 1.0 | number | Middle (percentile 0.4-0.6) |
lower_mid_multiplier | 0.9 | number | Lower-mid (percentile 0.2-0.4) |
bottom_tier_multiplier | 0.8 | number | Bottom 20% (percentile 0.0-0.2) |
Session Settings
| Key | Default | Type | Description |
|---|---|---|---|
session_timeout_minutes | 30 | integer | Session expires after this duration |
max_lp_per_hour_per_gym | 500 | integer | Anti-farming: max LP per gym per hour |
Cooldowns
| Key | Default | Type | Description |
|---|---|---|---|
cooldown_registered_hours | 12 | integer | Cooldown for registered gyms (hours) |
cooldown_sanctioned_hours | 168 | integer | Cooldown for sanctioned gyms (hours) |
Anti-Exploit
| Key | Default | Type | Description |
|---|---|---|---|
speed_clear_threshold_seconds | 60 | integer | Completions faster than this are blocked |
low_quality_threshold_seconds | 120 | integer | Completions faster than this get reduced rewards |
Teleportation
| Key | Default | Type | Description |
|---|---|---|---|
default_teleport_cost | 10 | integer | Default LP cost to teleport to a gym anchor |
default_teleport_cooldown_minutes | 5 | integer | Default cooldown between teleports (minutes) |
Auto-Reset Settings
| Key | Default | Type | Description |
|---|---|---|---|
gym_auto_reset_minutes | 15 | integer | Minutes after gym completion before auto-reset (0 = disabled) |
gym_idle_timeout_minutes | 30 | integer | Minutes of inactivity before auto-reset (0 = disabled) |
auto_reset_on_completion | true | boolean | Enable timer after gym completion |
auto_reset_on_idle | true | boolean | Enable timer after inactivity timeout |
Teleport Safety Settings
These settings control how players are handled during gym auto-reset
| Key | Default | Type | Description |
|---|---|---|---|
auto_reset_teleport_enabled | true | boolean | Master switch: teleport players before reset (false = no teleport ever) |
teleport_require_consent | true | boolean | Require player consent via clickable Yes/No prompt |
teleport_consent_timeout_seconds | 30 | integer | Seconds to wait for consent before the prompt expires |
auto_reset_warning_seconds | 10 | integer | Warning time before teleport/reset (seconds) |
Player Progression Tiers
| Key | Default | Type | Description |
|---|---|---|---|
tier_count | 0 | integer | Number of progression tiers (0 = disabled, max 10) |
Default file
# Brecher Trainers - League System Configuration
# Edit this file to customize the league system behavior.
# Invalid reloads are rejected and the currently installed snapshot is retained.
schema_version: 2
deployment_mode: STANDALONE
catalog_identity: "default"
accepted_previous_catalog_hash: "" # Temporary: allow one intentional proxy catalog migration (legacy CRC32 or SHA-256)
# ===================
# General Settings
# ===================
league_enabled: true # Enable player tiers and tier-gated offers
# ===================
# Registration Requirements
# ===================
min_trainers: 2 # Minimum trainer spawners required for registration
min_pokemon: 12 # Minimum total Pokemon across all trainers
min_average_level: 30 # Minimum average Pokemon level
min_unique_species: 8 # Minimum unique Pokemon species
require_leader: true # Require a leader spawner for registration
# ===================
# Rewards
# ===================
first_clear_multiplier: 2.0 # Reward multiplier for first clear
creator_dividend: 0.1 # Percentage of reward given to gym creator (0.0 - 0.5)
max_multiplier: 5.0 # Maximum total reward multiplier cap
# ===================
# League-Specific Settings
# ===================
# Tinker League: OP-curated official gyms with fixed rewards
# Frontier League: Player-created gyms with dynamic scaling
tinker_base_reward: 1000 # Fixed LP for Tinker League gyms
frontier_base_reward: 100 # Base LP for Frontier League gyms
frontier_min_multiplier: 0.8 # Minimum allowed Frontier multiplier
frontier_max_multiplier: 1.2 # Maximum allowed Frontier multiplier
# Percentile Tier Multipliers (for Frontier gyms)
top_tier_multiplier: 1.2 # Top 20% (percentile 0.8-1.0)
upper_mid_multiplier: 1.1 # Upper-mid (percentile 0.6-0.8)
middle_multiplier: 1.0 # Middle (percentile 0.4-0.6)
lower_mid_multiplier: 0.9 # Lower-mid (percentile 0.2-0.4)
bottom_tier_multiplier: 0.8 # Bottom 20% (percentile 0.0-0.2)
# ===================
# Session Settings
# ===================
session_timeout_minutes: 30 # Session expires after this duration
max_lp_per_hour_per_gym: 500 # Anti-farming: max LP per gym per hour
# Active sessions always settle before logout persistence.
# ===================
# Cooldowns
# ===================
cooldown_registered_hours: 12 # Cooldown for registered gyms (hours)
cooldown_sanctioned_hours: 168 # Cooldown for sanctioned gyms (hours)
# ===================
# Anti-Exploit
# ===================
speed_clear_threshold_seconds: 60 # Completions faster than this are blocked
low_quality_threshold_seconds: 120 # Completions faster than this get reduced rewards
# ===================
# Teleportation
# ===================
default_teleport_cost: 10 # Default LP cost to teleport to a gym anchor
default_teleport_cooldown_minutes: 5 # Default cooldown between teleports (minutes)
# ===================
# Auto-Reset Settings
# ===================
gym_auto_reset_minutes: 15 # Minutes after gym completion before auto-reset (0 = disabled)
gym_idle_timeout_minutes: 30 # Minutes of inactivity before auto-reset (0 = disabled)
auto_reset_on_completion: true # Enable timer after gym completion
auto_reset_on_idle: true # Enable timer after inactivity timeout
# ===================
# Teleport Safety Settings
# ===================
# These settings control how players are handled during gym auto-reset
auto_reset_teleport_enabled: true # Master switch: teleport players before reset (false = no teleport ever)
teleport_require_consent: true # Require player consent via clickable Yes/No prompt
teleport_consent_timeout_seconds: 30 # Seconds to wait for consent before the prompt expires
auto_reset_warning_seconds: 10 # Warning time before teleport/reset (seconds)
# ===================
# Player Progression Tiers
# ===================
tier_count: 0 # Number of progression tiers (0 = disabled, max 10)
# Example (uncomment and adjust to enable tiers):
# tier_0_min_earned: 500
# tier_0_min_unique_clears: 3
# tier_0_min_wins: 5
# tier_0_name: "Bronze"