Difference between revisions of "Robocode/System Requirements"

From Robowiki
Jump to navigation Jump to search
m (Fixed next typo "vs." => "vs")
(26 intermediate revisions by 9 users not shown)
Line 1: Line 1:
Page describing the system requirement for installing and running the [[Robocode]] game.
+
This page describes the system requirements for installing and running [[Robocode]].
  
 
== Robocode requires Java ==
 
== Robocode requires Java ==
In order to install and run Robocode [http://java.com Java<sup>TM</sup>] must be pre-installed on your system. The current versions of Robocode requires at least Java 5 (aka Java 1.5.0) or preferable a newer version. Please notice, that Java can be downloaded for free, and will run on most operative systems. Also notice, that it is the Java SE (Standard Edition) we mean when talking about Java in this context.
+
In order to install and run Robocode, [http://java.com Java<sup>TM</sup>] must be installed on your system. The current version of Robocode requires at least Java 5 (aka Java 1.5.0) or newer. Java can be downloaded for free, and will run on most operating systems. Also note that, when we refer to Java, we mean Java SE (Standard Edition).
  
== Do I have Java already? ==
+
Before downloading and installing Java, you should first check if you have a sufficient Java installation already. You can check this from this page: http://www.java.com/en/download/installed.jsp
Before downloading and installing Java, you should first check if you have Java installed already, and also if you have the required version of Java for installing and running Robocode.
 
  
You can check this from this page: http://www.java.com/en/download/installed.jsp
+
==== Java from Sun is preferred ====
 +
If you must choose between Java versions from different vendors, you should prefer the versions from Sun Microsystems. They are the official Java providers and, in general, have the least buggy Java implementation. If you use Java from other vendors, Robocode might not run stable.
  
== JRE or JDK? ==
+
==== JRE and JDK ====
 
You can choose between installing:
 
You can choose between installing:
 
* The JRE (Java Runtime Environment), which consists of the Java Virtual Machine used for executing Java programs.
 
* The JRE (Java Runtime Environment), which consists of the Java Virtual Machine used for executing Java programs.
* The JDK (Java Development Kit), which contains a bundle of software for developing Java programs, and which also includes the JRE.
+
* The JDK (Java Development Kit), which contains a bundle of software for developing Java programs, including the JRE.
  
The JRE is the core part of Java, and typically takes up less space on your system, and is faster to download. So if you are new to Java, and just want to have a quick look at Robocode, I recommend that you download the JRE. If you are already used to program in Java, you might prefer the JDK. Notice, that you can always install the JRE first, and then the JDK later on, if you want to.
+
The JRE is the core part of Java - it typically takes up less space on your system and is faster to download. Robocode requires just a JRE; if you are new to Java and just want to have a quick look at Robocode, it is recommended that you get this smaller version. If you are already used to programming in Java, you might prefer the JDK. Note that you can always install the JRE first and the JDK later on if you want to. Also, if you have a JRE but no JDK, Robocode will automatically set up the [http://jikes.sourceforge.net/ Jikes] compiler.
  
Robocode just requires a JRE and includes the [http://jikes.sourceforge.net/ Jikes] compiler, which can be used for compiling robots, if no other compiler is available.
+
==Installation and configuration==
 +
=== Making sure Java is installed and configured properly ===
 +
95% of the problems people run into when installing and running Robocode are due to a faulty Java installation, wrong Java configuration, bad Java VM implementation, etc. If something went wrong with this instructions please read and follow the installation notes for how to install and configure Java for your specific system.
  
== 32-bit or 64-bit Java? ==
+
=== PATH must be set ===
If your operative system is not designed for 64-bit (like e.g. Windows Vista x64), you should never install a 64-bit version of Java. If you are running 64-bit, then the normal Java versions will probably run just fine on your 64-bit system. In general, I recommend that to stick to the normal (32-bit) versions of Java if you are running on Windows. The reason being, that currently you'll need to set up stuff manually when installing a 64-bit version of Java for Windows in order to let it run properly without any problems. Also notice, that the 64-bit versions of Java currently lack of tools like the Java Plug-in or Java Web Start for Windows.
+
Note that it is really important that you point at the 'bin' folder, and not just JAVA_HOME. The PATH must be set so your system knows where to locate <code>java.exe</code>, which is used to start the Java VM that Robocode requires.
 +
====Set path on Windows====
 +
Add the path to your '''PATH''' environment variable, e.g. <code>PATH=%PATH%;JAVA_HOME\bin</code>.
 +
:# Find where you installed Java. The default position at: <code>C:\Program Files\Java\jre6\bin</code>
 +
:# Copy all that. 
 +
:# Right click on My Computer and select Properties. The System dialogue should have appeared. On Vista/7, choose "Advanced system settings" in the sidebar. On XP, choose 'Advanced' tab.
 +
:# Now, click on "Environmental Variables" which is a button at the bottom right.  
 +
:# Under the category "System variables" which is the lower box, scroll down to "Path" and double click on it.  
 +
:# In "Variable value", go to the end of all that text (Remember to put a semicolon down at the end of the original text first or something bad may happen) and paste in the path of your <code>java\bin</code> directory. The one you copied earlier. Then put a semicolon at the end of the java/bin text.
 +
:# Here's what an example Path value looks like: <code>%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\Program Files\Microsoft SQL Server\90\Tools\bin<strong style="color:red">;C:\Program Files\Java\jre6\bin</strong></code> (The highlighted text is what you may have to put down)
  
== Make sure Java is configured properly ==
+
====Set path on Windows 64-bit====
In most cases, when people run into problems when trying installing and running Robocode, 95% of the problems is due to a faulthy Java installation, wrong Java configuration, bad Java VM implementation and similar. Therefore, please read and follow the installation notes for how to install and configurate Java for your specific system.
+
Be careful when you install Java on Windows 64-bit the installation by default is  
 +
<code>C:\Program Files (x86)\Java\jre6\bin</code>
 +
So you must replace <code>C:\Program Files\Java\jre6\bin</code> by  <code>C:\Program Files (x86)\Java\jre6\bin</code> in PATH
  
In some cases, people have more than one version of the JRE and/or JDK installed in their system. This is not necessarily a problem as long as your system has been properly configured to handle all of them. So if you (or any of your programs) don't need an older version of Java, then should uninstall it. The lesser Java Runtime Environments you have installed, the better, as your system might not get confused when it have to choose which Java version to use.
+
====Set path on Linux====
 +
Many (perhaps most) Linux distributions include java in the path by default, so this is not needed. If it is in your case, add the path to your '''PATH''' environment variable <code>PATH=$PATH:$JAVA_HOME/bin</code> [http://www.troubleshooters.com/linux/prepostpath.htm].
 +
Please consult the manual for your distribution. For Gentoo you can find usefully information at the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=5 handbook].
  
If you must choose between Java versions from different vendors, you should prefer the versions from Sun, which are typically less buggy than the ones provided from other vendors. At least, that is my experience.
+
==Troubleshooting==
 +
=== 32-bit vs 64-bit Java ===
 +
If you do not have a 64-bit operating system, you should never install a 64-bit version of Java. If you are running 64-bit, then the normal Java versions will probably run just fine on your 64-bit system. In general, it is recommended that to stick to the 32-bit versions of Java on Windows x64, unless you need install the newest versions of Java 6 Update 12 (64-bit) or never. With older versions you might need to setup additional stuff in order to run Java properly on your Windows x64.
  
[[Category:Robocode Documentation|Robocode System Requirements]]
+
=== Multiple Java installations ===
 +
In some cases, people have more than one version of the JRE and/or JDK installed in their system. This is not necessarily a problem as long as your system has been properly configured to handle all of them. So if you (or any of your programs) don't need an older version of Java, then should uninstall it. The less Java Runtime Environments you have installed, the better, as your system is less likely to get confused when it has to choose which Java version to use.
 +
 
 +
== See also ==
 +
=== Installation Notes from Sun ===
 +
* [http://java.sun.com/javase/6/webnotes/install/index.html Java Platform Installation]: Find installation notes for Windows, Linux, and Solaris.
 +
* [http://java.sun.com/javase/6/webnotes/install/system-configurations.html Supported System Configurations]: Find the installation notes for ''all'' supported systems.
 +
 
 +
=== Tutorials ===
 +
* [[Robocode/Download|How to download and install Robocode]]
 +
* [[Robocode/Robot Anatomy|The anatomy of a robot]]
 +
* [[Robocode/Getting Started|Getting started with Robocode]]
 +
* [[Robocode/My First Robot|My First Robot Tutorial]]
 +
* [[Robocode/Game Physics|Robocode Game Physics]]
 +
* [[Robocode/Scoring|Scoring in Robocode]]
 +
* [[Robocode/Robot Console|Using the robot console]]
 +
* [[Robocode/Downloading_Robots|Downloading other robots]]
 +
* [[Robocode/Learning from Robots|Learning from other robots]]
 +
* [[Robocode/Package Robot|Package your robot]]
 +
* [[Robocode/FAQ|Frequently Asked Questions (FAQ)]]
 +
* [[Robocode/Articles|Articles about Robocode]]
 +
* [[Robocode/Console Usage|Starting Robocode from the command line]]
 +
* [[Robocode/Graphical_Debugging|Graphical debugging]]
 +
* [[Robocode/Eclipse|Using Eclipse as IDE]]
 +
* [[Robocode/Eclipse/Create_a_Project|Creating a project for your robots]]
 +
* [[Robocode/Eclipse/Create_a_Robot|Creating a robot in Eclipse]]
 +
* [[Robocode/Running from Eclipse|Running your robot from Eclipse]]
 +
* [[Robocode/Eclipse/Debugging Robot|Debugging your robot with Eclipse]]
 +
 
 +
=== News and Releases ===
 +
* [http://sourceforge.net/export/rss2_project.php?group_id=37202 RSS Feeds for the Robocode project]
 +
* [http://sourceforge.net/project/showfiles.php?group_id=37202&package_id=29609 Robocode file releases]
 +
 
 +
=== Home pages ===
 +
* [http://robocode.sourceforge.net/ Classic homepage]
 +
* [http://sourceforge.net/projects/robocode Robocode project at SourceForge]
 +
* [http://robocoderepository.com/ Robocode Repository]
 +
* [[wikipedia:Robocode|Wikipediaentry for Robocode]]
 +
 
 +
[[Category:Robocode Documentation]]

Revision as of 10:14, 28 May 2015

This page describes the system requirements for installing and running Robocode.

Robocode requires Java

In order to install and run Robocode, JavaTM must be installed on your system. The current version of Robocode requires at least Java 5 (aka Java 1.5.0) or newer. Java can be downloaded for free, and will run on most operating systems. Also note that, when we refer to Java, we mean Java SE (Standard Edition).

Before downloading and installing Java, you should first check if you have a sufficient Java installation already. You can check this from this page: http://www.java.com/en/download/installed.jsp

Java from Sun is preferred

If you must choose between Java versions from different vendors, you should prefer the versions from Sun Microsystems. They are the official Java providers and, in general, have the least buggy Java implementation. If you use Java from other vendors, Robocode might not run stable.

JRE and JDK

You can choose between installing:

  • The JRE (Java Runtime Environment), which consists of the Java Virtual Machine used for executing Java programs.
  • The JDK (Java Development Kit), which contains a bundle of software for developing Java programs, including the JRE.

The JRE is the core part of Java - it typically takes up less space on your system and is faster to download. Robocode requires just a JRE; if you are new to Java and just want to have a quick look at Robocode, it is recommended that you get this smaller version. If you are already used to programming in Java, you might prefer the JDK. Note that you can always install the JRE first and the JDK later on if you want to. Also, if you have a JRE but no JDK, Robocode will automatically set up the Jikes compiler.

Installation and configuration

Making sure Java is installed and configured properly

95% of the problems people run into when installing and running Robocode are due to a faulty Java installation, wrong Java configuration, bad Java VM implementation, etc. If something went wrong with this instructions please read and follow the installation notes for how to install and configure Java for your specific system.

PATH must be set

Note that it is really important that you point at the 'bin' folder, and not just JAVA_HOME. The PATH must be set so your system knows where to locate java.exe, which is used to start the Java VM that Robocode requires.

Set path on Windows

Add the path to your PATH environment variable, e.g. PATH=%PATH%;JAVA_HOME\bin.

  1. Find where you installed Java. The default position at: C:\Program Files\Java\jre6\bin
  2. Copy all that.
  3. Right click on My Computer and select Properties. The System dialogue should have appeared. On Vista/7, choose "Advanced system settings" in the sidebar. On XP, choose 'Advanced' tab.
  4. Now, click on "Environmental Variables" which is a button at the bottom right.
  5. Under the category "System variables" which is the lower box, scroll down to "Path" and double click on it.
  6. In "Variable value", go to the end of all that text (Remember to put a semicolon down at the end of the original text first or something bad may happen) and paste in the path of your java\bin directory. The one you copied earlier. Then put a semicolon at the end of the java/bin text.
  7. Here's what an example Path value looks like: %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;C:\Program Files\Microsoft SQL Server\90\Tools\bin;C:\Program Files\Java\jre6\bin (The highlighted text is what you may have to put down)

Set path on Windows 64-bit

Be careful when you install Java on Windows 64-bit the installation by default is C:\Program Files (x86)\Java\jre6\bin So you must replace C:\Program Files\Java\jre6\bin by C:\Program Files (x86)\Java\jre6\bin in PATH

Set path on Linux

Many (perhaps most) Linux distributions include java in the path by default, so this is not needed. If it is in your case, add the path to your PATH environment variable PATH=$PATH:$JAVA_HOME/bin [1]. Please consult the manual for your distribution. For Gentoo you can find usefully information at the handbook.

Troubleshooting

32-bit vs 64-bit Java

If you do not have a 64-bit operating system, you should never install a 64-bit version of Java. If you are running 64-bit, then the normal Java versions will probably run just fine on your 64-bit system. In general, it is recommended that to stick to the 32-bit versions of Java on Windows x64, unless you need install the newest versions of Java 6 Update 12 (64-bit) or never. With older versions you might need to setup additional stuff in order to run Java properly on your Windows x64.

Multiple Java installations

In some cases, people have more than one version of the JRE and/or JDK installed in their system. This is not necessarily a problem as long as your system has been properly configured to handle all of them. So if you (or any of your programs) don't need an older version of Java, then should uninstall it. The less Java Runtime Environments you have installed, the better, as your system is less likely to get confused when it has to choose which Java version to use.

See also

Installation Notes from Sun

Tutorials

News and Releases

Home pages