fakeplayer

FakePlayer

This is a server side plugin inspired by Carpet-Mod for Minecraft `1.20.x` and `1.21.x` and above.

Click me to visit a demo video.

Features

+ Lets you spawn fake players who look like real to the server, they can keep chunk loading + Fake players can be recolonized by vanilla commands and plugin commands, such as `/ban`, `/tp` + You can open and edit their inventory via `/fp invsee` or Right-Clicking on them + You can fully control their moving, jumping, attacking... What's better ? Make it periodical + Each player can configure his personal configuration

Requirements

+ Paper or Purpur software + CommandAPI Plugin

Config file

Fakeplayer only generates a template config file named `config.tmpl.yml`. You need to rename this file to `config.yml` as your configuration file. This approach can let you preview new content when you are upgrading it.

Commands

| Command | Description | Permission | Note | |---------------|-------------------------------------------|------------------------------|-----------------------------------------------------------------| | /fp spawn | Spawn a fake player | fakeplayer.command.spawn | | | /fp kill | Kill a fake player | fakeplayer.command.kill | | | /fp killall | Kill all fake players on the server | OP | | | /fp select | Select a fake player as default | fakeplayer.command.select | Available when player spawned more then 1 fake players | | /fp selection | View selected fake player | fakeplayer.command.selection | Available only when player spawned more then 1 fake players | | /fp list | List spawned fake players | fakeplayer.command.list | | | /fp distance | Show distance to a fake player | fakeplayer.command.distance | | | /fp drop | Drop held item | fakeplayer.command.drop | | | /fp dropstack | Drop entire stack of the held item | fakeplayer.command.dropstack | | | /fp dropinv | Drop all items in the inventory | fakeplayer.command.dropinv | | | /fp skin | Copy skin from another player | fakeplayer.command.skin | 60 seconds cooldown if copy from a offline player | | /fp invsee | Open an inventory of a fake player | fakeplayer.command.invsee | Right-clicking on fake players has the same effect | | /fp sleep | Sleep | fakeplayer.command.sleep | | | /fp wakeup | Wake up | fakeplayer.command.wakeup | | | /fp status | Show player status | fakeplayer.command.status | | | /fp respawn | Respawn a dead fake player | fakeplayer.command.respawn | Available when server config does not kick on fake player death | | /fp tp | Teleport to a fake player | fakeplayer.command.tp | | | /fp tphere | Teleport a fake player to you | fakeplayer.command.tphere | | | /fp tps | Swap positions with fake player | fakeplayer.command.tps | | | /fp set | Change the configuration of a fake player | fakeplayer.command.set | | | /fp config | Change default configuration | fakeplayer.command.config | | | /fp expme | Transfer exp to you | fakeplayer.command.expme | | | /fp attack | Attack | fakeplayer.command.attack | | | /fp mine | Mine | fakeplayer.command.mine | | | /fp use | Use/Interact/Place | fakeplayer.command.use | | | /fp jump | Jump | fakeplayer.command.jump | | | /fp stop | Stop all actions | fakeplayer.command.stop | | | /fp turn | Turn around | fakeplayer.command.turn | | | /fp look | Look at specified location | fakeplayer.command.look | | | /fp move | Move | fakeplayer.command.mvoe | | | /fp ride | Ride | fakeplayer.command.ride | | | /fp sneak | Sneak | fakeplayer.command.sneak | | | /fp sprint | Sprinting | fakeplayer.command.sprint | | | /fp swap | Swap main and off-hand items | fakeplayer.command.swap | | | /fp hold | Hold corresponding hotbar item | fakeplayer.command.hold | | | /fp cmd | Execute command | fakeplayer.command.cmd | | | /fp reload | Reload config file | OP | |

Personal Configuration

own can configure his own configuration, it will take effect on the next spawning

Command examples:

+ `/fp config list` - View all personalized configurations + `/fp config set collidable false` - Set personalized configuration

| Configuration Item | Note | |--------------------|-------------------------------------------------------------------------------------------------------------------------------------| | collidable | Whether collision box is enabled | | invulnerable | Whether invincible mode is enabled | | wolverine | Whether super heal mode is enabled | | look_at_entity | Automatically look at nearby attackable entities (including players), can be combined with `attack` to automatically fight monsters | | pickup_items | Whether to pick up items | | skin | Whether to use your skin | | replenish | Whether to auto-replenish | | autofish | Whether to autofish |

Permissions

Placeholder Variables

+ `%fakeplayer_total%`: Total count of fake players + `%fakeplayer_creator%`: The creator name of a fake player + `%fakeplayer_actions`: Active actions of a fake player such as : `USE|ATTACK`

Custom Translation

1. Create a `message` folder in `plugins/fakeplayer` 2. Copy this file to `message` folder 3. Rename the file to `message_language_region.properties` such as `message_en_us.properties` 4. Edit your `config.yml`, set `i18n.locale` to the name suffix which you just created such as `en_us` 5. Type `/fp reload-translation` to reload translation file. If you change `i18n.local`, you should `/fp reload` first

Make sure the translation file is encoding with UTF-8

FAQs

xxx lost connection: PacketEvents 2.0 failed to inject

Some plugin change the `Connection` of the fake player, You can set `prevent-kicking` to `ALWAYS` to solve it.

```yaml

config.yml

prevent-kicking: ALWAYS ```

Fake players do not attract aggression

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 receive hunger and health effects. You may need to use `res` or beacon to ensure the fake player's `hunger` and `health`.

Fake players automatically log out after a while

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 plugin from kicking out players for being idle:

```yaml

Note: You should use a complex password, or AuthMe may reject it

self-commands: - '/register abc123! abc123!' - '/login abc123!' ```