Cobblemon Multi Battle

Player-made gyms and Elo ranked battles for Cobblemon servers, with clone trainers, rewards, editable bans, admin tools, and full server-side control.
mulitbattle.jpg

mulitbattle.jpg

Description

Cobblemon Multi Battle

Two battle modes in one mod: Player Gyms and Ranked. Build your own gym with a clone trainer, or compete in Elo-based singles and doubles. Servers can enable either mode on its own or run both together.

Cobblemon Multi Battle main menu for Player Gyms and Ranked Mode

What is this mod?

Cobblemon Multi Battle is a 2-in-1 mod for Cobblemon servers. Player Gyms lets players build gyms with saved Pokémon teams and challenge each other’s clone trainers. Ranked adds Elo matchmaking, 1v1 singles, 2v2 doubles, seasons and configurable battle rules. Each mode has its own settings and emergency switch, so servers can use one mode or both.

Features at a glance

  • Two modes in one mod: Player Gyms and Ranked, independently enabled or disabled.
  • Player-owned gyms with 18 types, saved teams, player-skin clones, challenges and vault rewards.
  • Ranked singles and doubles with Elo, matchmaking, leagues, seasons and battle history.
  • Cinematic ranked intro, turn timer and animated battle results.
  • Automatic win rewards and manually claimed end-of-season rewards.
  • Ranked penalties for disconnects and forfeits, plus an editable banlist.
  • In-game Admin tool for gyms, ranked settings, player Elo and emergency controls.
  • Separate gym and ranked battle music, 3D Pokémon cards and optional Mega Showdown support.

For players

1. Get your Gym Mirror

Open Player Gyms from the main menu. The first time you do this, you can receive one free Gym Mirror, provided you have a free inventory slot. The free mirror is available only once per player. The mirror cannot be crafted. Operators can give out additional mirrors.

2. Choose a gym type

Right-click your Gym Mirror in the air to open the setup menu. Choose one of the 18 Pokémon types. Only an operator can change your gym type later; you can send a type-change request.

Gym type change request showing all 18 Pokémon types

3. Build your team

Add up to six Pokémon from your party or PC, or copy your party with one click. Each Pokémon must have your gym's type as either its primary or secondary type. The gym uses saved battle copies, including copies of held items. Your actual Pokémon are not duplicated into your inventory.

4. Place and manage your clone

Right-click a block with your mirror to place a clone trainer. The clone uses your real player skin and the team you saved. Placing it consumes the mirror. You can take the clone back after a cooldown (2 hours by default) and move it somewhere else.

Placed gym clone in the world

Your Gym menu shows the saved team, clone status, location, vault balance and management buttons. Pokémon cards show a 3D model, types, ability, nature, held item, moves and stats.

Your Gym menu with Flying type, saved team and Pokémon details

5. Find and challenge other gyms

Press I (the default gym-list key) to open All Gyms. Browse gyms by type, view owners and online status, and teleport to a gym when the server allows it. Right-click a placed clone to challenge it.

The challenge cooldown is 2 hours per player and gym by default. Servers can require the gym owner to be online and can decide whether owners may battle their own gyms.

Player Gyms list with type filters and teleport button

6. Earn rewards and use your vault

An operator can assign a one-time reward to each gym using an item in hand or a command. You receive that reward once per gym, but you can still challenge the gym again for fun.

With CobbleDollars rewards configured, the default economy settings are:

Event Default
Your clone defeats a challenger 5,000 added to your gym vault
A challenger defeats a clone 10,000 paid to the challenger
Gym vault maximum 100,000
Vault collection cooldown 3 days
Challenger win-money cooldown 2 hours across all gyms

The last cooldown is global. Winning at several gyms in quick succession does not pay the challenger win-money reward each time. Server owners can change these numbers.

7. Play Ranked

Open Ranked Mode, select your team and join a queue:

  • Singles 1v1: 3 Pokémon by default.
  • Doubles 2v2: 4 Pokémon by default.

Ranked uses Elo-based matchmaking and configured server arenas. All Pokémon battle at level 100 in Ranked. The default ranked cooldown is 10 minutes, and the server controls team sizes, arena positions, the allowed Elo gap and queue time limits.

Before a ranked battle begins, a cinematic intro shows the ranks and starts the battle music. During each turn, a 60-second timer appears at the top of the screen. The last 10 seconds have a warning tick. When time runs out, the turn is skipped. This does not count as a forfeit.

The Ranked menu shows your Elo, rank, wins, losses, streak, season timer and leaderboard. You can also view both teams in battle history, select your team, read the banlist and see the Elo and reward overview.

Ranked Mode with Elo, singles and doubles queues

Ranked results, rewards and penalties

At the end of a ranked match, the result screen shows the winner and loser. Elo animates up or down, rank changes are displayed, and the winner sees their rank reward. Ranked win rewards are paid automatically, with no claim button. The loser sees who beat whom, both teams and the result sound. A server broadcast announces who won and the Elo involved.

Forfeiting or disconnecting during a ranked battle causes an Elo penalty and a configurable ranked ban. If someone disconnects, their opponent receives no Elo and no rewards. The GUI warns players about penalties, and operators are notified starting with the third forfeit.

Ranks are Unranked, Bronze, Silver, Gold, Platin, Diamond, Master and Champion. Champion requires a streak at the top rank (10 wins by default). Ranked can award money and Arceus wishes per win. Elo calculations also support a configurable minimum win gain and a win-streak bonus.

Ranked seasons and archive

Seasons end automatically after a configurable number of months or days, or when an operator ends them manually. At the end of a season, the mod announces the result in a window and resets players for the next season. Season rewards are claimed manually in the rewards menu, unlike ranked win rewards.

Open History → Seasons to view the final standings of completed seasons, including rank, Elo, wins and losses.

8. Check the rules before queueing

Everyone can open a read-only ranked banlist. Servers can restrict Pokémon, individual forms, moves, abilities, held items, Mega, Tera, Z-Moves, Dynamax and all fusion Pokémon. Healing and revive items from the bag are blocked during ranked battles by default, but the server can disable that rule. Held items stay with Pokémon during ranked battles instead of dropping as loot.


For server owners

Install and check dependencies first

Install Cobblemon Multi Battle on both the server and every connecting client. Both sides need the mod. Use the following versions:

Component Requirement
Minecraft 1.21.1
Mod loader Fabric
Fabric Loader 0.17.2 or newer
Fabric API Required
Cobblemon 1.8.x
Java 21
Mega Showdown Optional, supported

Do not mark unrelated Minecraft versions or mod loaders as supported without testing them. Cobblemon 1.8.x support does not by itself guarantee compatibility with every other mod combination.

Set up the modes

  1. Install the required mods on the server and every connecting client, then start the server.
  2. Open the mod's main menu as an operator and select Admin tool.
  3. Open Gym settings and Ranked settings separately. Enable either mode or both.
  4. For gyms, review mirror access, clone rules, vault amounts, challenge cooldowns, teleport and reward commands.
  5. For ranked, configure arenas and player positions, bans, teams, Elo rules, season length and reward commands before enabling the queue.
  6. Test both modes, ranked disconnect penalties and reward claims with test players.

Admin tool

Operators with permission level 2 can open Admin tool from the main menu. The tool has controls for both systems without needing to edit configs for everyday changes.

Control What it does
Gyms Enable or disable individual gyms, remove clones and set per-gym rewards and cooldowns.
Requests Approve or deny gym type-change requests.
Give mirror Give additional Gym Mirrors.
Gym settings Gym rules, clone strength, vault economy, teleport, cooldowns and gym emergency switch.
Ranked settings Elo, matchmaking, penalties, seasons, rewards and ranked emergency switch.
Perms Give trusted players permission to edit ranked bans.
Player controls Set a player's Elo (rank updates immediately), clear bans and cooldowns, and manually end a season.

Admin settings: two separate panels

The two modes have separate settings screens and separate emergency OFF switches. Changes are saved to the server configuration immediately. Use the minus and plus buttons to adjust values in game.

image image

Player Gyms settings

The Admin tool includes:

  • Player Gyms ON/OFF and emergency OFF.
  • Individual gym ON/OFF, removal, one-time rewards and per-gym cooldowns.
  • Gym challenge cooldown and clone take-back cooldown.
  • Require the gym owner to be online; allow or prevent self-challenges.
  • Gym teleport ON/OFF.
  • Clone AI strength 0 to 5 and optional forced battle level.
  • Individual switches for Mega, Tera, Z-Moves and Dynamax on clones.
  • Vault payment for clone wins, challenger win payment, vault maximum, vault collection cooldown and the global challenger win-reward cooldown.

Ranked settings

Ranked has its own Settings page and emergency OFF switch. Admin controls include:

  • Ranked ON/OFF and emergency OFF.
  • Starting Elo, K-factor, loser protection and maximum Elo difference for matchmaking.
  • Minimum Elo gain on a win and an Elo bonus for win streaks.
  • Ranked queue time limit, configured arena player coordinates and team sizes.
  • Ranked cooldown (10 minutes by default). When changed in Admin tool, currently running cooldowns restart with the new value.
  • Fixed level 100 for all Pokémon in ranked battles.
  • Season length configured in days or months, and Champion streak requirement (10 by default).
  • Win-reward money and Arceus wishes per rank; end-of-season RP and other configured command rewards.
  • Configurable ranked bans following forfeits and disconnects, including Elo penalties.
  • Rank suffix commands, spacing through suffixSpacer, and automatic suffix reapplication when a player joins.
  • Switch to block or allow healing and revive items from the bag in ranked.

Win rewards are paid automatically when a ranked match finishes. When a season ends, Elo is reset, the season is recorded in the archive, and season rewards wait for players to claim them in the rewards menu.

Ranked bans

Ranked bans are edited in game. You do not have to edit the config for normal ban changes. Operators can ban:

  • Pokémon species and individual forms.
  • Moves and abilities.
  • Held items, including datapack or custom items via Item in hand.
  • Mega, Tera, Z-Moves and Dynamax.
  • All fusion Pokémon.

All players can view the banlist without editing it. Clear all bans requires confirmation. Through Admin tool → Perms, you can authorize individual non-operator players to manage the ranked bans.

Ranked bans menu with species, forms, moves, abilities and items

Economy and reward commands

Rewards run through server commands. Configure every command to match the economy, reward and permission mods installed on your server.

  • Gym one-time rewards: Operators can set an item held in hand or a command for each gym. Each player receives that reward once per gym.
  • Gym money: Configure dollarCommand for CobbleDollars integration. Clone wins add to the vault; challenger wins can pay the challenger under the global reward cooldown.
  • Ranked win rewards: Per-rank money and Arceus-wish commands run automatically when a ranked winner is confirmed. No collect button is required.
  • Season rewards: Configured RP, market points and other rewards are claimed manually through the ranked rewards menu after the season finishes.
  • Rank suffixes: Configure your permission plugin's suffix command. suffixSpacer controls the visible gap between the player's name and tag. Suffixes are reapplied on join.

The default commands are examples, not universal economy commands. Test them before enabling large payouts. Keep forfeits and disconnect penalties configured to discourage queue abuse.

Config files and commands

Path Purpose
config/cobblemon-multi-battle.json Player Gyms settings, including commented options.
config/cobblemon-multi-battle-ranked.json Ranked ranks, rewards, arenas and player coordinates, season length, music, commands and suffix settings.

Both files are server configuration files. Admin tool changes are saved immediately, and manual config edits can be loaded without restarting the server.

Available commands:

  • /multibattle give — Give Gym Mirrors (operator command).
  • /multibattle reload — Reload the configuration.
  • /multibattle season end — End the ranked season manually.

The old /mirrortrainers command still works as an alias. Ending a season resets Elo and makes its configured season rewards available to claim from the rewards menu.

Music and menus

Ranked battles start with a cinematic intro that reveals player ranks and plays the battle music. Player Gyms and Ranked each have their own battle music track, replacing Cobblemon's normal theme during those battles. Playback supports fade-in, fade-out and crossfade.

Pokémon cards show a 3D model, types, ability, nature, held item, moves and stats. Ranked menus include result animations, a visible turn timer, match history, season archive and a read-only banlist.

Performance and safe setup

  • No server-side tick loops are used by the mod.
  • Data is written when it changes, not continuously.
  • Lists are sent to clients when the relevant menu opens.
  • Clone skins load on a background thread, are cached on disk and do not block the server thread.
  • 3D models in menus render only when hovered or viewed, not all at once when the menu opens.

Configure ranked arenas, matchmaking and rewards before enabling the queue. Test winner and loser screens, disconnect penalties, timeouts, vault withdrawals, seasonal resets and manual reward claims. Back up server configuration and data before major changes. Use the separate emergency switches if one mode needs to be stopped.


Requirements and compatibility

Minecraft 1.21.1 · Fabric · Cobblemon 1.8.x · Fabric API · Fabric Loader 0.17.2+ · Java 21. Install the mod on both server and clients. Mega Showdown is optional. Player Gyms and Ranked are independent modes and can each be disabled by the server.

Languages

English, German, Spanish, Portuguese (Brazil) and Simplified Chinese. The interface follows the player's Minecraft language setting.

FAQ

Do clients need the mod too?
Yes. Both the server and clients must have Cobblemon Multi Battle installed.

Can I use only Player Gyms or only Ranked?
Yes. It is a 2-in-1 mod with two independently controlled modes.

How do I get another Gym Mirror?
The free mirror is available once when first opening Player Gyms with a free inventory slot. Further mirrors must come from operators.

Do I lose or duplicate my Pokémon when saving a gym team?
No. Gyms use saved battle copies, including held items. Nothing extra is placed into your inventory.

What happens when the ranked turn timer runs out?
After 60 seconds, the current turn is skipped. The warning tick starts during the final 10 seconds. It is not a forfeit.

What happens if I disconnect or forfeit in Ranked?
You lose Elo and receive a configurable ranked ban. A disconnecting player's opponent receives neither Elo nor rewards.

Do I have to claim ranked rewards?
Win rewards are paid automatically. Season rewards must be claimed manually in the rewards menu after a season ends.

Where can I view earlier ranked seasons?
Open Ranked History → Seasons to view final rank, Elo, wins and losses for completed seasons.

How do I change a player's Elo or reset penalties?
Operators can use the relevant Admin tool controls to set Elo, clear bans or cooldowns and end the season.

Can I use another economy or Mega Showdown?
Reward commands can be configured for your server's economy. Mega Showdown is supported but optional.

License

All Rights Reserved. Copyright BlackOverGod.

You may play the mod, link to its official download in modpacks or on servers, and show it in videos or livestreams. You may not modify, reupload, redistribute or host copies of the mod files without permission. Linking to the official download is allowed; bundling and redistributing the mod JAR is not covered by that permission.

Made by BlackOverGod.

Cobblemon Multi Battle Team

profile avatar
  • 2
    Followers
  • 2
    Projects
  • 7.0K
    Downloads

More from BlackOverGod