User Guide
Contains all the information relating to running the VirtualPlayers plugin.
Installation
Requirements
- A Paper server (or other derivative) running 1.20.6 or above
Downloading
- Download the VirtualPlayers plugin
- Stop your server and place the plugins in your plugins folder
- Start the server and VirtualPlayers will load
Utilizing Virtual Players
Virtual players can be created using the /vp create <name> command. By default, most actions from virtual players will not be sent to observers. In order to see all chat and command messages the virtual player receives, you must run /vp verbose [true|false]. Virtual players can be removed with /vp remove <name>.
If you wish to perform a large number of actions with virtual players, you can select an individual player by running /vp select <player>. This will mean that commands such as /vp chat [player] or anything denoted with the optional "[player]" argument will not need the player name entered each time.
You can see all virtual players by running /vp list. If you wish to observe a virtual player not created by yourself, you can run /vp observe <player>.
Virtual players will also have the default command permissions upon creation, meaning they will not be able to run administrator commands. In order to op them, you can run /vp op [player].
Commands
| Command |
Description |
| /vp create <name> | Creates a new virtual player. |
| /vp remove <name> | Removes a virtual player. |
| /vp removeall | Removes all virtual players. |
| /vp select <player> | Select a virtual player. |
| /vp observe <player> | Observes a virtual player. |
| /vp unobserve <player> | Unobserves a virtual player. |
| /vp list | Lists virtual players. |
| /vp verbose [player] [true|false] | Toggles verbosity for the virtual player. |
| /vp teleport [player] [location] | Teleports the virtual player to a location. |
| /vp command [player] <command...> | Runs a command as a virtual player. |
| /vp chat [player] <message...> | Sends a chat message as a virtual player. |
| /vp op [player] | Ops the virtual player. |
| /vp deop [player] | De-ops the virtual player. |
| /vp attack [player] <target> [damage] | Attacks another player as this virtual player. |
Permissions
| Permission |
Command |
| virtualplayers.command.help | /vp [help] |
| virtualplayers.command.create | /vp create |
| virtualplayers.command.remove | /vp remove |
| virtualplayers.command.removeall | /vp removeall |
| virtualplayers.command.select | /vp select |
| virtualplayers.command.observe | /vp observe |
| virtualplayers.command.unobserve | /vp unobserve |
| virtualplayers.command.list | /vp list |
| virtualplayers.command.verbose | /vp verbose |
| virtualplayers.command.teleport | /vp teleport |
| virtualplayers.command.command | /vp command |
| virtualplayers.command.chat | /vp chat |
| virtualplayers.command.op | /vp op |
| virtualplayers.command.deop | /vp deop |
| virtualplayers.command.attack | /vp attack |