MW Server Tutorial

How to Build a MekWars Server

Step 1: Learn to compile

This is really not an optional step. TubeAlloy taught you how to set up IntelliJ, so I'm going to teach you how to set up Eclipse.

1. Java
   1. Get a JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html
   2. Install the JDK

1. Eclipse
   1. Download eclipse from https://eclipse.org/downloads/ and install
   2. Start eclipse and set up an initial workspace

1. Subclipse
   1. Point your browser to https://marketplace.eclipse.org/content/subclipse#group-external-install-button
   2. Drag the install button to your open eclipse window
   3. Follow the prompts to install
   4. Change the SSH Connector (probably not necessary unless you have Write permissions to the repository, but it doesn't hurt anything)
      1. Windows -> Preferences
      2. Expand Team -> SVN
      3. Change SVN interface to SVNKit (Pure Java)

1. Set up the MekWars repository
   1. Open the SVN Resource Exploring perspectie (Window -> Perspective -> Open Perspective -> Other)
   2. Right-click in the SVN Repositories area and choose New -> Repository Location
   3. For the URL, enter svn://svn.code.sf.net/p/mekwars/code/trunk

1. Check out the MekWars repository
   1. From the SVN Repositories screen, right-click the MekWars repository you set up and select "Check Out"
   2. Choose "Check out as a project configured using the New Project Wizard" and hit Finish
   3. Select Java -> Java Project
   4. Hit "Next"
   5. Give the project a name ("MekWars" works for me) and hit "Next"
   6. Finish
   7. Click Yes and OK
   8. When the project is downloaded:
      1. Right-click the project and choose properties
      2. Go to Java Build Path
      3. Under Libraries, choose "Add JARs"
      4. Select all jar files in client-dist/lib
      5. Choose "Add JARs" again and select all jar files in server-dist/lib
      6. Choose "Add JARs" again and select MegaMek.jar
      7. Select OK
   9. This will now give you an error about the Motif Look and Feel
      1. Open properties back up
      2. Go to Java Build Path -> Libraries
      3. Select the JRE System Library and Remove
      4. Select Add Library
      5. Select JRE System Library
      6. Select your Java 8 JRE (mine is listed under workspace default)
      7. Select Finish

You now have a functional build environment.

1. Build MekWars
   1. Update the repository
      1. Right-click the project
      2. Choose Team -> Update to HEAD
   2. Build
   3. Right-click build.xml
   4. Select Run As -> Ant Build...
   5. Choose your targets and put them in order:
      1. init
      2. clean
      3. compile
      4. server-jar
      5. client-jar
      6. opEditor-jar
      7. MekWarsAutoUpdate-jar
   6. Click Run

Step 2: Set up the initial environment

Step 3: First server start

Step 4: Logs, logs, logs

(obviously a work in progress)