StellarGyms

StellarGyms is a server-authoritative Pixelmon gym system where players compete to become the named leader of persistent, AI-controlled gyms.

When a challenger defeats a gym, the exact party they entered with is preserved and becomes the gym’s next defending team. Future challengers battle an AI-controlled copy of that team, while the winning player is displayed as the current gym leader.

Captured teams preserve their important Pixelmon data, including species, forms, palettes, shiny state, levels, IVs, EVs, natures, abilities, moves, PP, held items, ribbons, friendship, Poké Balls, Dynamax and Gigantamax data, and other persistent Pokémon properties.

Features

Persistent player-controlled gym succession
AI-controlled copies of winning teams
Configurable initial gym teams
Gym leaders, challengers, rivalries, and takeover history
Leaderboards and player profiles
Current and best win streaks
Defense streaks and milestone rewards
Flawless victory tracking
Featured gym rotations
Daily multi-gym circuits
Permanent badge cabinet progression
Optional physical badge rewards
Gym bounties that grow from eligible challenger losses
Offline reward delivery and persistent notifications
Configurable NPCs for each gym
Economy, item, command, experience, message, and broadcast rewards
Vanilla chest-menu fallback
Optional animated client interface
Audit logging and persistent server data
Brigadier command suggestions
NeoForge permission support

Gym Succession

Each gym begins with an administrator-defined team.

When a player defeats the initial team:

The player becomes the named gym leader.
The party they entered with becomes the new defending team.
The configured initial-win reward is granted.

When another player defeats a player-derived team:

The challenger receives the configured conquest reward.
Any accumulated gym bounty is included.
The challenger becomes the new named leader.
Their entering party replaces the previous defending team.

The original administrator-defined team remains stored as the gym’s reset baseline.

Runtime defender Pokémon are copied and healed before battle. They receive temporary internal UUIDs so they cannot conflict with the real Pokémon owned by the leader.

Bounties and Anti-Farming

Player-controlled gyms can accumulate a bounty when challengers lose against them.

Repeated losses by the same challenger only increase the bounty after the configured cooldown has expired. This prevents players from repeatedly losing on purpose to inflate gym rewards.

Initial administrator teams do not accumulate bounties.

Progression

Featured Gyms

One valid gym is selected as the featured gym for each rotation.

A player’s first victory against the featured gym during that rotation grants the configured featured bonus. The rotation is stored persistently and cannot be rerolled by reconnecting.

Daily Circuit

Players can complete a daily circuit by defeating the configured number of different usable gyms.

Circuit progress:

Advances only when different gyms are defeated
Rewards the player once per completed circuit
Resets automatically at midnight UTC
Persists across restarts

Badge Cabinet

A player’s first clear of each gym permanently adds that gym to their badge collection.

Servers may optionally grant a physical badge item alongside the persistent badge entry.

Player Statistics

StellarGyms tracks:

Gym victories
Defense victories
Current challenger streak
Best challenger streak
Current defense streak
Best defense streak
Flawless victories
Featured gym victories
Gym-specific rivalry statistics
Badge ownership
Recent public battle activity
Leaderboard score and rank

Rewards

Each gym can define separate reward bundles for:

Initial team victories
Player-team conquests
Defender milestones
Featured gym victories
Daily circuit completion
First-time badge clears

Reward bundles can include:

PokéDollars or Vault currency
Player experience
Minecraft or modded item registry IDs
Console commands
Private messages
Server broadcasts

Reward commands support these placeholders:

{player}
{uuid}
{gym}
{leader}

Offline takeover and defense rewards are stored until the player logs in or uses /sg claim.

Economy Support

The economy mode can be configured as:

AUTO
PIXELMON
VAULT
NONE

AUTO

Attempts to use Pixelmon’s built-in bank system first, then checks for a compatible Vault economy provider.

PIXELMON

Uses Pixelmon PokéDollars.

VAULT

Uses the registered Vault economy provider on compatible hybrid NeoForge/Bukkit servers.

NONE

Disables money deposits while allowing non-money rewards such as items, experience, commands, and messages.

Servers can configure whether an unavailable economy causes the entire reward bundle to fail or only skips the money portion.

Optional Client Interface

The server mod contains all gameplay and does not require players to install a client companion.

Players without the client mod retain access through:

Commands
Gym NPCs
Vanilla paginated chest menus

The optional client companion adds:

A central gym navigation hub
Animated gym dossiers
Live leaderboards
Player profiles
Reward claims
Favorites and filters
Scrolling pages
Animated transitions
Eighteen Pokémon type identities
Ten gym frame themes
Four central menu worlds
Client sound controls
Reduced-motion accessibility settings

The server controls the active interface themes. Players may only change their local sound and reduced-motion preferences.

Main Menu Themes

The central menu supports four server-selected worlds:

cosmic_forge
chrono_garden
quantum_koi
aurora_engine

Players cannot override the server’s selected central menu theme.

Gym Types

Each gym can use one of Pixelmon’s eighteen standard types:

Normal
Fire
Water
Electric
Grass
Ice
Fighting
Poison
Ground
Flying
Psychic
Bug
Rock
Ghost
Dragon
Dark
Steel
Fairy

The auto option selects a type using the gym’s configured requirements or its name and ID when possible.

Gym Frame Themes

Each gym can use one of ten visual frame styles:

astral_observatory
glass_menagerie
neon_metro
clockwork_vault
verdant_conservatory
abyssal_sonar
royal_tactics
arcade_gauntlet
weather_beacon
lunar_archive

Configuration

Each gym has its own JSON configuration file.

Administrators can configure:

Gym ID and display name
Enabled state
Initial defending team
Battle rules
Access restrictions
Required Pokémon types
Gym type
Visual frame theme
Main menu theme
NPC name
NPC skin
NPC position
Challenge availability
Initial victory rewards
Conquest rewards
Bounty growth
Repeat-loss reward cooldown
Defender milestone requirements
Featured gym rewards
Circuit rewards
Badge rewards
Economy behavior
Physical badge items
Messages and broadcasts
Command rewards
Experience rewards
Item rewards
Permission requirements
Client sounds
Client motion settings
Leaderboard scoring
Operator permission level

The generated example gym is disabled by default so a new server cannot accidentally publish a placeholder team or distribute unintended rewards.

Player Commands

`/sg`

Opens the best available gym interface.

Aliases:

/gyms
/stellargyms

`/sg challenge <gym>`

Challenges a gym when its access rules allow it.

`/sg info <gym>`

Displays the gym’s current leader, defending team, streaks, bounty, and history.

`/sg list`

Lists configured gyms.

`/sg top`

Displays the server-authoritative player leaderboard.

Leaderboard scoring can include:

Victories
Defense wins
Challenger streaks
Defense streaks
Flawless victories
Featured victories

`/sg profile`

Displays the player’s private gym statistics, score, rank, streaks, and badge holdings.

`/sg featured`

Displays the current featured gym and the remaining rotation time.

`/sg circuit`

Displays the player’s current daily circuit progress.

`/sg inbox`

Displays persistent gym notifications, including leadership displacement and defense milestones.

`/sg inbox clear`

Clears stored gym notifications.

`/sg claim`

Claims queued takeover and defense rewards.

`/sg help`

Displays command help.

Administrator Commands

`/sg admin create <id> <name>`

Creates a new gym and attempts to capture the command sender’s current eligible Pixelmon party as its initial team.

`/sg admin setteam <gym> [player]`

Replaces the gym’s permanent initial team using the selected player’s party.

`/sg admin setleader <gym> <player>`

Forces a player-derived defending team without replacing the gym’s stored reset baseline.

`/sg admin setnpc <gym>`

Places or moves the gym’s configured NPC to the administrator’s current location.

`/sg admin spawnnpc <gym>`

Spawns the gym NPC.

`/sg admin removenpc <gym>`

Removes the gym NPC.

`/sg admin settheme <gym> <theme>`

Changes the gym’s visual frame theme.

`/sg admin setmenutheme <theme>`

Changes the server-wide central menu theme.

`/sg admin settype <gym> <auto|type>`

Sets the gym’s animated Pokémon type identity.

`/sg admin setreward <gym> ...`

Changes configured gym rewards.

`/sg admin toggle <gym>`

Enables or disables a gym.

`/sg admin reset <gym> confirm`

Restores the gym’s original administrator-defined team.

`/sg admin status`

Displays gym system and configuration status.

`/sg admin reload`

Reloads StellarGyms configuration files.

Command suggestions automatically include configured gym IDs, Pixelmon types, visual themes, reward types, and supported flags.

Permissions

Player actions are allowed by default unless changed through a compatible NeoForge permission provider.

Player Permissions

stellar_gyms.stellargyms.open
stellar_gyms.stellargyms.challenge
stellar_gyms.stellargyms.info
stellar_gyms.stellargyms.top
stellar_gyms.stellargyms.claim
stellar_gyms.stellargyms.chest
stellar_gyms.stellargyms.client

Administrator Permissions

stellar_gyms.stellargyms.admin
stellar_gyms.stellargyms.reload
stellar_gyms.stellargyms.create
stellar_gyms.stellargyms.npc
stellar_gyms.stellargyms.reset
stellar_gyms.stellargyms.reward

Administrator permissions default to the configured operator level.

Compatible permission plugins may display the shorter logical permission names as stellargyms.<action>.

Notifications and Claims

StellarGyms maintains a persistent inbox for important gym events.

Players can receive notifications when:

They are replaced as a gym leader
They earn a defense milestone
An offline reward is queued
A takeover affects one of their gyms

Notifications and rewards remain available after server restarts.

Server-Authoritative Design

All battles, gym teams, rewards, progression, rankings, and permissions are controlled by the server.

The optional client interface only displays server-provided information and sends requested actions back to the server. Installing the client companion does not give players control over gym data, rewards, teams, or themes.