SpawnBots

SpawnBots

SpawnBots is a lightweight open source, high-performance plugin for Paper that allows server administrators and players to spawn fully controllable fake players—without requiring any client-side mods or bloated dependencies.


✨ Features

Realistic Player Skins: Spawns bots with full skin rendering, including outer clothing layers and capes.
⚛️ Vanilla Physics & World Interaction: Bots are affected by gravity, can be pushed by entities, and naturally pick up items from the ground.
Interactive Equipment GUI: Manage main hand, offhand, armor, hotbar, and full inventory slots via an intuitive in-game interface.
⚔️ Command-Driven Actions: Order bots to attack targets, mine targeted blocks, or eat food on command.
Persistent Inventories: Inventories automatically save on bot removal, death, or server shutdown and restore upon respawning.
️ Integrated Chunk Keeping: Keeps a `5x5` chunk area active around each bot. Chunk tickets follow on teleportation and automatically unregister on removal.
️ Granular Controls: Toggle invulnerability (`undying`), control permissions, and inspect server impact using `/bot log`.

Commands & Permissions

All commands use full tab-completion for bot names, actions, and coordinates.

| Command | Permission | Description |
| --- | --- | --- |
| `/bot player <Name>` | `spawnbots.spawn` | Spawns a bot with the given player's skin (or removes it if already active). |
| `/bot equip` | `spawnbots.equip` | Opens a selection menu for all active bots. |
| `/bot equip <Name>` | `spawnbots.equip` | Directly opens the equipment GUI for a specific bot. |
| `/bot <Name> attack` | `spawnbots.attack` | Toggles attacking the line-of-sight target with the equipped weapon. |
| `/bot <Name> mine` | `spawnbots.mine` | Toggles mining the targeted block with the equipped tool. |
| `/bot <Name> eat` | `spawnbots.eat` | Forces the bot to eat food from either hand if hungry. |
| `/bot <Name> stop` | `spawnbots.stop` | Immediately halts the bot's active task. |
| `/bot <Name> undying` | `spawnbots.undying` | Makes the bot completely invulnerable. |
| `/bot <Name> dying` | `spawnbots.dying` | Re-enables damage and death for the bot. |
| `/bot <Name> tp` | `spawnbots.tp` | Teleports the bot to your current location. |
| `/bot <Name> tp <x> <y> <z>` | `spawnbots.tp` | Teleports the bot to target coordinates. |
| `/bot log` | `spawnbots.log` | Shows active bots, chunk tickets, estimated CPU load, and error logs. |

> [!NOTE]
> Admin Access: Grant `spawnbots.*` to give full access to all features. By default, permissions are r estricted to server operators (OP).