Difference between revisions of "RoboRumble/Contributing to RoboRumble"

From Robowiki
Jump to navigation Jump to search
(latest link highlighted)
m (Undo revision 53176 by MultiplyByZer0 (talk))
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div style="float: right; margin: 0.5em">__TOC__</div>
+
'''ATTENTION: This article is not about entering a new robot into RoboRumble. Enter [[RoboRumble/Enter The Competition|here]].'''
== Setting up ==
 
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.
 
  
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.
+
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.
  
=== With the ''Roborumble Superpack'' ===
+
Run it as much as you can! The more you run it, the faster everybody's bots will be ranked. Report problems [[{{TALKPAGENAME}}|here]].
The ''Roborumble Superpack'' is a zip file containing an updated Robocode 1.7.3.0 install, with all bots (as of 2011/01/23) downloaded already.
 
  
# Download and unzip the [http://dl.dropbox.com/u/4066735/roborumble-superpack-20110706.zip 'Roborumble Superpack'] with bots (28MB).
+
== Setting up ==
# for a the latest robot archive (automatically updated) grab [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (26.8MB) and extract it into the "robots" directory
+
# 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.
# Edit "roborumble/roborumble.txt", "roborumble/meleerumble.txt", "roborumble/teamrumble.txt", and "roborumble/twinduel.txt" files and change the Put_Your_Name_Here to your nick or your handle.
+
# 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.
# For newer CPU owners, disable [[Dynamic Overclocking]].
+
# Edit '''<code>roborumble/[roborumble/meleerumble/teamrumble/twinduel].txt</code>''' and change the <code>Put_Your_Name_Here</code> to your preferred username.
# There you go! You can start you client using roborumble.bat or roborumble.sh (depending on the OS)! Note, the first time it can take some time for robocode to examine the jar files.
+
# Extract the [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (35.9 MB zip file) into the "robots" directory.
 +
# (Optional) On newer CPUs on which you are planning to run RoboRumble exclusively, disable [[Dynamic Overclocking]].
  
=== From standard Robocode ===
+
There you go!
If you don't wish to use the ''Roborumble Superpack'', you may run the standard Robocode 1.7.3.0 or 1.7.3.2 installation if you fix the URLs in the config files.
 
  
# Make a new, clean installation of the version of '''Robocode 1.7.3.0 or 1.7.3.2''' ([http://sourceforge.net/projects/robocode/files/robocode/1.7.3.0/robocode-setup-1.7.3.0.jar/download download link]).
+
== Running battles ==
# Edit "roborumble/roborumble.txt", "roborumble/meleerumble.txt", and "roborumble/teamrumble.txt" file and change the Put_Your_Name_Here to your nick or your handle.
+
* Run [[1v1]] battles with '''<code>roborumble.bat</code>''' (Windows), '''<code>roborumble.sh</code>''' (Linux), or '''<code>roborumble.command</code>''' (MacOS).
# You might be also change all the http://rumble.fervir.com/ references (there are 3) to http://darkcanuck.net/
+
* Run [[melee]] battles with '''<code>meleerumble[.bat/.sh/.command]</code>'''.
# Extract the zip-file [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (26.8MB) into the "robots" directory.
+
* Run [[Teams|team]] battles with '''<code>teamrumble[.bat/.sh/.command]</code>'''.
# For newer CPU owners, disable [[Dynamic Overclocking]].
+
* Run [[Twin Duel|twin duel]] battles with '''<code>twinduel[.bat/.sh/.command]</code>'''.
# There you go!
 
# You can start your 1vs1 client using roborumble.bat, roborumble.sh or roborumble.command (depending on the OS)
 
# You can start your melee client using meleerumble.bat, meleerumble.sh or meleerumble.command (depending on the OS)!
 
# You can start your team client using teamrumble.bat, teamrumble.sh or teamrumble.command (depending on the OS)!
 
# Note, the first time it can take some time for robocode to examine the jar files.
 
  
=== Get robot database ===
+
== RoboRumble bot JARs ==
'''If you did not get the bots in the ''Roborumble Superpack''''', it is recommended that you get a reasonably up-to-date set of robots. Grab the following zip file and extract the .jar file to your RR@H robots directory. <br><br>
+
Downloads:
Since 21012.05.08 you can download the <font color="red">'''LATEST'''</font> robot pack from:
+
* [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/participants-latest.zip (26.8MB) (includes 1vs1, melee, team and twin bots)
+
* [http://robocode-archive.strangeautomata.com/ Earlier bot archives]
The file provides an archive of all robots in the rumble, which is automatically updates on an hourly basis. Thanks to [[User:Rednaxela|Rednaxela]] for maintaining this.<br> <br>
+
* [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])
For older robot versions, have a look at:
 
* http://robocode-archive.strangeautomata.com/robots  
 
  
==== 1vs1 database (dated) ====
+
Credits to [[Rednaxela]] for the archive server, and [[Jdev]] for the GitHub mirror.
get the 300 updates since ? till 20041017:
 
* http://robowiki.net/robocode/rrath_participants.zip (USA mirror)
 
* http://nat.robothai.net/robocode/rrath_participants.zip (Thailand mirror)
 
And get the 308 updates since 20041017 till 20070929:
 
* http://home.versatel.nl/gheijenk/robocode/things/rrath_add_20070929.zip (Netherlands mirror)
 
* http://nat.robothai.net/robocode/rrath_add_20070929.zip (Thailand mirror)
 
And get the 166 updates since 20070929 till 20090301:
 
* http://home.versatel.nl/gheijenk/robocode/things/rrath_add_20090301.zip (Netherlands mirror)
 
* http://nat.robothai.net/robocode/rrath_add_20090301.zip (Thailand mirror)
 
And get the 121 updates since 20090301 till 20090719
 
* http://nat.robothai.net/robocode/rrath_add_20090719.zip (Thailand mirror)
 
Get the updates since ? till 20120307:
 
* http://sites.google.com/site/mnrobocode/robots/Participants_20120307.zip
 
 
 
==== Melee database (dated) ====
 
* <s>http://home.versatel.nl/gheijenk/robocode/things/ParticipantsMelee_20080726.zip</s> (''replaced by the one below'')
 
* http://nat.robothai.net/robocode/ParticipantsMelee_20090719.zip
 
* http://sites.google.com/site/mnrobocode/robots/ParticipantsMelee_20120307.zip
 
 
 
==== Team database  (dated) ====
 
* http://home.versatel.nl/gheijenk/robocode/things/ParticipantsTeam_20080726.zip (Netherlands mirror)
 
* http://nat.robothai.net/robocode/ParticipantsTeam_20080726.zip (Thailand mirror)
 
* http://sites.google.com/site/mnrobocode/robots/ParticipantsTeams_20120307.zip
 
 
 
==== Twin Duel database (dated) ====
 
 
 
* http://sites.google.com/site/mnrobocode/robots/ParticipantsTwinDuel_20120307.zip
 
  
 +
== 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.
  
== How to enter a robot into the competition ==
+
== Troubleshooting ==
See here: [[RoboRumble/Enter_The_Competition]]
+
Remove the following files or directories:
 +
* <code>config/</code>
 +
* <code>roborumble/files/</code>
 +
* <code>roborumble/temp/</code>
 +
* <code>robots/robot.database</code>
  
== Problem reporting ==
+
And try again.
Issues on starting off with RoboRumble can be discussed on the [[Talk:RoboRumble/Starting With RoboRumble|talk page]].<br>
 
Old issues are archived at [[RoboRumble/StartingWithRoboRumbleOld]].
 
  
== Useful options in roborumble.txt ==
+
== Screenshots ==
* "'''USER'''": Your name/handle, used for identification of your roborumble client.
+
[[Image:RoboRumbleClient.png]]
* "'''BATTLESPERBOT'''" is the minimum number of battles a bot needs before it stops getting priority.
 
* "'''NUMBATTLES'''", the number of battles fought on each run of roborumble.
 
* "'''UPLOAD'''", can be used to disable uploading. Use this to disable uploading when testing a version of robocode NOT listed above. Note, the current server will reject results from incorrect versions anyway.
 
* "'''ITERATE'''", whether to run battles indefinitely.
 
  
 
== See Also ==
 
== See Also ==
 
{{:RoboRumble/Navigation}}
 
{{:RoboRumble/Navigation}}

Revision as of 23:31, 21 October 2017

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 (35.9 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