# FakePlayer<\/p>\n
This is a server side plugin inspired by Carpet-Mod for Minecraft `1.20.x` and `1.21.x` and above.<\/p>\n
Click me to visit a demo video.<\/p>\n
## Features<\/p>\n
+ Lets you spawn fake players who look like real to the server, they can keep chunk loading
\n+ Fake players can be recolonized by vanilla commands and plugin commands, such as `\/ban`, `\/tp`
\n+ You can open and edit their inventory via `\/fp invsee` or Right-Clicking on them
\n+ You can fully control their moving, jumping, attacking… What’s better ? Make it periodical
\n+ Each player can configure his personal configuration<\/p>\n
## Requirements<\/p>\n
+ Paper or Purpur software
\n+ CommandAPI Plugin<\/p>\n
## Config file<\/p>\n
**Fakeplayer only generates a template config file named `config.tmpl.yml`.**
\nYou need to rename this file to `config.yml` as your configuration file.
\nThis approach can let you preview new content when you are upgrading it.<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission | Note |
\n|—————|——————————————-|——————————|—————————————————————–|
\n| \/fp spawn | Spawn a fake player | fakeplayer.command.spawn | |
\n| \/fp kill | Kill a fake player | fakeplayer.command.kill | |
\n| \/fp killall | Kill all fake players on the server | OP | |
\n| \/fp select | Select a fake player as default | fakeplayer.command.select | Available when player spawned more then 1 fake players |
\n| \/fp selection | View selected fake player | fakeplayer.command.selection | Available only when player spawned more then 1 fake players |
\n| \/fp list | List spawned fake players | fakeplayer.command.list | |
\n| \/fp distance | Show distance to a fake player | fakeplayer.command.distance | |
\n| \/fp drop | Drop held item | fakeplayer.command.drop | |
\n| \/fp dropstack | Drop entire stack of the held item | fakeplayer.command.dropstack | |
\n| \/fp dropinv | Drop all items in the inventory | fakeplayer.command.dropinv | |
\n| \/fp skin | Copy skin from another player | fakeplayer.command.skin | 60 seconds cooldown if copy from a offline player |
\n| \/fp invsee | Open an inventory of a fake player | fakeplayer.command.invsee | Right-clicking on fake players has the same effect |
\n| \/fp sleep | Sleep | fakeplayer.command.sleep | |
\n| \/fp wakeup | Wake up | fakeplayer.command.wakeup | |
\n| \/fp status | Show player status | fakeplayer.command.status | |
\n| \/fp respawn | Respawn a dead fake player | fakeplayer.command.respawn | Available when server config does not kick on fake player death |
\n| \/fp tp | Teleport to a fake player | fakeplayer.command.tp | |
\n| \/fp tphere | Teleport a fake player to you | fakeplayer.command.tphere | |
\n| \/fp tps | Swap positions with fake player | fakeplayer.command.tps | |
\n| \/fp set | Change the configuration of a fake player | fakeplayer.command.set | |
\n| \/fp config | Change default configuration | fakeplayer.command.config | |
\n| \/fp expme | Transfer exp to you | fakeplayer.command.expme | |
\n| \/fp attack | Attack | fakeplayer.command.attack | |
\n| \/fp mine | Mine | fakeplayer.command.mine | |
\n| \/fp use | Use\/Interact\/Place | fakeplayer.command.use | |
\n| \/fp jump | Jump | fakeplayer.command.jump | |
\n| \/fp stop | Stop all actions | fakeplayer.command.stop | |
\n| \/fp turn | Turn around | fakeplayer.command.turn | |
\n| \/fp look | Look at specified location | fakeplayer.command.look | |
\n| \/fp move | Move | fakeplayer.command.mvoe | |
\n| \/fp ride | Ride | fakeplayer.command.ride | |
\n| \/fp sneak | Sneak | fakeplayer.command.sneak | |
\n| \/fp sprint | Sprinting | fakeplayer.command.sprint | |
\n| \/fp swap | Swap main and off-hand items | fakeplayer.command.swap | |
\n| \/fp hold | Hold corresponding hotbar item | fakeplayer.command.hold | |
\n| \/fp cmd | Execute command | fakeplayer.command.cmd | |
\n| \/fp reload | Reload config file | OP | |<\/p>\n
## Personal Configuration<\/p>\n
**Each player** can configure his **own** configuration, it will take effect on the next spawning<\/p>\n
Command examples:<\/p>\n
+ `\/fp config list` – View all personalized configurations
\n+ `\/fp config set collidable false` – Set personalized configuration<\/p>\n
| Configuration Item | Note |
\n|——————–|————————————————————————————————————————————-|
\n| collidable | Whether collision box is enabled |
\n| invulnerable | Whether invincible mode is enabled |
\n| wolverine | Whether super heal mode is enabled |
\n| look_at_entity | Automatically look at nearby attackable entities (including players), can be combined with `attack` to automatically fight monsters |
\n| pickup_items | Whether to pick up items |
\n| skin | Whether to use your skin |
\n| replenish | Whether to auto-replenish |
\n| autofish | Whether to autofish |<\/p>\n
## Permissions<\/p>\n Each command has its own permission node, but we provided some permissions packs<\/p>\n ### Permission `fakeplayer.spawn`<\/p>\n `fakeplayer.spawn` includes the following permissions:<\/p>\n – fakeplayer.command.spawn – Create fake player ### Permission `fakeplayer.tp`<\/p>\n `fakeplayer.tp` includes the following permissions:<\/p>\n – fakeplayer.command.tp ### Permission `fakeplayer.action`<\/p>\n `fakeplayer.action` includes the following permissions:<\/p>\n – fakeplayer.command.attack – Attack If your server does not restrict various player commands, you can use this directly. ## Placeholder Variables<\/p>\n + `%fakeplayer_total%`: Total count of fake players # Custom Translation<\/p>\n 1. Create a `message` folder in `plugins\/fakeplayer` **Make sure the translation file is encoding with UTF-8**<\/p>\n # FAQs<\/p>\n ## xxx lost connection: PacketEvents 2.0 failed to inject<\/p>\n Some plugin change the `Connection` of the fake player, You can set `prevent-kicking` to `ALWAYS` to solve it.<\/p>\n “`yaml ## Fake players do not attract aggression<\/p>\n By default, fake players are in invincible mode. Players need to manually turn off invincible mode with `\/fp config set invulnerable false` to attract aggression. After turning it off, they will ## Fake players automatically log out after a while<\/p>\n This may be because plugins like `AutheMe` detect that fake players have not logged in for a long time. You can include the login command in the configuration file’s `self-commands` to prevent the “`yaml A plugin for minecraft server to spawn fake players, inspired by Carpet Mod<\/p>\n","protected":false},"featured_media":68370,"template":"","meta":{"_minecraft_slug":"fakeplayer","_minecraft_project_id":"TcyhRi9n","_minecraft_author":"hello09x","_minecraft_license":"Apache-2.0","_minecraft_downloads":18271,"_minecraft_follows":48,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"fakeplayer.zip","_minecraft_size_bytes":1417830,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T00:44:11.558365Z","_minecraft_date_created":"2024-12-16T02:23:23.232857Z","_minecraft_date_modified":"2024-12-13T01:52:44.667875Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/fakeplayer","_minecraft_icon_attachment_id":68370,"_minecraft_imported_at":"2026-06-03T21:38:21+00:00","_minecraft_import_hash":"8064d5454bc7c438e2d26f7791f69005","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128,123,92],"mod_loader":[132,133],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-68369","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\nClick to visit<\/summary>\n
\n– fakeplayer.command.kill – Kill fake player
\n– fakeplayer.command.list – List fake players
\n– fakeplayer.command.distance – View distance
\n– fakeplayer.command.select – Select fake player
\n– fakeplayer.command.selection – View selected fake player
\n– fakeplayer.command.drop – Drop an item
\n– fakeplayer.command.dropstack – Drop entire stack of items
\n– fakeplayer.command.dropinv – Drop all inventory items
\n– fakeplayer.command.skin – Copy skin
\n– fakeplayer.command.invsee – View inventory
\n– fakeplayer.command.status – View status
\n– fakeplayer.command.respawn – Respawn fake player
\n– fakeplayer.command.config – Set default settings
\n– fakeplayer.command.set – Set fake player settings<\/p>\n
\n– fakeplayer.command.tphere
\n– fakeplayer.command.tps<\/p>\n
\n– fakeplayer.command.mine – Mine
\n– fakeplayer.command.use – Use
\n– fakeplayer.command.jump – Jump
\n– fakeplayer.command.sneak – Sneak
\n– fakeplayer.command.sprint – Sprinting
\n– fakeplayer.command.look – Look
\n– fakeplayer.command.turn – Turn
\n– fakeplayer.command.move – Move
\n– fakeplayer.command.ride – Ride
\n– fakeplayer.command.swap – Swap main and off-hand items
\n– fakeplayer.command.sleep – Sleep
\n– fakeplayer.command.wakeup – Wake up
\n– fakeplayer.command.stop – Stop all actions
\n– fakeplayer.command.hold – Switch hotbar
\n– fakeplayer.config.replenish – Auto-replenish
\n– fakeplayer.config.replenish.chest – Can replenish from nearby chests when auto-replenishing
\n– fakeplayer.config.autofish – Autofish<\/p>\n
\n`fakeplayer.basic` includes all secure permissions, except for `\/fp cmd` commands.
\n<\/details>\n
\n+ `%fakeplayer_creator%`: The creator name of a fake player
\n+ `%fakeplayer_actions`: Active actions of a fake player such as : `USE|ATTACK`<\/p>\n
\n2. Copy [this file](fakeplayer-core\/src\/main\/resources\/message\/message.properties) to `message` folder
\n3. Rename the file to `message_language_region.properties` such as `message_en_us.properties`
\n4. Edit your `config.yml`, set `i18n.locale` to the name suffix which you just created such as `en_us`
\n5. Type `\/fp reload-translation` to reload translation file. If you change `i18n.local`, you should `\/fp reload` first<\/p>\n
\n# config.yml
\nprevent-kicking: ALWAYS
\n“`<\/p>\n
\nreceive hunger and health effects. You may need to use `res` or beacon to ensure the fake player’s `hunger` and `health`.<\/p>\n
\nplugin from kicking out players for being idle:<\/p>\n
\n# Note: You should use a complex password, or AuthMe may reject it
\nself-commands:
\n – ‘\/register abc123! abc123!’
\n – ‘\/login abc123!’
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"