Robocode/Developers Guide for modify Robocode - Revision history

FlemmingLarsen: /* WINDOWS: */

2009-02-25T22:43:57Z

WINDOWS:

FlemmingLarsen: /* UNIX: */

2009-02-25T22:43:45Z

UNIX:

Lestofante: /* Create MOD launch file */

2008-12-16T22:02:52Z

Create MOD launch file

Lestofante: /* Modifing source code */

2008-12-11T19:00:39Z

Modifing source code

Lestofante: /* Modifing source code */

2008-12-11T18:30:57Z

Modifing source code

Lestofante: /* Modifing source code */

2008-12-11T18:30:07Z

Modifing source code

Lestofante at 18:28, 11 December 2008

2008-12-11T18:28:51Z

Lestofante: /* Create MOD launch file */

2008-12-11T18:20:09Z

Create MOD launch file

Lestofante: /* MOD version */

2008-12-11T18:17:44Z

MOD version

Lestofante: New page: This guide show you how to modify some parts or all of your robocode without need of reinstall it. You can choose if run the original or the MOD version ==Developer's Guide for building Ro...

2008-12-11T18:17:21Z

New page: This guide show you how to modify some parts or all of your robocode without need of reinstall it. You can choose if run the original or the MOD version ==Developer's Guide for building Ro...

New page

This guide show you how to modify some parts or all of your robocode without need of reinstall it.
You can choose if run the original or the MOD version
==Developer's Guide for building Robocode==
===Software Requirements===
* Sun's Java SE JDK (5.0 or >) or alternatives
* Robocode installed (same version as source)
* Robocode source (same version as installer)
* Text editor

Install the java SDK (JRE is not enough), then install robocode. As text editor you can simply use block notes, gedit, ecc.. You surely have installed one basic text editor in your operative system.

===Create MOD launch file===
We want create a mod but we don't want break the original robocode, so here the solution:
* open home folder of robocode (the installation directory)
* create a copy of robocode.sh and roborumble.sh (robocode.bat and roborumble.bat in windows), this will be your mod runner
* open the copy made after and delete ".jar" in the -cp option for roborumble and robocode
:example:
:old roborumble.sh(or roborumble.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar:libs/codesize.jar:libs/roborumble.jar roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
:new roborumble.sh(or roborumble.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode:libs/codesize.jar:libs/roborumble roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
* now open folder "libs" and extract robocode.jar and roborumble.jar (Warnig: prevent path error using "extract here" option), if nesessary set this folder's permission as read/write for your user
* try the modified version of robocode.sh or roborumble.sh (.bat for windows): everything should work as the original version

===Modifing source code===
If the MOD launch file is working is time for modify your robocode version.
* extract roborumble source code where you want
* find the source file you want modify
* copy it under the extracted folder "libs" in the right location indicated by file's package(tip: if you are in the right directory you will find a .class file with the same name as your .java)
* modify your source code

===Compiling Robocode's code===
I assume:

robocodeDir is the directory where you intalled robocode

fileName is the name of the file you want compile

fileDir it's the directory of the file you want compile

====UNIX:====
<pre>
cd fileDir
javac -cp robocodeDir/libs/robocode:robocodeDir/libs/roborumble fileName
</pre>

:example:
:robocodeDir = ~/robocode
:fileName = RoboRumbleAtHome.java (the main file of roborumble)
:fileDir = robocodeDir/libs/roborumble/roborumble
<pre>
cd ~/robocode/libs/roborumble/roborumble
javac -cp ~/robocode/libs/robocode:~/robocode/libs/roborumble RoboRumbleAtHome.java
</pre>

====WINDOWS:====
<pre>
cd fileDir
javac -cp robocodeDir\libs\robocode;robocodeDir\libs\roborumble fileName
</pre>

:example:
:robocodeDir = C:\robocode
:fileName = RoboRumbleAtHome.java (the main file of roborumble)
:fileDir = robocodeDir\libs\roborumble\roborumble
<pre>
cd C:\robocode\libs\roborumble\roborumble
javac -cp C:\robocode\libs\robocode;C:\robocode\libs\roborumble RoboRumbleAtHome.java
</pre>

===Launch Robocode===

====Original version====
Simply use the original robocode.sh or roborumble.sh (windows: robocode.bat or roborumble.bat)

====MOD version====
Simply use the [[Robocode/Developers Guide for modify Robocode/Create MOD launch file|modified]] robocode.sh or roborumble.sh (windows: robocode.bat or roborumble.bat)

@@ Line 16: / Line 16: @@
 * open the copy and delete ".jar" in the -cp option for roborumble and robocode
 :example:
-:old roborumble.sh(or roborumble.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar:libs/codesize.jar:libs/roborumble.jar roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
+:old roborumble.sh(or roborumble.bat): <pre>java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar:libs/codesize.jar:libs/roborumble.jar roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt</pre>
-:new roborumbleMOD.sh(or roborumbleMOD.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode:libs/codesize.jar:libs/roborumble roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
+:new roborumbleMOD.sh(or roborumbleMOD.bat): <pre>java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode:libs/codesize.jar:libs/roborumble roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt</pre>
 * now open folder  "libs" and extract robocode.jar and roborumble.jar (Warnig: prevent path error using "extract here" option), if necessary set this folder's permission as read/write for your user
 * try the modified version of robocode.sh or roborumble.sh (.bat for windows): everything should work normally

@@ Line 27: / Line 27: @@
 * copy it under the extracted folder "libs" in the right location indicated by file's package(tip: if you are in the right directory you will find a .class file with the same name as your .java)
 * modify your source code
-* if your MOD works send your code at [[https://sourceforge.net/tracker/?group_id=37202&atid=419489 souceforge.net page]] and if it's good enough will be implemented in the next version of robocode
+* if your MOD works send your code at [http://sourceforge.net/tracker/?group_id=37202&atid=419488 patch tracker] and if it's good enough will be implemented in the next version of robocode
 tip: is better import only the source code of the file you want modify and not all, so you know where you have changed something

@@ Line 27: / Line 27: @@
 * copy it under the extracted folder "libs" in the right location indicated by file's package(tip: if you are in the right directory you will find a .class file with the same name as your .java)
 * modify your source code
-* if your MOD works send your code at [[https://sourceforge.net/tracker/?group_id=37202&atid=419489|robocode souceforge.net page]] and if it's good enough will be implemented in the next version of robocode
+* if your MOD works send your code at [[https://sourceforge.net/tracker/?group_id=37202&atid=419489 souceforge.net page]] and if it's good enough will be implemented in the next version of robocode
 tip: is better import only the source code of the file you want modify and not all, so you know where you have changed something

@@ Line 27: / Line 27: @@
 * copy it under the extracted folder "libs" in the right location indicated by file's package(tip: if you are in the right directory you will find a .class file with the same name as your .java)
 * modify your source code
-* if your MOD works send your code at [[https://sourceforge.net/tracker/?group_id=37202&atid=419489]] and if it's good enough will be implemented in the next version of robocode
+* if your MOD works send your code at [[https://sourceforge.net/tracker/?group_id=37202&atid=419489|robocode souceforge.net page]] and if it's good enough will be implemented in the next version of robocode
 tip: is better import only the source code of the file you want modify and not all, so you know where you have changed something

← Older revision		Revision as of 18:17, 11 December 2008
Line 73:		Line 73:

	====MOD version====		====MOD version====
−	Simply use the [[Robocode/Developers Guide for modify Robocode/Create MOD launch file\|modified]] robocode.sh or roborumble.sh (windows: robocode.bat or roborumble.bat)	+	Simply use the [[Robocode/Developers Guide for modify Robocode#Create MOD launch file\|modified]] robocode.sh or roborumble.sh (windows: robocode.bat or roborumble.bat)

@@ Line 60: / Line 60: @@
 </pre>
-:example:
+:'''example''':
 :robocodeDir = C:\robocode
 :fileName = RoboRumbleAtHome.java (the main file of roborumble)

@@ Line 14: / Line 14: @@
 * open home folder of robocode (the installation directory)
 * create a copy of robocode.sh and roborumble.sh (robocode.bat and roborumble.bat in windows), this will be your mod runner
-* open the copy made after and delete ".jar" in the -cp option for roborumble and robocode
+* open the copy and delete ".jar" in the -cp option for roborumble and robocode
 :example:
 :old roborumble.sh(or roborumble.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar:libs/codesize.jar:libs/roborumble.jar roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
-:new roborumble.sh(or roborumble.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode:libs/codesize.jar:libs/roborumble roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
+:new roborumbleMOD.sh(or roborumbleMOD.bat): java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode:libs/codesize.jar:libs/roborumble roborumble.RoboRumbleAtHome ./roborumble/roborumble.txt
-* now open folder  "libs" and extract robocode.jar and roborumble.jar (Warnig: prevent path error using "extract here" option), if nesessary set this folder's permission as read/write for your user
+* now open folder  "libs" and extract robocode.jar and roborumble.jar (Warnig: prevent path error using "extract here" option), if necessary set this folder's permission as read/write for your user
-* try the modified version of robocode.sh or roborumble.sh (.bat for windows): everything should work as the original version
+* try the modified version of robocode.sh or roborumble.sh (.bat for windows): everything should work normally
 ===Modifing source code===