View source for RoboRumble/Contributing to RoboRumble

Consider contributing to RoboRumble by donating spare computer time to execute battles between bots. In doing so, you help the RoboRumble server display accurate rankings and the Robocode community understand the relative strengths of each bot.

You should run the RoboRumble client:
* if a new bot has been added, or a new bot version has been released
* if the rankings are not stable
* if any robot has fewer than 2000 battles
* or all the time if you want to make it a service. 

Similar to the [http://folding.stanford.edu/ Folding@home] and [https://setiathome.berkeley.edu/ SETI@Home] projects, the process is fully automated. Report problems [[{{TALKPAGENAME}}|on this talk page]].

== Setting up ==
# Go to [http://literumble.appspot.com/RumbleStats LiteRumble Statistics] and record what is next to "Allowed Robocode versions:"
# Go to the [http://sourceforge.net/projects/robocode/files/robocode/ Robocode downloads page], and download the version of Robocode that matches the allowed Robocode version in the previous step.
# Make a new, clean installation of that version of Robocode somewhere.
# In your new Robocode folder, edit '''<code>roborumble/[roborumble/meleerumble/teamrumble/twinduel].txt</code>''' and change the <code>Put_Your_Name_Here</code> to your preferred username.
# Extract the [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (40.9 MB zip file) into the "robots" directory.
# Optionally, only on CPUs where you are planning to run RoboRumble exclusively, disable [[wikipedia:Dynamic frequency scaling|dynamic frequency scaling]] (e.g. Intel SpeedStep) in your BIOS for more accurate results.

You are done!

== Running battles ==
* Run [[1v1]] battles with '''<code>roborumble.bat</code>''' (Windows), '''<code>roborumble.sh</code>''' (Linux), or '''<code>roborumble.command</code>''' (MacOS).
* Run [[melee]] battles with '''<code>meleerumble[.bat/.sh/.command]</code>'''.
* Run [[Teams|team]] battles with '''<code>teamrumble[.bat/.sh/.command]</code>'''.
* Run [[Twin Duel|twin duel]] battles with '''<code>twinduel[.bat/.sh/.command]</code>'''.

== RoboRumble bot JARs ==
Downloads:
* [http://robocode-archive.strangeautomata.com/participants-latest.zip The latest bot archive] (40.9 MB). It contains the JARs of all robots in the rumble, automatically updated on an hourly basis. Unzip them into your <code>robots/</code> folder.
* [http://robocode-archive.strangeautomata.com/ Earlier bot archives]
* [http://robocode-archive.strangeautomata.com/robots/ All JARs that have ever been submitted to RoboRumble] 
* [https://github.com/robomirror/mirror GitHub mirror of all RoboRumble JARs]

Credits to [[Rednaxela]] for the archive server, and [[Xor]] for the GitHub mirror.

== Useful options in roborumble.txt ==
* '''USER''' ‒ Your name/handle, used for identification of your roborumble client.
* '''BATTLESPERBOT''' ‒ The minimum number of battles a bot needs before it stops getting priority. Should be at least 5000 for more reliable results. 
* '''NUMBATTLES''' ‒ The number of battles fought on each run of roborumble. Should be set to lower values, e.g. 15, when running RoboRumble as a service.
* '''ITERATE''' ‒ Whether to run battles indefinitely.
* '''UPLOAD''' ‒ Can be used to disable uploading. Disable uploading when testing a version of Robocode NOT allowed by the server. Not really necessary, as the current server will reject results from incorrect versions anyway.

== Troubleshooting ==
Remove the following files or directories:
* <code>config/</code>
* <code>roborumble/files/</code>
* <code>roborumble/temp/</code>
* <code>robots/robot.database</code>

And try again.

== Screenshots ==
[[Image:RoboRumbleClient.png]]

== See Also ==
{{:RoboRumble/Navigation}}