VirtualPlayers2

Table of Contents

NOTE: This project has moved to Modrinth. All future updates will be posted there and this page will no longer receive updates.

A plugin that allows you to create virtual players for easy debugging of plugins through console or in-game.

VirtualPlayers is a plugin designed for developers and server admins to easily test and debug plugins that require multiple players. Virtual players are non-existent in-game, and are only accessible through console or chat, meaning they will be invisible on the server list, player count and in-game.

VirtualPlayers will also work with many large Minecraft plugins, such as WorldEdit, allowing you to perform actions that are typically reserved for online players, but through a console. Virtual players can also be managed in-game, or through other command senders, such as command blocks or signs.

Features

Run commands as a virtual player through console or chat
Send messages as a virtual player through console or chat
Teleport a virtual player to a specific location
Op/de-op a virtual player to test command execution
Attack a real player as a virtual player to test combat mechanics

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

Developer Guide

VirtualPlayers offers an API for developers to use. Please see the Developer Guide for instructions on using the API.

Comments

auraliux
- Join Date: 3/20/2020
- Posts: 3
- Member Details
#56 auraliux

View User Profile

Send Message

Posted Mar 28, 2020
trying to run /dc in command blocks returns "you need to be op to run this command". :o

Rollback Post to Revision RollBack
bufhimat
- Join Date: 8/20/2019
- Posts: 5
- Member Details
#55 bufhimat

View User Profile

Send Message

Posted Sep 2, 2019
This plugin is exactly what I was looking for to be able to run player-only commands at a distance from the player. I was able to teleport a virtualplayer to a coordinate and have it run a player-only command for the player to observe what is happening.

Rollback Post to Revision RollBack
Forge_User_30934570
- Join Date: 9/2/2017
- Posts: 6
- Member Details
#54 Forge_User_30934570

View User Profile

Send Message

Posted Jun 21, 2019
Great plugin! Thank you so much!
Works well on Spigot, and very good to test my plugins without having to start Minecraft!

Rollback Post to Revision RollBack
MattiBorchers
- Join Date: 6/3/2019
- Posts: 1
- Member Details
#52 MattiBorchers

View User Profile

Send Message

Posted Jun 3, 2019
Hello Kalashnikov79,

sadly, the 1.13 link is down. And are there plans for a 1.14 version?

Last edited by MattiBorchers: Jun 3, 2019

Rollback Post to Revision RollBack
Redned_23
- Join Date: 6/4/2019
- Posts: 2
- Member Details
#53 Redned_23

View User Profile

Send Message

Posted Jun 4, 2019
In reply to MattiBorchers:

The repository it used to be hosted on is currently down. Please join the BattlePlugins Discord if you wish to recieve a jar (latest version supports both 1.13 and 1.14): https://discord.gg/tMVPVJf.

Alternatively, you can compile it yourself here:

https://github.com/BattlePlugins/VirtualPlayers

(Just know, these builds have not been approved by the BukkitDev staff. Use them at your own risk.)

Last edited by Redned_23: Jun 4, 2019

Rollback Post to Revision RollBack
Kalashnikov79
- Join Date: 1/31/2012
- Posts: 253
- Member Details
#51 Kalashnikov79

View User Profile

Send Message

Posted Nov 14, 2018
Here's a quick update for Minecraft 1.13:

These builds have not been approved by the BukkitDev staff. Use them at your own risk.

http://rainbowcraft.sytes.net/download/plugins/VirtualPlayers2/v1.7.4.1/

Still have to do some testing before I release it on BukkitDev.

So lemme know if there are any issues.

Rollback Post to Revision RollBack
Kalashnikov79
- Join Date: 1/31/2012
- Posts: 253
- Member Details
#49 Kalashnikov79

View User Profile

Send Message

Posted Jan 17, 2018
Updated for both 1.11 and 1.12

Rollback Post to Revision RollBack
Forge_User_54865192
- Join Date: 1/5/2016
- Posts: 7
- Member Details
#44 Forge_User_54865192

View User Profile

Send Message

Posted Oct 22, 2017
@Europia79 Have you totally abandoned the plugin or you'll continue it? I think this is great project, and there are no other plugins like this!

Last edited by Forge_User_54865192: Oct 22, 2017

Rollback Post to Revision RollBack
_ForgeUser27175067
- Join Date: 8/24/2016
- Posts: 10
- Member Details
#45 _ForgeUser27175067

View User Profile

Send Message

Posted Oct 25, 2017
In reply to Forge_User_54865192:

This plugin might not be updated but it should work fine

Rollback Post to Revision RollBack
Forge_User_54865192
- Join Date: 1/5/2016
- Posts: 7
- Member Details
#46 Forge_User_54865192

View User Profile

Send Message

Posted Oct 26, 2017
In reply to overdraft015:

I tried it, but it doesnt work on 1.12.2

Rollback Post to Revision RollBack
Kalashnikov79
- Join Date: 1/31/2012
- Posts: 253
- Member Details
#47 Kalashnikov79

View User Profile

Send Message

Posted Nov 17, 2017
In reply to Forge_User_54865192:

https://github.com/Europia79/VirtualPlayers/tree/master/modules

Looks like the last module that was added was for 1.10

It's pretty easy to update. You just have to copy/paste the previous vX_Y_Z module, then edit the pom.xml to the new version, then edit the imports and check for
compiler errors. Then use maven to build.

Rollback Post to Revision RollBack
Forge_User_44305834
- Join Date: 3/2/2016
- Posts: 23
- Member Details
#43 Forge_User_44305834

View User Profile

Send Message

Posted Feb 28, 2017
plase not fuction for 1.9.4 all error no list user in the list and online not found? plase update thanks xD

Rollback Post to Revision RollBack
_ForgeUser12192054
- Join Date: 9/14/2013
- Posts: 397
- Member Details
#42 _ForgeUser12192054

View User Profile

Send Message

Posted Feb 23, 2017
Great plugin!

Do the virtual players show up in the player list? Also are the counted as players in the online players in the servers lists? (I mean if a have 5 virtual players an zero real players, will the number be shown as 5/100, 5 players of a total of 100?)

Thanks

Rollback Post to Revision RollBack
Kalashnikov79
- Join Date: 1/31/2012
- Posts: 253
- Member Details
#48 Kalashnikov79

View User Profile

Send Message

Posted Nov 17, 2017
In reply to resoluciones:

I don't remember... I really don't think so... as you've probably already tested.

VirtualPlayers was originally created to be able to run commands from the console... but have the commands ran by an in-game VirtualPlayer.

The original purpose was to be able to test BattleArena with just one person. Normally, you would need TWO people just to test a multiple game, like arenas... but with VirtualPlayers, we can solo test multiplayer games.

Another, unforeseen use-case emerged a little while back... There was a bug in Minecraft where one of the blocks (forget which one) corrupted the World... and any player that logged near the corrupted chunks would be kicked. So... I have no clue what other servers did to fix this... but me, I just logged in with a VirtualPlayer and edited away the buggy blocks... and fixed the corrupted chunks.

I'm really not sure what everyone else uses the plugin for ? I am curious tho.

Rollback Post to Revision RollBack
penguiino_os
- Join Date: 3/23/2018
- Posts: 9
- Member Details
#50 penguiino_os

View User Profile

Send Message

Posted Nov 7, 2018
In reply to Europia79:

I'm planning to create a skript script that uses this to rebuild a minigame arena.

Rollback Post to Revision RollBack
_ForgeUser12631024
- Join Date: 11/16/2013
- Posts: 2
- Member Details
#41 _ForgeUser12631024

View User Profile

Send Message

Posted Mar 5, 2016
Hey!

Plugin is great but it does not work on version 1.9. Could you update it?

I really care. Thanks.

Rollback Post to Revision RollBack
_ForgeUser18058368
- Join Date: 12/2/2014
- Posts: 95
- Member Details
#40 _ForgeUser18058368

View User Profile

Send Message

Posted Jan 13, 2016
Hi is it possible to take control of the virtual player and have him place a sign and edit it ? I can place any block but when i want to make the vp place a sign, the sign doesn't appear

thanks

Last edited by _ForgeUser18058368: Jan 13, 2016

Rollback Post to Revision RollBack
Kalashnikov79
- Join Date: 1/31/2012
- Posts: 253
- Member Details
#39 Kalashnikov79

View User Profile

Send Message

Posted Dec 20, 2015
@LaughNgamez

oh... thanks for reminding me man !!! i made a section called WorldEdit Compatibility for all the information (easy to find than a buried comment).

@Unpluggeddk

The easiest solution is to delete 2 lines of code from WorldEdit... The next easiest solution is for VirtualPlayers to provide an API that WorldEdit can use. However, modifying only the VirtualPlayers codebase to be compatible with WorldEdit is not an easy task. You have to inject the VirtualPlayer into the server's playerList... that's the easy part. Then you have to modify the entire logic of the VirtualPlayers plugin because since they're inside the server's playerList, they will be consider REAL, not virtual. This step is intermediate difficulty... not too hard... just time consuming. The hard part is giving the VirtualPlayer a PlayerConnection object in order to fix all the errors that you'll get.

Rollback Post to Revision RollBack
_ForgeUser8340299
- Join Date: 1/30/2012
- Posts: 172
- Member Details
#38 _ForgeUser8340299

View User Profile

Send Message

Posted Dec 20, 2015
@Unpluggeddk

You have to use old World Edit or a build posted in the comments of this post.

Rollback Post to Revision RollBack
Forge_User_51989634
- Join Date: 4/23/2012
- Posts: 151
- Member Details
#37 Forge_User_51989634

View User Profile

Send Message

Posted Nov 29, 2015
@Europia79

Np....

Btw mate, did you find a solution for using virtual players with worldedit?

like:

/dc bobby op
/dc bobby region select Deathrunstart
/dc bobby /set 0
Last edited by Forge_User_51989634: Nov 29, 2015

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.