Difference between revisions of "RoboRumble/Contributing to RoboRumble"

From Robowiki
Jump to navigation Jump to search
m
(→‎From standard Robocode: updated Robocode version requirements and notes about URLs)
(35 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{:RoboRumble/Navigation}}
+
<div style="float: right; margin: 0.5em">__TOC__</div>
 +
== 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.
 +
 
 +
=== With the ''Roborumble Superpack'' ===
 +
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.
  
== <b>To collaborate with RR@H</b> ==
+
# Download and unzip the [http://dl.dropbox.com/u/4066735/roborumble-superpack-20110706.zip 'Roborumble Superpack'] with bots (28MB).
 +
# 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
 +
# 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.
 +
# For newer CPU owners, disable [[Dynamic Overclocking]].
 +
# 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.
  
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.
+
=== From standard Robocode ===
 +
If you don't wish to use the ''Roborumble Superpack'', you may run the standard Robocode 1.8.1.0 or 1.8.2.0 installation.
  
# Make a separate installation of Robocode in a different directory (like <code>C:\robohome</code>), so running the client will not influence your own development and vice versa. '''Please only use versions 1.5.4, 1.6.0, or 1.6.1.4, as they are proven stable.'''
+
# Make a new, clean installation of the version of '''Robocode 1.8.1.0 or 1.8.2.0''' ([http://sourceforge.net/projects/robocode/files/robocode/ download link]).
# Download patch [[Darkcanuck/RRServer/Updates|here]] and place in <code>/libs</code> directory under your installation.
+
# 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.  
# Edit "roborumble\roborumble.txt" file and change the Put_Your_Name_Here to your nick or your handler.
+
# You might be also ensure all the rumble server references are correct (there are 3).  For Literumble, they should all begin with http://literumble.appspot.com/
# Extract all the zip-files below into the "robots" directory
+
# Extract the zip-file [http://robocode-archive.strangeautomata.com/participants-latest.zip latest bot archive] (26.8MB) into the "robots" directory.
# Start the client using roborumble.bat or roborumble.sh (depending on the OS). The first time it can take more than 15 minutes before all jar-files are examined!
+
# For newer CPU owners, disable [[Dynamic Overclocking]].
#* Or, on your first time you can start robocode with robocode.bat or robocode.sh (depending on OS), wait for the robocode database to be updated, then close robocode and run roborumble.bat/roborumble.sh normally.
+
# There you go!
# Run it as much time as you can. The more you run it, the more you contribute. It is fully automated, so you don't have to care at all.
+
# You can start your 1vs1 client using roborumble.bat, roborumble.sh or roborumble.command (depending on the OS)  
# If you find problems, refer to RoboRumble related pages, or post your issue and we will try to solve it.
+
# 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 ===
 
=== Get robot database ===
To get a reasonably up-to-date set of robots for the rumble to start with, grab the following zip file and extract the .jar file to your RR@H robots directory:
+
'''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>
 
+
Since 2012.05.08 you can download the <font color="red">'''LATEST'''</font> robot pack from:
==== 1vs1 database ====
+
* http://robocode-archive.strangeautomata.com/participants-latest.zip (26.8MB) (includes 1vs1, melee, team and twin bots)
 +
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>
 +
For older robot versions, have a look at:
 +
* http://robocode-archive.strangeautomata.com/robots
 +
Since 2013.01.07 rumble robots archive and robots for Challenges also mirrored to GitHub repository on daily basis (download link exmple: https://github.com/aleksey-zhidkov/rc-repo-mirror/raw/master/sample.Walls_1.0.jar):
 +
* https://github.com/aleksey-zhidkov/rc-repo-mirror
 +
==== 1vs1 database (dated) ====
 
get the 300 updates since ? till 20041017:
 
get the 300 updates since ? till 20041017:
* http://robowiki.net/robocode/rrath_participants.zip
+
* http://robowiki.net/robocode/rrath_participants.zip (USA mirror)
* http://www.krillrfiles.com/robocode/rrath_participants.zip <-- not working
+
* http://nat.robothai.net/robocode/rrath_participants.zip (Thailand mirror)
 
And get the 308 updates since 20041017 till 20070929:
 
And get the 308 updates since 20041017 till 20070929:
* http://home.versatel.nl/gheijenk/robocode/things/rrath_add_20070929.zip
+
* 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:
 
And get the 166 updates since 20070929 till 20090301:
* http://home.versatel.nl/gheijenk/robocode/things/rrath_add_20090301.zip
+
* 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
  
==== Melee database ====
 
* http://home.versatel.nl/gheijenk/robocode/things/ParticipantsMelee_20080726.zip
 
  
==== Team database ====
+
== How to enter a robot into the competition ==
* http://home.versatel.nl/gheijenk/robocode/things/ParticipantsTeam_20080726.zip
+
See here: [[RoboRumble/Enter_The_Competition]]
  
 
== Problem reporting ==
 
== Problem reporting ==
Line 40: Line 78:
 
* "'''BATTLESPERBOT'''" is the minimum number of battles a bot needs before it stops getting priority.
 
* "'''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.
 
* "'''NUMBATTLES'''", the number of battles fought on each run of roborumble.
** If you want the roborumble client to run battles indefinitely, use one of the following scripts.
+
* "'''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.
  
== Script ==
+
== See Also ==
Those scripts will be good for roborumbler. They run battles forever, catching standard and error stream and put it to a file in the directory ./log/tempNUMBER_OF_BATTLE.txt (the script have to be in the roborumble directory), the scripts will not work without the "log" directory
+
{{:RoboRumble/Navigation}}
 
 
Note: For robocode version 1.6.1.4 and up, there is no need of the script anymore. Instead, set ITERATE=YES in your setting file.
 
 
 
=== Batch script for Windows users ===
 
Save this script to a file in the roborumble directory in a file with ".bat" extension, create a directory called "log", then run the script with double click:
 
<pre>
 
@echo off
 
title RoboRumble@Home Client
 
set count=1
 
:run
 
echo "Iteration number: %count%"
 
java -Xmx512M  -Dsun.io.useCanonCaches=false -cp libs/robocode.jar;libs/codesize.jar;libs/roborumble.jar roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt >> ./log/temp%count%.txt
 
echo ---
 
set /a count+=1
 
goto run
 
</pre>
 
 
 
=== Bash script for *nix users ===
 
Save this script to a file in the roborumble directory, right click and set the file executable, create a directory called "log", then run the script from shell:
 
<pre>
 
#!/bin/bash
 
 
 
echo #  new line
 
count=0
 
while [ "$var1" != "fine" ]    #  forever
 
do
 
  let "count=count+1"
 
  echo "battle n: " $count
 
  sh roborumble.sh &> ./log/temp$count.txt
 
  echo
 
done 
 
 
 
exit 0
 
</pre>
 

Revision as of 08:10, 18 November 2013

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.

With the Roborumble Superpack

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.

  1. Download and unzip the 'Roborumble Superpack' with bots (28MB).
  2. for a the latest robot archive (automatically updated) grab latest bot archive (26.8MB) and extract it into the "robots" directory
  3. 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.
  4. For newer CPU owners, disable Dynamic Overclocking.
  5. 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.

From standard Robocode

If you don't wish to use the Roborumble Superpack, you may run the standard Robocode 1.8.1.0 or 1.8.2.0 installation.

  1. Make a new, clean installation of the version of Robocode 1.8.1.0 or 1.8.2.0 (download link).
  2. 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.
  3. You might be also ensure all the rumble server references are correct (there are 3). For Literumble, they should all begin with http://literumble.appspot.com/
  4. Extract the zip-file latest bot archive (26.8MB) into the "robots" directory.
  5. For newer CPU owners, disable Dynamic Overclocking.
  6. There you go!
  7. You can start your 1vs1 client using roborumble.bat, roborumble.sh or roborumble.command (depending on the OS)
  8. You can start your melee client using meleerumble.bat, meleerumble.sh or meleerumble.command (depending on the OS)!
  9. You can start your team client using teamrumble.bat, teamrumble.sh or teamrumble.command (depending on the OS)!
  10. Note, the first time it can take some time for robocode to examine the jar files.

Get robot database

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.

Since 2012.05.08 you can download the LATEST robot pack from:

The file provides an archive of all robots in the rumble, which is automatically updates on an hourly basis. Thanks to Rednaxela for maintaining this.

For older robot versions, have a look at:

Since 2013.01.07 rumble robots archive and robots for Challenges also mirrored to GitHub repository on daily basis (download link exmple: https://github.com/aleksey-zhidkov/rc-repo-mirror/raw/master/sample.Walls_1.0.jar):

1vs1 database (dated)

get the 300 updates since ? till 20041017:

And get the 308 updates since 20041017 till 20070929:

And get the 166 updates since 20070929 till 20090301:

And get the 121 updates since 20090301 till 20090719

Get the updates since ? till 20120307:

Melee database (dated)

Team database (dated)

Twin Duel database (dated)


How to enter a robot into the competition

See here: RoboRumble/Enter_The_Competition

Problem reporting

Issues on starting off with RoboRumble can be discussed on the talk page.
Old issues are archived at RoboRumble/StartingWithRoboRumbleOld.

Useful options in roborumble.txt

  • "USER": Your name/handle, used for identification of your roborumble client.
  • "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