Difference between revisions of "RoboRumble/Contributing to RoboRumble"

From Robowiki
Jump to navigation Jump to search
m (MultiplyByZer0 moved page RoboRumble/Starting With RoboRumble to RoboRumble/Contributing to RoboRumble: New name reflects the purpose of the page better)
m (→‎Setting up: update size)
(9 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
'''ATTENTION: This article is not about entering a new robot into RoboRumble. Enter [[RoboRumble/Enter The Competition|here]].'''
 
'''ATTENTION: This article is not about entering a new robot into RoboRumble. Enter [[RoboRumble/Enter The Competition|here]].'''
  
If you entered a bot into the competition, you could consider to collaborate running the competition by using your computer to execute battles and upload results (similar to SETI@Home project). The process is fully automated, so there is no pain on doing it.
+
You should consider contributing to RoboRumble and the Robocode community, by donating spare computer time to execute battles between bots (similar to the [http://folding.stanford.edu/ Folding@home] and [https://setiathome.berkeley.edu/ SETI@Home] projects). The process is fully automated, so there is no pain in doing it.
  
Run it as much as you can! The more you run it, the faster everybody's bots will be ranked. If you find problems, refer to the RoboRumble related pages, or post your issue and we will try to solve it.
+
Run it as much as you can! The more you run it, the faster everybody's bots will be ranked. Report problems [[{{TALKPAGENAME}}|here]].
 
 
[[{{TALKPAGENAME}}|Report problems here]].
 
  
 
== Setting up ==
 
== Setting up ==
 
+
# Make sure you are using Java SE 8. Older versions of Java may not work with certain bots, and Robocode 1.9.2.6 currently has problems when running on Java 9.
# Make a new, clean installation of the version of '''Robocode''' ([http://sourceforge.net/projects/robocode/files/robocode/ download link]). that matches what the [http://literumble.appspot.com/RumbleStats LiteRumble Statistics] indicates is allowed.
+
# Make a new, clean installation of the version of Robocode ([http://sourceforge.net/projects/robocode/files/robocode/ download]) that matches what [http://literumble.appspot.com/RumbleStats LiteRumble] indicates is allowed.
 
# Edit '''<code>roborumble/[roborumble/meleerumble/teamrumble/twinduel].txt</code>''' and change the <code>Put_Your_Name_Here</code> to your preferred username.
 
# Edit '''<code>roborumble/[roborumble/meleerumble/teamrumble/twinduel].txt</code>''' and change the <code>Put_Your_Name_Here</code> to your preferred username.
# Extract the zip-file [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (35.9 MB) into the "robots" directory.
+
# Extract the [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (41.0 MB zip file) into the "robots" directory.
 
# (Optional) On newer CPUs on which you are planning to run RoboRumble exclusively, disable [[Dynamic Overclocking]].
 
# (Optional) On newer CPUs on which you are planning to run RoboRumble exclusively, disable [[Dynamic Overclocking]].
  
Line 17: Line 15:
  
 
== Running battles ==
 
== Running battles ==
 
+
* Run [[1v1]] battles with '''<code>roborumble.bat</code>''' (Windows), '''<code>roborumble.sh</code>''' (Linux), or '''<code>roborumble.command</code>''' (MacOS).
* 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 [[melee]] battles with '''<code>meleerumble[.bat/.sh/.command]</code>'''.
 
* Run [[Teams|team]] battles with '''<code>teamrumble[.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>'''.
 
* Run [[Twin Duel|twin duel]] battles with '''<code>twinduel[.bat/.sh/.command]</code>'''.
  
== Getting the RoboRumble bot JARs ==
+
== RoboRumble bot JARs ==
 
+
Downloads:
The latest bot archive is available [http://robocode-archive.strangeautomata.com/participants-latest.zip here] (35.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/participants-latest.zip The latest bot archive] (35.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]
For earlier robot versions, see [http://robocode-archive.strangeautomata.com/robots/ here]. For earlier zip archive, see [http://robocode-archive.strangeautomata.com/ here]. A mirror is available [https://github.com/aleksey-zhidkov/rc-repo-mirror on GitHub].
+
* [http://robocode-archive.strangeautomata.com/robots/ All JARs that have ever been submitted into the RoboRumble] ([https://github.com/aleksey-zhidkov/rc-repo-mirror GitHub mirror])
  
Credits to [[Rednaxela]] for creating this.
+
Credits to [[Rednaxela]] for the archive server, and [[Jdev]] for the GitHub mirror.
  
 
== Useful options in roborumble.txt ==
 
== Useful options in roborumble.txt ==
Line 37: Line 34:
 
* '''ITERATE''' ‒ Whether to run battles indefinitely.
 
* '''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.
 
* '''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 ==
 
== See Also ==
 
{{:RoboRumble/Navigation}}
 
{{:RoboRumble/Navigation}}

Revision as of 13:28, 18 January 2019

ATTENTION: This article is not about entering a new robot into RoboRumble. Enter here.

You should consider contributing to RoboRumble and the Robocode community, by donating spare computer time to execute battles between bots (similar to the Folding@home and SETI@Home projects). The process is fully automated, so there is no pain in doing it.

Run it as much as you can! The more you run it, the faster everybody's bots will be ranked. Report problems here.

Setting up

  1. Make sure you are using Java SE 8. Older versions of Java may not work with certain bots, and Robocode 1.9.2.6 currently has problems when running on Java 9.
  2. Make a new, clean installation of the version of Robocode (download) that matches what LiteRumble indicates is allowed.
  3. Edit roborumble/[roborumble/meleerumble/teamrumble/twinduel].txt and change the Put_Your_Name_Here to your preferred username.
  4. Extract the latest bot archive (41.0 MB zip file) into the "robots" directory.
  5. (Optional) On newer CPUs on which you are planning to run RoboRumble exclusively, disable Dynamic Overclocking.

There you go!

Running battles

  • Run 1v1 battles with roborumble.bat (Windows), roborumble.sh (Linux), or roborumble.command (MacOS).
  • Run melee battles with meleerumble[.bat/.sh/.command].
  • Run team battles with teamrumble[.bat/.sh/.command].
  • Run twin duel battles with twinduel[.bat/.sh/.command].

RoboRumble bot JARs

Downloads:

Credits to Rednaxela for the archive server, and Jdev 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.
  • NUMBATTLES ‒ The number of battles fought on each run of roborumble
  • 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:

  • config/
  • roborumble/files/
  • roborumble/temp/
  • robots/robot.database

And try again.

Screenshots

RoboRumbleClient.png

See Also