Carpet Fake Players

Create and control server-side fake players on Paper and Purpur servers.

Carpet Fake Players lets you spawn and manage fake players with combat actions, item usage, persistent inventories, custom skins, sneaking, collision, physics and knockback.

Features

• Fake Players: Spawn and manage server-side bots.
• Player Ownership: Control your own bots with configurable bot limits.
• Persistent Data: Preserve bot inventories and data according to the configuration.
• Combat: Configure single attacks, continuous attacks and interval-based attacks.
• Item Usage: Make bots use items with configurable action timing.
• Inventory Control: Select hotbar slots, manage offhand items and drop items or inventories.
• Skins: Set bot skins using player names.
• Movement Physics: Support for gravity, collision, natural knockback and explosion knockback.
• Sneaking: Enable or disable sneaking for individual bots.
• Rejoining: Bring bots back after they leave.
• Original Bots: Spawn original bots and manage access for other players.
• Integrations: Includes AuthMe compatibility and LuckPerms support.
• Configuration: Customize bot limits, attributes, hunger exhaustion and messages.

Commands

Bot Management

/bot spawn
/bot kill
/bot rejoin
/bot info <name>
/bot hotbar <name> <0-8>
/bot offhand <name> <0-35>
/bot offhand <name> clear
/bot drop <name>
/bot dropstack <name>
/bot dropinv <name>
/bot sneak <name> on|off
/bot skin <name> <player>
/bot reload

Combat

/bot attack <name>
/bot attack <name> single
/bot attack <name> continuously
/bot attack <name> interval <ticks>
/bot attack <name> stop

Item Usage

/bot use <name>
/bot use <name> single
/bot use <name> continuously
/bot use <name> interval <ticks>
/bot use <name> stop

Single-action mode is the default for both attack and item usage.

Original Bots

/bot original spawn <name>
/bot original grant <player>
/bot original revoke <player>

Inventory Persistence

Bot inventories can be preserved when bots die or are removed, depending on the configuration. Inventory preservation supports bot removal and normal bot deaths.

Hunger Configuration

Attack and item-use exhaustion can be configured independently in config.yml:

hunger:
  attack: true
  use: true

Set either option to false to disable exhaustion from that action.

Permissions

The plugin includes the following permission nodes:

bot.*
bot.player
bot.action
bot.admin
bot.kill-other
bot.original
bot.original.grant
bot.reload
bot.rejoin
bot.use

Supported Versions

Separate source builds are provided for:

• Minecraft 26.1.x
• Minecraft 26.2
• Minecraft 26.3

Server software: Paper and Purpur
Java requirement: Java 25

Download the build matching your Minecraft version.

Installation

1. Download the correct build for your Minecraft version.
2. Stop your server.
3. Place the plugin JAR inside your server's plugins folder.
4. Start the server.
5. Configure the plugin using its generated config.yml.

Reporting Issues

When reporting a bug, include your Minecraft version, Paper/Purpur version, Java version, plugin version, full console error and steps to reproduce the issue.

Source Code

Source code and project updates:

https://github.com/ZynAyush/minecraft-playerbots