Artemis Engineering Client

This is a Java client for Artemis Space Bridge Simulator. It attempts to provide an better experience for those playing the Engineering station by providing various usability improvements and advanced functionality.

More information on specific functionality will be available as development progresses.

Acknowledgments

This is a client for Artemis Space Bridge Simulator created by Thom Robertson. You must have a legally purchased version of Artemis in order to play this game. Artemis is an awesome game and Thom has been kind enough to be supportive of third party clients. Please do not pirate Artemis - thank him by buying a copy of the game!

In order to talk to the Artemis server, this client uses IAN (Interface for Artemis Networking), created by Robert J. Walker (rjwut) on top of the original ArtClientLib created by Daniel Leong (dhleong). None of this would be possible without their hard work!

Persistent Custom Presets

TODO: document me!

Keybindings

Power vs. Coolant

If Shift is pressed, allocation keys affect coolant allocation, otherwise they affect power allocation.

Custom Keybindings

Define custom keybindings in the file input.cfg at the root of the repository. Each line defines a binding, and the format for each line is <system enum name> <positive key> <negative key> (each componnet is separated by one space). Duplicate bindings are not allowed. Order and capitalization are irrelevant.

Valid system names are:

• BEAMS
• TORPEDOES
• SENSORS
• MANEUVERING
• IMPULSE
• WARP_JUMP_DRIVE
• FORE_SHIELDS
• AFT_SHIELDS

Keys must match a VK_ key constant in java.awt.KeyEvent, without the VK_ prefix. Example of some custom keybindings:

WARP_JUMP_DRIVE F6 F5
beams BACK_slash braceright
FORE_Shields H comMA

Keys may not be one of the following reserved (i.e. not re-bindable) keys: BACK_SLASH (Debugging command) SPACE (Reset energy and coolant settings) 0-9 (Apply preset)

Keys may conflict with a default binding (see defaults below) only if they also define an input for the system that the default binding belonged to. Setting the same value as a default is okay. For example:

TORPEDOES W A		(A is the default for Primary Beam decrease)
BEAMS F1 F2			(Because we've defined a new key for Primary Beam decrease, it's okay)

This hasn't been tested on a keyboard using a character set other than the Western Latin standard.

Defaults

For each input that does not have a custom key binding specified in input.cfg, the following defaults are used:

  SYSTEM		INCREASE	DECREASE
  ----------------------------------
  Primary Beam 		Q			A
  Torpedoes			W			S
  Sensors			E			D
  Maneuver			R			F
  Impulse			T			G
  Warp				Y			H
  Front Shield		U			J
  Rear Shield		I			K

Contributing

General

The entry point to the program is located in the ClientMain.java file.

Developer Modes

The client has two special modes that are useful only to developers.

Fake mode: Fake mode runs a local simulation without actually connecting a real Artemis server. Highly recommended for basic UI development, as you will not need to continuously connect and reconnect to a real server, speeding cycle times. A lot of functionality is simulated (e.g. overheating a system works), but some is not (damcon teams don't really work). You can put the client in this mode by passing the --fake command line flag.

Proxy mode: Proxy mode allows a vanilla engineering client to connect to this client, which in turn connects to the server. With this setup, both clients will render the same data from the server, and either client can issue commands. This is a great way to check the behavior of the vanilla client against this improved client without running afoul of the "one engineering console per ship" limit. You can put the client in this mode by passing the --proxy command line flag.

You can also supply the server hostname/IP and optionally the port as command line arguments.

IDE Configuration

Dependencies

Dependencies should be checked in, so you shouldn't have to download anything extra. This isn't the greatest thing to do, but we need a dependency management system before we can get rid of this.

Eclipse

These instruction assume you are using Eclipse Neon (4.5.2).

First, clone this repository into the root of your Eclipse workspace.

Open Eclipse and choose File -> New -> Java Project. Enter the name of this repository exactly as the name of the project. You'll see text on the bottom of the window explaining that the wizard will automatically configure the JRE etc. Make sure Java SE 8 or later is selected (we're currently using 1.8.0_102). Click Finish.

Next, right click on the project and select Build Path -> Configure Build Path. If you don't see that option, right click on the project, select Properties and then the Java Build Path entry. Open the Libraries tab. If you see all of the .jar files which are present in the lib directory listed in addition to the JRE System Library, you can skip this step. If not, add all of the .jar files in lib and the Java3D-1.5.1 subdirectory.

With IAN v3.1.1 (and possibly later versions), source code attachment is required. To do that, return to the Java Build Path options and expand the entry for ian-3.1.1.jar under the Libraries tab. Select Source attatchment, then Edit. Select Browse then navigate to ArtemisEngineeringClient/lib and select ian-3.1.1-src.zip. Click OK three times to finish.

Lastly, navigate to Run -> Run Configurations and create two new Java Application configurations. Both should invoke com.brindyblitz.artemis.ClientMain. The first, titled AEC - Fake, should include the argument --fake. This will invoke the fake server (see Fake Mode above). The second, AEC - Live LAN, should have the IP address of your server as the argument, e.g. 10.0.0.4. This will connect to the real server upon launch (see Proxy Mode above). For both, select the entry point by going to the Main tab and entering com.brindyblitz.artemis.ClientMain in the text field under Main class.

IntelliJ IDEA

These instructions assume you are using IntelliJ IDEA 14.1.4.

1. Select Import Project.
2. Select the root directory of your clone.
3. Select Create project from existing sources.
4. Continue selecting defaults until the project loads.
5. In the project window's tree, locate the lib directory under ArtemisEngineeringClient.
6. Right click on ian-UNRELEASED.jar, select Add as source..., and select Build -> Rebuild Project.
   • You should now have no compilation errors.
   • You should now be able to navigate directly to the IAN source code from within your source files
7. In the project window's tree, right click on lib and select Mark Directory As -> Excluded. This will cause any compilation errors in any dependencies to go away (you only need that directory for code navigation, not compilation).

3D DAMCON Models

To import 3D models from the Artemis directory for use as wireframes in this project:

• Open DelEd 3D Editor
• File -> Open
• Navigate to Artemis directory then to dat, e.g. C:\Program Files (x86)\Steam\steamapps\common\Artemis\dat
• Select the DXS file corresponding to the model you want to export, e.g. artemis.dxs
• Select Open
• Click OK to ignore warnings about missing textures
• Select Plugins -> Wavefront OBJ Exporter (you may need to download and install this first)
• Select a locate to save the file, e.g. C:\artemis_from_deled.obj
• Set Scale to 1, Triangulate and Normals to None, and uncheck both checkboxes
• Click OK to export the OBJ file
• Open Blender and delete any objects that happen to be in your default scene
• File -> Import -> Wavefront (.obj)
• Locate the file you exported from DelEd and select Import
• File -> Export -> Wavefront (.obj)
• In the Export OBJ panel, set Forward to -Z, Up to Y Up, Scale to 1.0, Path Mode to Auto, and ensure that the following boxes (and no others) are checked: Apply Modifiers, Include Edges, and Write Normals (I'm not sure that these exact settings are needed but changing some of them got this process to work)
• Copy resulting OBJ file to the models folder (<project root>/assets/art/models)

Misc.

• http://www.java-gaming.org/index.php?topic=27429.0
• http://www.java-gaming.org/index.php?topic=27061.0
• https://github.com/Danny02/DarwinsBox/tree/master/Geometrie/src/main/java/darwin/geometrie/io

Picking Code Links

• https://www.opengl.org/archives/resources/faq/technical/selection.htm
• http://www.java-tips.org/other-api-tips-100035/112-jogl/1674-another-picking-example-in-jogl.html
• http://stackoverflow.com/questions/4485821/jogl-picking-example

JOGL Links

• http://forum.jogamp.org/Loading-and-drawing-obj-models-td2708428.html
• http://forum.jogamp.org/Any-3d-model-loader-for-jogl-td4031409.html
• http://stackoverflow.com/questions/3686942/3ds-with-jogl?rq=1 (JoglUtils)
• http://stackoverflow.com/questions/3691935/load-a-obj-file-with-java3d-and-use-it-in-jogl
• https://jogamp.org/wiki/index.php/Setting_up_a_JogAmp_project_in_your_favorite_IDE
• https://jogamp.org/wiki/index.php/Downloading_and_installing_JOGL
• https://jogamp.org/wiki/index.php/Using_JOGL_in_AWT_SWT_and_Swing#JOGL_in_Swing
• http://jogamp.org/jogl/doc/HowToBuild.html
• https://jogamp.org/wiki/index.php/Jogl_Tutorial
• https://github.com/elect86/jogl-samples/tree/master/jogl-samples/src/helloTriangle

Ardor3D

• https://github.com/Renanse/Ardor3D
• https://github.com/Renanse/Ardor3D/blob/master/ardor3d-extras/src/main/java/com/ardor3d/extension/model/obj/ObjImporter.java
• https://github.com/Renanse/Ardor3D/blob/master/ardor3d-examples/src/main/java/com/ardor3d/example/ExampleBase.java
• https://github.com/Renanse/Ardor3D/blob/master/ardor3d-examples/src/main/java/com/ardor3d/example/pipeline/SimpleObjExample.java

LWJGL

• http://wiki.lwjgl.org/index.php?title=Using_a_Resizeable_AWT_Frame_with_LWJGL
• http://forum.lwjgl.org/index.php?topic=4275.0
• https://github.com/OskarVeerhoek/YouTube-tutorials
• https://www.youtube.com/watch?v=izKAvSV3qk0&list=PL19F2453814E0E315&index=24
• https://github.com/OskarVeerhoek/YouTube-tutorials/blob/master/src/episode_24/ModelDemo.java