PlayerBatch

Bulk-summon, control, and script fake players on Fabric with Carpet.

PlayerBatch is a Minecraft 1.21.11 Fabric mod and Carpet addon built for summoning and managing large groups of fake players without the normal spam, lag, or command pain.

Quick Links

• Download latest jar: PlayerBatch-2.0.1-mc1.21.11.jar
• Modrinth page: PlayerBatch on Modrinth
• Extension API: PlayerBatch-ExtAPI
• Source code: GitHub repository
• Report bugs: Issues

What It Does

• Summons lots of fake players using Carpet's real /player system
• Queues large spawns to reduce lag spikes
• Supports custom names, formations, kits, and combat options
• Lets you select bots in bulk and control them with commands
• Adds group control, AI modes, bot utilities, and command-focused workflows
• Supports extensions through PlayerBatch-ExtAPI

Install

You need:

• Minecraft 1.21.11
• Fabric Loader
• Fabric API
• Carpet Mod
• Java 21

Install steps:

1. Install Fabric Loader for 1.21.11
2. Put Fabric API in your mods folder
3. Put Carpet in your mods folder
4. Download the latest PlayerBatch jar
5. Put the jar in your mods folder

Main Commands

Spawning

/pb spawn <count>
/pb spawn <count> {name1,name2,...} <formation> <arguments>
/pb presets combat <count> <arguments>

Selection

/pb wand
/pb selection all
/pb selection range <distance>
/pb selection count <number>
/pb selection clear
/pb selection list

Bot Control

/pb run <action>
/pb target look <player>
/pb teleport selected <direction> <block>
/pb repair tags

Kits

/pb kits save <name>
/pb kits load <name>
/pb kits self <name>
/pb kits list

Presets

/pb presets combat <count> [options]
/pb presets save <name> combat <count> <options>
/pb presets use <name> [count]
/pb presets list

Utility / Testing

/pb test all
/pb test goto coords <x> <y> <z>
/pb test goto entity <target>
/pb test stop
/pb config limit <number>
/pb config spawns_per_tick <number>
/pb config debug on
/pb config debug off

Example Commands

/pb spawn 50 {W4Whiskers,PixelCrafter} circle -diamondarmor -diamondtools -reach{6} -damage{true}
/pb spawn 100 {} dense -ironarmor -irontools -blocks{cobblestone*64}
/pb target look W4Whiskers
/pb repair tags
/pb test all

Formations

Built-in formations currently include:

• circle
• filled_circle
• dense
• square
• triangle
• random
• single_block

Why Use PlayerBatch

• Faster testing for PvP and arena setups
• Easier fake-player management than raw Carpet commands alone
• Better large-batch stability
• Cleaner command workflow
• Extension-ready for custom formations, arguments, actions, and behaviors

Extension API

Want to build add-ons for PlayerBatch?

• API repo: PlayerBatch-ExtAPI
• Extension entrypoint key: playerbatch-ext

Notes

• PlayerBatch is command-first
• It reuses Carpet fake-player spawning instead of reimplementing fake players
• The latest 1.21.11 jar can be downloaded directly from the Modrinth CDN link above

Support

If something breaks or acts weird:

• open an issue: GitHub Issues
• include your version, commands used, and logs if possible