Skip to content

Comms helper app designed for Android, intended to be used with Artemis Spaceship Bridge Simulator

License

Notifications You must be signed in to change notification settings

JordanLongstaff/Artemis-Messenger

Repository files navigation

Artemis Messenger 5.3.2

What is Artemis Messenger?

Artemis Messenger is an Android app designed to be used as a partial Comms client for Artemis Spaceship Bridge Simulator. Its original purpose was to receive and parse incoming Comms messages about side missions and organize the information into a neat, accessible and readable table, making it much easier to keep track of what side missions are available, what rewards they offer, and how much progress has been made. Eventually, it was expanded to include status details reported from ally ships and stations as well. Later, it was expanded further to calculate an efficient route to complete all side missions and assist ally ships that need help.

What is a side mission?

A side mission is a task within a simulation that entails the transport of supplies or data from one location to another, with a reward offered for doing so. Generally, when the player receives a message about a new side mission, the message begins with the line "Help us help you". It then lists specifics about the task itself, namely the location to visit first and the reward that is offered by the sender of the message; the ship or station that sent the message is the location to visit after the location mentioned in the content of the message. When one of the two locations is visited in order, that location sends a message that is parsed by the app, and the app updates the status of the side mission accordingly. The next location to visit is highlighted in orange. When a mission is completed, it turns green; it can then be removed from the table by touching it.

The app parses data from all messages relevant to side missions and organizes it into a table with three columns: Source, Destination and Reward. The Source is the first location to visit, the Destination is the second, and the Reward is what you receive for completing the mission. There are five types of rewards: Battery Charge (extra energy), Extra Coolant (extra coolant for Engineering), Nuclear Missiles (two Type 4 Nuke torpedoes), Production Speed (doubled at Destination station) and Shield Boost (stronger front and rear shields). The side missions in the table can be filtered by their type.

How do I complete side missions?

Side missions are simply tasks requiring you to travel from one point to another. These two points are listed in the Missions view as the Source and Destination, respectively. To complete a side mission, the player ship must travel to the Source, then to the Destination. If you want to complete all of the remaining active side missions efficiently, you can use the Route view, which lists the places to travel to in order. Whether you use the Route view or not, communication between the Helm, Science and Comms officers is key to effective and efficient collection of rewards.

What about ally ships and stations?

This app also has the ability to monitor the statuses of ally ships and stations! At the start of a simulation, and at regular intervals throughout, the app will send messages to ally ships requesting a hail from them. The message received in response is then parsed and used to populate the Allies table with information on the ally ships. The information is written in three columns: Ship (the ID and name of the ship), Shields (front and rear shield strength) and Status (all other information). The information reported in Status is as follows: ships can be normal, flying blind, malfunctioning, commandeered, or traps. They may have some side missions for you, and they may also have some spare energy, or in a Deep Strike mission, spare torpedoes. This information is obtained through messages, but the Shields information is not; it is updated live by a system manager.

The stations are managed using a similar system. Instead of interval updates, the stations give status updates when various events occur, such as docking, undocking, and the completion of missile production. There are two columns in this table: Station and Ordnance. The Station column includes the name and type of the station, its shield strength and any side missions or replacement fighters it has. Like ally ships, stations' shield strengths are updated in real time. The Ordnance column includes stock information on a station's Homing, Nuke, Mine, EMP and Plasma shock torpedoes, as well as a listing of what ordnance is currently being built, how much longer it is expected to take to finish, and how much faster than normal it is being built. At any time, the left side of a station's row in the table can be touched in order to send a request to stand by for docking; the Station column indicates when the crew is standing by or when you are docked there. If the right side is touched, the station will start building a different type of ordnance; this type cycles through the list of all available ordnances in response to multiple touches.

How do I know where to go to make all the stops?

The app can calculate the most efficient route to take between stops in a reasonable amount of time. The stops are listed in the order that they should be visited according to the calculated route. The app also shows the direction and distance to travel in order to reach each point from where the player is currently located. Originally, the routing algorithm was only intended for side missions, but now it is possible to include ally ships with various needs that require a visit in order to fill them.

How does the app do all of this?

The app communicates with a running Artemis server and receives packets from that server, which it then parses to obtain all of the information it uses. You can connect to a server if you know its address, but if the server is running Artemis version 2.7.0 or later, the app can broadcast a server discovery request and find a server address that way.

Can I contribute to this project?

Absolutely! This project is open-source, so you can fork it and make your own changes. If you have any issues or detect any bugs, you can report them in the Issues section on GitHub.

Credits

This app uses IAN (Interface for Artemis Networking), a Java library written by Robert J. Walker. It has been adapted for various purposes, including backwards compatibility with Artemis 2.2.0 and later. The 3D modeling features have been removed as they are not needed and are not compatible with Android.

About

Comms helper app designed for Android, intended to be used with Artemis Spaceship Bridge Simulator

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages