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.