Home›Java›Mods›FakePlayerPlus
FakePlayerPlus
ModsJava

FakePlayerPlus

Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.

by coderxi · on Modrinth

A modern, robust, and Paper/Folia-supported Minecraft fake player plugin rewritten from scratch in Kotlin. Enhanced successor to…

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.21.11–26.3 · Folia⬇ Download for 1.21.11–26.3 · Paper
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

English | 简体中文 | 繁體中文

FakePlayerPlus GitHub stars

This plugin generates fake players that act as real ones. To the server, they are fully recognized as real, living players.

⭐ If you like FakePlayerPlus, consider giving it a Star! It really helps the project grow.

This plugin is inspired by minecraft-fakeplayer plugin. With the rapid iteration of Minecraft versions, the original plugin's architecture is slightly struggling in patching and maintenance, so it was completely refactored from the ground up based on Kotlin. While inheriting the core features of the original plugin, this plugin achieves a high degree of decoupling in project architecture, making it a more modern, robust, and enhanced derivative version.

Migration

To facilitate a seamless transition from minecraft-fakeplayer, this plugin provides a data migration command to import SQLite data from the original plugin, preventing the loss of fake player NBT data.

Features

Configuration

Please refer to the config.yml configuration file in the plugin directory

Commands

[!IMPORTANT] If you don't restrict various commands for players, you can directly give players fakeplayer.basic, this permission includes all safe permissions

Command Description Permission Notes
/fp help Display help list fakeplayer.help Supports pagination via /fp help [page]
/fp spawn Summon a fake player fakeplayer.spawn The summon limit can be configured in the configuration file
fakeplayer.spawn.limit.<node> Configure node in the configuration file to set custom summon limits for specific players/groups
/fp spawn <name> Summon with a specific name fakeplayer.spawn.name Not recommended for regular players because it occupies unregistered real player names
/fp select <name> Select a fake player fakeplayer.select Any action command can target a specific fake player by adding <name> at the end of the command
/fp remove Remove a fake player fakeplayer.remove --all to remove all fake players
/fp kill Kill the fake player fakeplayer.kill --all to kill all fake players
The death-action option can be configured in the config.yml to mimic original plugin behavior. Note: If keep-inventory is disabled on the server, the kill command will cause items to drop from the inventory.
/fp invsee View fake player inventory fakeplayer.invsee Players can also right-click the fake player to open it
/fp enderchest View fake player enderchest fakeplayer.enderchest Players can also shift-right-click the fake player to open it
/fp tp Teleport to the fake player fakeplayer.tp
/fp tphere Teleport the fake player to you fakeplayer.tp
/fp tpswap Swap positions with the fake player fakeplayer.tp
/fp tppos Teleport fake player to specific position fakeplayer.tp
/fp skin <name> Set a premium account skin for the fake player fakeplayer.skin This command has a 60-second cooldown
/fp cmd Force fake player to execute a command fakeplayer.cmd If the command contains spaces or requires a / prefix, wrap it in ", e.g., /fp cmd "kill @p"
/fp swap Swap main and off-hand items. fakeplayer.swap
/fp chat Force fake player to send a chat message fakeplayer.chat Wrap the text in " if the message contains spaces
/fp settings Open the Settings GUI fakeplayer.settings
/fp action Open the Action List GUI fakeplayer.action The action buttons will only display if the player has the corresponding permission (see below)
/fp action start <action> Open the Action Execution GUI fakeplayer.action.<action>
/fp action execute <action> Execute Action directly fakeplayer.action.<action>
/fp owner list List the owners of the fake player fakeplayer.owner.list
/fp owner add Add a player as an owner of the fake player fakeplayer.owner.add
/fp owner remove Revoke a player's owner permissions fakeplayer.owner.remove
/fp reload Reload configuration fakeplayer.reload

PlaceholderAPI

Placeholder Type Description Example Output
%fakeplayer_total% Global Gets the total number of fake players currently online across the server 5
%fakeplayer_list% Global Gets the list of names of all fake players currently online (The separator can be configured in the language file) FakePlayer_1,FakePlayer_2
%fakeplayer_list_0_name% Global Gets the information of the fake player at the specified index in the list (name can be replaced with any FakePlayer-type attribute below, e.g., uuid, spawner, etc.) FakePlayer_1
%fakeplayer_isfake% Player Checks if the current player is a fake player true / false
%fakeplayer_name% FakePlayer The name of the fake player FakePlayer_1
%fakeplayer_uuid% FakePlayer The UUID of the fake player d6850f71-24e2-3d31-9ad4-1f5806837a17
%fakeplayer_spawner% FakePlayer Gets the name of the creator who summoned this fake player Steve
%fakeplayer_spawntime% FakePlayer The time when the fake player was summoned (The time format can be configured in the language file) 2026-07-01 00:00:00
%fakeplayer_actions% FakePlayer Gets the list of actions currently being executed by the fake player (The localized text and separator can be configured in the language file) Attack|Mine
Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more