MMNet Wiki - User contributions [en]

Setting up IntelliJ IDEA

2016-05-08T12:15:18Z

Tubealloy:

'''Note - I use IntelliJ Ultimate with the Darcula theme, your IDE may look slightly different'''

If you do not have a subversion client installed you should install tortoisesvn and tick the option to install the command line tools during installation

1. Open IntelliJ IDEA and hit file -> New -> Project from version control -> Subversion

2. Click the green + and enter the url for Mekwars ( svn://svn.code.sf.net/p/mekwars/code/trunk ). Highlight the added repository and click on Checkout

[[File:Intellijsvn.JPG]]

3. Create a directory to store the code by clicking on the folder icon then highlight the folder and click ok (mekwarssvn in this example)

[[File:Intellijdirectory.jpg]]

4. Highlight the <pathtoproject>\p\mekwars\code\trunk and click ok

[[File:Intellijsvnbranch.jpg]]

5. Select the 1.8 format if prompted, you should see "Checking out files to blahblahblah" and a progress bar at the bottom of your IDE. Once finished you will be prompted to open the project.

6. You should have a directory layout that looks like this

[[File:Intellijdirectorylayout.jpg]]

7.Highlight "trunk" and either press F4 or right-click and select "open module settings"

8.Select "Project". Set the SDK to your installed Java version. Set the Project language level to 7

[[File:Intellijprojectsdk.jpg]]

9.Select "Modules" and set the folders as shown in the screenshot below ( highlight src and click on "Sources" on top and do the same for resources and the client and dist libs ). Click OK when done

[[File:Intellijmodulesettings.jpg]]

Then switch to Dependencies and click the green +

Select "jar or directory"

Add MegaMek.jar from one of the dist folders so that megamek classes are recognised by the ide as below.

If you still see some unknown classes in the IDE then add the dist/client/lib and dist/server/lib in the same way

[[File:Intellijmegamekjar.jpg]]

10.Click on the "Ant Build" option on the right

[[File:Intellijantlocation.jpg|1000px]]

11.Click the green +

12.Select build.xml, you should see the following

[[File:Intellijantwindow.jpg]]

13.Highlight "compile" and click the play button. Click messages at the bottom to see the ant build in progress

14.If this fails check the previous steps, if successful then highlight and run dist-client and dist-server

15.Assuming everything ran successfully you should have a "dist" folder in trunk now containing both client and server

16.Expand dist/server and right-click on MekWarsServer.jar. Select "Run MekwarsServer.jar". It will fail immediately but you will notice it appear in the top right of the screen

[[File:Intellijrunconfigurationlocation.jpg]]

17.Click the drop-down and select "Edit Configurations"

18.Copy these settings (altering for your path ). The working directory is the important bit that was missing

[[File:Intellijserverworkingdirectory.jpg]]

19.Click ok and click the play button next to the drop-down. You should see the server called in the run window at the bottom of the IDE

20.Repeat steps 16 - 19 but for dist/client/MekWarsClient.jar and instead of hitting play at step 19 hit the bug next to the play button

21.Connect to 127.0.0.1 as a username with no password. If you set a breakpoint in the src folder by clicking on a line number then the IDE will pause and allow you to debug.

Note you can also debug the server in the same way

Setting up IntelliJ IDEA

2016-05-08T12:01:34Z

Tubealloy:

'''Note - I use IntelliJ Ultimate with the Darcula theme, your IDE may look slightly different'''

If you do not have a subversion client installed you should install tortoisesvn and tick the option to install the command line tools during installation

1. Open IntelliJ IDEA and hit file -> New -> Project from version control -> Subversion

2. Click the green + and enter the url for Mekwars ( svn://svn.code.sf.net/p/mekwars/code/trunk ). Highlight the added repository and click on Checkout

[[File:Intellijsvn.JPG]]

3. Create a directory to store the code by clicking on the folder icon then highlight the folder and click ok (mekwarssvn in this example)

[[File:Intellijdirectory.jpg]]

4. Highlight the <pathtoproject>\p\mekwars\code\trunk and click ok

[[File:Intellijsvnbranch.jpg]]

5. Select the 1.8 format if prompted, you should see "Checking out files to blahblahblah" and a progress bar at the bottom of your IDE. Once finished you will be prompted to open the project.

6. You should have a directory layout that looks like this

[[File:Intellijdirectorylayout.jpg]]

7.Highlight "trunk" and either press F4 or right-click and select "open module settings"

8.Select "Project". Set the SDK to your installed Java version. Set the Project language level to 7

[[File:Intellijprojectsdk.jpg]]

9.Select "Modules" and set the folders as shown in the screenshot below ( highlight src and click on "Sources" on top and do the same for resources and the client and dist libs ). Click OK when done

[[File:Intellijmodulesettings.jpg]]

Then switch to Dependencies and click the green +
Select "jar"
Add MegaMek.jar from one of the dist folders so that megamek classes are recognised by the ide
[[File:Intellijmegamekjar.jpg]]

10.Click on the "Ant Build" option on the right

[[File:Intellijantlocation.jpg|1000px]]

11.Click the green +

12.Select build.xml, you should see the following

[[File:Intellijantwindow.jpg]]

13.Highlight "compile" and click the play button. Click messages at the bottom to see the ant build in progress

14.If this fails check the previous steps, if successful then highlight and run dist-client and dist-server

15.Assuming everything ran successfully you should have a "dist" folder in trunk now containing both client and server

16.Expand dist/server and right-click on MekWarsServer.jar. Select "Run MekwarsServer.jar". It will fail immediately but you will notice it appear in the top right of the screen

[[File:Intellijrunconfigurationlocation.jpg]]

17.Click the drop-down and select "Edit Configurations"

18.Copy these settings (altering for your path ). The working directory is the important bit that was missing

[[File:Intellijserverworkingdirectory.jpg]]

19.Click ok and click the play button next to the drop-down. You should see the server called in the run window at the bottom of the IDE

20.Repeat steps 16 - 19 but for dist/client/MekWarsClient.jar and instead of hitting play at step 19 hit the bug next to the play button

21.Connect to 127.0.0.1 as a username with no password. If you set a breakpoint in the src folder by clicking on a line number then the IDE will pause and allow you to debug.

Note you can also debug the server in the same way

File:Intellijmegamekjar.jpg

2016-05-08T12:00:06Z

Tubealloy:

MWClient execution logic

2016-05-07T12:14:47Z

Tubealloy:

1) Main method sets up logs using static methods of CampaignData which points to MWLogger ( Should we switch to a logger like log4j? )

2) Stdout and StdErr are set to /logs/megameklog.txt since megamek uses stdout and stderr ( duplicated code in MWDedHost, again should we use log4j? )

3) Args are parsed, ded is set to true if -dedicated is set, enable or disable splash is read.

4) New CConfig is created by reading
data/mwconfig.txt or data/mwconfig.txt.bak
serverdata.dat if present
images including camo '''if''' not a dedicated server

5 )Splash screen is enabled or disabled and data/mechfiles/units.cache is deleted if it exists

6) The created CConfig is passed as the argument for a new MWClient

7) The MWClient either calls the MekWarsDed.jar if it's a dedicated instance or sets the look and feel if not.

8) MWClient stores a reference to the java runtime bean at rt

9) MWClient creates a new CConnector, passing itself as the argument (since it implements IClient ) and sets the splash window.

10) If not a ded the client retrieves settings and sets data as follows -

Create a new CCampaign which in turn holds CPlayer and a reference to MWClient
Grab the player reference from the CCampaign
Initialise and set the protocal commands (comm, ping, pong and acksignon )
Initialise and set gui commands ( Ping and Mail )
Set the "loading data" status on the splash screen
Show sign on dialog if autoconnect is false or if serverip, name or password are empty
Create a datafetcher on specified port
Check for data/servers/<serverip>.<serverport>/dataLastUpdated.dat. Set the cache to use this directory
Load the ops list
set up ops

If it is a ded then it does the following
create protocol commands
create datafetcher, grab the ops
delete mmconf/gameoptions.xml if it exists

11) Once past this step both deds and players load the camaignData by calling getData() and timestamping before and after data retrieval.The datafetcher updates the last updated stamp and serialises itself

12) At this point deds have the username prepended with [Dedicated]

13) Options for dedrestarts, savedgamemaxdays, dedowners, port, ignore lists and keywords are read in at this point. The autosave purging thread is started.

14) The splash is set to "connecting" and the chatserver ip and port are set.

15) Non-dedicated clients now start loading up the gui as follows
Create a new CMainFrame passing in the MWClient as the parameter and set the logout image
Sets the window dimensions and components using either pack() or validate() depending on whether packframe is true. It also sets various gui items like size, location, state
Mute sound if set
update attack menu
set browser to allow urls to be opened in system browser
connect to chat server
set splash to "constructing gui"
set main frame to visible
get rid of the splash
refresh the status, playerpanel, bmpanel and hqpanel
Send client version and username to the chat server
Send /getsavedmail to the chat server
Start the repair thread ( for repairing mechs )

If it's a ded then instead it
Tries to connect to the server up to 20 times with a 90 second sleep time

16)Set up the timeout thread

MWClient execution logic

2016-05-07T11:45:39Z

Tubealloy:

'''Under construction'''
1) Main method sets up logs using static methods of CampaignData which points to MWLogger ( Should we switch to a logger like log4j? )

2) Stdout and StdErr are set to /logs/megameklog.txt since megamek uses stdout and stderr ( duplicated code in MWDedHost, again should we use log4j? )

3) Args are parsed, ded is set to true if -dedicated is set, enable or disable splash is read.

4) New CConfig is created by reading
data/mwconfig.txt or data/mwconfig.txt.bak
serverdata.dat if present
images including camo '''if''' not a dedicated server

5 )Splash screen is enabled or disabled and data/mechfiles/units.cache is deleted if it exists

6) The created CConfig is passed as the argument for a new MWClient

7) The MWClient either calls the MekWarsDed.jar if it's a dedicated instance or sets the look and feel if not.

8) MWClient stores a reference to the java runtime bean at rt

9) MWClient creates a new CConnector, passing itself as the argument (since it implements IClient ) and sets the splash window.

10) If not a ded the client creates the gui etc. as follows -

Create a new CCampaign which in turn holds CPlayer and a reference to MWClient
Grab the player reference from the CCampaign
Initialise and set the protocal commands (comm, ping, pong and acksignon )
Initialise and set gui commands ( Ping and Mail )
Set the "loading data" status on the splash screen
Show sign on dialog if autoconnect is false or if serverip, name or password are empty
Create a datafetcher on specified port
Check for data/servers/<serverip>.<serverport>/dataLastUpdated.dat. Set the cache to use this directory
Load the ops list
set up ops

If it is a ded then it does the following
create protocol commands
create datafetcher, grab the ops
delete mmconf/gameoptions.xml if it exists

MWClient execution logic

2016-05-07T10:39:59Z

Tubealloy:

MWClient execution logic

2016-05-07T09:54:19Z

Tubealloy:

MWClient execution logic

2016-05-07T09:53:57Z

Tubealloy: Created page with "1) Main method sets up logs using static methods of CampaignData which points to MWLogger ( Should we switch to a logger like log4j? ) 2) Stdout and StdErr are set to /logs/m..."

MekWars Developers

2016-05-07T09:44:17Z

Tubealloy:

[[Setting up IntelliJ IDEA]]

[[Code entry-points]]

[[MWClient execution logic]]

Code entry-points

2016-05-07T08:55:18Z

Tubealloy:

Taken from manifest main properties

'''Client''' - src\client\MWClient.java

'''Server''' - src\server\MWServ.java

'''Dedicated host''' - src\dedicatedhost\MWDedHost.java

'''Updater''' - src\updaters\MekWarsAutoUpdate.java

'''OperationsEditor''' - src\OperationsEditor\MainOperations.java

'''PlanetDatConverter''' - src\server\campaign\tools.PlanetDatConverter\PlanetDatConverter.java

'''Tracker''' - src\tracker\MWTracker.java

Code entry-points

2016-05-07T08:54:41Z

Tubealloy: Created page with "Taken from manifest main properties Client - src\client\MWClient.java Server - src\server\MWServ.java Dedicated host - src\dedicatedhost\MWDedHost.java Updater - src\upda..."

Taken from manifest main properties

Client - src\client\MWClient.java

Server - src\server\MWServ.java

Dedicated host - src\dedicatedhost\MWDedHost.java

Updater - src\updaters\MekWarsAutoUpdate.java

OperationsEditor - src\OperationsEditor\MainOperations.java

PlanetDatConverter - src\server\campaign\tools.PlanetDatConverter\PlanetDatConverter.java

Tracker - src\tracker\MWTracker.java

MekWars Developers

2016-05-07T08:47:26Z

Tubealloy:

[[Setting up IntelliJ IDEA]]

[[Code entry-points]]

MekWars Developers

2016-05-07T08:47:16Z

Tubealloy:

[[Setting up IntelliJ IDEA]]
[[Code entry-points]]

MekWars Developers

2016-05-05T16:36:17Z

Tubealloy:

[[Setting up IntelliJ IDEA]]

Setting up IntelliJ IDEA

2016-05-05T16:33:31Z

Tubealloy: Created page with "'''Note - I use IntelliJ Ultimate with the Darcula theme, your IDE may look slightly different''' If you do not have a subversion client installed you should install tortoise..."

'''Note - I use IntelliJ Ultimate with the Darcula theme, your IDE may look slightly different'''

If you do not have a subversion client installed you should install tortoisesvn and tick the option to install the command line tools during installation

1. Open IntelliJ IDEA and hit file -> New -> Project from version control -> Subversion

2. Click the green + and enter the url for Mekwars ( svn://svn.code.sf.net/p/mekwars/code/trunk ). Highlight the added repository and click on Checkout

[[File:Intellijsvn.JPG]]

3. Create a directory to store the code by clicking on the folder icon then highlight the folder and click ok (mekwarssvn in this example)

[[File:Intellijdirectory.jpg]]

4. Highlight the <pathtoproject>\p\mekwars\code\trunk and click ok

[[File:Intellijsvnbranch.jpg]]

5. Select the 1.8 format if prompted, you should see "Checking out files to blahblahblah" and a progress bar at the bottom of your IDE. Once finished you will be prompted to open the project.

6. You should have a directory layout that looks like this

[[File:Intellijdirectorylayout.jpg]]

7.Highlight "trunk" and either press F4 or right-click and select "open module settings"

8.Select "Project". Set the SDK to your installed Java version. Set the Project language level to 7

[[File:Intellijprojectsdk.jpg]]

9.Select "Modules" and set the folders as shown in the screenshot below ( highlight src and click on "Sources" on top and do the same for resources and the client and dist libs ). Click OK when done

[[File:Intellijmodulesettings.jpg]]

10.Click on the "Ant Build" option on the right

[[File:Intellijantlocation.jpg|1000px]]

11.Click the green +

12.Select build.xml, you should see the following

[[File:Intellijantwindow.jpg]]

13.Highlight "compile" and click the play button. Click messages at the bottom to see the ant build in progress

14.If this fails check the previous steps, if successful then highlight and run dist-client and dist-server

15.Assuming everything ran successfully you should have a "dist" folder in trunk now containing both client and server

16.Expand dist/server and right-click on MekWarsServer.jar. Select "Run MekwarsServer.jar". It will fail immediately but you will notice it appear in the top right of the screen

[[File:Intellijrunconfigurationlocation.jpg]]

17.Click the drop-down and select "Edit Configurations"

18.Copy these settings (altering for your path ). The working directory is the important bit that was missing

[[File:Intellijserverworkingdirectory.jpg]]

19.Click ok and click the play button next to the drop-down. You should see the server called in the run window at the bottom of the IDE

20.Repeat steps 16 - 19 but for dist/client/MekWarsClient.jar and instead of hitting play at step 19 hit the bug next to the play button

21.Connect to 127.0.0.1 as a username with no password. If you set a breakpoint in the src folder by clicking on a line number then the IDE will pause and allow you to debug.

Note you can also debug the server in the same way

File:Intellijserverworkingdirectory.jpg

2016-05-05T16:29:58Z

Tubealloy:

File:Intellijrunconfigurationlocation.jpg

2016-05-05T16:26:38Z

Tubealloy:

File:Intellijantwindow.jpg

2016-05-05T16:22:30Z

Tubealloy:

File:Intellijantlocation.jpg

2016-05-05T16:19:11Z

Tubealloy:

File:Intellijmodulesettings.jpg

2016-05-05T16:16:48Z

Tubealloy:

File:Intellijprojectsdk.jpg

2016-05-05T16:14:08Z

Tubealloy:

File:Intellijdirectorylayout.jpg

2016-05-05T16:11:09Z

Tubealloy:

File:Intellijsvnbranch.jpg

2016-05-05T16:07:33Z

Tubealloy:

File:Intellijdirectory.jpg

2016-05-05T16:03:25Z

Tubealloy:

File:Intellijsvn.JPG

2016-05-05T15:59:56Z

Tubealloy: svn settings

svn settings

MekWars Developers

2016-05-05T15:47:58Z

Tubealloy: Created page with "Placeholder"

Placeholder