Testing AutoReferee

Interested in joining an elite demon-ninja hybrid task force planning to hold the world's helium reserves hostage? Ready to stare Death in the face and challenge him to a pillow fight, winner-take-all? Prepared to step on a lego barefoot without crying? Then you just might be man enough to test AutoReferee. Let's get setup together!

If at any point you believe you have found a bug, unexpected behavior, or just have an idea about how to improve AutoReferee, feel free to leave a ticket in our issue tracker. This helps us know what needs to be improved. Communication is key!

Step 0: Getting Setup!

First, install AutoReferee. This should be pretty straightfoward, in most cases as simple as downloading the plugin to your plugins folder. Once you have done this and have confirmed (by checking the console) that AutoReferee is loaded, configured, and running, we can begin testing the plugin. Note that no other plugins will be necessary, and many might conflict with AutoReferee, so consider disabling them for the duration of this test. If you choose to not disable your plugins and find that AutoReferee conflicts with a plugin on your system, please note this in an issue on the issue tracker. It is helpful for us to know which plugins cause issues when run with AutoReferee, so that we can note this in our documentation.

Step 1: Setting up a Match

Now is the fun part: fire up the server and hop on. If you aren't an op, you should at least have the autoreferee.admin permission node. If you want to configure a map of yours to work with AutoReferee, follow this tutorial for configuring a map. Otherwise, we get to skip that mess and jump right into the action. Huzzah!

Type /autoref maplist first to get a list of the various maps you can choose from. Dark grey names represent maps that are available, but not yet installed on your server; white names are maps that have been installed on your server. Choose any name on that list and type /autoref load <mapname>. If the map you choose has not been installed on your server, it will be automatically downloaded. Now you are ready to call some friends (tell them to bring money for pizza this time)!

Step 2: Playing a Match

Here you stand in this empty map, all alone. But fret not, simply /autoref invite <playername> to join you. They will be able to respond, yes or no, to your invitation. If they accept, they will be teleported to you to play with (or against) you. If they decline, don't worry: that just means one less Christmas present you have to buy this year. Win-win situation.

Once they are in the world with you, players should join a team with /jointeam <teamname>. Feel free to not specify a team name, in which case you will be assigned to the current smallest team. If you need to leave a team for any reason, /leaveteam. Players who disconnect before the match begins will be automatically removed from their team. Consider it a service, but the kind of service you didn't ask for, or sign up for, or want. Like advertisements. What were we talking about?

When your team is ready, type /ready. Once both teams are ready, the match will begin. If any referees are present, they should type /ready as well (keep in mind that if a referee types /ready, the match will start immediately, irrespective of whether or not the teams are ready). Once the map has begun, flip your switch, push your button, brush your teeth, do whatever it is that allows you to enter the lane and get started. Violently assault the other team with sharp weapons and complete the map objectives for glory. Blood for the blood god! Armok be praised! Once the match is complete, a match summary will be generated for everyone to whine over. Enjoy this moment. Savor the tears of your enemies.

Step X: Conclusion

So you completed a match, and now you have that feeling of emptiness that can only be filled with women and cheap booze? Why not do something productive? Send feedback! Leave an issue on the issue tracker detailing the results of your test. If everything went as expected, maybe drop us a comment in the testing issue thread, just to let us know that a test went successfully. Know that we really appreciate any testing you can find time to do. None of this project would be possible without the support and encouragement of the community.

The following is a list of helpful information when you provide feedback:

• System info (hardware, OS, java version, anything you can give)
• Match info (map, number of players, how did you acquire the map, etc)
• Game info (how did the game play? did everything work correctly?)
• Match summary link
• Your opinion on how things could be improved