--------------------------------------------------
How to set up a new project for TripleA in Eclipse
--------------------------------------------------


1. Download TripleA:
--------------------

* the latest version can be found at
  http://triplea.sourceforge.net/
* select a download that fits your OS
* depending on your download, run the installer or unpack the archive
* it's also recommended to download the source code so you can include
  it in your project later


2. Create a new Java project in Eclipse:
----------------------------------------

* in Eclipse, select "File"->"New"->"Java Project"
* choose a name for your project
* make sure the selected JRE is Java 6 or later
* click "Next"
* select the "Libraries" tab and click "Add External JARs"
* in the file selection dialog, navigate to your TipleA home folder,
  locate the "triplea.jar" in the "bin" folder and open it
* the JAR should now show up in the list. If you downoaded the TripleA
  source, click the small arrow next to "triplea.jar" to expand it and
  double-click "Source attachment". Select "External location" and
  click "External Folder". Select the "src" folder in your source
  download and click "OK"
* click "OK" to finish creating the project


3. Set up a new run configuration:
----------------------------------

* right-click your project in the package explorer and select "Properties"
* in the properties dialog, select "Run/Debug Settings" from the list to
  the left and click "New..."
* select "Java Application"
* in the text field for the main class, enter
  "games.strategy.engine.framework.GameRunner"
* you can also rename your run configuration if you want
* confirm with "OK". You should now be able to run TripleA by pressing the
  run button