System Map - Revision history

Cholmondely: /* For Practitioners of the Dark Arts */ Added link

2026-06-24T12:03:14Z

‎For Practitioners of the Dark Arts: Added link

Cholmondely: /* For Practitioners of the Dark Arts */ Updated

2026-06-24T12:02:04Z

‎For Practitioners of the Dark Arts: Updated

Cholmondely: Corrected assumption

2026-06-24T11:44:19Z

Corrected assumption

Phkb: /* For Practitioners of the Dark Arts */

2026-06-24T09:40:09Z

‎For Practitioners of the Dark Arts

Cholmondely: Oops!

2026-06-24T09:05:05Z

Oops!

Cholmondely: Page created

2026-06-24T09:03:50Z

Page created

New page

[[File:System Map OXP.png|thumb|right|450px|System Map (Oolite v.1.92+) Accessed through F7 screen (while docked) - press "s"<br>'''Sun''' = yellow S<br>'''Planet''' = green P (if purple, planet is a gas giant; hexagon shows presence of Planet Fall landing sites)<br>'''Moon''' = brown M<br>'''Your ship''' = red loop<br>'''Witchpoint Beacon''' = blue hourglass<br>'''Main Orbital Station''' = blue waffle (other stations = white waffle)]]
Adds a local system map, showing sun, planets, moons and main stations.
[[File:System Map OXP (v.1.90).png|thumb|right|450px|System Map (Oolite v.1.90) Accessed through F4 screen (ship and system interfaces)]]
== Overview ==
The System Map is a rotatable 2D map of the local solar system. As well as the components of the system (sun, planets, moons), local astrogatory beacons are also shown: to whit, GalCop stations & most other stations and the Witchpoint Beacon.

=== Notes on Usage ===
==== Oolite v.1.92+ ====
Access the System Map through pressing "s" while on the [[F7 page (data on "system")]].

==== Oolite v.1.90 ====
Access the System Map through the [[F4 page (ship and system interfaces)]] - look under the ''informational'' entries.

==== Map Focus ====
Changing the map focus will change the color of all entities to grey except for the focused entity. The name of the focused entity will be displayed at the top of the screen.

Repeating the focus command will cycle through all entities and then return to "None", when no entities are the focus. Resetting the view will also reset the focus.

<div style="clear:both"> </div>
[[Image:IconLib.png|100px|right]]
=== Library OXP ===
This OXP runs off functionality embedded inside [[Library OXP]] which must be present for System Map OXP to work.

== License ==
*Author: [[User:Phkb|Phkb]]
*License: CC-BY-SA-NC 4.0
*Required oolite version: 1.90 (better with 1.92+)

== For Practitioners of the Dark Arts ==
:--->
<div class="mw-collapsible mw-collapsed" data-expandtext="Reveal Dark Secrets" data-collapsetext="Conceal Dark Secrets" style="overflow:auto;">
[[File:Lib Starmap02.png|thumb|right|300px|Svengali's Starmap Demo OXP]]
'''Starmap Demo OXP'''
This OXP (and the more recent versions of Library required to run it) conflict with Svengali's original Starmap Demo OXP (see the [[Library OXP wiki page]]). His OXP also works in-flight and shows moving ships for mission settings.

'''3rd Party access'''

It is possible for other OXPs to add extra points of interest to the map. To do so, use the following code:

var sm = worldScripts.SystemMap;

// if you have an ship/station entity you want to show
sm.$addCustomMarker({
ent: myCustomShip,
map: "markerimage.png",
col: 1
});

// if you just want to mark a position
var myPos = Vector3D(0.0, 0.0, 0.5).fromCoordinateSystem("wpu")
sm.$addCustomMarker({
pos: myPos,
map: "markerimage.png",
col: 2
});

When using the "ent" (entity) option, and this item becomes the map focus, the text displayed for it will follow the following logic:
:If a "displayName" property has been included in the definition for the marker, that will be used.
:If the entity has a displayName, that will be used.
:Otherwise, the entity name will be used.

When using the "pos" (position) option, and this item becomes the map focus, the text displayed for it will follow the following logic:
:if a "displayName" property has been included in the definition for the marker, that will be used.
:The text "Point of interest" will be used.

When included, the "map" should be an image in the Textures folder, 128x128 in size. Included with the System Map OXP are:
:map_planet.png
:map_planet_1-9.png
:map_planet_pf1-9.png
:map_moon.png
:map_moon_pf.png
:map_point.png
:map_question.png
:map_station.png

Some others can be found in the Library OXP.

If "map" is not included, it will default to "map_station.png".

When included, the "col" should be a number between 0-9
:0 or not included: white
:1: red
:2: green
:3: blue
:4: purple
:5: gray
:6: aqua
:7: amber
:8: gold
:9: UV
:10: brown
:11: dark gray
:12: yellow

</div>

== Version History ==

*0.5
:- Added some more error checks for the custom markers.
:- Reordered the way items are added to the array, so similar items (eg planets, stations) are always grouped together.
:- Added compatibility with PlanetFall v1.

*0.4
:- Tweak to script name to try to fix missing interface entry.

*0.3
:- Initial release.

== Gameplay and Balance Indicator ==
[[File:Tag-colour-blue.png|right]]
Information to help discover your current Solar System.

{{misc-OXP}}

@@ Line 32: / Line 32: @@
 [[File:Lib Starmap02.png|thumb|right|300px|Svengali's Starmap Demo OXP]]
 '''Starmap Demo OXP'''
-This OXP also works in-flight and also shows moving ships for mission settings.
+This OXP also works in-flight and also shows moving ships for mission settings. See [[Library OXP]] for the download link.

@@ Line 32: / Line 32: @@
 [[File:Lib Starmap02.png|thumb|right|300px|Svengali's Starmap Demo OXP]]
 '''Starmap Demo OXP'''
-This OXP (and the more recent versions of Library required to run it) may conflict with Svengali's original Starmap Demo OXP (see the [[Library OXP]] wiki page) - this has happened on at least one older AppleMac running Oolite v.1.90. His OXP also works in-flight and shows moving ships for mission settings.
+This OXP also works in-flight and also shows moving ships for mission settings.

@@ Line 32: / Line 32: @@
 [[File:Lib Starmap02.png|thumb|right|300px|Svengali's Starmap Demo OXP]]
 '''Starmap Demo OXP'''
-This OXP (and the more recent versions of Library required to run it) conflict with Svengali's original Starmap Demo OXP (see the [[Library OXP]] wiki page). His OXP also works in-flight and shows moving ships for mission settings.
+This OXP (and the more recent versions of Library required to run it) may conflict with Svengali's original Starmap Demo OXP (see the [[Library OXP]] wiki page) - this has happened on at least one older AppleMac running Oolite v.1.90. His OXP also works in-flight and shows moving ships for mission settings.

@@ Line 80: / Line 80: @@
 If "map" is not included, it will default to "map_station.png".
-When included, the "col" should be a number between 0-9
+When included, the "col" should be a number between 0-12
 :0 or not included: white
 :1: red