StendhalNetBeans

Dependencies

To use NetBeans with Stendhal, you'll need these things:

• NetBeans 5.5
  
• A decent file manager/command line access. Reccomended: Konqueror or just Windows Explorer(Thunar/GNOME file manager aren't too great)

• Command line access for CVS

Step 1: Create a NetBeans Project

First things first: We'll need a NetBeans project. To do this, go to File>New Project (or just click the new project button).

When the 'New Project' window opens, go ahead and select the 'General' category and the 'Java Application' project type.

You should see something like this:
<Note>:
You will probably see something different than what I have (you can get the C/C++ addon if you like but we won't be using it.). If you don't have either the 'General' category or the 'Java Application' type, do these things: If you used a .rpm or a .deb:
(1) Curse at yourself for using the Ubuntu .deb or an RPM from somewhere else
(3) Uninstall the .deb or rpm
(3) Download the *official* NetBeans package from http://www.netbeans.org/
</Note>
Now for the screenshot:
http://timothyb89.homelinux.org/wikipix/nb_new1.png

Now that that's done, go ahead and hit the Next button. Things to do
(1): Change the project name (I use 'Stendhal')
(2): (OPTIONAL) Change the project location
(3): Uncheck 'Create Main Class'

When you do those, you should have something like this: (you shouldn't have 'Project folder can not be created' as that should be filled in for you)
http://timothyb89.homelinux.org/wikipix/nb_new2.png

---

Step 2: Get Stendhal from CVS

You don't actually have to get anything from CVS, but I do reccomend it.
If you don't want to use CVS (or can't) you can always download and extract the source tarball from the SourceForge page and skip this step.
You way want to skip this step if you are using Windows as it usually doesn't have CVS installed.

Step 1: Open a terminal
There's so many ways to do this, so I'll try to use a generic way.

Linux:
Press the key combination ALT and F2. A run window should appear- type xterm or konsole (or gnome-terminal) in it and hit the enter key.

Windows:
Press the key combination WinKey and R. In the dialog that opens, type cmd and hit the enter key.

Step 2: Checkout Stendhal from CVS
Developers
You know how to do this. Make a new directory, set CVS_RSH to ssh, and checkout using ext instead of pserver.

Everyone else:
Run these commands:

  mkdir stendhal_temp
  cd stendhal_temp
  cvs -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne login (password is empty; press return)
  cvs -z3 -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne co -P stendhal

---

Step 3: Copy Stendhal Files into NetBeans Project

Y file and folder into your NetBeans project folder (probably ~/Stendhal or My Documents/Stendhal). First off: Open the stendhal folder found in the stendhal_temp folder we made earlier (if you didn't get CVS, use the directory you extracted your files to).
From there, copy EVERY file and folder into your NetBeans project folder (probably ~/Stendhal or My Documents/Stendhal).
You should replace the entire src folder and build.xml

---

Step 4: Finish configuring NetBeans

Add Libraries

NetBeans will complain if we don't do this, so its best we get it done.

From the 'Project' pane, right click on the 'Libraries' entry and choose 'Add Jar'.
In the browse dialog, browse to the libs folder found in the project folder. Choose a jar and click OK.
Repeat for all of the other jars.

Now NetBeans should be ready to work with Stendhal. The ant buildfile has been modified to work with NetBeans so you can:

• Run the client (with the normal run- not the server as that would require too much configuration)
  
• Build the client and server (with the normal NetBeans build)