English | 简体中文

FakePlayerPlus

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

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.

• Note: Before performing the migration, please make sure to back up your original data files to prevent irreversible data loss.
• Steps: Copy the minecraft-fakeplayer database file from plugins/fakeplayer/data.db into the plugins/FakeplayerPlus directory. Then, execute /fp import data.db fake_player_profile to import the data.

Features

• Identical to Real Players
• Keep Chunks Loaded: Summon fake players to help you keep chunks loaded and mobs refreshing
• Inventory Storage: You can use the fake player's inventory to store items.
• Behavior & Action Control: Supports controlling fake players to perform actions such as attacking, mining, jumping, fishing, etc., and supports periodic loops.
• Developer API🚀: Core features have been abstracted into an api package, available for plugin developers to invoke
• Language Files 🚀: Custom language files supported with hot-reload
• Dynamic Count Adjustment 🚀: When the server TPS is too low, it can kick fake players and lower the summon limit
• Settings GUI 🚀: Quickly toggle entity collision, invincibility mode, auto-restock, and other features via Dialog interface.
• Action GUI 🚀: Easily execute fake player actions via Dialog interface
• Chat Feature 🚀: Make fake players send chat messages using /fp chat
• Latency (PING) Settings 🚀: Configure fake player ping values, or simulate ping jitter to camouflage real players
• Multi-user Management 🚀: Players can share fake player control rights with each other

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 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 vanilla 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 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 <action>	Open the Action Execution GUI	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

Fake Player Independent Settings / Actions

Please refer to the /fp settings and /fp action commands.

PlaceholderAPI

Placeholder	Type	Description	Example Output
%fakeplayer_total%	Global	Gets the total number of fake players currently online across the server	5
%fakeplayer_isfake%	Player	Checks if the current player is a fake player	true / false
%fakeplayer_spawner%	Fake Player	Gets the name of the creator who summoned this fake player	Steve
%fakeplayer_actions%	Fake Player	Gets the list of actions currently being executed by the fake player (Localized)	Attack|Mine