FakePlayerPlus

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 18 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**English** | [简体中文](./README.zh.md)

# FakePlayerPlus ![](https://img.shields.io/badge/Paper-1.21.11_--_26.2-2B7FFF?logo=telegram&logoColor=3884F7) ![](https://img.shields.io/badge/Folia-1.21.11_--_26.2-C33CCA?logo=leaflet&logoColor=C33CCA)

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](https://github.com/tanyaofei/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

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

## Fake Player Independent Settings / Actions

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

![FakePlayer UI](https://github.com/user-attachments/assets/a60189fa-3416-4164-9854-16dedb05b721)

## PlaceholderAPI

FakePlayerPlus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README