Skip to main content
Version: Next (unreleased)

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.

KeyDefaultTypeDescription
schema_version2integerLeague 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_modeSTANDALONEstringSTANDALONE 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"stringName 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""stringTemporary: allow one intentional proxy catalog migration (legacy CRC32 or SHA-256)

General Settings​

KeyDefaultTypeDescription
league_enabledtruebooleanEnable player tiers and tier-gated offers

Registration Requirements​

KeyDefaultTypeDescription
min_trainers2integerMinimum trainer spawners required for registration
min_pokemon12integerMinimum total Pokemon across all trainers
min_average_level30integerMinimum average Pokemon level
min_unique_species8integerMinimum unique Pokemon species
require_leadertruebooleanRequire a leader spawner for registration

Rewards​

KeyDefaultTypeDescription
first_clear_multiplier2.0numberReward multiplier for first clear
creator_dividend0.1numberPercentage of reward given to gym creator (0.0 - 0.5)
max_multiplier5.0numberMaximum total reward multiplier cap

League-Specific Settings​

Tinker League: OP-curated official gyms with fixed rewards Frontier League: Player-created gyms with dynamic scaling

KeyDefaultTypeDescription
tinker_base_reward1000integerFixed LP for Tinker League gyms
frontier_base_reward100integerBase LP for Frontier League gyms
frontier_min_multiplier0.8numberMinimum allowed Frontier multiplier
frontier_max_multiplier1.2numberMaximum allowed Frontier multiplier

Percentile Tier Multipliers (for Frontier gyms)

KeyDefaultTypeDescription
top_tier_multiplier1.2numberTop 20% (percentile 0.8-1.0)
upper_mid_multiplier1.1numberUpper-mid (percentile 0.6-0.8)
middle_multiplier1.0numberMiddle (percentile 0.4-0.6)
lower_mid_multiplier0.9numberLower-mid (percentile 0.2-0.4)
bottom_tier_multiplier0.8numberBottom 20% (percentile 0.0-0.2)

Session Settings​

KeyDefaultTypeDescription
session_timeout_minutes30integerSession expires after this duration
max_lp_per_hour_per_gym500integerAnti-farming: max LP per gym per hour

Cooldowns​

KeyDefaultTypeDescription
cooldown_registered_hours12integerCooldown for registered gyms (hours)
cooldown_sanctioned_hours168integerCooldown for sanctioned gyms (hours)

Anti-Exploit​

KeyDefaultTypeDescription
speed_clear_threshold_seconds60integerCompletions faster than this are blocked
low_quality_threshold_seconds120integerCompletions faster than this get reduced rewards

Teleportation​

KeyDefaultTypeDescription
default_teleport_cost10integerDefault LP cost to teleport to a gym anchor
default_teleport_cooldown_minutes5integerDefault cooldown between teleports (minutes)

Auto-Reset Settings​

KeyDefaultTypeDescription
gym_auto_reset_minutes15integerMinutes after gym completion before auto-reset (0 = disabled)
gym_idle_timeout_minutes30integerMinutes of inactivity before auto-reset (0 = disabled)
auto_reset_on_completiontruebooleanEnable timer after gym completion
auto_reset_on_idletruebooleanEnable timer after inactivity timeout

Teleport Safety Settings​

These settings control how players are handled during gym auto-reset

KeyDefaultTypeDescription
auto_reset_teleport_enabledtruebooleanMaster switch: teleport players before reset (false = no teleport ever)
teleport_require_consenttruebooleanRequire player consent via clickable Yes/No prompt
teleport_consent_timeout_seconds30integerSeconds to wait for consent before the prompt expires
auto_reset_warning_seconds10integerWarning time before teleport/reset (seconds)

Player Progression Tiers​

KeyDefaultTypeDescription
tier_count0integerNumber of progression tiers (0 = disabled, max 10)

Default file​

Download league.yaml

# 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"

Support the Community

Help keep our servers running and support future projects!