Stendhal on Eclipse: Difference between revisions

* Unzip the download an run Eclipse

* Fill in the following information:<br>URI: <code><nowiki>git://git.code.sf.net/p/arianne/stendhal</nowiki></code>

Eclipse 06.png|Just click "next" on destionation

== Configure Project ==

<ol>

<li>In the New Project wizard select Java -> Java Project (do not select a simple "general" project!) and click "Next".</li>

<li>Project name: stendhal ( or whatever you like to call it ).

<li>Under the section named "JRE" make sure a Java version 1.5 or higher is selected and click "Finish".</li>

<li>Right click on your project folder and select "Properties" in the context menu.</li>

<li>Then select "Java Build Path" on the left side of the dialog box.</li>

<li>Now remove all existing folders from source path and add the two source folders 'src' and 'tests' by clicking on the "Add Folder..." button</li>

<pre>

source folder #1:

stendhal/src

Included:(All)

Excluded:(None)

Native library location: (None)

source folder #2:

stendhal/tests

Included:(All)

Excluded:(None)

Native library location: (None)

default output folder: stendhal/bin

</pre>

<i><span style="color:red;">NOTE:</span> For newer versions of eclipse an asterix (*) may need to be added manually to "Included". If the project is already checked out just right-click "src" & "tests" in the Package Explorer panel & select <span style="color:blue;">Build Path > Configure Inclusion / Exclusion Filters...</span> Under "Inclusion patterns" select "Add" then input "*" and select "OK" then "Finish". Updated screenshots to be added.</i>

<li> On the "Libraries" tab: click on the "Add JARs" button and select all the *.jar-files in stendhal/libs (some versions of eclipse may automatically import the .jar files).</li>

<i><span style="color:red;">NOTE:</span> If project checkout did not complete before the Create New Project Wizard starts you may have to add the .jar files later. To get to the project properties page either select "Project" from the menu bar then select "Properties" or right-click the root folder in the Package Explorer panel then select "Properties" from the drop-down menu. Updated screenshots to be added.</i>

<li> Check the text encoding at Project -> Properties -> Resource -> Text Encoding. Set it to UTF-8 unless it is that already.</li>

</ol>

Eclipse should be able to compile the source code now. There could be a little yellow sign (signalling warning messages) before your project folder but there must not be red X (error messages). The package explorer should now display the "src" folder below the root folder with a different icon, the icon is like a small grid.

==Trouble Shooting==

menu Windows | Preferences | Java | Installed JREs

* there should be at least one entry with a valid JAVA_HOME path (make it so so JDK compliance is at least Java 7)

==To make it run the server in Debug mode==

<pre> Name: StendhalServer

on the [Arguments] tab:

VM arguments: -Xmx128M

on the [Classpath] tab:

click UserEntries

button "Advanced"

(*) add folder | OK

and select the project root folder | OK

</pre>

* button [Debug]

And then the server should be started.

==To make the client run==

# Then again the small black arrow on the right side of the green bug. (Or you may also choose to use the "Run" command instead of "Debug" in case you only want to debug the server component.)

yay shiny new client, shiny server