Mobarmy Battles

A team-based PvE minigame plugin for Paper 1.21.x. Two teams farm mobs in separate worlds, configure attack waves, then battle each other's armies in a copied arena.

How It Works

Lobby — Players join Team A or Team B via the Team Selection GUI (right-click the Iron Sword).

Farming Phase — Each team is teleported to a unique survival world. Kill mobs to collect them for your army. A boss bar counts down the remaining time.

Configuration Phase — Players are frozen in place and assign their collected mobs across three attack waves using a GUI. Click Ready when done.

Battle Phase — Both teams are teleported to identical arena copies. Mobs spawn wave-by-wave against the opposing team. The last team standing wins.

Features:

Random block drops (every block drops a randomized item

Team backpack (shared chest item per team)

Spectator mode with player teleport GUI

Arena template system (bring your own world)

Debug / solo mode for testing

Scoreboard, boss bar & MiniMessage styled chat

Commands:

/mobarmy Show command help mobarmy.use

/mobarmy start Start a new game with the given farming duration mobarmy.admin

/mobarmy cancel Cancel the current game and return everyone to the lobby mobarmy.admin

/mobarmy setspawn lobby Set the lobby spawn point to your location mobarmy.admin

/mobarmy stats Show collected mob statistics for both teams mobarmy.use

/mobarmy team <a|b> Force-assign a player to a team mobarmy.admin

/mobarmy watch Open the spectator teleport GUI mobarmy.use

/mobarmy debug Toggle debug mode (+99 mobs, solo play) mobarmy.admin

/mobarmy tp [world] Teleport to a world (lists all if no arg) mobarmy.admin

/mobarmy fixbattle Remove orphaned mobs from battle tracking mobarmy.admin

/mobarmy unfreeze <player|*> Reset movement/attributes for stuck players mobarmy.admin

/mobarmy configgui <a|b> Reopen the wave configuration GUI for a team mobarmy.admin

/mobarmy fixdifficulty Set lobby to Peaceful, match worlds to Hard mobarmy.admin

/mobarmy backpack Receive a team backpack item (during a match) mobarmy.use

Permissions Permission Description Default mobarmy.use Allows basic commands (stats, watch, backpack) Everyone mobarmy.admin Allows admin commands (start, cancel, setspawn, team, debug, etc.) OP only

Setup Place the compiled JAR into your server's plugins/ folder.

Place a vanilla overworld copy into plugins/MobArmyBattle/arena-template/ (must contain level.dat, region/, etc.).

Start the server, then set the lobby spawn: /mobarmy setspawn lobby.

Players join teams, then run /mobarmy start to begin.