Elite Wiki - User contributions [en]

SOTL Exploration

2026-08-12T08:55:58Z

Cholmondely: Linked Captain Beatnik's new Gravitational Sensor Readout

[[File:SOTL Exploration.png|thumb|right|The new F6 screen!]]
[[File:SOTL Exploration F7.png|thumb|right|The new F7 screen!]]
[[Image:Sotl-scan.png|thumb|right|Compass and compass data]]
'''Song of the Labyrinth: Exploration''' is an experimental scenario OXP for Oolite, set in a very different part of space, and a considerably lower-tech environment than the Oolite setting.

== Overview ==
The colony ship ''Local Maximum'' suffered an extremely severe hyperspace misjump around seventy years ago, arriving in an uncharted system thousands of light years away from known space. The colony ship's hyperdrive was severely damaged, and the dim red star they named Max's Drift had no habitable planets and poor mineral reserves. Most of the ship's internal equipment survived the accident, and the colonists have been able to survive using hydroponics facilities and extracting water and metals from the system's asteroids.

Mining has recently obtained a small surplus of Uranium and Osmium required for the production of hyperspace fuel, and a cargo shuttle has been extensively refitted to carry a small hyperdrive and a range of survey gear. Its initial task is to survey the local cluster, hoping to find minerals which so far have not been located in exploitable quantities, both to restock the colonists' reserves and to allow fuel and equipment to be produced for a more extended mission.

=== Cim's summary ===
This is an OXP which uses the Oolite engine to make a game based on exploration rather than on combat and trading. The player starts off in the centre of the map and explores the surrounding systems visually and with a range of sensor tools.

Implemented so far:

Basic multi-planet system maps (much more to do here)
Hyperspace is its own thing rather than a cut-scene tunnel
More realistic (though still somewhat adjusted) system scale
Basic planetary detection and parallax searches
Gravitational sensors to measure planetary mass, and detect planets beyond visual range

==Download==
There are 3 files.
:The [https://cim.sotl.org.uk/games/files/oolite/SOTL_Exploration_0.4.oxz Exploration OXZ] (SOTL_Exploration_0.4)
:The [https://cim.sotl.org.uk/games/files/oolite/Song_of_the_Labyrinth_Startup_1.1.oxz Loader OXZ] (Song_of_the_Labyrinth_Startup_1.1)
:And [https://cim.sotl.org.uk/games/files/oolite/Song_of_the_Labyrinth_Altmap_1.0.oxz Altmap] (Song_of_the_Labyrinth_Altmap_1.0) - see [[SOTL Altmap]] for details of this second scenario

As this is a scenario OXP which changes many of Oolite's basic rules, it is disabled in conventional Oolite games, and requires the starting of a new game from a special position to play it. This position is available in the SOTL Loader/Startup OXP (for technical reasons this must be downloaded separately).

None of your normal OXPs will be usable in a SOTL Exploration game.

For more information, see [https://bb.oolite.space/viewtopic.php?f=4&t=17603 the forum thread]

===Warning===
This is an experimental OXP, and the Startup OXP may need to be updated if the main OXP is - which will mean you lose any progress (and of course, you also have to use a nightly Oolite build). Comments during development are extremely welcome but don't get too attached to your progress yet.

[[File:Lagrange Points (Basic).png|thumb|right|400px|The five Lagrange points generated by the interaction of the gravity of the Sun with that of the Earth]]
[[File:Lagrange Points.png|thumb|right|400px| Effective potential contour map (not to scale) of Sun-Earth system: L1, L2, L3 are unstable saddle points; L4, L5 are maxima but stable because of the Coriolis effect]]
==Equipment fitting==
The '''Shaula'''-class survey ship you fly can carry ten modules (in addition to the generator and flight computer which must be carried). The initial fitting is 3 fuel tanks, 3 capacitors, 1 gravity sensor, 1 spectroscopic sensor, and 1 prospecting laser, though you can customise this as much as you like before you leave.

===Flight computer===
The flight computer provides navigation support in both normal space and hyperspace, and integrates the output from your ships sensors - without it, you will have to carry out many more tasks manually, and you are recommended to return to base immediately for repairs.

It will automatically mark planets once you approach closely enough to get accurate information on their position and speed, and give them a preliminary designation. Information about the currently selected target will be displayed on your HUD

It has three primable modes:
* '''bookmark''': place a waypoint at your current location and heading. Useful if you spot something interesting but can't immediately check it out. Only one bookmark can be used at once.
* '''lagrange''': places a waypoint at each of the 5 Lagrange points of the currently selected planet. Both the planet and star must have mass estimates recorded for this to work. The L4 and L5 points are stable and may contain small clusters of asteroids.
* '''engine mode''': switches the engines between "precision" and "cruise" mode. Cruise mode is significantly faster and will generally be used, but precision mode will make flying near asteroids and docking with the Local Maximum considerably safer. You must be stationary to switch engine modes. The HUD's speed bar will indicate either '''pn''' (Precision mode) or '''CR''' (Cruise mode).

===Fuel tanks===
Fuel tanks carry hyperspace fuel. Each tank carries 6 tonnes of fuel. A hyperspace jump consumes fuel in tonnes equal to the square root of its distance in LY (i.e. longer jumps are more fuel-efficient). Exiting a jump early will not save fuel. The only current source of fuel is the Local Maximum - plan your jumps carefully or risk being stranded in another system forever.

===Capacitors===
Capacitors store energy from your generator to provide boosts to particular energy-intensive systems such as the lasers and hyperdrive. The more you have, the more margin for error you have in carrying out tasks, and the longer hyperspace jumps you can safely carry out.

===Gravity scanner===
[[Image:Sotl-gravity.png|thumb|right|400px|Gravitational Sensor - do not forget to set the mode ("b")]]
The gravity scanner allows the mass of nearby stars and planets to be estimated. If multiple gravity scanners are fitted, they are used in parallel to provide more accurate readings. You must be at a complete stop to use it. You may turn with it in use, but this will interfere with the readings.

Use the mode key ('b') to cycle between the four modes of operation, and press 'n' to activate the current mode:
* power on/off: initial mode, you must switch it off to re-engage drives
* scan on/off: while scanning, it will collect gravitational data, giving you the intensity and direction of the net gravitation force (in the screenshot, below and slightly ahead of the ship). The longer the scan runs for, the more precise a reading you'll get. You can turn the ship while the scan is running, but this will affect the data quality and you'll then need to wait a little bit for it to settle. Once you're happy with the data collected, press 'n' to stop the scan
* assign scan: assigns the scan data to the selected compass target (you need to pick for yourself what object you believe to be the gravitationally dominant one). The system will filter out components of the gravitational force not parallel to the direction of the target, and then use that to calculate surface gravity
* filter scan: if you already know the approximate mass of an object from a previous scan, you can filter it out of the scan by selecting it with the compass and pressing 'n' in this mode. This lets you get more accurate readings for unmeasured objects, and with sufficient practice and luck can also help you find undiscovered planets.

What are x,y,z? Where are they measured from?

Relative to your ship and its current axis set.

Why are they only positive?

They are not: there's an implicit zero-mark about half-way up the scale.

So if you turn your ship so that the X and Y are about half-way up, and the Z is all the way up, then the gravitational source should be in front of you. (On arrival in a new system, the dominant gravitational force will be the star, so this should be easy to verify!)

And what is the significance of all those "G" 's?

That's the gravitational field strength at the current location - minus any gravitational fields from previously-identified bodies.

How does one use this equipment to find planets?

So, to find planets:
:- get reasonably close to the star, turn to face it, verify that the grav sensor has the half-half-full XYZ readings mentioned above
:- set the star on the compass, assign the scan
:- now filter the scan to exclude the star
:- the high-unit (Gs, milli-Gs) of the grav scan should drop out
:- and you should have a new direction for the next most dominant gravitational source
:- turn to face that using the XYZ scans
:- then set off in that direction
:- hopefully after a while you'll come across a planet

Now you can repeat the process - do another G-scan, and you should get a pretty high milli-G reading when near the planet. Assign the scan, filter out that planet, and then see what's left to find a second planet. Eventually you'll have filtered out all the major gravitational sources, and your gravity scan will just be returning noise in the pico-G region. At that point you've probably found all the planets. ''cim » Thu Mar 03, 2022 9:17 am''

===Spectroscopic scanner and prospecting laser===
The spectroscopic scanner lets you determine the composition of stars, planets and asteroids by measuring emitted or reflected light. It returns the relative amounts of ten elements or compounds of particular survey interest, on a '''logarithmic scale'''.
[[Image:Sotl-spectroscopic.png|thumb|right|400px|Spectroscopic Scanner and Prospecting Laser]]
To use it, point your ship at the thing you want to scan, target it with compass or ident as appropriate, activate the sensor with 'n', and cycle the mode to the correct scan (star, planet or asteroid) with 'b'. Then, activate the scan with 'n' and watch the composition bars climb.

If the target is an asteroid, you'll need to fire the prospecting laser to get anything decent out of the scan.

When the scan looks done, press 'n' again to stop the scan and assign the results to the targeted body. Stars and planets are targeted with the compass; asteroids with the ident system.

Try to stop the scan when the highest of the ten bars reaches the top but no later. Stop too soon and you'll not have collected enough light and may miss some important trace components or have inaccuracies in parameters; stop too late and you'll oversaturate the sensors and corrupt the result.

The bars will go up faster the closer you are to the object, which reduces measurement noise - as does fitting multiple units - though this must be balanced against the risk of oversaturation.

You get different information depending on what you targeted
* '''Stars''': brightness, and metallicity. Metallicity gives you a very rough idea of how likely the system is to be dense in heavy elements, based on the traces of them in the corona.
* '''Planets''': surface temperature and atmosphere type
* '''Asteroids''': mineral composition (there are a lot of potential minerals, so there's two scan types). Any minerals detected in exploitable amounts will be noted on scan completion - the threshold is a lot lower for the rare ones.

===Sampling laser and sample collection bay===
The sampling laser will break small chunks off an asteroid - ideally one you have previously scanned with the prospecting laser - which can then be scooped into the sample collection bay and returned to the Local Maximum for extraction of valuable minerals. Each collection bay will hold 15 samples. (On particularly mineral-rich asteroids, a single sample may contain multiple usable minerals)

===Wreckage, Silicates, Ice and Ores ===
The list of commodities on the [[F8 screen (commodity market)|F8 commodities screen]] is adumbrated by the F8F8 entry for each item - so there is no current need for ice, but there ''is'' for Uranium, Rhenium, ''etc''.

[[Image:sotl-hyperspace.png|thumb|right|400px|SOTL Hyperspace]]
==Hyperspace==
Hyperspace travel is dangerous - especially in a ship as improvised as the Shaula-class. When you activate the hyperdrive, an additional instrument display will be projected on to your HUD

# Above: '''progress to destination''' ("travelling"). This starts with you leaving the gravitational influence of your current system, then travelling through hyperspace, then entering your destination system. If you need to drop out mid-jump, this will determine where you end up.
# Right: '''current energy reserves'''. Hyperspace travel is energy-intensive. If you run out of energy mid-jump, your ship will be destroyed as it fails to maintain hyperspatial integrity. You can press 'h' again to abort the jump and drop out away from your destination, which will damage your ship due to the rough exit, but you should at least survive.
# Centre: '''jump status'''. If this is '''yellow''' or '''green''' the jump is going well. If '''orange''', you are losing energy fast but should have sufficient reserves to finish the jump. If '''red''', you do not have sufficient reserves at the current rate of energy loss to complete the jump (this will start flashing '''red'''/'''black''' if you have fewer than 5 seconds available)
# Left, bottom: '''jump alignment'''. You need to handle a lot of the jump yourself. Keep your '''yellow''' marks aligned with the moving '''green''' ones using your pitch and roll controls - the closer the alignment, the less energy you will need to maintain hyperspatial integrity.

The pattern you need to align to is a property of the particular jump you are making, so with practice you can use less energy. Additionally, the more times you complete a jump the more computer assistance you receive with future jumps on the same route, which reduces the precision needed to maintain energy levels. (This means you need to carry fewer energy banks and can carry more survey equipment instead)

Jumps are non-linear:
- time aligning in hyperspace needed to complete the jump is proportional to distance
- real time taken is proportional to distance squared
- fuel usage is proportional to the square root of the distance

As large masses travel through normal space, they leave ripples behind them in the hyperspace medium, and semi-stable calm points. The larger the mass, the better the calm point. For this reason, a successful jump will place you in the calm point for the system's star.

==Version History==
See the BB Discussion thread for Cim's 2021 notes about what he had hoped to add.
* 0.4: added sampling laser and collection bay, adjusted HUD to be easier to read when facing star
* 0.3: added spectroscopic scanner, asteroids, prospecting laser
* 0.2: first public release, added gravity scanner, stars, planets
* 0.1: unreleased, hyperspace changes only

=== Cim's original plans for the future development of this OXP (or, what's missing!) ===
*A nicer cockpit/HUD.

*The longer-term idea was that your home base would only have a limited amount of hyperspace fuel - large, but not infinite.
:You'd then need to locate and mine particular materials from asteroids which could be synthesised into fuel back at the home base.
:While doing that you'd also be picking up other raw materials, which would let your home build additional equipment

*First basic one would be a mining drone which attached to an asteroid and started doing (slow!) automated mining of it. Build a few of those and you can start to get minerals in a bit faster. You'd have to give up a lot of your storage space to drag it out there in the first place, of course.

*That would then unlock additional deployable modules - a basic fuel storage depot, which would let you move fuel out from the base ship, and then run bigger expeditions from there - and then later a portable fuel refinery which would mean you didn't have to transport mined materials all the way back to base to get more fuel

*Probably then another sort of drone at some point which would pick up gas/liquid elements from planets for you, which would then extend the range of things your base could construct ... as well as resupply oxygen on the base ship, and other large-but-not-infinite consumables

*Goals: As well as modules for you, also goals to supply materials to repairs on the base ship
:Eventually, then a long-term goal to repair the base ship entirely (including its hyperdrive), and gradually move it across the chart to one of the habitable planets you found while exploring for the rest of this. (And then you've "won" but obviously you can keep exploring the rest of the map, with the benefit that you no longer need to keep dragging oxygen and water and minerals to your base)

I have no objection in principle to what there is being put in the Expansions Manager, maybe someone else will finish it off / take it in another direction someday.

But ... one reason I didn't put it in the manager is that Exploration depends on Loader, so if you install Exploration, you get the Loader OXP too (Song_of_the_Labyrinth_Startup). Loader can't depend on Exploration, because if it did, Exploration won't load in the core scenario, and then Loader won't load because Exploration isn't there, and then you can't actually start the scenario game. But that means when you're installing from the manager, if you install Loader it can't then auto-install Exploration ... and then if you try to run Loader it'll probably go wrong with an entirely unhelpful error message

The manager ideally needs a new relationship type adding to handle that sort of "install-time but not run-time" dependency, but I never got round to that either.

You might be able to make this clear enough with descriptions.

== Musings ==
=== Overview of SOTL Exploration ===
There seem to be three major points about this .oxp/game/proof of concept.

1) It is ''genuine'' exploration within the Oolite game framework. Although the map is known (ie the location of the stars), one must "discover" how to make the jump, and discover what is at the other end (planets, asteroids, ''etc''). And as the only pilot, there is nobody else about to spoonfeed you the information!

2) The Hyperspace Jump is no longer a doddle - it's now an adventure! It now starts to resemble what one reads about in some of the science fiction.

3) Finding the planets is now an adventure too!

Since cim programmed this ''within'' the Oolite game framework, some of these ideas should be transferable to the main game for those with the skills.

=== Ideas for improvement ===
1) Replace the Coriolis (colony ship "Local Maximum") with a [[Generation Ships OXP|Generation Ship]] (see "Tweaks" below), unsure about replacing the player's Adder (but, if the technology is more primitive than Oolite's, then the Adder is too modern).
::Using a Generation Ship could make the later stages of the game quite interesting (moving the colony ship to a habitable planet). It would not have hyperdrive. So if it were to follow the player into a wormhole - and then get ''lost''... !
:For immersion, have a different interface when docking, involving interaction with the colony ship leaders ([[HD Backgrounds Image Pack A]]; [[LitF]]; [[Galactic Navy OXP]])
:F4 ship/station interface screen: remove "GalCop station" from 3rd registration screen; remove offensive/defensive from Fast Activation screens
:F8 screen (stuff for sale!) seems a bit bizarre! Column headings need changing.

2) Better HUD
:especially half-way marks for the Gravitational Sensor ''(badly needed'') - see Captain Beatnik's tweaked version ("Tweaks" below)
:: (i) The vanilla game HUD has roll/pitch indicators, which Wildeblood rotated 90° for his [[Wide-Screen HUD]]. These have a zero-point in the ''middle'' of the bar.
:: (ii) the various [[User:Captain Beatnik|Coluber/CB HUDs]] which have markings along their bars.
:: (iii) But they ideally need coloured fill bars extending from the zero point in the middle to show things more accurately. Is this doable?
:: (iv) [[Vimana HUD]] & [[Vimana-X HUD]] have bits which can appear & disappear (Travel Module, Ship Module, ''etc''.) - and could be used for the gravitational sensor, for example.

3) Create uses for the mined minerals, new equipment made back at "Local Maximum", ''etc''. As in [[SOTL_Exploration#Cim.27s_original_plans_for_the_future_development_of_this_OXP_.28or.2C_what.27s_missing.21.29|Cim's original plans]] above.

4) Addition: Add in "landing on anchor" with [[Planetfall2 OXP|PF2]] to visit the colonies? There are presumably other non-Hyperspace ships travelling between the colonies and "Local Maximum" which could be added in for immersion. (something [[Dynamic_Ship_List_(Oolite)|small]]: [[Landing Craft|Isis Landing Craft]] w/o decal? [[Firefly]]? [[Y-Wing]]? [[Mining Pod]]?)

5) Addition: small craft flying between the planet and the colony ship ferrying people and resources from one t'other.

6) Addition: Add in Thargoids? Allow "Interdiction" during Hyperspace travel? ("Tough" start!). Thargoid visitations could get worse as the game goes on, but one could (with discovered resources) upgrade one's laser and add some defences!

=== Questions ===
*What happens if you just grab asteroid chunks without analysing them and bring them back to base? Do they still add to the resources in the F8 screen?

== Tweaks ==
[[File:Captain Beatnik's SOTL Gravitational Sensor 0.4.1.jpg|right|200px]]
* '''Generation Ship''': to replace the colony ship ''Local Maximum'' which is currently a Coriolis station with a more immersive Generation Ship.
:Follow phkb's instructions [https://bb.oolite.space/viewtopic.php?p=306558#p306558 here] - you will need to use his linked "Generation_Ships.oxp download" which corrects the dock model alignment and positioning to make docking easier.
* '''Gravitational Sensor'''
:Captain Beatnik had been decent enough to rejig the Sensor readouts so that they are easier to decipher. Download his version of SOTL Exploration OXP [https://app.box.com/s/v3oigcxwncmm7l4dzbu5zzp8mghd5szp here] (if you want a Generation Ship as well, you will still need to tweak in line with Phkb's instructions above!).

== Links ==
*[[SOTL Altmap]] - for details of the second game!
*[https://bb.oolite.space/viewtopic.php?f=4&t=17603 BB Discussion Thread] (2015+)
*[https://github.com/cim--/oxp-SongOfTheLabyrinth SOTL GitHub site]
*[[User:Cim|Cim]]: link to author's page & his other OXPs
*[[Exploration]]

{{Unclassified-OXP}}
{{demo-OXP}}

File:Captain Beatnik's SOTL Gravitational Sensor 0.4.1.jpg

2026-08-12T08:51:18Z

Cholmondely: From https://bb.oolite.space/viewtopic.php?p=306928#p306928

== Summary ==
From https://bb.oolite.space/viewtopic.php?p=306928#p306928

Planetfall2 OXP

2026-08-11T13:49:44Z

Cholmondely: /* Version History */ Hid more of the version history

[[Image:IconPF2.png|100px|right]]
[[File:PlanetFall2 city 7.png|300px|thumb|right|Landing at a city]]
[[File:PlanetFall2 moon 5.png|300px|thumb|right|Landing on a moon]]
== Overview ==
{{Infobox EquipStats Oolite| title = PlanetFall2 OXP
|image =
|equipName = Atmospheric Stabilisers
|equipCost = 5,000₢
|equipTL = 9
}}
An OXP which allows the Commander to land at specific locations on planets and moons (but not suns, even at night). Each main planet has up to 5 designated landing sites, while additional planets can have 3, and each moon can have 2 (configurable via [[Library OXP|Library Config]]). Pick your landing site and point your ship at the flashing marker near the surface that indicates the Ground Control Interface Point for the landing zone. Ensure your flight path is not too steep, otherwise you may sustain damage when the automated landing protocol engages.

Be careful of turbulence as you enter the atmosphere. To assist with atmospheric turbulence, the "Atmospheric Stabilisers" can be purchased at any TL9+ system for 5000cr. When equipped, this will reduce the impact of turbulence on your ship. Speed will have an impact on how much your ship is effected by turbulence. Slowing down will decrease the effect.

Your approach will trigger an automatic landing request. You should receive a response after a few seconds, indicating you are either cleared for landing or not. If you have clearance, continue towards the Ground Control Interface Point at less than 100 m/s until the automated system engages, captures your ship and lowers you to a landing pad.

Planetary take-off is via a launch booster, with control being returned to the Commander once orbital insertion is achieved.

=== A suite of OXPs ===
This OXP is currently a suite of 3 OXPs with another 2 optional OXPs:
*'''PlanetFall2''' (the coding)
*'''PlanetFall Resources A''' } individual planetary images part 1
*'''PlanetFall Resources B''' } individual planetary images part 2

*Optional: '''Feudal PlanetFall2''' (linking PlanetFall2 with [[Feudal States]] which is currently the only OXP which does much on the planet surface).
:<s>At time of writing PlanetFall2 is only compatible with Feudal States v.1 (and the ''alpha'' Feudal States v.2 is only compatible with PlanetFall v.1)!</s> It should now be compatible with both versions of Feudal States.
*Optional: [[Planet Rotation Cosmetics OXP]] slows down the planet's rotation as you approach it and are captured by the planet's gravity.

[[File:Planetfall2 Transit system.png|right|300px]]

=== Gaming changes from Thargoid's PlanetFall v1 (2008-13) ===
*You can now land on a planet without purchasing "planetary landing capabilities"/"atmospheric stabilisers" - but it is rather more dangerous
::If you have already bought "planetary landing capabilities", PF2 will convert them to "atmospheric stabilisers"
*There are now specific landing sites on the planet
*Commodity Markets are now included (''ie'' PlanetFall Markets OXP is redundant).
*When landed you can transit from one landing site to another (and pay good money to transit your ship, too!).
*[[Maintenance]] overhauls are now performed on the planet surface rather than in the orbital station (they will tell you this on the station!)
*There are other changes to be discovered!

== Requirements ==
*Oolite v.1.90 or better
*[[GNN]] v1.4
*[[Library OXP]]
*[[Market Script Interface]]
*[[External Docking System]]

While it isn’t a requirement, the [[Planet Rotation Cosmetics OXP]] is a highly recommended addition for PlanetFall 2.

== Options ==
There are a '''lot''' of options available to help configure the system the way you want it. The list is long, so if you want to see everything, ''click'' the link on the right.
<div class="mw-collapsible mw-collapsed" data-expandtext="Show me everything!" data-collapsetext="Turn it off! Turn it off!" style="overflow:auto;">
Library Config has the following sections for PlanetFall2:
* General settings
* Main planet settings
** F3/F8 access
** Spawn chances
* Extra Planet settings
** F3/F8 access
** Spawn chances
* Moon settings
** F3/F8 access
** Spawn chances
* Spawn chances: TL factors
* Transit costs
* Ship transfer costs

=== General settings ===
'''Flags'''
* '''Move shipyards to planet:''' Controls whether shipyards are moved to planet-side locations.
* '''Move maintenance to planet:''' Controls whether the "Maintenance Overhaul" item is moved to only be offered on planet-side locations.
* '''Atmosphere turbulence:''' Controls whether the turbulence effect, when entering the atmosphere of a planet, is active or not.
* '''Shallow approach:''' Controls whether a shallow approach angle is required when landing on a surface location.
* '''Use landing images:''' Controls whether the images displayed after landing at a planetary site are displayed.
* '''Use Almanac names:''' Controls whether the names of planetary locations are given names based on the methodology from the Galactic Almanac.
* '''Allow planetary transit:''' Controls whether it is possible to fast travel to other planetary sites after landing.

'''Values'''
* '''Main planet max:''' Maximum number of locations that could be spawned on the main planet.
* '''Extra planet max:''' Maximum number of locations that could be spawned on a secondary planet with an atmosphere.
* '''Moon max:''' Maximum number of locations that could be spawned on a moon with no atmosphere.
* '''Atmosphere max altitude:''' Maximum height (in km) of the atmosphere of a planet.
* '''Beacon range:''' Max distance (in km) that planetary beacons become visible to the player.
* '''Service Level dec:''' Amount that service level will be reduced by when launching from a planet.
* '''Transfer Time:''' Amount of time (in hours) that will pass when transferring player ship to the current location.
* '''Train speed:''' Base average speed of trains (in kph), which is scaled up or down based on the TL of the system.
* '''Turbulence impact scale:''' Scales the impact of turbulence, where 1.0 means no change to the default, 0.5 halves the impact, and 0.0 means no impact (same as turning turbulence off).

=== Main planet settings ===
==== F3/F8 Access ====
'''Flags'''
* '''Capital cities:''' Whether capital cities will have access to the F3 Equip Ship screen.
* '''Military bases:''' Whether military bases will have access to the F3 Equip Ship screen.
* '''Leisure complexes:''' Whether leisure complexes will have access to the F3 Equip Ship screen.
* '''Factories:''' Whether factories will have access to the F3 Equip Ship screen.
* '''Rubbish dumps:''' Whether rubbish dumps will have access to the F3 Equip Ship screen.

'''Values'''
* '''Capital cities:''' What type of market will be available at capital cities.
* '''Military bases:''' What type of market will be available at military bases.
* '''Leisure complexes:''' What type of market will be available at military bases.
* '''Factories:''' What type of market will be available at factories.
* '''Rubbish dumps:''' What type of market will be available at rubbish dumps.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51. (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn city:''' Chance of spawning a capital city.
* '''Spawn military base:''' Chance of spawning a military base.
* '''Spawn leisure complex:''' Chance of spawning a leisure complex.
* '''Spawn factory:''' Chance of spawning a factory.
* '''Spawn rubbish dump:''' Chance of spawning a rubbish dump.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Extra planet Settings ===
==== F3/F8 Access ====
'''Flags'''
* '''Colony cities:''' Whether colony cities will have access to the F3 Equip Ship screen.
* '''Military bases:''' Whether military bases will have access to the F3 Equip Ship screen.
* '''Leisure complexes:''' Whether leisure complexes will have access to the F3 Equip Ship screen.
* '''Factories:''' Whether factories will have access to the F3 Equip Ship screen.
* '''Rubbish dumps:''' Whether rubbish dumps will have access to the F3 Equip Ship screen.

'''Values'''
* '''Colony cities:''' What type of market will be available at colony cities.
* '''Military bases:''' What type of market will be available at military bases.
* '''Leisure complexes:''' What type of market will be available at leisure complexes.
* '''Factories:''' What type of market will be available at factories.
* '''Rubbish dumps:''' What type of market will be available at rubbish dumps.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51 (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn colony city:''' Chance of spawning a colony city.
* '''Spawn military base:''' Chance of spawning a military base.
* '''Spawn leisure complex:''' Chance of spawning a leisure complex.
* '''Spawn factory:''' Chance of spawning a factory.
* '''Spawn rubbish dump:''' Chance of spawning a rubbish dump.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Moons ===
==== F3/F8 Access ====
'''Flags'''
* '''Colony domes:''' Whether colony domes will have access to the F3 Equip Ship screen.
* '''Mines:''' Whether mines will have access to the F3 Equip Ship screen.
* '''Prisons:''' Whether prisons will have access to the F3 Equip Ship screen.
* '''Leisure domes:''' Whether leisure domes will have access to the F3 Equip Ship screen.
* '''Robot factories:''' Whether robot factories will have access to the F3 Equip Ship screen.
* '''Research complexes:''' Whether research complexes will have access to the F3 Equip Ship screen.
* '''Wastelands:''' Whether wastelands will have access to the F3 Equip Ship screen.

'''Values'''
* '''Colony domes:''' What type of market will be available at colony domes.
* '''Mines:''' What type of market will be available at mines.
* '''Prison:''' What type of market will be available at prisons.
* '''Leisure domes:''' What type of market will be available at leisure domes.
* '''Robot factories:''' What type of market will be available at robot factories.
* '''Research complexes:''' What type of market will be available at research complexes.
* '''Wastelands:''' What type of market will be available at wastelands.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51 (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn colony dome:''' Chance of spawning a colony dome.
* '''Spawn mine:''' Chance of spawning a mine.
* '''Spawn prison:''' Chance of spawning a prison.
* '''Spawn leisure dome:''' Chance of spawning a leisure dome.
* '''Spawn robot factory:''' Chance of spawning a robot factory.
* '''Spawn research complex:''' Chance of spawning a research complex.
* '''Spawn wasteland:''' Chance of spawning a wasteland.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Spawn chances: TL factors ===
'''Values'''
* '''Main planet min/max:''' Factor to apply to spawn chance of main planet locations based on the TL of the system.
* '''Extra planets min/max:''' Factor to apply to spawn chance of extra planet locations based on the TL of the system.
* '''Moons min/max:''' Factor to apply to spawn chance of moon locations based on the TL of the system.

The min value would be applied at the lowest TL, while the max value would apply to the highest TL. 
TL's in between would get a scaled value between min and max.

=== Transit costs ===
'''Values'''
* '''Fee:''' Base cost for a single trip (cr).
* '''Anarchy factor:''' Factor applied to fee in Anarchy systems
* '''Feudal factor:''' Factor applied to fee in Feudal systems.
* '''Multi-government factor:''' Factor applied to fee in Multi-Government systems.
* '''Dictatorship factor:''' Factor applied to fee in Dictatorship systems.
* '''Communist factor:''' Factor applied to fee in Communist systems.
* '''Confederacy factor:''' Factor applied to fee in Confederacy systems.
* '''Democracy factor:''' Factor applied to fee in Democracy systems.
* '''Corporate State factor:''' Factor applied to fee in Corporate State systems.

eg 0.0 = All trips are free; 1.0 = Use base cost; 0.5 = 50% of base cost.

=== Ship transfer costs ===
'''Values'''
* '''Fee:''' Base cost for ship transfer (cr).
* '''Anarchy factor:''' Factor applied to fee in Anarchy systems
* '''Feudal factor:''' Factor applied to fee in Feudal systems.
* '''Multi-government factor:''' Factor applied to fee in Multi-Government systems.
* '''Dictatorship factor:''' Factor applied to fee in Dictatorship systems.
* '''Communist factor:''' Factor applied to fee in Communist systems.
* '''Confederacy factor:''' Factor applied to fee in Confederacy systems.
* '''Democracy factor:''' Factor applied to fee in Democracy systems.
* '''Corporate State factor:''' Factor applied to fee in Corporate State systems.

eg 0.0 = Ship transfers are free; 1.0 = Use base cost; 1.5 = 150% base cost.

</div>

== Downloads ==
All components are downloadable through the in-game [[Expansions Manager]] 
Direct download here 
* [[Media:PlanetFall2_2.35.oxz|PlanetFall2_2.35.oxz]] (downloaded {{#downloads:PlanetFall2_2.35.oxz}} times).
* [[Media:PlanetFall2_ResourcesA.oxz|PlanetFall2_ResourcesA.oxz]] v1.1
* [[Media:PlanetFall2_ResourcesB.oxz|PlanetFall2_ResourcesB.oxz]] v1.0
* [[Media:Feudal_PlanetFall2_1.7.oxz|Feudal_PlanetFall2_1.7.oxz]] v1.7 (downloaded {{#downloads:Feudal_PlanetFall2_1.7.oxz}} times).
 
* [[Media:PlanetFall2_BlackMonks.oxz|PlanetFall2_BlackMonks.oxz]] v2.1 - Adds Bank of the Black Monks to the planet surface locations, providing all the normal bank facilities. The [[Black_Monk_Monastery|Bank of the Black Monks]] also needs to be installed.
* [[Media:PlanetFall2_HoopyCasino.oxz|PlanetFall2_HoopyCasino.oxz]] v2.5 - Adds HOopy casinos to the planet surface locations, complete with gaming opportunities. The [[HOopy_Casino|HOopy Casino OXP]] also needs to be installed.
* [[Media:PlanetFall2_Oo-Haul.oxz|PlanetFall2_Oo-Haul.oxz]] v2.1 - Adds an Oo-Haul distribution centre to the main planet, and a mission to escort a hauler from it out to either the witchpoint or constore. The [[Your_Ad_Here!|YAH/Your Ad Here!]] OXP and [[Oo-Haul]] need to be installed.

== License ==
*Author (PF v.2): [[User:Phkb|Phkb]]
*Author (PF v.1): [[User:Thargoid|Thargoid]]

This OXP is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license with the following clauses:

* Whilst you are free (and encouraged) to re-use any of the scripting, models or texturing in this OXP, the usage must be distinct from that within this OXP. Unique identifiers such as (but not limited to) unique shipdata.plist entity keys, mission variables, script names (this.name), equipment identity strings (EQ_), description list arrays and entity roles must not be re-used without prior agreement. Basically if it's unique or would identify or overwrite anything in the original OXP, then you may not re-use it (for obvious compatibility reasons).
* rebundling of this OXP within another distribution is permitted as long as it is unchanged. The following derivates however are permitted and except from the above:
** the conversion of files between XML and openStep.
** the merging of files with other files of the same type from other OXPs.
* The license information (either as this file or merged into a larger one) must be included in the OXP.
* Even though it is not compulsory, if you are re-using any sizable or recognisable piece of this OXP, please let me know :)

---> (Details of images used) --->
<div class="mw-collapsible mw-collapsed" data-expandtext="Show gory details" data-collapsetext="Hide gory details" style="overflow:auto;">
'''Image files:''' 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_20850610.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21988050.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_23326348.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21988072.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_23326337.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21835246.htm Image by user6702303 on Freepik 
 
https://www.freepik.com/free-photo/blue-sky-with-scattered-white-clouds_12110221.htm Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22542965.htm Freepik 
https://www.freepik.com/free-photo/cloudy-sky-daylight-background_19380968.htm Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22543011.htm Freepik 
https://www.freepik.com/free-photo/blue-sky-with-cloud-closeup_6133056.htm Image by photogenia on Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22542943.htm Freepik 
https://www.freepik.com/free-vector/20-vehicles-outline-icon-presentation_38543743.htm Image by flatart on Freepik 
 
https://www.freepik.com/free-ai-image/subway-dark-atmosphere_76653967.htm Image by freepik 
https://www.freepik.com/free-ai-image/new-york-city-subway-train-motion_69844323.htm Image by freepik 
https://www.freepik.com/free-photo/motion-blur-automatic-train-moving-inside-tunnel-tokyo-japan_10824408.htm Image by tawatchai07 on Freepik 
 
</div>
Some images were generated by AI at https://www.freepik.com/pikaso/ai-image-generator 

'''Sound files:''' 
"e train 140kmh 04 190613_0029.wav" by klankbeeld -- https://freesound.org/s/476298/ -- License: Attribution 4.0 
"Arrival of a passenger electric train.1950km station_2(Eq,lmtr).wav" by newlocknew -- https://freesound.org/s/580464/ -- License: Attribution 4.0 

== Version History ==
2.35
* Tighter integration with Library.
* Improved handling of nova conditions.

2.34
* Shipyard not moved to planet in Anarchy systems.
* Made ship maintenance available from stations in Anarchy systems.
* Methods for creating random location names should now create the same name for the same location, every time. No more name switching.
* Added some additional place naming methods for potential future use.
* Fixed issue with naming function for Leisure Complexes, where some of the elements in brackets were not being returned.
* Corrections to some number extraction processes.

<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
2.33
* Fixed bug in $getPlanetFromLandingSite function.
* Tweak to monkey patch function.

2.32
* Fixed issue where a excessive number of Colony Domes were being spawned (and possibly Colony Cities as well).
* Citizens of a system can now use the transit system for free. (Requires Diplomacy OXP)
* Home System members with enough standing can now use the transit system for free. (Requires Home System OXP).

2.31
* Added GNN interface to some planetary surface locations.
* Fixed null reference error that could occur during transits.
* Added screenID's to all mission screens.
* Speed of the landing FX now scales with system performance.
* Switched to using logcontrol.plist for debug output.

2.30
* Changed manifest title from "PlanetFall" to "PlanetFall2".
* Changed Library Config aliases to "PlanetFall2".
* Changed category to "Systems".
* Fixed issue with adding OXP locations to custom systems, where some keys were being added to the list twice.

2.29
* Shuttles that choose to land on a planet will now do so at one of the landing sites.
* Shuttles will also launch from the landing sites.

2.28
* Fixed method of detecting when two landing sites are too close together.
* Changed calculation method for positioning landing sites to ensure good separation from others.

2.27
* Fixed issue where stored names were not being restored from missionVariables reliably.
* Fixed issue with naming system for Oo-Haul sites, which wasn't including "(Distribution Centre)" in the name.
* Fixed issue with naming HOopy Casino sites, which wasn't including "(HOopy Casino)" in the name.
* OXP planet locations defined via the ship role "planetFall2_???_externalOXP" are now attempted to be added to custom systems. Random factors and spawn conditions can then come in to play to limit the number of spawns.

2.26
* Darkened overlay images for better compatibility with Oolite 1.92.

2.25
* Moved more text into missiontext.plist.
* Fixed issue with ship transfer fee not being calculated correctly when being deducted from the players account.

2.24
* Added check for, and warning message of, PlanetLand OXP conflict.

2.23
* Fixed issue where shipyards were not viewable on stations that have overridden the "move shipyards to planet" option.

2.22
* Display a message when attempting to access shipyards on stations when they are located on planetary surfaces.
* Added option to disable the shallow approach angle requirement when landing on a surface location.
* Tweaked spawning logic so planetary locations can't be too close together, increasing the distance from the previous fix.

2.21
* Change to manifest file to match with split of resources pack into two.

2.20
* Added a function, $getSystemLocations, which returns an object containing the ship keys and place names of all planetary locations in a given system.

2.19
* Setting beacon range to zero will make all beacons visible all the time.
* Added ability to scale the maximum turbulence factor per planet.

2.18
* Added a "turbulence impact scale" option so the effect of turbulence can be scaled to taste.
* Allowed for blank entries in location overrides to switch to randomised location types and naming.
* Fixed issues when checking roles to determine the type of VFX to show for landing.
* Added ability to override the landing clouds, docks and overlays on a per-planet basis.
* Some code refactoring.

2.17
* Moved most text into missiontext.plist for easier localisation.
* Removed monkey patch on Marker Inquirer as no longer required.

2.16
* Tweak to prevent LMSS and Laser Arrangement interfaces disappearing on non-PlanetFall locations.

2.15
* Increased the number of shipdata entities to better handle high values for the number of planetary landing points.

2.14
* Added protection for instances where a planet or moon has no air color value set.
* Fixed issue where the reason for the denial of a landing request was not being transmitted to the player.

2.13
* Further fixes to linkage between landing sites and planets.

2.12
* Fixed incorrect property setting in shipdata.
* Changed allegiance setting for research complexes to be neutral.
* Fixed issue where landing sites could spawn too close together.

2.11
* Fixed issue where link between landing sites and planets could occasionally break due to rounding errors.

2.10
* Prevented things like "Immigration Control" from appearing in Anarchy systems.
* Prevented turbulence frame callback from being started twice.
* Fixed error: this.serviceLevelDecrease is not a function.
* Tweaks to hopefully permanently fix issue where turbulence effect keeps running after a witchspace jump or docking.

2.9
* Fixed JS error in transit process code.
* Fixed issue where Vimana-X HUD was not resetting correctly on launch after using transit system.

2.8
* Split off planet rotation slowing into separate OXP, and made optional for this OXP.

2.7
* Dying while turbulence is active will now stop the frame callback.
* Added tweak to planet rotation when approaching planet, slowing it down to make scale issues less obvious (can be configured with Library Config).
* Code refactoring.

2.6
* Small tweak to the market script.
* Small fix to the name generation process for Capital Cities.

2.5
* Refined some text in messages for better understanding and integration with the built in voice.
* Added a pre-spawn check for a condition script on custom (ie non-built-in) surface locations.
* Fixed issue that was preventing custom names from being applied to custom system setups.
* Added a PDF document outlining how to create custom systems, for non-coders.
* Updates for the PlanetFall Oo-haul mission pack.
* Added conflict with PlanetFallMarketSaver - this OXP shouldn't be necessary with PlanetFall2.
* Added conflict with PlanetFall Markets - this OXP shouldn't be necessary with PlanetFall2.
* Removed some unused settings in config.
* Split off graphical assets into separate OXP, to make updating the core code easier for everyone.
* Added a second train FX image, so that the second animation doesn't just look completely like the first.
* Tweaked train FX images to make them more centred.
* Added scan class to station entities.

2.4
* Adjusted calculations to make landing when pointing at the GCIP more consistent.

2.3
* Added a planet-side transit system, so you don't have to launch and re-dock to visit another landing site on the same planet.
* Transit costs are adjusted based on government types. Configurable via Library Config.
* Ship transfer costs are adjusted based on government types. Configurable via Library Config.
* Fixed shipyard transfer process to not run more than once per system.
* Added fragment and vertex shaders to ensure all break patterns appear clearly and without shadow.
* Removed yaw turbulence factor. Only pitch and roll turbulence will be now be set.
* Fixed issue that was preventing subSurface colonies and moonSurface domes from being spawned.
* Amount of reduction to service level is now configurable via Library Config.
* Added a function (PlanetFall2.playerShipIsLocal) that can be called to determine if the player is near their ship or not.
* Removed the Blackmonks and HoOpy Casino config options, and incorporated spawn chances in script_info object of shipdata and condition script.

2.2
* Fixed issue where, if "Additional Planets" doesn't create any planets, no landing sites are created on the main planet.
* Reapplied monkey match for Market Inquirer to address issue with beacons not showing when more than 100000m from the player when docked.
* Removed conflicts with SW Planetary Systems and Moons, although it is unlikely any created moons will get landing sites.

2.1
* Added methods to allow for a fully customised system to be defined (with multiple sites per planet/moon).
* Moved Feudal States override code into a separate OXP.
* Fixed missing semi-colon in shipdata.plist.
* Switched ground control interface point to be a normal ship object (rather than a visual effect) to gain better compatibility with OXP's like Telescope.
* Made the ground control interface points more visible.
* Reduced the number of monkey patches required.
* Made the maximum range at which the space compass will detect ground control interface points configurable via Library Config, and changed the default value to 200km.
* Added some conflict oxps ("Planetary Systems" and "Moons" by stranger).
* Improved compatibility with Market Inquirer.
* Tweaked spawning methods to better reflect the original PlanetFall results, where OXP station roles are not added unless override flag is set.
* Added a warning screen for players, informing them that ship maintenance services are only available on the planet.
* Added a chance of a misjump when executing a witchspace jump inside the atmosphere.
* Fixed issue where entering witchspace while the turbulence effect is still active would result in it staying active.
* Fixed bug that was setting service level to the minimum value when launching from a planetary location.
* Turbulence now doesn't end when speed is zero.
* Added a config item to manage how much the service level of the player ship is reduced.
* Added shipdata entries to allow for multiple military bases, leisure complexes, factories and dumps on the main planet in custom systems.
* Fixed issues where NaN, NaN, Nan is calculated for a vector.
* Log messages now controllable via a debug flag.
* Removed some unused code.

2.0
* Updated landing FX, with clouds and landing pads.
* Updated launching FX.
* Changed docking method to have a fixed location (rather than just descending towards the planet surface anywhere), which means you can now save your game at planetary locations.
* Access to equipment sales (F3 Equip Ship) configuration via Library Config.
* Updated market information to allow for 3 different methods to be applied to any of the locations. (Configurable via Library Config)
* Added a variety of arrival report screen backgrounds. (Can be turned off via Library Config)
* Added a turbulence effect when in the atmosphere of a planet. (Can be turned off via Library Config)
* Equipment item renamed to "Atmospheric Stabilisers", but is optional for planetary landings.
* Moved ships from shipyards on other stations to planetary locations. (Configurable via Library Config)
* Moved "Maintenance Overhaul" to only be available on the main planet. (Configurable via Library Config)
* Added script updates to Feudal Systems, Aquatics, Market Inquirer, Galactic Almanac and In-System cargo delivery to maintain compatibility.
* Additional compatibility settings updated via shipdata-overrides.plist.
</div>

== The Dark Side ==
=== Custom designing a system ===
You can now custom design a system:
:specifically naming landing sites (see inside Lave.oxp)
:adding tweaks for entering the atmosphere: storms, haze, colours, and [[OXP_howto_texture#Planet_textures|city night-lights]] (see inside Famous Planets v.3 & see inside Lave.oxp)
:tweaking landing: images (see inside DGill's newest Feudal Systems suite - Digebiti & Tibecea, PF2 Blackmonks, PF2 HoOpy Casinos and PF2 Oohaul)
:tweaking landing: haze (see Famous Planets v.3 - G1 Larais)
:tweaking landing: activities (see inside DGill's newest Feudal Systems suite, PF2 Blackmonks, PF2 HoOpy Casinos and PF2 Oohaul)

To tweak a system, see the "Creating Custom Systems.pdf" & the "Developer's ReadMe" hidden inside the PF2 and then also the example [https://app.box.com/s/5xbksy48qr9cp31z2wpef6wjla05s3ih/file/1505969925081 SuperSystem.oxp]
:There is more detail [https://bb.oolite.space/viewtopic.php?p=301011#p301011 here] (runs on for several pages) and [https://bb.oolite.space/viewtopic.php?p=301065#p301065 here]

=== Problems with the Oolite game engine ===
*Planets were never meant to be interacted with in Oolite - there's a lot of hand-waving going on with PF2 when it comes to landing on the surface. [https://bb.oolite.space/viewtopic.php?p=301396#p301396 Phkb (2025)]
*The Oolite game engine does support larger planets and stars - I put together an OXP a while ago which uses them - but not necessarily particularly well. (Editor: [[SOTL Altmap]]? [[SOTL Exploration]]?) 
:You would have noticeable "corners" on the planets at 'real-world' sizes, as a 20,000 triangle polygon gets too large. You can already see these if you go as low as you can on a planet and look at the horizon. Similarly, the way planet texturing works would need to be significantly changed to avoid pixels tens of kilometres wide. There are display issues with large stars at high distances. There's a bit of a hack in the display code to avoid the worst of it, but there can still be strange issues with which objects are displayed in front of which. (You would probably need a higher Open GL version to solve these, which may or may not be practical to hide behind a graphics setting toggle) [https://bb.oolite.space/viewtopic.php?p=263420#p263420 Cim (2018)]

== Links ==
*[https://bb.oolite.space/viewtopic.php?t=21606 BB thread] (2024)
*[[Planetfall OXP]] PF v.1 original wiki page

== Quick Facts ==
{{OXPLevel|0|2}}{{IconOXP|ooVersion="1.90"|oxpCPU="Average"|oxpMEM="Low"|oxpGPU="Average"|oxpIsAPI=true|oxpIsDocumented=true|oxpIsConfigurable=true}}
[[Image:IconLib.png|48px|right|link=Library OXP|alt=Config options available through 'Library']]
{{Infobox OXPb| title = PlanetFall2.oxz
|version = 2.35
|release = 2026-08-03
|license = CC BY-NC-SA 3.0
|features = Planetary landings
|category = Systems OXPs
|author = [[User:Thargoid|Thargoid]], [[User:phkb|phkb]]
|feedback = [https://bb.oolite.space/viewtopic.php?t=21606 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-orange.png|right]]
By default, planetary landings are harder than they were in V1. However, if you don't land on or approach planets, gameplay is largely unaffected (or it can be).

Planetfall2 OXP

2026-08-11T13:48:34Z

Cholmondely: /* The Dark Side */ Added more

[[Image:IconPF2.png|100px|right]]
[[File:PlanetFall2 city 7.png|300px|thumb|right|Landing at a city]]
[[File:PlanetFall2 moon 5.png|300px|thumb|right|Landing on a moon]]
== Overview ==
{{Infobox EquipStats Oolite| title = PlanetFall2 OXP
|image =
|equipName = Atmospheric Stabilisers
|equipCost = 5,000₢
|equipTL = 9
}}
An OXP which allows the Commander to land at specific locations on planets and moons (but not suns, even at night). Each main planet has up to 5 designated landing sites, while additional planets can have 3, and each moon can have 2 (configurable via [[Library OXP|Library Config]]). Pick your landing site and point your ship at the flashing marker near the surface that indicates the Ground Control Interface Point for the landing zone. Ensure your flight path is not too steep, otherwise you may sustain damage when the automated landing protocol engages.

Be careful of turbulence as you enter the atmosphere. To assist with atmospheric turbulence, the "Atmospheric Stabilisers" can be purchased at any TL9+ system for 5000cr. When equipped, this will reduce the impact of turbulence on your ship. Speed will have an impact on how much your ship is effected by turbulence. Slowing down will decrease the effect.

Your approach will trigger an automatic landing request. You should receive a response after a few seconds, indicating you are either cleared for landing or not. If you have clearance, continue towards the Ground Control Interface Point at less than 100 m/s until the automated system engages, captures your ship and lowers you to a landing pad.

Planetary take-off is via a launch booster, with control being returned to the Commander once orbital insertion is achieved.

=== A suite of OXPs ===
This OXP is currently a suite of 3 OXPs with another 2 optional OXPs:
*'''PlanetFall2''' (the coding)
*'''PlanetFall Resources A''' } individual planetary images part 1
*'''PlanetFall Resources B''' } individual planetary images part 2

*Optional: '''Feudal PlanetFall2''' (linking PlanetFall2 with [[Feudal States]] which is currently the only OXP which does much on the planet surface).
:<s>At time of writing PlanetFall2 is only compatible with Feudal States v.1 (and the ''alpha'' Feudal States v.2 is only compatible with PlanetFall v.1)!</s> It should now be compatible with both versions of Feudal States.
*Optional: [[Planet Rotation Cosmetics OXP]] slows down the planet's rotation as you approach it and are captured by the planet's gravity.

[[File:Planetfall2 Transit system.png|right|300px]]

=== Gaming changes from Thargoid's PlanetFall v1 (2008-13) ===
*You can now land on a planet without purchasing "planetary landing capabilities"/"atmospheric stabilisers" - but it is rather more dangerous
::If you have already bought "planetary landing capabilities", PF2 will convert them to "atmospheric stabilisers"
*There are now specific landing sites on the planet
*Commodity Markets are now included (''ie'' PlanetFall Markets OXP is redundant).
*When landed you can transit from one landing site to another (and pay good money to transit your ship, too!).
*[[Maintenance]] overhauls are now performed on the planet surface rather than in the orbital station (they will tell you this on the station!)
*There are other changes to be discovered!

== Requirements ==
*Oolite v.1.90 or better
*[[GNN]] v1.4
*[[Library OXP]]
*[[Market Script Interface]]
*[[External Docking System]]

While it isn’t a requirement, the [[Planet Rotation Cosmetics OXP]] is a highly recommended addition for PlanetFall 2.

== Options ==
There are a '''lot''' of options available to help configure the system the way you want it. The list is long, so if you want to see everything, ''click'' the link on the right.
<div class="mw-collapsible mw-collapsed" data-expandtext="Show me everything!" data-collapsetext="Turn it off! Turn it off!" style="overflow:auto;">
Library Config has the following sections for PlanetFall2:
* General settings
* Main planet settings
** F3/F8 access
** Spawn chances
* Extra Planet settings
** F3/F8 access
** Spawn chances
* Moon settings
** F3/F8 access
** Spawn chances
* Spawn chances: TL factors
* Transit costs
* Ship transfer costs

=== General settings ===
'''Flags'''
* '''Move shipyards to planet:''' Controls whether shipyards are moved to planet-side locations.
* '''Move maintenance to planet:''' Controls whether the "Maintenance Overhaul" item is moved to only be offered on planet-side locations.
* '''Atmosphere turbulence:''' Controls whether the turbulence effect, when entering the atmosphere of a planet, is active or not.
* '''Shallow approach:''' Controls whether a shallow approach angle is required when landing on a surface location.
* '''Use landing images:''' Controls whether the images displayed after landing at a planetary site are displayed.
* '''Use Almanac names:''' Controls whether the names of planetary locations are given names based on the methodology from the Galactic Almanac.
* '''Allow planetary transit:''' Controls whether it is possible to fast travel to other planetary sites after landing.

'''Values'''
* '''Main planet max:''' Maximum number of locations that could be spawned on the main planet.
* '''Extra planet max:''' Maximum number of locations that could be spawned on a secondary planet with an atmosphere.
* '''Moon max:''' Maximum number of locations that could be spawned on a moon with no atmosphere.
* '''Atmosphere max altitude:''' Maximum height (in km) of the atmosphere of a planet.
* '''Beacon range:''' Max distance (in km) that planetary beacons become visible to the player.
* '''Service Level dec:''' Amount that service level will be reduced by when launching from a planet.
* '''Transfer Time:''' Amount of time (in hours) that will pass when transferring player ship to the current location.
* '''Train speed:''' Base average speed of trains (in kph), which is scaled up or down based on the TL of the system.
* '''Turbulence impact scale:''' Scales the impact of turbulence, where 1.0 means no change to the default, 0.5 halves the impact, and 0.0 means no impact (same as turning turbulence off).

=== Main planet settings ===
==== F3/F8 Access ====
'''Flags'''
* '''Capital cities:''' Whether capital cities will have access to the F3 Equip Ship screen.
* '''Military bases:''' Whether military bases will have access to the F3 Equip Ship screen.
* '''Leisure complexes:''' Whether leisure complexes will have access to the F3 Equip Ship screen.
* '''Factories:''' Whether factories will have access to the F3 Equip Ship screen.
* '''Rubbish dumps:''' Whether rubbish dumps will have access to the F3 Equip Ship screen.

'''Values'''
* '''Capital cities:''' What type of market will be available at capital cities.
* '''Military bases:''' What type of market will be available at military bases.
* '''Leisure complexes:''' What type of market will be available at military bases.
* '''Factories:''' What type of market will be available at factories.
* '''Rubbish dumps:''' What type of market will be available at rubbish dumps.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51. (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn city:''' Chance of spawning a capital city.
* '''Spawn military base:''' Chance of spawning a military base.
* '''Spawn leisure complex:''' Chance of spawning a leisure complex.
* '''Spawn factory:''' Chance of spawning a factory.
* '''Spawn rubbish dump:''' Chance of spawning a rubbish dump.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Extra planet Settings ===
==== F3/F8 Access ====
'''Flags'''
* '''Colony cities:''' Whether colony cities will have access to the F3 Equip Ship screen.
* '''Military bases:''' Whether military bases will have access to the F3 Equip Ship screen.
* '''Leisure complexes:''' Whether leisure complexes will have access to the F3 Equip Ship screen.
* '''Factories:''' Whether factories will have access to the F3 Equip Ship screen.
* '''Rubbish dumps:''' Whether rubbish dumps will have access to the F3 Equip Ship screen.

'''Values'''
* '''Colony cities:''' What type of market will be available at colony cities.
* '''Military bases:''' What type of market will be available at military bases.
* '''Leisure complexes:''' What type of market will be available at leisure complexes.
* '''Factories:''' What type of market will be available at factories.
* '''Rubbish dumps:''' What type of market will be available at rubbish dumps.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51 (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn colony city:''' Chance of spawning a colony city.
* '''Spawn military base:''' Chance of spawning a military base.
* '''Spawn leisure complex:''' Chance of spawning a leisure complex.
* '''Spawn factory:''' Chance of spawning a factory.
* '''Spawn rubbish dump:''' Chance of spawning a rubbish dump.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Moons ===
==== F3/F8 Access ====
'''Flags'''
* '''Colony domes:''' Whether colony domes will have access to the F3 Equip Ship screen.
* '''Mines:''' Whether mines will have access to the F3 Equip Ship screen.
* '''Prisons:''' Whether prisons will have access to the F3 Equip Ship screen.
* '''Leisure domes:''' Whether leisure domes will have access to the F3 Equip Ship screen.
* '''Robot factories:''' Whether robot factories will have access to the F3 Equip Ship screen.
* '''Research complexes:''' Whether research complexes will have access to the F3 Equip Ship screen.
* '''Wastelands:''' Whether wastelands will have access to the F3 Equip Ship screen.

'''Values'''
* '''Colony domes:''' What type of market will be available at colony domes.
* '''Mines:''' What type of market will be available at mines.
* '''Prison:''' What type of market will be available at prisons.
* '''Leisure domes:''' What type of market will be available at leisure domes.
* '''Robot factories:''' What type of market will be available at robot factories.
* '''Research complexes:''' What type of market will be available at research complexes.
* '''Wastelands:''' What type of market will be available at wastelands.
Market type key:
* 0 = No market;
* 1 = Default market, which will likely be the main station market;
* 2 = SFEP (Stations for Extra Planets) method, which adjusts prices and quantities based on the distance of the site from the main station.
* 3 = Original market, as defined in PlanetFall v1.51 (but pre-Oolite 1.84).

==== Spawn chances ====
'''Values'''
* '''Spawn colony dome:''' Chance of spawning a colony dome.
* '''Spawn mine:''' Chance of spawning a mine.
* '''Spawn prison:''' Chance of spawning a prison.
* '''Spawn leisure dome:''' Chance of spawning a leisure dome.
* '''Spawn robot factory:''' Chance of spawning a robot factory.
* '''Spawn research complex:''' Chance of spawning a research complex.
* '''Spawn wasteland:''' Chance of spawning a wasteland.

eg 0.4 = 40% chance. The chance will be adjusted slightly by the TechLevel factor (see below).

=== Spawn chances: TL factors ===
'''Values'''
* '''Main planet min/max:''' Factor to apply to spawn chance of main planet locations based on the TL of the system.
* '''Extra planets min/max:''' Factor to apply to spawn chance of extra planet locations based on the TL of the system.
* '''Moons min/max:''' Factor to apply to spawn chance of moon locations based on the TL of the system.

The min value would be applied at the lowest TL, while the max value would apply to the highest TL. 
TL's in between would get a scaled value between min and max.

=== Transit costs ===
'''Values'''
* '''Fee:''' Base cost for a single trip (cr).
* '''Anarchy factor:''' Factor applied to fee in Anarchy systems
* '''Feudal factor:''' Factor applied to fee in Feudal systems.
* '''Multi-government factor:''' Factor applied to fee in Multi-Government systems.
* '''Dictatorship factor:''' Factor applied to fee in Dictatorship systems.
* '''Communist factor:''' Factor applied to fee in Communist systems.
* '''Confederacy factor:''' Factor applied to fee in Confederacy systems.
* '''Democracy factor:''' Factor applied to fee in Democracy systems.
* '''Corporate State factor:''' Factor applied to fee in Corporate State systems.

eg 0.0 = All trips are free; 1.0 = Use base cost; 0.5 = 50% of base cost.

=== Ship transfer costs ===
'''Values'''
* '''Fee:''' Base cost for ship transfer (cr).
* '''Anarchy factor:''' Factor applied to fee in Anarchy systems
* '''Feudal factor:''' Factor applied to fee in Feudal systems.
* '''Multi-government factor:''' Factor applied to fee in Multi-Government systems.
* '''Dictatorship factor:''' Factor applied to fee in Dictatorship systems.
* '''Communist factor:''' Factor applied to fee in Communist systems.
* '''Confederacy factor:''' Factor applied to fee in Confederacy systems.
* '''Democracy factor:''' Factor applied to fee in Democracy systems.
* '''Corporate State factor:''' Factor applied to fee in Corporate State systems.

eg 0.0 = Ship transfers are free; 1.0 = Use base cost; 1.5 = 150% base cost.

</div>

== Downloads ==
All components are downloadable through the in-game [[Expansions Manager]] 
Direct download here 
* [[Media:PlanetFall2_2.35.oxz|PlanetFall2_2.35.oxz]] (downloaded {{#downloads:PlanetFall2_2.35.oxz}} times).
* [[Media:PlanetFall2_ResourcesA.oxz|PlanetFall2_ResourcesA.oxz]] v1.1
* [[Media:PlanetFall2_ResourcesB.oxz|PlanetFall2_ResourcesB.oxz]] v1.0
* [[Media:Feudal_PlanetFall2_1.7.oxz|Feudal_PlanetFall2_1.7.oxz]] v1.7 (downloaded {{#downloads:Feudal_PlanetFall2_1.7.oxz}} times).
 
* [[Media:PlanetFall2_BlackMonks.oxz|PlanetFall2_BlackMonks.oxz]] v2.1 - Adds Bank of the Black Monks to the planet surface locations, providing all the normal bank facilities. The [[Black_Monk_Monastery|Bank of the Black Monks]] also needs to be installed.
* [[Media:PlanetFall2_HoopyCasino.oxz|PlanetFall2_HoopyCasino.oxz]] v2.5 - Adds HOopy casinos to the planet surface locations, complete with gaming opportunities. The [[HOopy_Casino|HOopy Casino OXP]] also needs to be installed.
* [[Media:PlanetFall2_Oo-Haul.oxz|PlanetFall2_Oo-Haul.oxz]] v2.1 - Adds an Oo-Haul distribution centre to the main planet, and a mission to escort a hauler from it out to either the witchpoint or constore. The [[Your_Ad_Here!|YAH/Your Ad Here!]] OXP and [[Oo-Haul]] need to be installed.

== License ==
*Author (PF v.2): [[User:Phkb|Phkb]]
*Author (PF v.1): [[User:Thargoid|Thargoid]]

This OXP is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license with the following clauses:

* Whilst you are free (and encouraged) to re-use any of the scripting, models or texturing in this OXP, the usage must be distinct from that within this OXP. Unique identifiers such as (but not limited to) unique shipdata.plist entity keys, mission variables, script names (this.name), equipment identity strings (EQ_), description list arrays and entity roles must not be re-used without prior agreement. Basically if it's unique or would identify or overwrite anything in the original OXP, then you may not re-use it (for obvious compatibility reasons).
* rebundling of this OXP within another distribution is permitted as long as it is unchanged. The following derivates however are permitted and except from the above:
** the conversion of files between XML and openStep.
** the merging of files with other files of the same type from other OXPs.
* The license information (either as this file or merged into a larger one) must be included in the OXP.
* Even though it is not compulsory, if you are re-using any sizable or recognisable piece of this OXP, please let me know :)

---> (Details of images used) --->
<div class="mw-collapsible mw-collapsed" data-expandtext="Show gory details" data-collapsetext="Hide gory details" style="overflow:auto;">
'''Image files:''' 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_20850610.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21988050.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_23326348.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21988072.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_23326337.htm Image by user6702303 on Freepik 
https://www.freepik.com/free-photo/empty-dark-room-modern-futuristic-sci-fi-background-3d-illustration_21835246.htm Image by user6702303 on Freepik 
 
https://www.freepik.com/free-photo/blue-sky-with-scattered-white-clouds_12110221.htm Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22542965.htm Freepik 
https://www.freepik.com/free-photo/cloudy-sky-daylight-background_19380968.htm Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22543011.htm Freepik 
https://www.freepik.com/free-photo/blue-sky-with-cloud-closeup_6133056.htm Image by photogenia on Freepik 
https://www.freepik.com/free-photo/beautiful-skyscape-during-daytime_22542943.htm Freepik 
https://www.freepik.com/free-vector/20-vehicles-outline-icon-presentation_38543743.htm Image by flatart on Freepik 
 
https://www.freepik.com/free-ai-image/subway-dark-atmosphere_76653967.htm Image by freepik 
https://www.freepik.com/free-ai-image/new-york-city-subway-train-motion_69844323.htm Image by freepik 
https://www.freepik.com/free-photo/motion-blur-automatic-train-moving-inside-tunnel-tokyo-japan_10824408.htm Image by tawatchai07 on Freepik 
 
</div>
Some images were generated by AI at https://www.freepik.com/pikaso/ai-image-generator 

'''Sound files:''' 
"e train 140kmh 04 190613_0029.wav" by klankbeeld -- https://freesound.org/s/476298/ -- License: Attribution 4.0 
"Arrival of a passenger electric train.1950km station_2(Eq,lmtr).wav" by newlocknew -- https://freesound.org/s/580464/ -- License: Attribution 4.0 

== Version History ==
2.35
* Tighter integration with Library.
* Improved handling of nova conditions.

2.34
* Shipyard not moved to planet in Anarchy systems.
* Made ship maintenance available from stations in Anarchy systems.
* Methods for creating random location names should now create the same name for the same location, every time. No more name switching.
* Added some additional place naming methods for potential future use.
* Fixed issue with naming function for Leisure Complexes, where some of the elements in brackets were not being returned.
* Corrections to some number extraction processes.

2.33
* Fixed bug in $getPlanetFromLandingSite function.
* Tweak to monkey patch function.

2.32
* Fixed issue where a excessive number of Colony Domes were being spawned (and possibly Colony Cities as well).
* Citizens of a system can now use the transit system for free. (Requires Diplomacy OXP)
* Home System members with enough standing can now use the transit system for free. (Requires Home System OXP).

2.31
* Added GNN interface to some planetary surface locations.
* Fixed null reference error that could occur during transits.
* Added screenID's to all mission screens.
* Speed of the landing FX now scales with system performance.
* Switched to using logcontrol.plist for debug output.

2.30
* Changed manifest title from "PlanetFall" to "PlanetFall2".
* Changed Library Config aliases to "PlanetFall2".
* Changed category to "Systems".
* Fixed issue with adding OXP locations to custom systems, where some keys were being added to the list twice.

2.29
* Shuttles that choose to land on a planet will now do so at one of the landing sites.
* Shuttles will also launch from the landing sites.

2.28
* Fixed method of detecting when two landing sites are too close together.
* Changed calculation method for positioning landing sites to ensure good separation from others.

2.27
* Fixed issue where stored names were not being restored from missionVariables reliably.
* Fixed issue with naming system for Oo-Haul sites, which wasn't including "(Distribution Centre)" in the name.
* Fixed issue with naming HOopy Casino sites, which wasn't including "(HOopy Casino)" in the name.
* OXP planet locations defined via the ship role "planetFall2_???_externalOXP" are now attempted to be added to custom systems. Random factors and spawn conditions can then come in to play to limit the number of spawns.

<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
2.26
* Darkened overlay images for better compatibility with Oolite 1.92.

2.25
* Moved more text into missiontext.plist.
* Fixed issue with ship transfer fee not being calculated correctly when being deducted from the players account.

2.24
* Added check for, and warning message of, PlanetLand OXP conflict.

2.23
* Fixed issue where shipyards were not viewable on stations that have overridden the "move shipyards to planet" option.

2.22
* Display a message when attempting to access shipyards on stations when they are located on planetary surfaces.
* Added option to disable the shallow approach angle requirement when landing on a surface location.
* Tweaked spawning logic so planetary locations can't be too close together, increasing the distance from the previous fix.

2.21
* Change to manifest file to match with split of resources pack into two.

2.20
* Added a function, $getSystemLocations, which returns an object containing the ship keys and place names of all planetary locations in a given system.

2.19
* Setting beacon range to zero will make all beacons visible all the time.
* Added ability to scale the maximum turbulence factor per planet.

2.18
* Added a "turbulence impact scale" option so the effect of turbulence can be scaled to taste.
* Allowed for blank entries in location overrides to switch to randomised location types and naming.
* Fixed issues when checking roles to determine the type of VFX to show for landing.
* Added ability to override the landing clouds, docks and overlays on a per-planet basis.
* Some code refactoring.

2.17
* Moved most text into missiontext.plist for easier localisation.
* Removed monkey patch on Marker Inquirer as no longer required.

2.16
* Tweak to prevent LMSS and Laser Arrangement interfaces disappearing on non-PlanetFall locations.

2.15
* Increased the number of shipdata entities to better handle high values for the number of planetary landing points.

2.14
* Added protection for instances where a planet or moon has no air color value set.
* Fixed issue where the reason for the denial of a landing request was not being transmitted to the player.

2.13
* Further fixes to linkage between landing sites and planets.

2.12
* Fixed incorrect property setting in shipdata.
* Changed allegiance setting for research complexes to be neutral.
* Fixed issue where landing sites could spawn too close together.

2.11
* Fixed issue where link between landing sites and planets could occasionally break due to rounding errors.

2.10
* Prevented things like "Immigration Control" from appearing in Anarchy systems.
* Prevented turbulence frame callback from being started twice.
* Fixed error: this.serviceLevelDecrease is not a function.
* Tweaks to hopefully permanently fix issue where turbulence effect keeps running after a witchspace jump or docking.

2.9
* Fixed JS error in transit process code.
* Fixed issue where Vimana-X HUD was not resetting correctly on launch after using transit system.

2.8
* Split off planet rotation slowing into separate OXP, and made optional for this OXP.

2.7
* Dying while turbulence is active will now stop the frame callback.
* Added tweak to planet rotation when approaching planet, slowing it down to make scale issues less obvious (can be configured with Library Config).
* Code refactoring.

2.6
* Small tweak to the market script.
* Small fix to the name generation process for Capital Cities.

2.5
* Refined some text in messages for better understanding and integration with the built in voice.
* Added a pre-spawn check for a condition script on custom (ie non-built-in) surface locations.
* Fixed issue that was preventing custom names from being applied to custom system setups.
* Added a PDF document outlining how to create custom systems, for non-coders.
* Updates for the PlanetFall Oo-haul mission pack.
* Added conflict with PlanetFallMarketSaver - this OXP shouldn't be necessary with PlanetFall2.
* Added conflict with PlanetFall Markets - this OXP shouldn't be necessary with PlanetFall2.
* Removed some unused settings in config.
* Split off graphical assets into separate OXP, to make updating the core code easier for everyone.
* Added a second train FX image, so that the second animation doesn't just look completely like the first.
* Tweaked train FX images to make them more centred.
* Added scan class to station entities.

2.4
* Adjusted calculations to make landing when pointing at the GCIP more consistent.

2.3
* Added a planet-side transit system, so you don't have to launch and re-dock to visit another landing site on the same planet.
* Transit costs are adjusted based on government types. Configurable via Library Config.
* Ship transfer costs are adjusted based on government types. Configurable via Library Config.
* Fixed shipyard transfer process to not run more than once per system.
* Added fragment and vertex shaders to ensure all break patterns appear clearly and without shadow.
* Removed yaw turbulence factor. Only pitch and roll turbulence will be now be set.
* Fixed issue that was preventing subSurface colonies and moonSurface domes from being spawned.
* Amount of reduction to service level is now configurable via Library Config.
* Added a function (PlanetFall2.playerShipIsLocal) that can be called to determine if the player is near their ship or not.
* Removed the Blackmonks and HoOpy Casino config options, and incorporated spawn chances in script_info object of shipdata and condition script.

2.2
* Fixed issue where, if "Additional Planets" doesn't create any planets, no landing sites are created on the main planet.
* Reapplied monkey match for Market Inquirer to address issue with beacons not showing when more than 100000m from the player when docked.
* Removed conflicts with SW Planetary Systems and Moons, although it is unlikely any created moons will get landing sites.

2.1
* Added methods to allow for a fully customised system to be defined (with multiple sites per planet/moon).
* Moved Feudal States override code into a separate OXP.
* Fixed missing semi-colon in shipdata.plist.
* Switched ground control interface point to be a normal ship object (rather than a visual effect) to gain better compatibility with OXP's like Telescope.
* Made the ground control interface points more visible.
* Reduced the number of monkey patches required.
* Made the maximum range at which the space compass will detect ground control interface points configurable via Library Config, and changed the default value to 200km.
* Added some conflict oxps ("Planetary Systems" and "Moons" by stranger).
* Improved compatibility with Market Inquirer.
* Tweaked spawning methods to better reflect the original PlanetFall results, where OXP station roles are not added unless override flag is set.
* Added a warning screen for players, informing them that ship maintenance services are only available on the planet.
* Added a chance of a misjump when executing a witchspace jump inside the atmosphere.
* Fixed issue where entering witchspace while the turbulence effect is still active would result in it staying active.
* Fixed bug that was setting service level to the minimum value when launching from a planetary location.
* Turbulence now doesn't end when speed is zero.
* Added a config item to manage how much the service level of the player ship is reduced.
* Added shipdata entries to allow for multiple military bases, leisure complexes, factories and dumps on the main planet in custom systems.
* Fixed issues where NaN, NaN, Nan is calculated for a vector.
* Log messages now controllable via a debug flag.
* Removed some unused code.

2.0
* Updated landing FX, with clouds and landing pads.
* Updated launching FX.
* Changed docking method to have a fixed location (rather than just descending towards the planet surface anywhere), which means you can now save your game at planetary locations.
* Access to equipment sales (F3 Equip Ship) configuration via Library Config.
* Updated market information to allow for 3 different methods to be applied to any of the locations. (Configurable via Library Config)
* Added a variety of arrival report screen backgrounds. (Can be turned off via Library Config)
* Added a turbulence effect when in the atmosphere of a planet. (Can be turned off via Library Config)
* Equipment item renamed to "Atmospheric Stabilisers", but is optional for planetary landings.
* Moved ships from shipyards on other stations to planetary locations. (Configurable via Library Config)
* Moved "Maintenance Overhaul" to only be available on the main planet. (Configurable via Library Config)
* Added script updates to Feudal Systems, Aquatics, Market Inquirer, Galactic Almanac and In-System cargo delivery to maintain compatibility.
* Additional compatibility settings updated via shipdata-overrides.plist.
</div>

== The Dark Side ==
=== Custom designing a system ===
You can now custom design a system:
:specifically naming landing sites (see inside Lave.oxp)
:adding tweaks for entering the atmosphere: storms, haze, colours, and [[OXP_howto_texture#Planet_textures|city night-lights]] (see inside Famous Planets v.3 & see inside Lave.oxp)
:tweaking landing: images (see inside DGill's newest Feudal Systems suite - Digebiti & Tibecea, PF2 Blackmonks, PF2 HoOpy Casinos and PF2 Oohaul)
:tweaking landing: haze (see Famous Planets v.3 - G1 Larais)
:tweaking landing: activities (see inside DGill's newest Feudal Systems suite, PF2 Blackmonks, PF2 HoOpy Casinos and PF2 Oohaul)

To tweak a system, see the "Creating Custom Systems.pdf" & the "Developer's ReadMe" hidden inside the PF2 and then also the example [https://app.box.com/s/5xbksy48qr9cp31z2wpef6wjla05s3ih/file/1505969925081 SuperSystem.oxp]
:There is more detail [https://bb.oolite.space/viewtopic.php?p=301011#p301011 here] (runs on for several pages) and [https://bb.oolite.space/viewtopic.php?p=301065#p301065 here]

=== Problems with the Oolite game engine ===
*Planets were never meant to be interacted with in Oolite - there's a lot of hand-waving going on with PF2 when it comes to landing on the surface. [https://bb.oolite.space/viewtopic.php?p=301396#p301396 Phkb (2025)]
*The Oolite game engine does support larger planets and stars - I put together an OXP a while ago which uses them - but not necessarily particularly well. (Editor: [[SOTL Altmap]]? [[SOTL Exploration]]?) 
:You would have noticeable "corners" on the planets at 'real-world' sizes, as a 20,000 triangle polygon gets too large. You can already see these if you go as low as you can on a planet and look at the horizon. Similarly, the way planet texturing works would need to be significantly changed to avoid pixels tens of kilometres wide. There are display issues with large stars at high distances. There's a bit of a hack in the display code to avoid the worst of it, but there can still be strange issues with which objects are displayed in front of which. (You would probably need a higher Open GL version to solve these, which may or may not be practical to hide behind a graphics setting toggle) [https://bb.oolite.space/viewtopic.php?p=263420#p263420 Cim (2018)]

== Links ==
*[https://bb.oolite.space/viewtopic.php?t=21606 BB thread] (2024)
*[[Planetfall OXP]] PF v.1 original wiki page

== Quick Facts ==
{{OXPLevel|0|2}}{{IconOXP|ooVersion="1.90"|oxpCPU="Average"|oxpMEM="Low"|oxpGPU="Average"|oxpIsAPI=true|oxpIsDocumented=true|oxpIsConfigurable=true}}
[[Image:IconLib.png|48px|right|link=Library OXP|alt=Config options available through 'Library']]
{{Infobox OXPb| title = PlanetFall2.oxz
|version = 2.35
|release = 2026-08-03
|license = CC BY-NC-SA 3.0
|features = Planetary landings
|category = Systems OXPs
|author = [[User:Thargoid|Thargoid]], [[User:phkb|phkb]]
|feedback = [https://bb.oolite.space/viewtopic.php?t=21606 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-orange.png|right]]
By default, planetary landings are harder than they were in V1. However, if you don't land on or approach planets, gameplay is largely unaffected (or it can be).

Riredi OXP

2026-08-09T22:35:18Z

Cholmondely: /* New Version! */ Updated the update

[[File:Riredi_sodalite_orbital_station2.png|thumb|799px|right|Riredi sodalite orbital station]]
[[File:riredi planet.png|thumb|300px|left|Riredi.oxp's Riredi]]
<div style="clear:left"></div>
== Overview ==
*Custom texture for the planet
*New F7 description of the planet
*Unique orbital station
*Custom docking tunnel for [[BGS]]
*Special station defenders

[[Sector1/Riredi]] is the home of '''Coluber Inc.''' (Coluber Works and Shipyards Ltd.) and '''Riredisec Ltd.''' (a well established transport company that is specialized in the transportation of larger quantities of gold, platinum and gemstones).

The station is thus unique (designed and built by Coluber) and is guarded by [[Coluber Pitviper|Pitviper Mark II]]s which are manufactured locally by Coluber.

This OXP was initially created by Captain Beatnik in 2014.

=== Riredi v.2.0 ===
This OXP has been updated by [[User:Phkb|Phkb]] in 2024 (currently v.2.4)

The new version includes
*retextures of the Sodalite station & buoy,
*retexture of the planet (now includes city lights)
*introduces various trading tweaks (illegality of radioactives, a [[New Cargoes]] commodity)
*creates a preponderance of Coluber ships in the station shipyard (if the various Coluber ship OXPs are loaded)
*introduces retextured Coluber police ships to the system.
*includes PlanetFall 2 integration.

It links in with [[User:Phkb|Phkb]]'s Pitviper Mark II Facelift OXP (See [[Coluber Pitviper]]).

[[File:IconBGS.png|right |link=BGS|BGS enhances this OXP]]
[[File:IconPF2.png|right |link=Planetfall2 OXP|PlanetFall2 adds lore-based landing sites]]
[[File:New Cargoes icon.png|right|link=New Cargoes|New Cargoes commodity added in]]

== Development ==
*The original OXP was created by Captain Beatnik back in 2014 (planet texture, F7 screen description, station).
*It was then rejigged as an OXZ for the in-game [[Expansions Manager]] by Dybal in 2020.
*Phkb then added in city lights to the planet textures, improved ship textures, New Cargoes and planet landing sites for PlanetFall2 in 2024.
*Captain Beatnik is currently adding more: a lore-based planet texture, greeting screen on docking, ''etc''.

*Captain Beatnik has also added much lore for the planet and its denizens (see his [[User:Captain Beatnik|User:page]] for links to it).

== Links ==
*[[Sector1/Riredi]] - contains some of the new Lore
*[https://bb.oolite.space/viewtopic.php?f=4&t=16237 RELEASE: Riredi (ambience OXP)] BB Thread (2014-24)
*[[User:Captain Beatnik|Captain Beatnik]]: links to his other OXPs (pitvipers, racing ships & HUDs)

== Download ==
This oxp was repackaged and placed on the [[Expansions Manager]] by [[User:Dybal|Dybal]] and has since been updated by Phkb.
=== New Version! ===
*[[User:Captain Beatnik|Captain Beatnik]] has been working on updating this OXP further: [https://app.box.com/s/kkbg2ceb45aisg88npzq9o0wqxkebcy0 ''download here (9th Aug 2026 update)''].

(i) Planet Texture: It now contains a lore-based planet texture with the appropriate geography (the vast central sea; Apex Mons (a gigantic, extinct shield volcano with three military research facilities on its crater rim, faintly visible at night); and the massive Coluber Works and Shipyards complex, situated in isolation within an ancient southern meteorite crater. The city night-lights now allow the N-Ddshriiipjiziss mega-metropolitan region to become visible in-game whenever the peninsula it occupies is on the planet's night side. Even the gigantic palace complex of the Three Protecting Mothers is now visible — albeit only as a tiny lightspot — from orbit, just as described in the lore.

(ii) Panorama: Minor tweaks now position the station to allow fantastic views of the planet — including the day-night terminator — both upon arrival at the Witchpoint and after launching from the station.

(iii) Greeting: You are now met with an immersive greeting when you dock at the station - a welcome screen that displays useful information alongside some humorous messages — such as alerts if the ship has damaged modules or requires maintenance. The screen also shows your legal status, with the greeting becoming more reserved or even hostile if you are flagged as an Offender or Fugitive.

==== Possible future improvements ====
If I find the time, I’ll try building some interior facilities for the station next. I already have a few ideas, but I’m still working out a concept for how to implement them. (Captain Beatnik, August 2026).

[[File:Tag-colour-green.png]]

{{dockables-OXP}}
{{ambience-OXP}}

Baakili Far Trader

2026-08-09T17:42:03Z

Cholmondely: /* Tweaks */ Added Krager's script

{{Semantic Infobox ShipStats Oolite
|title=Baakili Far Trader
|image = [[Image:Z_Baakili.png|120px]]
|width = 850m
|height = 850m
|length = 1400m
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
}}
== Baakili Far Trader OXP ==
by [[User:Zieman|Zieman]]

This OXP adds an enigmatic alien race to the Ooniverse. These aliens fly gigantic, weird-looking spaceships and trade, as they say: "in information, sometimes esoteric, but always accurate".

Inspired by a character found in [http://en.wikipedia.org/wiki/Space_Rogue Paul Neurath's Space Rogue] (Origin 1989).

Released under the [http://creativecommons.org/licenses/by-nc-sa/3.0/ Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported] License.

== Overview ==
The mysterious Baakili value information above all else, so only a few select items of usual trader cargo is accepted. The rumours of sentients dropped near GalCop stations in remote systems with certain period of their lives erased from their memories are yet to be confirmed.

== Finding one and Trading ==
If you have an Advanced Space Compass, Baakili Nav Buoy is shown as U.

To initiate trade procedure, approach from behind - when you're close enough, you'll be transported to the trading area.

== Additional info ==
Baakili Far Trader has the role "bigTrader" in the role set, so it can be summoned by the Big Ships OXP. Even then the Baakili will behave in their own way.

Bigships_1.0.2.zip included in the download.

== Version history ==
2.0 - current version: [http://app.box.com/shared/zug5tyeqfk Download v 2.0 from Box.com] (2010)
* uses shaders via Oolite's materials model
* added Baakili to pirate-victim-roles.plist

1.2 - second bugfix: [http://koti.mbnet.fi/jouniku/Oolite/Baakili%20Far%20Trader%201.2.zip Download v 1.2 direct from Zieman's website]
* fixed problems that prevented the use of custom commodities.plist
* now the Baakili gets unique commodity market as intended, both when spawned by the OXP's own populator script and as bigTrader by the Big Ships OXP

1.1 - first bugfix
* fixed shipdata (prevented the ship's appearance 2 times out of 3)
* replaced the populator script with a javascript one

1.0 - initial release

== Tweaks ==
You will need to tweak the market to work with post 1.80 versions of Oolite: see [https://bb.oolite.space/viewtopic.php?f=4&t=17621#p239979 here] for instructions

Krager published a script for this OXP doing just that: see [https://bb.oolite.space/viewtopic.php?p=306882#p306882 here] (2026)

== Links ==
*[http://koti.mbnet.fi/jouniku/Oolite/ZOoliteOPXs.html Zieman's Oolite OXPs Website]
*[http://jouniku.mbnet.fi/Oolite/ZOoliteOPXs.html Another Zieman web site]

*[https://bb.oolite.space/viewtopic.php?p=274666#p274666 Recent activity] (2021)
*[https://bb.oolite.space/viewtopic.php?f=4&t=7372 Thread includes Baakili] (2010-2)

*[[User:Zieman|Zieman]]
*[[Far Arm ships]]: 10 ships & 4 missiles inspired by Paul Neurath's Space Rogue
*[[Tin of SPAM]]
*[[Z-ships]]: (Asp Explorer, Cobra Commodore, Porcupine & Python Courier)
*[[Zieman's Habitat Orbital Station]]

{{OXPLevel|0}}
{{ship-OXP}}
[[Category:Oolite carriers]]
[[Category:Non-humanoid people]]

Zerstörer

2026-08-09T12:28:51Z

Cholmondely: Added some lore, destubbed

{{Semantic Infobox ShipStats Oolite| title=Zerstörer
|image = [[image:Zerstörer.png|120px]]
|dimensions = 89x29x101
|width = 89m
|height = 29m
|length = 101m
|capacity = 20 TC
|capacityext = N/A
|maxspeed = 0.40 LM
|maneuverability = Roll: 1.9 Pitch: 1.25
|energybanks = Unknown
|energyrecharge = 3.8
|gunmounts = Fore
|missileslots = 4
|shieldboost = No
|milshields = No
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
|baseprice = N/A
}}
==Overview==
Also known as 'The Zerstoerer' and 'Prinz Klasse Zerstoerer' (English: Destroyer)

Sadly, the Zerstoerer can be a lumbering ungainly ship, unless flown by a pilot with lightening-speed reactions. While less suited for jousting, the Zerstoerer can be deadly in a full-fledged assault.

== Lore ==
The Zerstoerer was originally designed to protect the feudal naval strategists, those lucky individuals blessed with the strategic “coup d’oeil”, keeping them safe so that they could direct their navies against their enemies - whether Thargoids, pirates, bolsheviks or bourgeois money-grubbing corporatists. Sadly, many are now in the hands of the cravenly wealthy who have the connections to get their hands on one of these flagships.

These are built by Chivalric Spaceworks which has dockyards spread throughout the Feudal states

The Zerstoerer is flown by the princely class and is the one of the various feudal ships. Based on the Tetrahedron, the four-aspected nature of the ship reflects the four crucial values of chivalry: Piety, Nobility (includes loyalty & courtesy), Valour and Honour (includes Fair Play).

With the onslaught of the Thargoids, the resulting enfeeblement of GalCop and the concommitant rise of piracy, the Feudal Worlds were no longer able to source starships from the relevant corporations (especially with the inevitable political interference), and the growing need for "worthy steeds" for the knightly classes led to Lord Ramirez (rumoured to hail from [[Sector1/Geinona|Geinona]]) designing these Feudal Fliers, and eventually establishing Chivalric Spaceworks.

== Download ==
The Zerstörer is available in the: [[Feudal States]] OXP.

Zerstörer

2026-08-09T12:10:57Z

Cholmondely: Added some lore, destubbed

{{Semantic Infobox ShipStats Oolite| title=Zerstörer
|image = [[image:Zerstörer.png|120px]]
|dimensions = 89x29x101
|width = 89m
|height = 29m
|length = 101m
|capacity = 20 TC
|capacityext = N/A
|maxspeed = 0.40 LM
|maneuverability = Roll: 1.9 Pitch: 1.25
|energybanks = Unknown
|energyrecharge = 3.8
|gunmounts = Fore
|missileslots = 4
|shieldboost = No
|milshields = No
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
|baseprice = N/A
}}
==Overview==
Also known as 'The Zerstoerer' and 'Prinz Klasse Zerstoerer' (English: Destroyer)

Sadly, the Zerstoerer can be a lumbering ungainly ship, unless flown by a pilot with lightening-speed reactions. While less suited for jousting, the Zerstoerer can be deadly in a full-fledged assault.

== Lore ==
These are built by Chivalric Spaceworks which has dockyards spread throughout the Feudal states

The Zerstoerer is flown by the princely class and is the one of the various feudal ships. Based on the Tetrahedron, the four-aspected nature of the ship reflects the four crucial values of chivalry: Piety, Nobility (includes loyalty & courtesy), Valour and Honour (includes Fair Play).

With the onslaught of the Thargoids, the resulting enfeeblement of GalCop and the concommitant rise of piracy, the Feudal Worlds were no longer able to source starships from the relevant corporations (especially with the inevitable political interference), and the growing need for "worthy steeds" for the knightly classes led to Lord Ramirez (rumoured to hail from [[Sector1/Geinona|Geinona]]) designing these Feudal Fliers, and eventually establishing Chivalric Spaceworks.

== Download ==
The Zerstörer is available in the: [[Feudal States]] OXP.

Korvette

2026-08-09T12:06:49Z

Cholmondely: Added some lore, destubbed

{{Semantic Infobox ShipStats Oolite
|title=Korvette
|image = [[image:Korvette.png|120px]]
|width = 39m
|height = 11m
|length = 54m
|capacity = 10 TC
|capacityext = N/A
|maxspeed = 0.36 LM
|maneuverability = Roll: 2.3 Pitch: 2.0
|energybanks = Unknown
|energyrecharge = 3.0
|gunmounts = Fore
|missileslots = 4
|shieldboost = No
|milshields = No
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
|baseprice = N/A
}}
==Overview==
Also known as 'Freiherr-Klasse Korvette'

In the right hands, the Korvette is a nifty and agile steed, well capable of scoring first at a pas d'armes, and then evading the opponent's sally.

== Lore ==
These are built by Chivalric Spaceworks which has dockyards spread throughout the Feudal states

The Korvette is flown by the baronial class and is the one of the various feudal ships. Based on the Tetrahedron, the four-aspected nature of the ship reflects the four crucial values of chivalry: Piety, Nobility (includes loyalty & courtesy), Valour and Honour (includes Fair Play).

With the onslaught of the Thargoids, the resulting enfeeblement of GalCop and the concommitant rise of piracy, the Feudal Worlds were no longer able to source starships from the relevant corporations (especially with the inevitable political interference), and the growing need for "worthy steeds" for the knightly classes led to Lord Ramirez (rumoured to hail from [[Sector1/Geinona|Geinona]]) designing these Feudal Fliers, and eventually establishing Chivalric Spaceworks.

== Download ==
The Korvette is available in the: [[Feudal States]] OXP.

Jäger

2026-08-09T12:01:55Z

Cholmondely: Added some lore, destubbed

{{Semantic Infobox ShipStats Oolite
|title=Jäger
|image = [[image:Jäger.png|120px]]
|width = 17m
|height = 9m
|length = 39m
|capacity = 5 TC
|capacityext = N/A
|maxspeed = 0.375 LM
|maneuverability = Roll: 2.5 Pitch: 2.0
|energybanks = Unknown
|energyrecharge = 2.0
|gunmounts = Fore
|missileslots = 2
|shieldboost = No
|milshields = No
|hyperspace = Yes
|isoxp = OXP
|isplayer = No
|baseprice = N/A
}}
==Overview==
Also known as 'The Jaeger' or 'Ritter-Klasse Jaeger' (English: Hunter)

== Lore ==
These are built by Chivalric Spaceworks which has dockyards spread throughout the Feudal states

The Jaeger is flown by humble knights and is the least sophisticated of the various feudal ships. Based on the Tetrahedron, the four-aspected nature of the ship reflects the four crucial values of chivalry: Piety, Nobility (includes loyalty & courtesy), Valour and Honour (includes Fair Play).

With the onslaught of the Thargoids, the resulting enfeeblement of GalCop and the concommitant rise of piracy, the Feudal Worlds were no longer able to source starships from the relevant corporations (especially with the inevitable political interference), and the growing need for "worthy steeds" for the knightly classes led to Lord Ramirez (rumoured to hail from [[Sector1/Geinona|Geinona]]) designing these Feudal Fliers, and eventually establishing Chivalric Spaceworks.

== Download ==
The Jäger is available in the: [[Feudal States]] OXP.

Planetinfo.plist

2026-08-09T11:27:06Z

Cholmondely: /* Properties of the Planet */ Added note about "fogUniform"

'''planetinfo.[[plist]]''' in 'AddOns/Config' contains a dictionary for each of systems for which you wish to set custom data. A list of all galaxies and planets can be found [[Oolite planet list|here]]. Each of the properties mentioned below can be set (but, notably, not the location of the main planet, which is hard coded into the system seed value):

[[File:BellScrib goatsoup1.JPG|thumb|right|Ian Bell worksheet for the goatsoup recipe from his vanished archives See [[Oolite_planet_list#Where_do_these_crazy_names_come_from|Where do these crazy names come from?]] ]]

=== Colour Specifiers ===
'''Colour specifiers''' are used to declare colours in material attribute dictionaries, and in other contexts such as lasers in ''[[shipdata.plist]]''. Colour specifiers take any of several forms:
Named colours, RGB / RGBA tuples, RGB / RGBA dictionaries or HSBA dictionaries.

Colours can be viewed at https://rgbcolorpicker.com/0-1 and many other websites

Click on the "gory details" for more: --->
<div class="mw-collapsible mw-collapsed" data-expandtext="Show gory details" data-collapsetext="Hide gory details" style="overflow:auto;">
==== Named colours ====
The simplest form of colour specifier is a string containing a colour name. The following names are supported:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Colour names
! Name !! RGBA value
|-
| blackColor || 0, 0, 0, 1
|-
| darkGrayColor || 1/3, 1/3, 1/3, 1
|-
| lightGrayColor || 2/3, 2/3, 2/3, 1
|-
| whiteColor || 1, 1, 1, 1
|-
| grayColor || 1/2, 1/2, 1/2, 1
|-
| redColor || 1, 0, 0, 1
|-
| greenColor || 0, 1, 0, 1
|-
| blueColor || 0, 0, 1, 1
|-
| cyanColor || 0, 1, 1, 1
|-
| yellowColor || 1, 1, 0, 1
|-
| magentaColor || 1, 0, 1, 1
|-
| orangeColor || 1, 1/2, 0, 1
|-
| purpleColor || 1/2, 0, 1/2, 1
|-
| brownColor || 0.6, 0.4, 0.2, 1
|-
| clearColor || 0, 0, 0, 0
|-
|}

==== RGBA tuples ====
Colours may also be specified in RGB or RGBA (red, green, blue, alpha [transparency]). RGB or RGBA tuples may be specified as arrays or as strings separated by spaces. The values may range from 0 to 1 or 0 to 255. (If no value is greater than 1, 0–1 is assumed, otherwise 0–255.) Examples:
* <code>"1 1 0"</code> — yellow
* <code>"0 128 0 128"</code> — medium green at 50% opacity
* <code>(1, 0, 0)</code> – red

==== RGBA dictionaries ====
Just in case you’re unsure of the order the RGB[A] components come in, you can use a dictionary:
{
blue = 0.8;
green = 0.8;
}
Accepted keys are '''red''', '''green''', '''blue''' and '''alpha''' (or '''opacity'''), all optional (default: 0.0 for red, green and blue, 1.0 for alpha).

==== HSBA dictionaries ====
But wait, there’s more! Colours may also be specified as dictionaries in the [http://en.wikipedia.org/wiki/HSB_colour_space HSB colour space]. Accepted keys are '''hue''' (hue angle in degrees, required), '''saturation''', '''brightness''' (or '''value''') and '''alpha''' (or '''opacity'''). The default for the optional keys is 1.0.
{
// Pale magenta
hue = 300;
saturation = 0.3;
}
</div>

=== Added for Oolite v.1.91 ===
*air_density / or the Javascript planet entity airDensity - see below (pretty picture!)

=== Added for Oolite v.1.89 ===
This needs editing by somebody who understands it! Snatched from the Progress thread
*[https://bb.oolite.space/viewtopic.php?p=270737#p270737 air_color] now produces the right color for the sky. Not only that, it is now used as the atmosphere scatter color when the planet is viewed from space. Non-blue atmospheres are finally possible!
*[https://bb.oolite.space/viewtopic.php?p=270771#p270771 air_color_mix_ratio]
*[https://bb.oolite.space/viewtopic.php?p=271058#p271058 terminator_threshold_vector shipdata key]
*[https://bb.oolite.space/viewtopic.php?p=271058#p271058 JSPlanet terminatorThresholdVector property]
*[https://bb.oolite.space/viewtopic.php?p=269833#p269833 MULTIPLIER_LIGHTSRCRADIANCE and MULITPLIER_EXPOSURE]: Planet, ships and atmosphere shaders can now define lightsource radiance and scene exposure multipliers
*Also stuff about city lights
*And probably other stuff I missed!

==Where Settings Apply==

===Universal Settings===

Universal options are applied to all 2048 solar systems, this is useful for settings such as ambient lighting levels, eg.
"universal" =
{
...
}
Universal options can be over-ridden by specifying the same option for a specific system or. Obviously, not all options make sense to apply to the whole universe.

===Interstellar Space===

Conditions for interstellar space in general can be set with the “interstellar space” key.

Note: [https://bb.oolite.space/viewtopic.php?f=2&t=17191 Procedure to find all interstellar spaces] (2015)

===Specific Systems===

Each system is keyed by a string consisting of the galaxy number (0..7) followed by a space and then the planet number (0..255), eg.
"0 7" =
{
...
}
specifies system 7, in galaxy 0, ''Lave''.

===Specific Interstellar Spaces===

You can also specify a position in interstellar space, eg.
"interstellar: 0 7 129" =
{
...
}
specifies the space in galaxy 0 between systems 7 and 129, ''Lave'' and ''Zaonce''.

Note that
"interstellar: 0 7 129" = // jumping from Lave towards Zaonce
{
...
}
and
"interstellar: 0 129 7" = // jumping from Zaonce towards Lave
{
...
}
are distinct locations and if they both need the same properties this must be explicitly set for both.

In 1.81 the property "link_color" when set on a specific interstellar space changes the colour of the link between the two systems in the advanced navigation array (assuming no route is in place above it). When setting link_color, the lower system ID must be placed first, because of how the chart is drawn.

'''Note''' that [[User:Switeck|Switeck]] has done a lot of work on this - there are intermediate spots in the interstellar spaces - but only on the line between two systems. See the OXPs on his User: page

==Layers==

Settings other than "universal" in Oolite 1.81 or later have a 'layer' property from 0 to 3. The default value for planetinfo.plist files is 1. If multiple OXPs specify a setting for a particular property, the order they will be checked in is:
'''* Layer 3 settings'''
'''* Layer 2 settings''' (default for Javascript changes to data)
'''* Layer 1 settings''' (default for planetinfo.plist)
'''* Universal settings'''
'''* Layer 0 settings''' (value for core game settings)

This allows OXPs to safely override each other's changes if necessary, and for OXPs which really need a specific setting in a particular system to set it at layer 3

Example
"layer" = 2;

==Terraforming Example==

For the planet Lave, you would use the key '0 7' (planet 7 in galaxy 0) Then you set the values. The following example sets Lave's sea to blue, land to green, and land to sea ratio to 75%.

Code:
{
"0 7" =
{
"percent_land" = "75";
"land_color" = "0.5 1.0 0.5";
"sea_color" = "0.3 0.7 1.0";
}
}

Then you can override any of the settings listed above, for example to change Zaatxe's (Galaxy 0 Planet 8) inhabitants into blue frogs you'd enter

Code:
"0 8" =
{
"inhabitants" = "Blue Frogs";
}

You can use any or all of the keys in each of the entries. It's probably best to only use the key's you want to change. So, another example, to change the sky_blur_xxx settings for Zaonce (Galaxy 0 Planet 129) to big, heavily clustered, but pale blurs - you'd enter

Code:
"0 129" =
{
"sky_blur_cluster_chance" = "0.9";
"sky_blur_alpha" = "0.1";
"sky_blur_scale" = "32.0";
}

==About the Inhabitants==

===Concealment===
{{oolite-prop-added|1.83}}

An integer that determines how much information about the system is unknown.

Example:
"concealment" = "300";
The following values are recognised:
* 0: default, all information visible
* 100 or more: F7 screen shows no information, economy/government/TL/star colour not visible on chart
* 200 or more: system name is not shown
* 300 or more: system vanishes entirely from chart, will not be used in route plotting, cannot be targeted by player (NPCs can still jump to it, though)

===Government===

An integer between 0 and 7 indicating the government type of the system.

Example:
"government" = "7";

Possible values:
: 0: Anarchy
: 1: Feudal
: 2: Multi-Governmental
: 3: Dictatorship
: 4: Communist
: 5: Confederacy
: 6: Democracy
: 7: Corporate State

===Economy===
An integer between 0 and 7 indicating the economy type of the system.

Example:
"economy" = "5";

Possible values:
: 0: Rich Industrial
: 1: Average Industrial
: 2: Poor Industrial
: 3: Mainly Industrial
: 4: Mainly Agricultural
: 5: Rich Agricultural
: 6: Average Agricultural
: 7: Poor Agricultural

===Tech Level===

An integer between 0 and 14 indicating the sophistication of the planets technology. The tech level displayed on the system data screens in game is one higher than this number (range 1 to 15).

Example:
"techlevel" = "13";

Note: [https://bb.oolite.space/viewtopic.php?p=113258#p113258 Episodic minor variations in TL (2010)]

Further Note: The [[Famous Planets]] OXP transmogrifies [[Sector1/Sori]] into the Anarchy "Ascension" with a TL of 16! This is virtually no different to Ceesxe's TL 15.

===Population===

An integer between 0 and 67 indicating the number of inhabitants of a planet in hundreds of millions

Example:
"population" = "23";

See Wildeblood's note on no upper limit [https://bb.oolite.space/viewtopic.php?p=299408#p299408 here] (2025)

===Productivity===

An integer indicating the productivity of a planet.

Example:
"productivity" = "1000";

===Name===

The name of the planet.

Example:
"name" = "The planet's name";

'''Note''': See the [https://bb.oolite.space/viewtopic.php?t=12131 Pronounceable Planets Project] thread on the forum for some ideas!

===Inhabitant===

The name for one of the inhabitants of the main planet.

Example:
"inhabitant" = "Green Platypus";

===Inhabitants===

The name of the inhabitants of the main planet.

Example:
"inhabitants" = "Green Platypi";

===Description===

A short description of the planet.

Example:
"description" = "Really, anything you want to say about the place!";

'''Note''': For more than 1 oxp describing a system see [https://bb.oolite.space/viewtopic.php?p=165471#p165471 here] (2012) - and elsewhere. Note that ''eg''. [[System Features Rings]] does this through Javascript. rather than a .plist.

===Government Description===
{{oolite-prop-added|1.81}}

Overrides the default text used to describe the government.

Example:
"government_description" = "Dictatorship (Monarchy)";

===Economy Description===
{{oolite-prop-added|1.81}}

Overrides the default text used to describe the economy.

Example:
"economy_description" = "Mainly Industrial (Machine Tools)";

===Population Description===
{{oolite-prop-added|1.77}}

Overrides the default text used to describe the population.

Example:
"population_description" = "13 Billion";

===Random Seed===
{{oolite-prop-added|1.81}}

A seed for a random number generator used in Oolite 1.81 to generate system properties impractical to store in this file (e.g. the positions of each star on the background starfield)

For historical reasons, this is a string of 6 integers between 0 and 255, for example:
random_seed = "74 90 72 2 83 183";

==System population==
These properties are only used in Oolite 1.79 or later.

===Populator===

The name of the worldscript function which will be used to [[Oolite_System_Populator|populate the system]]

Example:
"populator" = "systemWillPopulate";

===Repopulator===

The name of the worldscript function which will be used to [[Oolite_System_Populator|repopulate the system]]

Example:
"repopulator" = "systemWillRepopulate";

==Properties of the Planet==

'''Most of these properties are ignored if a planet texture is set.'''

Note that the available planet texture generator properties changed in places between Oolite 1.77 and Oolite 1.80

And note the 2016 introduction of the shader uniform [[Shaders in Oolite: uniforms|fogUniform]] (a Javascript method for adding fog to planet atmospheres)

===Air Color===
A colour specifier determining the color of the planet's sky, as well as the atmosphere scatter color.

Example:
"air_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Air Color Mix Ratio===
{{oolite-prop-added|1.89}}

The amount of air color that be mixed in the overall atmosphere color. A number from 0.0 to 1.0 (default 0.5).

Example:
"air_color_mix_ratio" = "0.0..1.0";

===Atmosphere Rotational Velocity===

Sets how fast the atmosphere is rotating. (A random value between 0.0 to 0.03 is the default).

Example:
"atmosphere_rotational_velocity" = "0.1";

===Cloud Alpha===
{{oolite-prop-added|1.77}}

The transparency level of the cloud layer, relative to the standard transparency. 1.0 is the default. Texture packs which include clouds on the planetary texture may wish to reduce this.

Example:
"cloud_alpha" = "0.2";

===Has Atmosphere===
{{oolite-prop-added|1.81}}

This boolean property is used for the main planet only. If it is unset or true, the main planet has an atmosphere, as is always the case in 1.80 and before. If it is set to be false, then the planet will not have an atmosphere.

Example:
"has_atmosphere" = 0;

This has no effect on secondary planets - their atmosphere is determined by whether addition uses <code>addPlanet</code> or <code>addMoon</code>.

[[File:AtmDensityExample.png|thumb|320px|right|Atmosphere Density examples: Stranger's ''FPO Lave'' in four increasing atmosphere densities: 0.2, 0.5, 0.75 and 1.0. Every other parameter in the planet definition is the same in all pictures.]]
=== Air Density ===
{{oolite-prop-added|1.91}}

A number clamped in range from 0.0 to 1.0 describing the density of the planet's atmosphere. All planets in the core use 0.75 as default.

Example:
"air_density" = "0.0..1.0";

===Illumination Color===
{{oolite-prop-added|1.91}}

A colour specifier determining the colour of the planet's illumination such as cities light. Illumination is inserted as a grayscale map in the alpha channel of the planet's diffuse texture. You can specify this key even if no illumination map is defined, but it won't have any effect - without an illumination map the dark side of the planet remains dark in all cases.

Example:
"illumination_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Land Color===

Example:
"land_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Percent Cloud===
The percentage of the planet's atmosphere occupied by clouds.

Example:
"percent_cloud" = "0..100";

Note that with a low cloud_alpha setting not all of the clouds defined here may actually be visible

===Percent Ice===
The percentage of the planet occupied by the polar ice caps. Oolite 1.81 or later.

Example:
"percent_ice" = "0..100";

===Percent Land===
The percentage of the planet occupied by land.

Example:
"percent_land" = "0..100";

===Planet Distance===
{{oolite-prop-added|1.81}}

The distance from the centre of the planet to the witchpoint. Only used for the system main planet - secondary planets are positioned separately.

Example:
"planet_distance" = "410000";

The main planet is always positioned on the z-axis.

===Planet Distance Multiplier===
{{oolite-prop-added|1.81}}

Multiplies the distance from the centre of the main planet to the witchpoint.

Example:
"planet_distance_multiplier" = "1.5";

===Planet Name===
{{oolite-prop-added|1.79}}

The planet's name. For the main planet, this defaults to being the same as the system name - the property is mainly intended for secondary planets.

Example
"planet_name" = "Earth";

===Polar Land Color===
{{oolite-prop-added|1.81}}

Sets the land colour in polar regions.

Example:
"land_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Polar Sea Color===
{{oolite-prop-added|1.81}}

Sets the sea colour in polar regions.

Example:
"sea_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Radius===
An integer between 3000 and 7000 indicating the radius of the main planet. On the F7 screen, this is measured in kilometres. The radius in game is 1/100th of this.

Example:
"radius" = "5500";

===Rotational Velocity===
A number describing the rotational velocity of the planet in radians per second. Overrides rotation_speed if both are set.

Example:
"rotational_velocity" = 0.0015;

===Rotation Speed===
A number describing the rotational velocity of the planet in radians per second. Unlike rotational_velocity, this is affected by rotation_speed_factor.

Example:
"rotation_speed" = 0.0015;

===Rotation Speed Factor===
The rotational speed of all planets whose rotational speed was set by rotation_speed and not by rotational_velocity will be multiplied by this number.

Example:
"rotation_speed_factor" = 1.0;

(Intended more for the universal section as a "personal taste" option than for individual planets)

===Sea Color===

Example:
"sea_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Terminator Threshold Vector===
{{oolite-prop-added|1.89}}

This property gives control over the color of the planet's terminator. The way the property works is not entirely straightforward, so see [https://bb.oolite.space/viewtopic.php?p=271058#p271058 this post on BB] for more information.

Example:
"terminator_threshold_vector" = "0.0..1.0 0.0..1.0 0.0..1.0";
By default the terminator vector is "0.105 0.18 0.28" - which results in a reddish orange colour.

===Texture===
The replacement texture to be used by a system's main planet. 

For textures you can use lat-long maps (twice as wide as high) with a special elongation at the poles, or cube maps. Other maps will also be wrapped around planets, but will always give distortions. 
Since Oolite 1.74 you can also use cube maps for planets. Cube maps are 6 times higher than wide and will be recognised automatically by Oolite, based on the dimensions. Cube maps are the preferred method, because lat-long give some distortion and have the poles improperly placed in Oolite's implementation. See also [[Planettool]] for conversion from lat-long into cube maps.

From Oolite 1.89 onwards, illumination mapping on custom planets is supported. The illumination map goes in the diffuse map's alpha channel. Low alpha values translate to high illumination. This allows for effects like city lights on a planet's dark side.

Example:
"texture" = "newPlanetTexture.png";
:N.B.
The illumination mapping feature is disabled by setting ''Graphics Detail: Shaders Enabled'' or lower in the game setting menu. ''Enabled'' at ''Graphics Detail: Extra Detail''.

===Texture HSB Color===
This changes the overall hue of the replacement texture.

Example:
"texture_hsb_color" = "0.0..1.0 0.0..1.0 0.0..1.0";

===Texture NormSpec===
{{oolite-prop-added|1.89}}

The external texture that will be used as a normal and specular map for the given planet. Colorspace should be linear, with the normal map in the r,g and b and the specular map in the a channel. The texture can be of either equirectangular or cubemap formats. This feature is available at the Extra Detail setting only. To set:
"texture_normspec" = "planetNormalAndSpecularMap.png";

==Properties of the Sky==

===Ambient Level===

Sets how much ambient light (shed by stars and nebulae) illuminates the dark side of objects like planets and ships. Values should typically be between 0.0 and 1.0 (1.0 is the default) but can be higher for a flat lit, cartoon-like effect.

Example:
"ambient_level" = "0.0";

===Nebula Count Multiplier===
This is used for defining the number of nebulas. Default is 1.0. Number can be greater or less than default and is also randomised a bit.

Example:
"nebula_count_multiplier" = "1.5";

===Sky Blur Alpha===
Default 0.1

Example:
"sky_blur_alpha" = "0.0 .. 1.0";

===Sky Blur Cluster Chance===
This is used for creating nebulae (typically 0.80)

Example:
"sky_blur_cluster_chance" = "0.85";

===Sky Blur Scale===
Default 10. Larger numbers generate bigger nebula, but slow down the game considerable on slower machines.

Example:
"sky_blur_scale" = "0.0 .. 128.0 or more";

===Sky N Blurs===
This is used for defining the number of nebulas (typical is 80, maximum is 1280). This key is multiplied by a "nebula_count_multiplier" definition in Oolite 1.81 or later.

Example:
"sky_n_blurs" = "800";

===Sky N Stars===
This is used for defining the number of stars (typical = 600, maximum in 1.76 or earlier is 4800). This key is multiplied by a "star_count_multiplier" definition in Oolite 1.81 or later. In reduced detail mode, this number will be capped to 2400.

Example:
"sky_n_stars" = "1200";

===Sky and Nebula RGB Colors===

These are rgb values (from 0.0 to 1.0) for the two colours between which the colour of the stars (and nebulaesque blurs) vary, ordered r1 g1 b1 r2 g2 b2 where (r1 g1 b1) defines the first colour and (r2 g2 b2) the second. 
(Default values are "0.75 0.8 1.0 1.0 0.85 0.6")

Example:
"sky_rgb_colors" = "0.0..1.0 0.0..1.0 0.0..1.0 0.0..1.0 0.0..1.0 0.0..1.0";

Alternatively, two [[Materials in Oolite#Colour specifiers|colour specifiers]] may be used:
"sky_color_1" = "redColor";
"sky_color_2" =
{
"hue" = "60";
"brightness" = "0.8";
}

"nebula_color_1" = "greenColor";
"nebula_color_2" = "blueColor";

===Star Count Multiplier===
This is used for defining the number of stars. Default is 1.0. Number can be greater or less than default and is also randomised a bit.

Example:
"star_count_multiplier" = "0.5";

==Properties of the Station==

===Market Script===
{{oolite-prop-added|1.81}}

A Javascript file used to load a [[Oolite Market Scripts|market script]] for global system price and quantity modifications.

Example:
"market_script" = "myoxp_newsystemmarket.js";

'''Note:''' [https://bb.oolite.space/viewtopic.php?p=235837#p235837 What's the difference between the market script specified in planetinfo.plist and the one called for by trade-goods.plist?] (2015)

===Station===
The type of station orbiting the main planet.

Example:
"station" = "coriolis..dodec..special";

===Station Roll===
The speed at which the station rotates (as with all rotational velocities this is in radians per second) and affects all rotating stations in a system. For a specific station you can use the key [[Shipdata.plist#station_roll | station_roll]] in shipdata.plist.

Example:
"station_roll" = "0.5";

===Station Vector===
The direction of the main station from the main planet

Example:
"station_vector" = "-0.717 -0.668 0.201";

===Stations Require Docking Clearance===

Specifies if a player has to explicit ask docking permission. See also [[Oolite_Docking_Clearance_Protocol_%28v1.72_or_later%29|Oolite Docking Clearance]]

===Market (defunct)===
The market to be used in this system as the default market. It points to a key in commodities.plist

Example:
"market" = "rockhermit";
Will use the rockhermit market as default for for all stations in the system. When no market is defined a key in commodities.plist is used that matches the role of the main station. Than that is not defined, the default market is used in this system.

In 1.81 and later, this is replaced by market_script

==Properties of the Sun==
;N.B.
The corona effect, modified by the first three properties mentioned below, is disabled by setting ''Reduced Detail:On'' in the game setting menu. ''Enabled'' by default (''Reduced Detail:Off'').

===Corona Flare===

Sets the overall size of the corona in proportion to its sun. (See note above.)

A number from 0.0 (invisibly small) to 1.0 (huge)

Example:
"corona_flare" = "0.075";

===Corona Hues===

Specifies whether the corona should have visible bands of colours within the corona. (See note above.)

A number from 0.0 (monochromatic) to 1.0 (vivid alternating colours).

Example:
"corona_hues" = "0.6";

===Corona Shimmer===

Specifies how quickly the corona colours change. (See note above.)

A number from 0.0 (very slow) to 1.0 (very fast).

Example:
"corona_shimmer" = "0.4";

===Sun Color===

Sets the colour of a system's sun.

Can be any [[Materials in Oolite#Colour specifiers|colour specifier]] or [[Materials in Oolite#Named colours|named colour]]. The specified colour is blended with 50% white so it will never be a saturated colour. Dark colours will be brightened by this blending.

Example:
"sun_color" = "blueColor";

===Sun Distance===
{{oolite-prop-added|1.81}}

Sets the distance between the sun and the main planet in metres.

Example:
"sun_distance" = 924122;

Ignored if sun_distance_modifier is set.

===Sun Distance Multiplier===
{{oolite-prop-added|1.81}}

Multiplies the distance between the sun and the main planet by this factor.

Example:
"sun_distance_multiplier" = 2;

Ignored if sun_distance_modifier is set.

===Sun Distance Modifier===

Sets the approximate distance between a system sun and its main planet. The standard distance is 20 planetary radii. Setting it much lower (10, or even less) will cause delays when generating systems, as Oolite compensates for possible collisions between the sun and other system objects.

Example:
"sun_distance_modifier" = "15.0";

In Oolite 1.81 or later, sun_distance_multiplier is more useful.

=== Sun Gone Nova ===

Sets a nova sun in the system.

Example:
"sun_gone_nova" = "YES";

===Sun Name===

Stores the name of a system's sun. This is only implemented in Oolite from version 1.79 onwards, though was used by OXPs before then.

Example:
"sun_name" = "Alpha Centauri";

===Sun Radius===

Sets the radius of a system's sun. A number between 1000 and 1000000.

Example:
"sun_radius" = "100000";

===Sun Vector===
The direction of the sun from the main planet

Example:
"sun_vector" = "-0.717 -0.668 0.201";

==Additional Planets==

Finally you can also define your own custom planets and moons:
"LavesPurpleMoon" =
{
...
}


To add them to the system, use JS methods <code>[[Oolite_JavaScript_Reference:_System#addPlanet|system.addPlanet]]</code> and <code>[[Oolite_JavaScript_Reference:_System#addPlanet|system.addMoon]]</code>. For the example above, the <code>planetInfoKey</code> will be <code>"LavesPurpleMoon"</code>.

===Position===
Position of the planet in space. The first parameter is 3-character code of the coordinate system, other three is x, y and z components of position vector.
"position" = "pwm 0 -50000 0";

You can omit the coordinate system parameter, then the absolute coordinate system will be used:
"position" = "0 -50000 0";

See [[Oolite coordinate systems]] for more info about it.

===Orientation===
Orientation of the planet in space (seems not to be working correctly).

Example:
"orientation" = "0.0 1.0 0.0 0.0";

===Other keys===

You can use other keys from the [[#Properties_of_the_Planet| Properties of the Planet]] section for your planets and moons.

Here are some of the keys you may want to use:
* "radius": Radius of the planet in km. e.g. a value of 500 is drawn with a radius of 5000 meters but in player dialogues this value is presented as 500 km.
* "rotational_velocity": Rotation of the planet in rotations per second.
* "texture": The name of the texture file that is used to wrap around the surface.
* "seed": Seed value used to create the planet's surface features. If no seed is defined it uses the same seed as the main planet, and will create a copy of it.

[[File:Ico-Glow.png|thumb|right|300px|Click for more detail (eg the Ico station)]]
== Experimentation ==
The effect to the right was created by [[User:Cody|Cody]]. "OXPs were a Griff Icosahedron station, a [[Deep Horizon Nav Buoy]], a core planet (I think - if not, [[Povray Planets]]), a mix of [[KeeperSky]] & [[Zygo Cinematic Sky & Nebulas]], plus '''star_count_multiplier''' = 56; '''sun_distance_multiplier''' = 5; and '''ambient_level''' = 0.15;

For a similar "lights down" look, you'd have to tweak '''oolite-default-shader.fragment''' thusly:
:#define MULTIPLIER_LIGHTSRCRADIANCE 2.0
:#define MULITPLIER_EXPOSURE 1.0

*For another example see cbr's modifed "Tionisla is Mars" texture [https://bb.oolite.space/viewtopic.php?p=306156#p306156 here] (2026)

== Links ==
*[[Random number generator]] - original method for creating planet descriptions (before Oolite v.1.80 back in 2014).
*[https://bb.oolite.space/viewtopic.php?f=4&t=3860 seed = "1 2 3 4 5 6";]: Psuedo-random number generation & planet descriptions (2007)
*[https://bb.oolite.space/viewtopic.php?f=4&t=3808 position = "x y z" in planetinfo.plist] (2007)
*[https://bb.oolite.space/viewtopic.php?f=3&t=17678 How to regenerate planetinfo?] (cim, 2015) Replacing the current 7Mb .plist with the original goatsoup recipe.

*Wildeblood's [[World Builder]] allows you to experiment with these settings in-game.

=== Assorted Tweaks ===
*[[User:Submersible|Submersible]]'s collection of [https://www.youtube.com/user/submersibletoaster YouTube videos] of planet textures (2012)
*[https://bb.oolite.space/viewtopic.php?f=2&t=5044 Question: How to add custom planet descriptions] (2008)
*[https://bb.oolite.space/viewtopic.php?p=217053#p217053 Tweaking your skies] (Tricky, 2014)
*[https://bb.oolite.space/viewtopic.php?f=4&t=20959 Empty system] Removing the stations (and presumably inhabitants) from a system (2021)
*[https://bb.oolite.space/viewtopic.php?t=17191 Programming for Interstellar Space] (2015)

[[Category:Oolite]]
[[Category:Oolite scripting]]

Fully Annotated HUD Configuration (hud.plist) File

2026-08-09T10:02:00Z

Cholmondely: Made link at bottom human-readable

[[File:Origin-story.png|right|thumb|300px|x-origin & y-origin!]]
{
// =============================================================================
// IMPORTANT: This is a PROPERTY LIST (.plist) file in OpenStep format.
// =============================================================================
// Please note that this file uses OpenStep format (not JSON, XML, or other formats).
// When editing, be careful to preserve all punctuation, especially:
// - Commas at the end of dictionary entries (except the last one)
// - Semicolons after key-value pairs
// - Proper use of quotes, parentheses, and braces
// Incorrect punctuation will cause the file to fail to load in Oolite.
//
// =============================================================================
// GLOBAL HUD SETTINGS
// =============================================================================
// These settings control the overall behavior and appearance of the entire HUD. (The parameters that control visibility of the HUD elements are not included)
// Changes here affect all HUD elements globally.

// --- CROSSHAIR SETTINGS ---
// Controls the appearance of the targeting crosshair
crosshair_scale = 32.0; // Size multiplier for the crosshair. Higher values = larger crosshair
crosshair_width = 1.5; // Line thickness of the crosshair in pixels
crosshair_color = "greenColor"; // Color of the crosshair. Can be named colors ("redColor", "blueColor")
// or RGBA tuples like "(0.0, 1.0, 0.0, 1.0)" for green

// --- SCANNER SETTINGS ---
// Controls the behavior and appearance of the radar scanner
scanner_minimalistic = no; // If YES, uses a simplified scanner display with less detail
scanner_non_linear = no; // If YES, scanner zoom is non-linear (more sensitive near center)
scanner_ultra_zoom = no; // If YES, enables ultra zoom mode for the scanner

// --- GUI AND DISPLAY SETTINGS ---
// General interface settings
allow_big_gui = no; // If YES, allows larger GUI elements (rarely used)
overall_alpha = 0.75; // Global transparency for all HUD elements (0.0 = invisible, 1.0 = opaque)

// --- SPECIAL INDICATOR SETTINGS ---
// Controls specific HUD behaviors
cloak_indicator_on_status_light = yes; // If YES, shows cloak status on the status light instead of separate indicator
reticle_target_sensitive = no; // If YES, reticle changes color when hovering over targets

// =============================================================================
// POSITION SYSTEM DOCUMENTATION
// =============================================================================
// POSITION PARAMETERS:
// All positioned elements use the following coordinate system:
//
// x: The x-position of the dial on screen.
// y: The y-position of the dial on screen.
//
// x_origin:
// - x_origin = 1.0: x co-ordinate is relative to the RIGHT hand side of the screen
// - x_origin = 0 or unspecified: x is relative to the MIDDLE of the screen (default)
// - x_origin = -1.0: x co-ordinate is relative to the LEFT hand side of the screen
//
// y_origin:
// - y_origin = 1.0: y co-ordinate is relative to the TOP of the screen
// - y_origin = 0 or unspecified: y is relative to the MIDDLE of the screen (default)
// - y_origin = -1.0: y is relative to the BOTTOM of the screen
//
// BEST PRACTICE: It is preferable to define HUD elements relative to the screen
// borders (x_origin = ±1.0, y_origin = ±1.0) rather than the center, so that HUD
// elements fit better on all screen aspect ratios and resolutions.

// =============================================================================
// SPECIAL PARAMETERS DOCUMENTATION
// =============================================================================
// SPECIAL PARAMETERS:
// Some parameters only work with specific dials and have unique behaviors:
//
// align:
// - Only works with "drawASCTarget:" selector
// - When set to 1, right-aligns the text to the X coordinate instead of standard left alignment
// - Other values: 0 = left alignment (default), <s> 2 = center alignment </s>
//
// labelled:
// - Only works with "drawEnergyGauge:" selector
// - When set to yes, adds bank numbers to the energy banks
// - Has no effect on other dials
//
// n_bars:
// - For "drawEnergyGauge:": determines how many energy banks are drawn (default is 1)
// - For "drawPrimedEquipment:": if set to >1 (odd numbers work better than even),
// also shows some previous and next primable equipment in the cycle
// - Ignored for all other dials
//
// spacing:
// - Only works with "drawMissileDisplay:" selector
// - Determines spacing between the missile icons in the display
// - Does nothing for other dials

// =============================================================================
// DIALS SECTION
// =============================================================================
// The dials array defines all individual HUD elements (gauges, indicators, displays).
// Elements are drawn in the order they appear here - later elements appear on top.
// Each dial is a dictionary with properties defining its appearance and behavior.
//
// COLOR PARAMETER USAGE:
// Many dials support color parameters that change appearance based on values:
// - color_low: Color for low values/ranges
// - color_medium: Color for medium values/ranges
// - color_high: Color for high values/ranges
// - color_critical: Color for critical/dangerous values (temperature, altitude)
// - color_surround: Color for the border/frame around the dial
// - color: Base color for dials that don't use range-based coloring
//
// All color parameters accept standard Oolite color formats:
// - Named colors: "greenColor", "redColor", "yellowColor", etc.
// - RGB tuples: (1.0, 0.0, 0.0) for red
// - RGBA tuples: (1.0, 0.0, 0.0, 0.5) for semi-transparent red
// - Hex strings: "#FF0000" for red (less common in plist files)

dials = // these are drawn, in order, after the legends
(
// =============================================================================
// TARGETING RETICLE
// =============================================================================
// The crosshair that appears when targeting missiles or objects
{ // Targeting reticle
equipment_required = "EQ_SCANNER_SHOW_MISSILE_TARGET"; // Only show if this equipment is installed
selector = "drawTargetReticle:"; // Internal method that draws this element
// reticle_scale = 0.015625 /* 1/64 is default */ // Uncomment to override default scale
target_rgba = "greenColor"; // Color for normal targeting
target_sensitive_rgba = "redColor"; // Color when crosshairs are over target
wormhole_rgba = "cyanColor"; // Color when targeting wormholes
// Note: Moves about on screen - no position parameters needed
},

// =============================================================================
// WAYPOINT DISPLAY
// =============================================================================
// Shows navigation waypoints when advanced compass is equipped
{ // Waypoint display
equipment_required = "EQ_ADVANCED_COMPASS"; // Only show with advanced compass
selector = "drawWaypoints:"; // Internal drawing method
// Note: Moves about on screen - no position parameters needed
},

// =============================================================================
// SCANNER (RADAR)
// =============================================================================
// The main radar display showing contacts around the ship
{ // scanner
alpha = 1.0; // Transparency (1.0 = fully opaque)
selector = "drawScanner:"; // Internal method to draw the scanner
// POSITION PARAMETERS:
x = 0; // Horizontal position: 0 = center of screen
y = 68; // Vertical position: 68 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 64.0; // Height of scanner in pixels
width = 288.0; // Width of scanner in pixels
rgb_color = (1.0, 0.0, 0.0); // RGB color: (red, green, blue) = bright red
},

// =============================================================================
// SCANNER ZOOM INDICATOR
// =============================================================================
// Shows the current zoom level of the scanner
{ // scanner zoom indicator
alpha = 1.0; // Fully opaque
selector = "drawScannerZoomIndicator:"; // Drawing method
// POSITION PARAMETERS:
x = 100; // 100 pixels right of center
y = 36; // 36 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// STICK SENSITIVITY INDICATOR
// =============================================================================
// Shows current joystick/control sensitivity setting
{ // stick sensitivity indicator
alpha = 1.0; // Fully opaque
selector = "drawStickSensitivityIndicator:"; // Drawing method
// POSITION PARAMETERS:
x = 150; // 150 pixels right of center
y = 75; // 75 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 12; // 12 pixels tall
width = 12; // 12 pixels wide
},

// =============================================================================
// COMPASS
// =============================================================================
// Shows direction to target/station/waypoint
{ // compass
alpha = 1.0; // Fully opaque
selector = "drawCompass:"; // Drawing method
// POSITION PARAMETERS:
x = 132; // 132 pixels right of center
y = 32; // 32 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
rgb_color = (0.0, 0.0, 1.0); // RGB color: blue
},

// =============================================================================
// STATION AEGIS INDICATOR
// =============================================================================
// Shows when within station protection range
{ // station aegis
alpha = 1.0; // Fully opaque
selector = "drawAegis:"; // Drawing method
// POSITION PARAMETERS:
x = -132; // 132 pixels left of center
y = 32; // 32 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// FUEL SCOOP STATUS
// =============================================================================
// Shows when fuel scoop is active
{ // fuel scoop status
alpha = 0.75; // Semi-transparent (75% opaque)
selector = "drawScoopStatus:"; // Drawing method
// POSITION PARAMETERS:
x = -132; // 132 pixels left of center
y = 92; // 92 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// SPEED BAR
// =============================================================================
// Shows current ship speed
{ // speed bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw a border around the bar (2 pixels larger than bar)
height = 8; // Bar height in pixels
selector = "drawSpeedBar:"; // Drawing method
width = 80; // Bar width in pixels
// POSITION PARAMETERS:
x = 200; // 200 pixels right of center
y = 95; // 95 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color_low = "greenColor"; // Color for low speed range
color_medium = "yellowColor"; // Color for medium speed range
color_high = "redColor"; // Color for high speed range
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// ROLL BAR
// =============================================================================
// Shows current roll rate
{ // roll bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw border around bar
height = 6; // Bar height
selector = "drawRollBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = 200; // 200 pixels right of center
y = 80; // 80 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color = "greenColor"; // Base color for the roll bar
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// PITCH BAR
// =============================================================================
// Shows current pitch rate
{ // pitch bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw border around bar
height = 6; // Bar height
selector = "drawPitchBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = 200; // 200 pixels right of center
y = 70; // 70 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color = "greenColor"; // Base color for the pitch bar
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// YAW BAR
// =============================================================================
// Shows current yaw rate
{ // yaw bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw border around bar
height = 8; // Bar height
selector = "drawYawBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = 200; // 200 pixels right of center
y = -130; // 130 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
// COLOR PARAMETERS:
color = "greenColor"; // Base color for the yaw bar
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// ENERGY GAUGE
// =============================================================================
// Shows main energy bank levels
{ // energy gauge
draw_surround = yes; // Draw border around gauge
height = 48; // Gauge height
selector = "drawEnergyGauge:"; // Drawing method
width = 80; // Gauge width
// POSITION PARAMETERS:
x = 200; // 200 pixels right of center
y = 35; // 35 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// SPECIAL PARAMETERS:
labelled = yes; // Add bank numbers to the energy banks (only works with this selector)
n_bars = 3; // Number of energy banks to display (only works with this selector)
// COLOR PARAMETERS:
color_low = "redColor"; // Color for low energy level
color_medium = "yellowColor"; // Color for medium energy level
color_surround = "whiteColor"; // Color for the border around the gauge
},

// =============================================================================
// FORWARD SHIELD BAR
// =============================================================================
// Shows forward shield strength
{ // forward shield bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw border around bar
height = 8; // Bar height
selector = "drawForwardShieldBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 94; // 94 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color_low = "redColor"; // Color for low shield strength
color_medium = "yellowColor"; // Color for medium shield strength
color_high = "greenColor"; // Color for high shield strength
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// AFT SHIELD BAR
// =============================================================================
// Shows aft shield strength
{ // aft shield bar, can draw a surround 2 units out from the dial size specified
draw_surround = yes; // Draw border around bar
height = 8; // Bar height
selector = "drawAftShieldBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 78; // 78 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color_low = "redColor"; // Color for low shield strength
color_medium = "yellowColor"; // Color for medium shield strength
color_high = "greenColor"; // Color for high shield strength
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// SURROUND (DECORATIVE)
// =============================================================================
// Draws a decorative border (used here for visual grouping)
{ // just draws a surround 2 units around the selected size
height = 40; // Height of surround area
color = "yellowColor"; // Color of the border
selector = "drawSurround:"; // Drawing method
width = 80; // Width of surround area
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 46; // 46 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// FUEL BAR
// =============================================================================
// Shows current fuel level
{ // fuel bar
height = 8; // Bar height
selector = "drawFuelBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 61; // 61 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
// Special case: 'medium' is used for the bar itself, while 'high' and 'low'
// are used for the distance marker for the current destination system
color_low = "redColor"; // Color for distance marker when fuel is insufficient
color_medium = "greenColor"; // Color for the fuel bar itself
color_high = "yellowColor"; // Color for distance marker when fuel is sufficient
color_surround = "whiteColor"; // Color for the border around the bar (if draw_surround is enabled)
},

// =============================================================================
// WITCHSPACE DESTINATION LABEL
// =============================================================================
// Shows the destination system during hyperspace
{ // witchspace destination label
selector = "drawWitchspaceDestination:"; // Drawing method
height = 10; // Character height
width = 10; // Character width
// POSITION PARAMETERS:
y = 55; // 55 pixels up from bottom
x = -240; // 240 pixels left of center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
color = (0.25,0.25,1.0,1.0); // RGBA color: blue with full opacity
},

// =============================================================================
// CABIN TEMPERATURE BAR
// =============================================================================
// Shows internal cabin temperature
{ // cabin temperature bar
height = 8; // Bar height
selector = "drawCabinTempBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 51; // 51 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color_low = "greenColor"; // Color for normal temperature range
color_medium = "yellowColor"; // Color for elevated temperature range
color_high = "orangeColor"; // Color for high temperature range
color_critical = "redColor"; // Color for dangerous critical temperature
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// WEAPON TEMPERATURE BAR
// =============================================================================
// Shows weapon system temperature
{ // weapon temperature bar
height = 8; // Bar height
selector = "drawWeaponTempBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 41; // 41 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// Note: Weapon temperature bar doesn't support the standard color parameters
// It uses the default temperature gradient coloring
},

// =============================================================================
// ALTITUDE BAR
// =============================================================================
// Shows altitude when near planets
{ // altitude bar
height = 8; // Bar height
selector = "drawAltitudeBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = -200; // 200 pixels left of center
y = 31; // 31 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// COLOR PARAMETERS:
color_low = "greenColor"; // Color for safe altitude range
color_medium = "yellowColor"; // Color for caution altitude range
color_high = "orangeColor"; // Color for warning altitude range
color_critical = "redColor"; // Color for critical altitude (danger of crashing)
color_surround = "whiteColor"; // Color for the border around the bar
},

// =============================================================================
// MISSILE DISPLAY
// =============================================================================
// Shows status of mounted missiles
{ // missile display, x and y give the location, the x-spacing is given by spacing, the size defines the icon size
height = 12; // Icon height
selector = "drawMissileDisplay:"; // Drawing method
spacing = 16; // Horizontal spacing between missile icons
width = 12; // Icon width
// POSITION PARAMETERS:
x = -228; // 228 pixels left of center
y = 16; // 16 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// STATUS INDICATOR LIGHT
// =============================================================================
// Shows general ship status (alert/warning/caution)
{ // status indicator light, x and y give the location, the size defines the icon size
height = 8; // Light height
selector = "drawStatusLight:"; // Drawing method
width = 8; // Light width
// POSITION PARAMETERS:
x = -108; // 108 pixels left of center
y = 32; // 32 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// SHIP'S CLOCK
// =============================================================================
// Shows current game time
{ // ship's clock, x and y give the location, the size defines the character size
height = 12; // Character height
selector = "drawClock:"; // Drawing method
width = 12; // Character width
// POSITION PARAMETERS:
x = -41; // 41 pixels left of center
y = 18; // 18 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
},

// =============================================================================
// PRIMED EQUIPMENT DISPLAY
// =============================================================================
// Shows currently activated/primed equipment
{ // primed equipment, x and y give the location, the size defines the character size
selector = "drawPrimedEquipment:"; // Drawing method
// POSITION PARAMETERS:
y_origin = -1; // Vertical origin: -1 = bottom of screen
x = 156; // 156 pixels right of center
y = -2; // 2 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
width = 10; // Character width
height = 10; // Character height
// SPECIAL PARAMETERS:
n_bars = 3; // Shows current and adjacent primable equipment (odd numbers work better)
},

// =============================================================================
// COMPASS BEACON/WAYPOINT ID
// =============================================================================
// Shows the ID of targeted beacon or waypoint
{ // compass beacon/waypoint ID, x and y give the location, the size defines the character size
equipment_required = "EQ_ADVANCED_COMPASS"; // Only with advanced compass
selector = "drawASCTarget:"; // Drawing method
height = 12; // Character height
width = 12; // Character width
// POSITION PARAMETERS:
x = 144; // 144 pixels right of center
y = 4; // 4 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
// SPECIAL PARAMETERS:
align = 1; // Right-align text to X coordinate (only works with this selector)
},

// =============================================================================
// WEAPONS SYSTEMS OFFLINE TEXT
// =============================================================================
// Shows warning when weapons are offline
{ // weapons systems offline text, x and y give the location, the size defines the character size
height = 10; // Character height
selector = "drawWeaponsOfflineText:"; // Drawing method
width = 10; // Character width
// POSITION PARAMETERS:
x = -51; // 51 pixels left of center
y = -51; // 51 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
rgb_color = (0.0, 1.0, 0.0, 1.0); // RGBA color: green with full opacity
},

// =============================================================================
// FPS COUNTER
// =============================================================================
// Shows frames per second (debug/development tool)
{ // fps counter, x and y give the location, the size defines the character size
height = 18; // Character height
selector = "drawFPSInfoCounter:"; // Drawing method
width = 18; // Character width
// POSITION PARAMETERS:
x = -300; // 300 pixels left of center
y = -20; // 20 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 1; // Vertical origin: 1 = top of screen
rgb_color = (0.0, 1.0, 0.0, 1.0); // RGBA color: green with full opacity
},

// =============================================================================
// CUSTOM BAR (EXAMPLE)
// =============================================================================
// Example of a custom bar that could be added for OXP-specific purposes
// This is not in the original file but shows how drawCustomBar would work
/*
{ // custom bar example
draw_surround = yes; // Draw border around bar
height = 8; // Bar height
selector = "drawCustomBar:"; // Drawing method
width = 80; // Bar width
// POSITION PARAMETERS:
x = 0; // Center of screen
y = -150; // 150 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
// COLOR PARAMETERS:
color_low = "blueColor"; // Color for low values
color_medium = "greenColor"; // Color for medium values
color_high = "yellowColor"; // Color for high values
color_surround = "whiteColor"; // Color for the border around the bar
},
*/
);

// =============================================================================
// LEGENDS SECTION
// =============================================================================
// Legends are text labels that appear with dials. They are drawn BEFORE dials,
// so text appears behind the graphics. Each legend can be linked to a specific
// dial using the 'with_dial' property.
//
// COLOR PARAMETER:
// Legends support a 'color' property to override the default text color:
// - color: Sets the text color for the legend
// - Accepts standard Oolite color formats (named colors, RGB/RGBA tuples)

legends = // these are drawn, in order, before the dials
(
// =============================================================================
// LEFT SIDE LEGENDS
// =============================================================================
// Labels for dials on the left side of the screen

{
text = "FWD"; // Text to display: Forward shields
align = 1; // Text alignment: 1 = center
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 86; // 86 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 12; // Font height
width = 12; // Font width
// COLOR PARAMETER:
color = "cyanColor"; // Text color for this legend
with_dial = "drawForwardShieldBar:"; // Only show if this dial is visible
},
{
text = "AFT"; // Text to display: Aft shields
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 70; // 70 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 12; // Font height
width = 12; // Font width
// COLOR PARAMETER:
color = "cyanColor"; // Text color for this legend
with_dial = "drawAftShieldBar:"; // Link to aft shield bar
},
{
text = "FUEL"; // Text to display: Fuel level
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 55; // 55 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 10; // Font height
width = 10; // Font width
// COLOR PARAMETER:
color = "orangeColor"; // Text color for this legend
with_dial = "drawFuelBar:"; // Link to fuel bar
},
{
text = "CT"; // Text to display: Cabin Temperature
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 45; // 45 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 10; // Font height
width = 10; // Font width
// COLOR PARAMETER:
color = "yellowColor"; // Text color for this legend
with_dial = "drawCabinTempBar:"; // Link to cabin temp bar
},
{
text = "LT"; // Text to display: Laser Temperature
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 34; // 34 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 10; // Font height
width = 10; // Font width
// COLOR PARAMETER:
color = "yellowColor"; // Text color for this legend
with_dial = "drawWeaponTempBar:"; // Link to weapon temp bar
},
{
text = "ALT"; // Text to display: Altitude
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 24; // 24 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 10; // Font height
width = 10; // Font width
// COLOR PARAMETER:
color = "greenColor"; // Text color for this legend
with_dial = "drawAltitudeBar:"; // Link to altitude bar
},
{
text = "MISS"; // Text to display: Missiles
align = 1; // Center alignment
// POSITION PARAMETERS:
x = -245; // 245 pixels left of center
y = 3; // 3 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 14; // Font height
width = 14; // Font width
// COLOR PARAMETER:
color = "redColor"; // Text color for this legend
with_dial = "drawMissileDisplay:"; // Link to missile display
},

// =============================================================================
// RIGHT SIDE LEGENDS
// =============================================================================
// Labels for dials on the right side of the screen

{
text = "SPD"; // Text to display: Speed
// POSITION PARAMETERS:
x = 242; // 242 pixels right of center
y = 86; // 86 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 14; // Font height
width = 14; // Font width
// COLOR PARAMETER:
color = "whiteColor"; // Text color for this legend
with_dial = "drawSpeedBar:"; // Link to speed bar
},
{
text = "ROLL"; // Text to display: Roll rate
// POSITION PARAMETERS:
x = 242; // 242 pixels right of center
y = 72; // 72 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 12; // Font height
width = 12; // Font width
// COLOR PARAMETER:
color = "whiteColor"; // Text color for this legend
with_dial = "drawRollBar:"; // Link to roll bar
},
{ // yaw bar legend
text = "YAW"; // Text to display: Yaw rate
// POSITION PARAMETERS:
x = 242; // 242 pixels right of center
y = -138; // 138 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
height = 12; // Font height
width = 12; // Font width
// COLOR PARAMETER:
color = "whiteColor"; // Text color for this legend
with_dial = "drawYawBar:"; // Link to yaw bar
},
{
text = "PITCH"; // Text to display: Pitch rate
// POSITION PARAMETERS:
x = 242; // 242 pixels right of center
y = 62; // 62 pixels up from bottom
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = -1; // Vertical origin: -1 = bottom of screen
height = 12; // Font height
width = 12; // Font width
// COLOR PARAMETER:
color = "whiteColor"; // Text color for this legend
with_dial = "drawPitchBar:"; // Link to pitch bar
}
);

// =============================================================================
// MULTI-FUNCTION DISPLAYS (MFDs)
// =============================================================================
// MFDs are customizable panels that can show various information like cargo,
// manifest, map, etc. Players can cycle through different MFD modes in-game.
// You can define up to 12 MFDs. They are typically positioned on the sides
// of the screen to avoid interfering with the main HUD elements.
//
// COLOR PARAMETER:
// MFDs support a 'color' property to change from the default green:
// - color: Sets the color of the MFD display elements
// - Accepts standard Oolite color formats (named colors, RGB/RGBA tuples)

multi_function_displays = // can have 1 to 12 multi function displays
(
{
width = 198; // Panel width in pixels
height = 132; // Panel height in pixels
// POSITION PARAMETERS:
x = -156; // 156 pixels left of center
y = -72; // 72 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 1; // Vertical origin: 1 = top of screen
// COLOR PARAMETER:
color = "cyanColor"; // Color for MFD display elements (default is green)
},
{
width = 198; // Panel width in pixels
height = 132; // Panel height in pixels
// POSITION PARAMETERS:
x = 156; // 156 pixels right of center
y = -72; // 72 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 1; // Vertical origin: 1 = top of screen
// COLOR PARAMETER:
color = "cyanColor"; // Color for MFD display elements (default is green)
}
);

// =============================================================================
// MESSAGE GUI
// =============================================================================
// Controls the display of in-game messages (mission messages, alerts,
// status updates, etc.). This is the main text display area for communications.

message_gui = {
width = 252; // Panel width in pixels
height = 140; // Panel height in pixels
// POSITION PARAMETERS:
x = 128; // 128 pixels right of center
y = -60; // 60 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
row_height = 14; // Height of each message line in pixels
permanent = no; // If NO, panel hides when no messages
background_automatic = yes; // If YES, background auto-hides when no messages
// default background transparent
background_rgba = "0.0 0.05 0.45 0.0"; // Background color (RGBA): dark blue, fully transparent
text_color = "yellowColor"; // Default text color for messages
text_comms_color = "greenColor"; // Text color for communications messages
};

// =============================================================================
// COMMUNICATIONS LOG GUI
// =============================================================================
// Shows the history of communications (radio chatter, station messages,
// comms log, etc.). Typically positioned opposite the message GUI.

comm_log_gui = {
alpha = "0.75"; // Transparency: can be number or string
width = 216; // Panel width in pixels
height = 132; // Panel height in pixels
// POSITION PARAMETERS:
x = -156; // 156 pixels left of center
y = -68; // 68 pixels down from center
x_origin = 0; // Horizontal origin: 0 = center of screen
y_origin = 0; // Vertical origin: 0 = center of screen (default)
row_height = 12; // Height of each log line in pixels
permanent = no; // If NO, panel hides when inactive
automatic = yes; // If YES, auto-hides when no communications
background_rgba = "0.0 0.05 0.45 0.5"; // Background color: dark blue, semi-transparent
};
}

// See [https://wiki.alioth.net/index.php/HUD_Customisation_Guide HUD_Customisation_Guide]

[[Category:Oolite scripting]]

Riredi OXP

2026-08-09T09:42:52Z

Cholmondely: Added CB's latest!

[[File:Riredi_sodalite_orbital_station2.png|thumb|799px|right|Riredi sodalite orbital station]]
[[File:riredi planet.png|thumb|300px|left|Riredi.oxp's Riredi]]
<div style="clear:left"></div>
== Overview ==
*Custom texture for the planet
*New F7 description of the planet
*Unique orbital station
*Custom docking tunnel for [[BGS]]
*Special station defenders

[[Sector1/Riredi]] is the home of '''Coluber Inc.''' (Coluber Works and Shipyards Ltd.) and '''Riredisec Ltd.''' (a well established transport company that is specialized in the transportation of larger quantities of gold, platinum and gemstones).

The station is thus unique (designed and built by Coluber) and is guarded by [[Coluber Pitviper|Pitviper Mark II]]s which are manufactured locally by Coluber.

This OXP was initially created by Captain Beatnik in 2014.

=== Riredi v.2.0 ===
This OXP has been updated by [[User:Phkb|Phkb]] in 2024 (currently v.2.4)

The new version includes
*retextures of the Sodalite station & buoy,
*retexture of the planet (now includes city lights)
*introduces various trading tweaks (illegality of radioactives, a [[New Cargoes]] commodity)
*creates a preponderance of Coluber ships in the station shipyard (if the various Coluber ship OXPs are loaded)
*introduces retextured Coluber police ships to the system.
*includes PlanetFall 2 integration.

It links in with [[User:Phkb|Phkb]]'s Pitviper Mark II Facelift OXP (See [[Coluber Pitviper]]).

[[File:IconBGS.png|right |link=BGS|BGS enhances this OXP]]
[[File:IconPF2.png|right |link=Planetfall2 OXP|PlanetFall2 adds lore-based landing sites]]
[[File:New Cargoes icon.png|right|link=New Cargoes|New Cargoes commodity added in]]

== Development ==
*The original OXP was created by Captain Beatnik back in 2014 (planet texture, F7 screen description, station).
*It was then rejigged as an OXZ for the in-game [[Expansions Manager]] by Dybal in 2020.
*Phkb then added in city lights to the planet textures, improved ship textures, New Cargoes and planet landing sites for PlanetFall2 in 2024.
*Captain Beatnik is currently adding more: a lore-based planet texture, greeting screen on docking, ''etc''.

*Captain Beatnik has also added much lore for the planet and its denizens (see his [[User:Captain Beatnik|User:page]] for links to it).

== Links ==
*[[Sector1/Riredi]] - contains some of the new Lore
*[https://bb.oolite.space/viewtopic.php?f=4&t=16237 RELEASE: Riredi (ambience OXP)] BB Thread (2014-24)
*[[User:Captain Beatnik|Captain Beatnik]]: links to his other OXPs (pitvipers, racing ships & HUDs)

== Download ==
This oxp was repackaged and placed on the [[Expansions Manager]] by [[User:Dybal|Dybal]] and has since been updated by Phkb.
=== New Version! ===
*[[User:Captain Beatnik|Captain Beatnik]] has been working on updating this OXP further: [https://app.box.com/s/w4xio5dzdt8vhebw5qkihhpqejwiah45 ''download here (Aug 2026 update)''].

(i) Planet Texture: It now contains a lore-based planet texture with the appropriate geography (the vast central sea; Apex Mons (a gigantic, extinct shield volcano with three military research facilities on its crater rim, faintly visible at night); and the massive Coluber Works and Shipyards complex, situated in isolation within an ancient southern meteorite crater. The city night-lights now allow the N-Ddshriiipjiziss mega-metropolitan region to become visible in-game whenever the peninsula it occupies is on the planet's night side. Even the gigantic palace complex of the Three Protecting Mothers is now visible — albeit only as a tiny lightspot — from orbit, just as described in the lore.

(ii) Panorama: Minor tweaks now position the station to allow fantastic views of the planet — including the day-night terminator — both upon arrival at the Witchpoint and after launching from the station.

(iii) Greeting: You are now met with an immersive greeting when you dock at the station - a welcome screen that displays useful information alongside some humorous messages — such as alerts if the ship has damaged modules or requires maintenance. The screen also shows your legal status, with the greeting becoming more reserved or even hostile if you are flagged as an Offender or Fugitive.

==== Possible future improvements ====
If I find the time, I’ll try building some interior facilities for the station next. I already have a few ideas, but I’m still working out a concept for how to implement them. (Captain Beatnik, August 2026).

[[File:Tag-colour-green.png]]

{{dockables-OXP}}
{{ambience-OXP}}

Feudal States

2026-08-07T12:03:44Z

Cholmondely: /* DGill's Feudal Suite */ Added note on updated pdf

{{Infobox OXP| title = Feudal States OXP
|image = [[Image:Titleeagle.jpg|200px]]
|download = [https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc Latest (2021)]
|version = 2.1
|story = N/A
|stations = [[Feudal States#Ships and Stations|Stations]]
|ships = [[Feudal States#Ships and Stations|Ships]]
|mission = [[Feudal States#Elements|Elements]]
|equipment = N/A
|alternativeHUD = None
|soundSet = Some Music
|category = Systems OXPs
|author = [[User:Ramirez|Ramirez]]
}}

== Overview ==

The Feudal States is a flavour OXP that adds various new elements to the ''leading'' feudal systems in Oolite galaxies. The current version covers Galaxies 1, 2, 3, 5, 6 and (incompletely) 7.

== Elements ==

The OXP contains four basic elements:

'''Challenges'''

Pilots can visit [[Royal Hunting Lodge]]s where they are able to challenge nobles in ship-to-ship contact. Bets can be placed on the outcome, giving you an alternative way of making quick money. Use the '''F8''' interface while docked at the Lodge to accept a challenge and bet on it.

'''Missions'''

Good pilots are in high demand amongst the Feudal States. Visit the Royal Court where you can take on missions, ranging from simple deliveries to the capture and ransom of senior nobles. Use the '''F8''' interface for the Royal Court after landing on the planet.

'''Promotions'''

As your standing with the Feudal States increases, you can join their ranks as a knight of one of the royal houses. Further success will see you elevated to the peerage, with the chance of becoming one of the leading members of royal society.

'''Tournaments'''

The Feudal States hold regular tournaments where nobles gather to test their skills in combat. All pilots with noble rank are eligible to take part, with the winner taking home a major cash prize as well as increasing their prestige.

More detailed information on the OXP is available in the PDF readme (see below).

== Lore ==
The sections immediately beneath are taken from Ramirez's included .pdf:
[[File:Feudal inter Digebiti.png|thumb|right|500px|[[Sector1/Digebiti|Digebiti]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibecea.png|thumb|right|500px|[[Sector1/Tibecea|Tibecea]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibedied.png|thumb|right|500px|[[Sector1/Tibedied|Tibedied]] (From DGill's Feudal States Images OXP)]]
=== History ===
The Feudal States were formed in the decades following the first wave of the galaxy’s human colonisation. While the Corporations and Democracies had great success in securing new territory and resources, many individuals found themselves disenfranchised from power, lacking either the political skill or the business acumen to have a real say in the governing of their own affairs. In many systems, breakaway movements soon sprung up, with miners, engineers and farmers agreeing to pool their resources and seek a better life elsewhere.
The risks were great. Much of the galaxy’s unclaimed territory had by this time become a lawless hunting ground for pirates, cruising from system to system preying on unfortunate merchants and passenger liners. With no defence fleet of their own, and little money to pay for mercenary protection, the colonists turned their back on the complex systems of government that had oppressed them, and instead sought to build their strength through the ancient principles of feudalism. The idea was simple: anyone willing to provide military service to the movement would be rewarded with substantial territories in the new systems, with all the wealth and privilege associated with it.

Despite its rather old-fashioned nature, this offer of service was readily accepted by thousands of highly-rated combat pilots, many of whom had also lost out in the galactic land-grab and were having to scrape a living as itinerant freelancers. For them, serving as a knight in one of the Feudal States was an opportunity to further their careers in a more stable environment and finally earn the respect they felt was their due.

Many Feudal States were established in this way, each system forming its own set of houses, ranks, titles and styles based loosely upon those of Old Earth. For several years, the different states supported each other, eager to present a united front to other governments. But as the ranks of knights swelled, the Feudal States became ever more aggressive in character and friendly rivalry often led to war. Unable to challenge the military authority of the more established governments, the Feudal States turned upon each other in a bid to achieve supremacy.

The Feudal Wars, as the conflicts became known, were small, localised affairs and had little impact on the galaxy as a whole, although many dealers in other systems made their fortune by supplying arms and equipment to the belligerent states. Only when fighting spilled over into a nearby Democratic system, resulting in the accidental destruction of a passing freighter convoy, did the Galactic Cooperation act to put an end to the conflict. A ceasefire was enforced, the terms of which included a general embargo on the supply of offensive weapons by members of the Cooperation to any of the Feudal States.

The ceasefire remains in force today, however it is an uneasy truce and hostilities have recently resumed, with the feudal houses mounting frequent raids against each other’s trade convoys and even capturing high-ranking nobles for ransom. So long as any violence is contained within Feudal borders and does not endanger the lives of visitors, [[GalCop]] has tended to turn a blind eye to most inter-house conflict and police patrols do not venture far from the main space stations.

=== Economy ===
The Feudal States operate a range of economic models from industrial to agricultural, but they are all hampered by a lack of valuable raw resources; the systems with the most potential having been colonised long ago. Some states have managed to exploit indigenous flora and fauna with moderate success, but the majority have turned to tourism to boost their income. Particularly popular are the [[Royal Hunting Lodge]]s, small stations set away from the main space lanes where knights and nobles gather to test their combat skills and take part in large inter-house tournaments. For those living in societies where conflict is increasingly frowned upon, and the presence of GalCop is never far away, a visit to the Feudal States offers the chance to experience the life of a warrior, living according to the ancient laws of [[Royal Hunting Lodge|chivalry]].

=== Ships and Equipment ===
The trade embargo enforced by GalCop has left the Feudal States heavily self-sufficient in terms of equipment. Due to their lack of skill in high-tech engineering, the states favour simple but sturdy ships for military service rather than the more complex, high-maintenance models used by other governments. In recent times, most ships have been provided through a special contract with Beckmann-Fleisig AG, an independent shipbuilder with similar views on function over form.

A significant consequence of the Feudal States’ low-tech approach is that pilots are less reliant on the complex missile and defence systems that have become popular on many ship models. As a result, pilots in feudal service are known to be exceptionally good shots and many hold high combat ratings with the Elite Federation. Typically, each Feudal House operates three basic ship classes: the Jäger, Korvette and Zerstörer.

=== From Cim's Ship's Manual ===
''Tucked away inside his [[Ship's Library OXP]]:''

A Feudal System is defined as “a system where the exercise of power is hierarchical in nature”. In practice, since that is virtually tautologous, this status is reserved for those systems which have been unable to come to a satisfactory agreement with the Cooperative over at least one of the terms in the treaties. They may make a few goodwill payments to fund a basic station and patrols, or the Cooperative may provide them from surplus funding elsewhere, but there is no formal agreement.

[[Sector7/Atlaeser|Atlaeser]] in Chart 7 actually follows a traditional feudal model in its government, with the Grand Mover ruling with an inner court of Flock Leaders, and an outer court of Path and Skein Leaders (the planet still uses the traditional avian titles of nobility, from pre-spaceflight migrations). The system has relatively high living standards even for the serf classes, thanks to a well-balanced economy, and excellent natural resources.

At the other end of the scale, [[Sector3/Sovere|Sovere]] in Chart 3 has virtually no natural resources, and even its water is contaminated with hallucinogenic compounds. The corporate government would like to sell the water to other systems, as there is some demand for it, but under Cooperative law it is classified as a Narcotic, and the government's refusal to accept this classification is the crux of the dispute with the Cooperative.

[[Sector8/Cetiat|Cetiat]] in Chart 8 is the sort of system where the Cooperative practice of restricting the supply of technology to Feudal systems makes a lot of sense. The system refuses to sign up to either the non-aggression or mutual defence clauses of the Cooperative treaties, although fortunately its lack of industrial resources means that the nearby systems are not in any great danger from its pitiful navy. The dictatorship's territorial ambitions, while extremely unlikely to get anywhere, are long-standing.

'''NOTE''' that cim's account is at loggerheads with that of Ramirez just above it. One presumes that this is motivated by an uneasiness with the concept of popular feudalism so far in the future. As adumbrated in the musings section beneath, with the collapse of the Golden Age due to Thargoid invasions and the rise of piracy, Feudalism is a perfectly reasonable response.

== Ships and Stations ==

{| cellspacing="3" align="center" border="0" text-align="center"
|align="center" width="200" height="175"|[[Image:Jäger.png |link= Jäger |100px|]] [[Jäger]]
|align="center" width="200" height="175"|[[Image:Korvette.png |link= Korvette |100px|]] [[Korvette]]
|align="center" width="200" height="175"|[[Image:Zerstörer.png |link= Zerstörer |100px|]] [[Zerstörer]]
|align="center" width="200" height="175"|[[Image:Lodge.png |link= Royal Hunting Lodge |100px|]] [[Royal Hunting Lodge]]
|}

== Difficulty ==

Taking part in missions, challenges and tournaments is entirely optional. Missions and tournament events increase in difficulty as you progress, while challenges vary in difficulty depending on the skill and rank of your opponent.

== Requirements ==

Note that the ship models use shaders to help with identification, though the OXP will run with shader options turned off.

[[File:IconPF2.png|right|link=Planetfall2 OXP|PlanetFall2 adds feudal landing sites]]

== Dependencies ==

Requires [[Planetfall_OXP|Planetfall OXP]] (either the 2013 PF1 version ''or'' the 2024 PF2 version).

== Download ==
*v.2.1 Downloadable from [https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc here]
*[[Media:Feudal_States_1.16.3.oxz|Feudal_States_1.16.3.oxz]] (downloaded {{#downloads:Feudal_States_1.16.3.oxz}} times) or through the in-game [[Expansions Manager]].
*The Feudal States OXP is available for download at [http://www.arcadia-digital.net/steve/Oolite/Oolite.html Ramirez' Oolite Pages]
*[[Media:Feudal_States_1.16.2.oxz|Feudal_States_1.16.2.oxz]] for Oolite 1.79 or later (downloaded {{#downloads:Feudal_States_1.16.2.oxz}} times).

[[Image:IconGNN.png|right|48px|link=GNN|DGill's version uses GNN]]
[[Image:IconLib.png|right|48px|link=Library OXP|DGill's version uses Library's PAD]]
[[Image:IconPF2.png|right|48px|link=Planetfall2|DGill's version uses Planetfall2]]
=== DGill's Feudal Suite ===
DGill's Feudal States oxp suite (in Beta, for playtesting) - these 4 OXPs replace Ramirez's original, above. [[File:New.gif]]
*[https://drive.google.com/drive/folders/1lqj6brYWwgR555AcewXgvKpZak7sswTx?usp=sharing Feudal States Extended]
*[https://drive.google.com/drive/folders/1O1_Wpcl2OW-e8dWPTDkq-5py1W2dOyRQ?usp=sharing Feudal States Tibecea]
*[https://drive.google.com/drive/folders/1FeBS8o85YsSRHIpNtmwxI91bXA-Qq5DL?usp=sharing Feudal States Ships]
*[https://drive.google.com/drive/folders/1l8eW-8q27q2bKlanl3-nD7XmtbwTtBVW?usp=sharing Feudal States Images]

"Tibecea" both adds estate management to the game (once one is of high-enough feudal rank) ''and'' flavours the SE corner of G1 (Santaari) around [[Tibecea (Rough Guide)|Tibecea]].

The feudal suite adds in more activities and dovetails beautifully with [[Planetfall2 OXP]], building on the possibilities which Planetfall2 introduces to Oolite. At the time of writing, it is the only OXP which does this. It ''also'' works with the older Planetfall.

==== Revised PDF ====
DGill has revised Ramirez's .pdf to include G8/Xrata.

To extract it, try here: [[File:The Feudal States Extended.pdf.zip]]

Or you can just dig it out of his "Feudal States Extended" OXP.

== Musings ==
G8 is missing from this OXP (there are 32 feudal states there). It would also be nice to add in some more nationalities (Norwegian? Hungarian? Finnish? Brazilian? Scottish? ''etc''). And maybe one or two of the other species - the batrachians of G8 Rear or the felines of G8 Aanra?

The escutcheons for G7 are likewise missing.

''This is all fixed in DGill's four-piece Feudal States suite''

=== Historic context ===
Feudalism developed in Europe as a response to the downfall of the Roman Empire (≅ GalCop) and the incursions of the barbarians (≅ Thargoids & pirates). As matters in The Eight worsen and presuming that GalCop proves incapable of supporting local regimes, one might well expect more states to take up a feudal system of government as people cry out for protection against the invaders!

== Tweaks ==
OXP's being modifiable, this one, also, can be changed at whim if you have the skills. See the screen shots of DGill's version [https://bb.oolite.space/viewtopic.php?p=278048#p278048 here], with larger hunting lodges, a feudal HUD (!) and a greater variety of different missions.

== PDF ==
Tucked away inside this oxp is one of [[User:Ramirez|Ramirez]]'s famous .pdf's stashed full of information (15 pages!).

To extract it, try here: [[File:The Feudal States.pdf.zip]]

''Or'' you can use the [[Expansions Manager]], or just expand it with your computer's software unzipper and peek into the folder.

== Links ==

*You can find the Feudal States discussion thread on the Oolite Bulletin Boards [https://bb.oolite.space/viewtopic.php?t=5511 here].
*See the Royal Houses box at the bottom of this page
*An earlier Feudal OXP was written by Caracal [https://bb.oolite.space/viewtopic.php?t=4860 Teaser OXP for Feudals: Target Practice] (2008 - download link broken)

This has proved a very popular OXP - together with the main thread there are many others dealing with problems people found. These two are a little different:
*[https://bb.oolite.space/viewtopic.php?f=6&t=13140 Land ownership as reward for missions for Feudal lords?] (2012)
*[https://bb.oolite.space/viewtopic.php?f=2&t=18710 How do you imagine Feudal Systems?] (2017)

{{FeudalStatesRoyalHouses}}

{{station-OXP}}{{ship-OXP}}{{mission-OXP}}

[[Category:The Feudal States| ]] [[Category:Fictional organisations]]

File:The Feudal States Extended.pdf.zip

2026-08-07T11:56:29Z

Cholmondely: From DGill's Feudal States OXP suite

== Summary ==
From DGill's Feudal States OXP suite

Sector8/Index

2026-08-07T11:49:29Z

Cholmondely: Added Feudal States OXP

{{GalaxyGuide/IndexList}}

== Overview over Galaxy Sector 8 ==

<div style="position:relative">{{ClickMapHeader|Sector=8|Image=Sector8_OverViewMap.png}}
{{ClickMapEntry|Name=Anesbi|Sector=8|XPos=1|YPos=45|XPosRel=6|YPosRel=70}}
{{ClickMapEntry|Name=Iseror|Sector=8|XPos=204|YPos=230|XPosRel=616|YPosRel=348}}
{{ClickMapEntry|Name=Ererso|Sector=8|XPos=38|YPos=249|XPosRel=117|YPosRel=376}}
{{ClickMapEntry|Name=Leatanre|Sector=8|XPos=168|YPos=103|XPosRel=508|YPosRel=157}}
{{ClickMapEntry|Name=Tebienla|Sector=8|XPos=206|YPos=59|XPosRel=622|YPosRel=91}}
{{ClickMapEntry|Name=Revequ|Sector=8|XPos=85|YPos=146|XPosRel=258|YPosRel=222}}
{{ClickMapEntry|Name=Eresorbe|Sector=8|XPos=95|YPos=218|XPosRel=288|YPosRel=330}}
{{ClickMapEntry|Name=Vegedius|Sector=8|XPos=147|YPos=121|XPosRel=445|YPosRel=184}}
{{ClickMapEntry|Name=Querbeis|Sector=8|XPos=136|YPos=13|XPosRel=412|YPosRel=22}}
{{ClickMapEntry|Name=Leater|Sector=8|XPos=29|YPos=211|XPosRel=90|YPosRel=319}}
{{ClickMapEntry|Name=Bianbies|Sector=8|XPos=132|YPos=208|XPosRel=400|YPosRel=315}}
{{ClickMapEntry|Name=Maana|Sector=8|XPos=201|YPos=38|XPosRel=607|YPosRel=60}}
{{ClickMapEntry|Name=Biis|Sector=8|XPos=86|YPos=143|XPosRel=261|YPosRel=217}}
{{ClickMapEntry|Name=Usmaedin|Sector=8|XPos=36|YPos=189|XPosRel=111|YPosRel=286}}
{{ClickMapEntry|Name=Erlabeor|Sector=8|XPos=12|YPos=24|XPosRel=39|YPosRel=39}}
{{ClickMapEntry|Name=Xeerin|Sector=8|XPos=153|YPos=83|XPosRel=463|YPosRel=127}}
{{ClickMapEntry|Name=Teescear|Sector=8|XPos=255|YPos=204|XPosRel=769|YPosRel=309}}
{{ClickMapEntry|Name=Oresreat|Sector=8|XPos=10|YPos=133|XPosRel=33|YPosRel=202}}
{{ClickMapEntry|Name=Esusge|Sector=8|XPos=17|YPos=14|XPosRel=54|YPosRel=24}}
{{ClickMapEntry|Name=Lequatdi|Sector=8|XPos=245|YPos=3|XPosRel=739|YPosRel=7}}
{{ClickMapEntry|Name=Oredrier|Sector=8|XPos=237|YPos=241|XPosRel=715|YPosRel=364}}
{{ClickMapEntry|Name=Soladiar|Sector=8|XPos=16|YPos=126|XPosRel=51|YPosRel=192}}
{{ClickMapEntry|Name=Inzaan_1|Sector=8|XPos=74|YPos=45|XPosRel=225|YPosRel=70}}
{{ClickMapEntry|Name=Maenes|Sector=8|XPos=108|YPos=91|XPosRel=327|YPosRel=139}}
{{ClickMapEntry|Name=Xebeis|Sector=8|XPos=39|YPos=73|XPosRel=120|YPosRel=112}}
{{ClickMapEntry|Name=Cetiat|Sector=8|XPos=20|YPos=29|XPosRel=63|YPosRel=46}}
{{ClickMapEntry|Name=Titiridi|Sector=8|XPos=14|YPos=17|XPosRel=45|YPosRel=28}}
{{ClickMapEntry|Name=Geale|Sector=8|XPos=45|YPos=158|XPosRel=138|YPosRel=240}}
{{ClickMapEntry|Name=Ceanve|Sector=8|XPos=84|YPos=65|XPosRel=255|YPosRel=100}}
{{ClickMapEntry|Name=Esveti|Sector=8|XPos=151|YPos=246|XPosRel=457|YPosRel=372}}
{{ClickMapEntry|Name=Ceraerar|Sector=8|XPos=87|YPos=119|XPosRel=264|YPosRel=181}}
{{ClickMapEntry|Name=Aarzari|Sector=8|XPos=10|YPos=48|XPosRel=33|YPosRel=75}}
{{ClickMapEntry|Name=Dieranor|Sector=8|XPos=190|YPos=100|XPosRel=574|YPosRel=153}}
{{ClickMapEntry|Name=Ceanquan|Sector=8|XPos=185|YPos=187|XPosRel=559|YPosRel=283}}
{{ClickMapEntry|Name=Enustien|Sector=8|XPos=187|YPos=58|XPosRel=565|YPosRel=90}}
{{ClickMapEntry|Name=Atanon|Sector=8|XPos=114|YPos=151|XPosRel=345|YPosRel=229}}
{{ClickMapEntry|Name=Biatge|Sector=8|XPos=76|YPos=95|XPosRel=231|YPosRel=145}}
{{ClickMapEntry|Name=Aditira|Sector=8|XPos=58|YPos=67|XPosRel=177|YPosRel=103}}
{{ClickMapEntry|Name=Orbira|Sector=8|XPos=116|YPos=87|XPosRel=351|YPosRel=133}}
{{ClickMapEntry|Name=Aedis|Sector=8|XPos=116|YPos=116|XPosRel=351|YPosRel=177}}
{{ClickMapEntry|Name=Anri|Sector=8|XPos=133|YPos=253|XPosRel=403|YPosRel=382}}
{{ClickMapEntry|Name=Orlaaror|Sector=8|XPos=122|YPos=128|XPosRel=369|YPosRel=195}}
{{ClickMapEntry|Name=Edandi|Sector=8|XPos=89|YPos=234|XPosRel=270|YPosRel=354}}
{{ClickMapEntry|Name=Intearbe|Sector=8|XPos=194|YPos=141|XPosRel=586|YPosRel=214}}
{{ClickMapEntry|Name=Quedbiqu|Sector=8|XPos=147|YPos=42|XPosRel=445|YPosRel=66}}
{{ClickMapEntry|Name=Orqure|Sector=8|XPos=122|YPos=134|XPosRel=369|YPosRel=204}}
{{ClickMapEntry|Name=Arqubi|Sector=8|XPos=225|YPos=46|XPosRel=679|YPosRel=72}}
{{ClickMapEntry|Name=Maisrais|Sector=8|XPos=171|YPos=198|XPosRel=517|YPosRel=300}}
{{ClickMapEntry|Name=Reonar|Sector=8|XPos=61|YPos=244|XPosRel=186|YPosRel=369}}
{{ClickMapEntry|Name=Xeceon|Sector=8|XPos=216|YPos=138|XPosRel=652|YPosRel=210}}
{{ClickMapEntry|Name=Maatxeri|Sector=8|XPos=38|YPos=127|XPosRel=117|YPosRel=193}}
{{ClickMapEntry|Name=Enbeza|Sector=8|XPos=30|YPos=34|XPosRel=93|YPosRel=54}}
{{ClickMapEntry|Name=Geen|Sector=8|XPos=234|YPos=132|XPosRel=706|YPosRel=201}}
{{ClickMapEntry|Name=Soisqu|Sector=8|XPos=213|YPos=224|XPosRel=643|YPosRel=339}}
{{ClickMapEntry|Name=Veerbidi|Sector=8|XPos=223|YPos=90|XPosRel=673|YPosRel=138}}
{{ClickMapEntry|Name=Getiusza|Sector=8|XPos=173|YPos=198|XPosRel=523|YPosRel=300}}
{{ClickMapEntry|Name=Zaatquat|Sector=8|XPos=164|YPos=40|XPosRel=496|YPosRel=63}}
{{ClickMapEntry|Name=Riarquge|Sector=8|XPos=81|YPos=250|XPosRel=246|YPosRel=378}}
{{ClickMapEntry|Name=Esusla|Sector=8|XPos=99|YPos=90|XPosRel=300|YPosRel=138}}
{{ClickMapEntry|Name=Zainat|Sector=8|XPos=134|YPos=245|XPosRel=406|YPosRel=370}}
{{ClickMapEntry|Name=Onisain|Sector=8|XPos=17|YPos=76|XPosRel=54|YPosRel=117}}
{{ClickMapEntry|Name=Orlatein|Sector=8|XPos=204|YPos=111|XPosRel=616|YPosRel=169}}
{{ClickMapEntry|Name=Onusra|Sector=8|XPos=172|YPos=60|XPosRel=520|YPosRel=93}}
{{ClickMapEntry|Name=Edsoan|Sector=8|XPos=123|YPos=20|XPosRel=372|YPosRel=33}}
{{ClickMapEntry|Name=Onveat|Sector=8|XPos=123|YPos=123|XPosRel=372|YPosRel=187}}
{{ClickMapEntry|Name=Rebite|Sector=8|XPos=102|YPos=241|XPosRel=309|YPosRel=364}}
{{ClickMapEntry|Name=Belebi|Sector=8|XPos=81|YPos=220|XPosRel=246|YPosRel=333}}
{{ClickMapEntry|Name=Xezaxees|Sector=8|XPos=251|YPos=166|XPosRel=757|YPosRel=252}}
{{ClickMapEntry|Name=Aanra|Sector=8|XPos=201|YPos=98|XPosRel=607|YPosRel=150}}
{{ClickMapEntry|Name=Erzara|Sector=8|XPos=224|YPos=84|XPosRel=676|YPosRel=129}}
{{ClickMapEntry|Name=Gexeala|Sector=8|XPos=137|YPos=52|XPosRel=415|YPosRel=81}}
{{ClickMapEntry|Name=Usreinxe|Sector=8|XPos=21|YPos=79|XPosRel=66|YPosRel=121}}
{{ClickMapEntry|Name=Isdidied|Sector=8|XPos=130|YPos=204|XPosRel=394|YPosRel=309}}
{{ClickMapEntry|Name=Enedge|Sector=8|XPos=152|YPos=141|XPosRel=460|YPosRel=214}}
{{ClickMapEntry|Name=Artelaan|Sector=8|XPos=46|YPos=99|XPosRel=141|YPosRel=151}}
{{ClickMapEntry|Name=Inisbi|Sector=8|XPos=123|YPos=213|XPosRel=372|YPosRel=322}}
{{ClickMapEntry|Name=Ramaa|Sector=8|XPos=208|YPos=166|XPosRel=628|YPosRel=252}}
{{ClickMapEntry|Name=Aresgeti|Sector=8|XPos=143|YPos=175|XPosRel=433|YPosRel=265}}
{{ClickMapEntry|Name=Zariorte|Sector=8|XPos=183|YPos=163|XPosRel=553|YPosRel=247}}
{{ClickMapEntry|Name=Raaran|Sector=8|XPos=124|YPos=25|XPosRel=375|YPosRel=40}}
{{ClickMapEntry|Name=Laace|Sector=8|XPos=122|YPos=251|XPosRel=369|YPosRel=379}}
{{ClickMapEntry|Name=Areran|Sector=8|XPos=101|YPos=239|XPosRel=306|YPosRel=361}}
{{ClickMapEntry|Name=Inorle|Sector=8|XPos=59|YPos=80|XPosRel=180|YPosRel=123}}
{{ClickMapEntry|Name=Geintiso|Sector=8|XPos=7|YPos=33|XPosRel=24|YPosRel=52}}
{{ClickMapEntry|Name=Ininlequ|Sector=8|XPos=231|YPos=247|XPosRel=697|YPosRel=373}}
{{ClickMapEntry|Name=Uszasora|Sector=8|XPos=90|YPos=161|XPosRel=273|YPosRel=244}}
{{ClickMapEntry|Name=Teat|Sector=8|XPos=116|YPos=231|XPosRel=351|YPosRel=349}}
{{ClickMapEntry|Name=Teteus|Sector=8|XPos=174|YPos=17|XPosRel=526|YPosRel=28}}
{{ClickMapEntry|Name=Biered|Sector=8|XPos=33|YPos=232|XPosRel=102|YPosRel=351}}
{{ClickMapEntry|Name=Tirige|Sector=8|XPos=78|YPos=56|XPosRel=237|YPosRel=87}}
{{ClickMapEntry|Name=Anedin|Sector=8|XPos=185|YPos=3|XPosRel=559|YPosRel=7}}
{{ClickMapEntry|Name=Ceenti|Sector=8|XPos=160|YPos=44|XPosRel=484|YPosRel=69}}
{{ClickMapEntry|Name=Orus|Sector=8|XPos=207|YPos=55|XPosRel=625|YPosRel=85}}
{{ClickMapEntry|Name=Arlale|Sector=8|XPos=193|YPos=72|XPosRel=583|YPosRel=111}}
{{ClickMapEntry|Name=Edtetiin|Sector=8|XPos=1|YPos=97|XPosRel=6|YPosRel=148}}
{{ClickMapEntry|Name=Ceened|Sector=8|XPos=172|YPos=215|XPosRel=520|YPosRel=325}}
{{ClickMapEntry|Name=Ertebira|Sector=8|XPos=56|YPos=114|XPosRel=171|YPosRel=174}}
{{ClickMapEntry|Name=Tiatisbi|Sector=8|XPos=212|YPos=134|XPosRel=640|YPosRel=204}}
{{ClickMapEntry|Name=Laorlaza|Sector=8|XPos=230|YPos=221|XPosRel=694|YPosRel=334}}
{{ClickMapEntry|Name=Bedice|Sector=8|XPos=68|YPos=149|XPosRel=207|YPosRel=226}}
{{ClickMapEntry|Name=Orcece|Sector=8|XPos=70|YPos=69|XPosRel=213|YPosRel=106}}
{{ClickMapEntry|Name=Erteenon|Sector=8|XPos=69|YPos=197|XPosRel=210|YPosRel=298}}
{{ClickMapEntry|Name=Dirima|Sector=8|XPos=159|YPos=114|XPosRel=481|YPosRel=174}}
{{ClickMapEntry|Name=Legean|Sector=8|XPos=119|YPos=11|XPosRel=360|YPosRel=19}}
{{ClickMapEntry|Name=Onanqu|Sector=8|XPos=128|YPos=123|XPosRel=388|YPosRel=187}}
{{ClickMapEntry|Name=Maantege|Sector=8|XPos=117|YPos=250|XPosRel=354|YPosRel=378}}
{{ClickMapEntry|Name=Tetete|Sector=8|XPos=3|YPos=60|XPosRel=12|YPosRel=93}}
{{ClickMapEntry|Name=Diriledi|Sector=8|XPos=244|YPos=252|XPosRel=736|YPosRel=381}}
{{ClickMapEntry|Name=Reisorza|Sector=8|XPos=13|YPos=1|XPosRel=42|YPosRel=4}}
{{ClickMapEntry|Name=Aneded|Sector=8|XPos=100|YPos=57|XPosRel=303|YPosRel=88}}
{{ClickMapEntry|Name=Isxein|Sector=8|XPos=140|YPos=120|XPosRel=424|YPosRel=183}}
{{ClickMapEntry|Name=Istixeti|Sector=8|XPos=13|YPos=76|XPosRel=42|YPosRel=117}}
{{ClickMapEntry|Name=Atmala|Sector=8|XPos=183|YPos=226|XPosRel=553|YPosRel=342}}
{{ClickMapEntry|Name=Beanle|Sector=8|XPos=178|YPos=181|XPosRel=538|YPosRel=274}}
{{ClickMapEntry|Name=Releleat|Sector=8|XPos=81|YPos=129|XPosRel=246|YPosRel=196}}
{{ClickMapEntry|Name=Bebima|Sector=8|XPos=177|YPos=1|XPosRel=535|YPosRel=4}}
{{ClickMapEntry|Name=Vebixe|Sector=8|XPos=229|YPos=75|XPosRel=691|YPosRel=115}}
{{ClickMapEntry|Name=Esmara|Sector=8|XPos=159|YPos=194|XPosRel=481|YPosRel=294}}
{{ClickMapEntry|Name=Arustea|Sector=8|XPos=9|YPos=212|XPosRel=30|YPosRel=321}}
{{ClickMapEntry|Name=Laxesori|Sector=8|XPos=111|YPos=60|XPosRel=336|YPosRel=93}}
{{ClickMapEntry|Name=Usrelain|Sector=8|XPos=158|YPos=135|XPosRel=478|YPosRel=205}}
{{ClickMapEntry|Name=Aatdire|Sector=8|XPos=12|YPos=213|XPosRel=39|YPosRel=322}}
{{ClickMapEntry|Name=Inusge|Sector=8|XPos=14|YPos=13|XPosRel=45|YPosRel=22}}
{{ClickMapEntry|Name=Bigexein|Sector=8|XPos=121|YPos=67|XPosRel=366|YPosRel=103}}
{{ClickMapEntry|Name=Enxeleti|Sector=8|XPos=140|YPos=2|XPosRel=424|YPosRel=6}}
{{ClickMapEntry|Name=Anrasoti|Sector=8|XPos=119|YPos=129|XPosRel=360|YPosRel=196}}
{{ClickMapEntry|Name=Enerqu|Sector=8|XPos=87|YPos=231|XPosRel=264|YPosRel=349}}
{{ClickMapEntry|Name=Esxear|Sector=8|XPos=158|YPos=122|XPosRel=478|YPosRel=186}}
{{ClickMapEntry|Name=Xexean|Sector=8|XPos=246|YPos=74|XPosRel=742|YPosRel=114}}
{{ClickMapEntry|Name=Isri|Sector=8|XPos=1|YPos=123|XPosRel=6|YPosRel=187}}
{{ClickMapEntry|Name=Tiatza|Sector=8|XPos=123|YPos=62|XPosRel=372|YPosRel=96}}
{{ClickMapEntry|Name=Zaveusge|Sector=8|XPos=77|YPos=100|XPosRel=234|YPosRel=153}}
{{ClickMapEntry|Name=Geatiar|Sector=8|XPos=195|YPos=8|XPosRel=589|YPosRel=15}}
{{ClickMapEntry|Name=Atbea|Sector=8|XPos=106|YPos=151|XPosRel=321|YPosRel=229}}
{{ClickMapEntry|Name=Tiqubied|Sector=8|XPos=180|YPos=15|XPosRel=544|YPosRel=25}}
{{ClickMapEntry|Name=Oredaris|Sector=8|XPos=152|YPos=166|XPosRel=460|YPosRel=252}}
{{ClickMapEntry|Name=Leesusen|Sector=8|XPos=125|YPos=10|XPosRel=378|YPosRel=18}}
{{ClickMapEntry|Name=Zarila|Sector=8|XPos=18|YPos=200|XPosRel=57|YPosRel=303}}
{{ClickMapEntry|Name=Ditegere|Sector=8|XPos=217|YPos=117|XPosRel=655|YPosRel=178}}
{{ClickMapEntry|Name=Rete|Sector=8|XPos=46|YPos=3|XPosRel=141|YPosRel=7}}
{{ClickMapEntry|Name=Soaxe|Sector=8|XPos=75|YPos=60|XPosRel=228|YPosRel=93}}
{{ClickMapEntry|Name=Mausdile|Sector=8|XPos=249|YPos=34|XPosRel=751|YPosRel=54}}
{{ClickMapEntry|Name=Tibiri|Sector=8|XPos=97|YPos=173|XPosRel=294|YPosRel=262}}
{{ClickMapEntry|Name=Cecees|Sector=8|XPos=94|YPos=96|XPosRel=285|YPosRel=147}}
{{ClickMapEntry|Name=Gexequon|Sector=8|XPos=244|YPos=169|XPosRel=736|YPosRel=256}}
{{ClickMapEntry|Name=Tevebebi|Sector=8|XPos=191|YPos=218|XPosRel=577|YPosRel=330}}
{{ClickMapEntry|Name=Eres|Sector=8|XPos=102|YPos=19|XPosRel=309|YPosRel=31}}
{{ClickMapEntry|Name=Zaonrixe|Sector=8|XPos=26|YPos=192|XPosRel=81|YPosRel=291}}
{{ClickMapEntry|Name=Legece|Sector=8|XPos=226|YPos=126|XPosRel=682|YPosRel=192}}
{{ClickMapEntry|Name=Arenxeon|Sector=8|XPos=165|YPos=67|XPosRel=499|YPosRel=103}}
{{ClickMapEntry|Name=Belaus|Sector=8|XPos=159|YPos=34|XPosRel=481|YPosRel=54}}
{{ClickMapEntry|Name=Resobi|Sector=8|XPos=241|YPos=72|XPosRel=727|YPosRel=111}}
{{ClickMapEntry|Name=Esinen|Sector=8|XPos=28|YPos=6|XPosRel=87|YPosRel=12}}
{{ClickMapEntry|Name=Uszave|Sector=8|XPos=137|YPos=210|XPosRel=415|YPosRel=318}}
{{ClickMapEntry|Name=Riedanen|Sector=8|XPos=99|YPos=118|XPosRel=300|YPosRel=180}}
{{ClickMapEntry|Name=Birare|Sector=8|XPos=18|YPos=59|XPosRel=57|YPosRel=91}}
{{ClickMapEntry|Name=Inzaan_2|Sector=8|XPos=73|YPos=174|XPosRel=222|YPosRel=264}}
{{ClickMapEntry|Name=Inbein|Sector=8|XPos=236|YPos=27|XPosRel=712|YPosRel=43}}
{{ClickMapEntry|Name=Inceisa|Sector=8|XPos=172|YPos=204|XPosRel=520|YPosRel=309}}
{{ClickMapEntry|Name=Enonlebe|Sector=8|XPos=79|YPos=253|XPosRel=240|YPosRel=382}}
{{ClickMapEntry|Name=Raeserre|Sector=8|XPos=179|YPos=1|XPosRel=541|YPosRel=4}}
{{ClickMapEntry|Name=Ususoner|Sector=8|XPos=238|YPos=208|XPosRel=718|YPosRel=315}}
{{ClickMapEntry|Name=Oresrati|Sector=8|XPos=16|YPos=255|XPosRel=51|YPosRel=385}}
{{ClickMapEntry|Name=Rain|Sector=8|XPos=23|YPos=20|XPosRel=72|YPosRel=33}}
{{ClickMapEntry|Name=Diquus|Sector=8|XPos=65|YPos=172|XPosRel=198|YPosRel=261}}
{{ClickMapEntry|Name=Enarines|Sector=8|XPos=79|YPos=200|XPosRel=240|YPosRel=303}}
{{ClickMapEntry|Name=Tile|Sector=8|XPos=201|YPos=12|XPosRel=607|YPosRel=21}}
{{ClickMapEntry|Name=Endiqu|Sector=8|XPos=121|YPos=33|XPosRel=366|YPosRel=52}}
{{ClickMapEntry|Name=Xetila|Sector=8|XPos=122|YPos=122|XPosRel=369|YPosRel=186}}
{{ClickMapEntry|Name=Texeare|Sector=8|XPos=111|YPos=245|XPosRel=336|YPosRel=370}}
{{ClickMapEntry|Name=Ontear|Sector=8|XPos=174|YPos=15|XPosRel=526|YPosRel=25}}
{{ClickMapEntry|Name=Aletius|Sector=8|XPos=39|YPos=234|XPosRel=120|YPosRel=354}}
{{ClickMapEntry|Name=Lelemaa|Sector=8|XPos=136|YPos=87|XPosRel=412|YPosRel=133}}
{{ClickMapEntry|Name=Tetige|Sector=8|XPos=79|YPos=107|XPosRel=240|YPosRel=163}}
{{ClickMapEntry|Name=Atmabe|Sector=8|XPos=54|YPos=67|XPosRel=165|YPosRel=103}}
{{ClickMapEntry|Name=Reenaten|Sector=8|XPos=112|YPos=83|XPosRel=339|YPosRel=127}}
{{ClickMapEntry|Name=Laedon|Sector=8|XPos=50|YPos=81|XPosRel=153|YPosRel=124}}
{{ClickMapEntry|Name=Ceenza|Sector=8|XPos=141|YPos=95|XPosRel=427|YPosRel=145}}
{{ClickMapEntry|Name=Enenonge|Sector=8|XPos=123|YPos=4|XPosRel=372|YPosRel=9}}
{{ClickMapEntry|Name=Laedat|Sector=8|XPos=67|YPos=95|XPosRel=204|YPosRel=145}}
{{ClickMapEntry|Name=Arance|Sector=8|XPos=223|YPos=145|XPosRel=673|YPosRel=220}}
{{ClickMapEntry|Name=Arqua|Sector=8|XPos=106|YPos=37|XPosRel=321|YPosRel=58}}
{{ClickMapEntry|Name=Islebeen|Sector=8|XPos=52|YPos=207|XPosRel=159|YPosRel=313}}
{{ClickMapEntry|Name=Biinceor|Sector=8|XPos=50|YPos=51|XPosRel=153|YPosRel=79}}
{{ClickMapEntry|Name=Maarabi|Sector=8|XPos=153|YPos=101|XPosRel=463|YPosRel=154}}
{{ClickMapEntry|Name=Letioned|Sector=8|XPos=198|YPos=47|XPosRel=598|YPosRel=73}}
{{ClickMapEntry|Name=Eresen|Sector=8|XPos=184|YPos=63|XPosRel=556|YPosRel=97}}
{{ClickMapEntry|Name=Soceorbi|Sector=8|XPos=107|YPos=18|XPosRel=324|YPosRel=30}}
{{ClickMapEntry|Name=Bibirale|Sector=8|XPos=6|YPos=57|XPosRel=21|YPosRel=88}}
{{ClickMapEntry|Name=Teenatle|Sector=8|XPos=33|YPos=20|XPosRel=102|YPosRel=33}}
{{ClickMapEntry|Name=Biorle|Sector=8|XPos=1|YPos=17|XPosRel=6|YPosRel=28}}
{{ClickMapEntry|Name=Anteed|Sector=8|XPos=192|YPos=97|XPosRel=580|YPosRel=148}}
{{ClickMapEntry|Name=Biabi|Sector=8|XPos=112|YPos=152|XPosRel=339|YPosRel=231}}
{{ClickMapEntry|Name=Atbele|Sector=8|XPos=155|YPos=134|XPosRel=469|YPosRel=204}}
{{ClickMapEntry|Name=Quxege|Sector=8|XPos=166|YPos=33|XPosRel=502|YPosRel=52}}
{{ClickMapEntry|Name=Ceesari|Sector=8|XPos=160|YPos=163|XPosRel=484|YPosRel=247}}
{{ClickMapEntry|Name=Vezaorla|Sector=8|XPos=190|YPos=47|XPosRel=574|YPosRel=73}}
{{ClickMapEntry|Name=Belees|Sector=8|XPos=245|YPos=89|XPosRel=739|YPosRel=136}}
{{ClickMapEntry|Name=Arbetequ|Sector=8|XPos=222|YPos=105|XPosRel=670|YPosRel=160}}
{{ClickMapEntry|Name=Mageesti|Sector=8|XPos=26|YPos=124|XPosRel=81|YPosRel=189}}
{{ClickMapEntry|Name=Zabixedi|Sector=8|XPos=119|YPos=201|XPosRel=360|YPosRel=304}}
{{ClickMapEntry|Name=Laceus|Sector=8|XPos=141|YPos=130|XPosRel=427|YPosRel=198}}
{{ClickMapEntry|Name=Atisen|Sector=8|XPos=131|YPos=8|XPosRel=397|YPosRel=15}}
{{ClickMapEntry|Name=Axebe|Sector=8|XPos=224|YPos=178|XPosRel=676|YPosRel=270}}
{{ClickMapEntry|Name=Anrara|Sector=8|XPos=197|YPos=83|XPosRel=595|YPosRel=127}}
{{ClickMapEntry|Name=Dibiedin|Sector=8|XPos=100|YPos=20|XPosRel=303|YPosRel=33}}
{{ClickMapEntry|Name=Maabile|Sector=8|XPos=12|YPos=56|XPosRel=39|YPosRel=87}}
{{ClickMapEntry|Name=Tioned|Sector=8|XPos=65|YPos=38|XPosRel=198|YPosRel=60}}
{{ClickMapEntry|Name=Sorezaqu|Sector=8|XPos=111|YPos=216|XPosRel=336|YPosRel=327}}
{{ClickMapEntry|Name=Didilaer|Sector=8|XPos=26|YPos=68|XPosRel=81|YPosRel=105}}
{{ClickMapEntry|Name=Bequri|Sector=8|XPos=144|YPos=85|XPosRel=436|YPosRel=130}}
{{ClickMapEntry|Name=Biatzate|Sector=8|XPos=44|YPos=222|XPosRel=135|YPosRel=336}}
{{ClickMapEntry|Name=Belabia|Sector=8|XPos=220|YPos=132|XPosRel=664|YPosRel=201}}
{{ClickMapEntry|Name=Maletees|Sector=8|XPos=239|YPos=102|XPosRel=721|YPosRel=156}}
{{ClickMapEntry|Name=Sodiri|Sector=8|XPos=201|YPos=220|XPosRel=607|YPosRel=333}}
{{ClickMapEntry|Name=Onatce|Sector=8|XPos=51|YPos=254|XPosRel=156|YPosRel=384}}
{{ClickMapEntry|Name=Diesdi|Sector=8|XPos=22|YPos=165|XPosRel=69|YPosRel=250}}
{{ClickMapEntry|Name=Qumaus|Sector=8|XPos=195|YPos=237|XPosRel=589|YPosRel=358}}
{{ClickMapEntry|Name=Xeoresce|Sector=8|XPos=14|YPos=104|XPosRel=45|YPosRel=159}}
{{ClickMapEntry|Name=Ustiza|Sector=8|XPos=133|YPos=201|XPosRel=403|YPosRel=304}}
{{ClickMapEntry|Name=Esdi|Sector=8|XPos=196|YPos=164|XPosRel=592|YPosRel=249}}
{{ClickMapEntry|Name=Dienve|Sector=8|XPos=22|YPos=109|XPosRel=69|YPosRel=166}}
{{ClickMapEntry|Name=Ondizaat|Sector=8|XPos=86|YPos=182|XPosRel=261|YPosRel=276}}
{{ClickMapEntry|Name=Gequadi|Sector=8|XPos=241|YPos=164|XPosRel=727|YPosRel=249}}
{{ClickMapEntry|Name=Tilaanes|Sector=8|XPos=45|YPos=15|XPosRel=138|YPosRel=25}}
{{ClickMapEntry|Name=Qurixean|Sector=8|XPos=9|YPos=155|XPosRel=30|YPosRel=235}}
{{ClickMapEntry|Name=Tequenes|Sector=8|XPos=59|YPos=162|XPosRel=180|YPosRel=246}}
{{ClickMapEntry|Name=Veenen|Sector=8|XPos=233|YPos=18|XPosRel=703|YPosRel=30}}
{{ClickMapEntry|Name=Rear|Sector=8|XPos=59|YPos=146|XPosRel=180|YPosRel=222}}
{{ClickMapEntry|Name=Beorsora|Sector=8|XPos=90|YPos=74|XPosRel=273|YPosRel=114}}
{{ClickMapEntry|Name=Raaed|Sector=8|XPos=244|YPos=39|XPosRel=736|YPosRel=61}}
{{ClickMapEntry|Name=Zaeded|Sector=8|XPos=124|YPos=184|XPosRel=375|YPosRel=279}}
{{ClickMapEntry|Name=Biraa|Sector=8|XPos=117|YPos=248|XPosRel=354|YPosRel=375}}
{{ClickMapEntry|Name=Reusleed|Sector=8|XPos=106|YPos=111|XPosRel=321|YPosRel=169}}
{{ClickMapEntry|Name=Geisor|Sector=8|XPos=88|YPos=97|XPosRel=267|YPosRel=148}}
{{ClickMapEntry|Name=Ergerexe|Sector=8|XPos=89|YPos=89|XPosRel=270|YPosRel=136}}
{{ClickMapEntry|Name=Labirior|Sector=8|XPos=2|YPos=46|XPosRel=9|YPosRel=72}}
{{ClickMapEntry|Name=Riladi|Sector=8|XPos=57|YPos=30|XPosRel=174|YPosRel=48}}
{{ClickMapEntry|Name=Zabeor|Sector=8|XPos=225|YPos=141|XPosRel=679|YPosRel=214}}
{{ClickMapEntry|Name=Inonin|Sector=8|XPos=210|YPos=217|XPosRel=634|YPosRel=328}}
{{ClickMapEntry|Name=Edzaar|Sector=8|XPos=172|YPos=63|XPosRel=520|YPosRel=97}}
{{ClickMapEntry|Name=Veusbi|Sector=8|XPos=103|YPos=138|XPosRel=312|YPosRel=210}}
{{ClickMapEntry|Name=Laxerive|Sector=8|XPos=166|YPos=6|XPosRel=502|YPosRel=12}}
{{ClickMapEntry|Name=Vemaed|Sector=8|XPos=214|YPos=62|XPosRel=646|YPosRel=96}}
{{ClickMapEntry|Name=Isaso|Sector=8|XPos=218|YPos=88|XPosRel=658|YPosRel=135}}
{{ClickMapEntry|Name=Inuses|Sector=8|XPos=52|YPos=7|XPosRel=159|YPosRel=13}}
{{ClickMapEntry|Name=Atoresra|Sector=8|XPos=94|YPos=73|XPosRel=285|YPosRel=112}}
{{ClickMapEntry|Name=Edtizabe|Sector=8|XPos=244|YPos=169|XPosRel=736|YPosRel=256}}
{{ClickMapEntry|Name=Asoarle|Sector=8|XPos=147|YPos=196|XPosRel=445|YPosRel=297}}
{{ClickMapEntry|Name=Enrienge|Sector=8|XPos=129|YPos=10|XPosRel=391|YPosRel=18}}
{{ClickMapEntry|Name=Bees|Sector=8|XPos=99|YPos=242|XPosRel=300|YPosRel=366}}
{{ClickMapEntry|Name=Esusale|Sector=8|XPos=94|YPos=96|XPosRel=285|YPosRel=147}}
{{ClickMapEntry|Name=Ormabiin|Sector=8|XPos=129|YPos=239|XPosRel=391|YPosRel=361}}
{{ClickMapEntry|Name=Riattein|Sector=8|XPos=204|YPos=38|XPosRel=616|YPosRel=60}}
{{ClickMapEntry|Name=Orleso|Sector=8|XPos=172|YPos=188|XPosRel=520|YPosRel=285}}
{{ClickMapEntry|Name=Intiso|Sector=8|XPos=227|YPos=199|XPosRel=685|YPosRel=301}}
{{ClickMapFooter}}</div>

== Systems in Galaxy Sector 8 ==
*A [[Sector8/Aanra|Aanra]] [[Sector8/Aarzari|Aarzari]] [[Sector8/Aatdire|Aatdire]] [[Sector8/Aditira|Aditira]] [[Sector8/Aedis|Aedis]] [[Sector8/Aletius|Aletius]] [[Sector8/Aneded|Aneded]] [[Sector8/Anedin|Anedin]] [[Sector8/Anesbi|Anesbi]] [[Sector8/Anrara|Anrara]] [[Sector8/Anrasoti|Anrasoti]] [[Sector8/Anri|Anri]] [[Sector8/Anteed|Anteed]] [[Sector8/Arance|Arance]] [[Sector8/Arbetequ|Arbetequ]] [[Sector8/Arenxeon|Arenxeon]] [[Sector8/Areran|Areran]] [[Sector8/Aresgeti|Aresgeti]] [[Sector8/Arlale|Arlale]] [[Sector8/Arqua|Arqua]] [[Sector8/Arqubi|Arqubi]] [[Sector8/Artelaan|Artelaan]] [[Sector8/Arustea|Arustea]] [[Sector8/Asoarle|Asoarle]] [[Sector8/Atanon|Atanon]] [[Sector8/Atbea|Atbea]] [[Sector8/Atbele|Atbele]] [[Sector8/Atisen|Atisen]] [[Sector8/Atmabe|Atmabe]] [[Sector8/Atmala|Atmala]] [[Sector8/Atoresra|Atoresra]] [[Sector8/Axebe|Axebe]]
*B [[Sector8/Beanle|Beanle]] [[Sector8/Bebima|Bebima]] [[Sector8/Bedice|Bedice]] [[Sector8/Bees|Bees]] [[Sector8/Belabia|Belabia]] [[Sector8/Belaus|Belaus]] [[Sector8/Belebi|Belebi]] [[Sector8/Belees|Belees]] [[Sector8/Beorsora|Beorsora]] [[Sector8/Bequri|Bequri]] [[Sector8/Biabi|Biabi]] [[Sector8/Bianbies|Bianbies]] [[Sector8/Biatge|Biatge]] [[Sector8/Biatzate|Biatzate]] [[Sector8/Bibirale|Bibirale]] [[Sector8/Biered|Biered]] [[Sector8/Bigexein|Bigexein]] [[Sector8/Biinceor|Biinceor]] [[Sector8/Biis|Biis]] [[Sector8/Biorle|Biorle]] [[Sector8/Biraa|Biraa]] [[Sector8/Birare|Birare]]
*C [[Sector8/Ceanquan|Ceanquan]] [[Sector8/Ceanve|Ceanve]] [[Sector8/Cecees|Cecees]] [[Sector8/Ceened|Ceened]] [[Sector8/Ceenti|Ceenti]] [[Sector8/Ceenza|Ceenza]] [[Sector8/Ceesari|Ceesari]] [[Sector8/Ceraerar|Ceraerar]] [[Sector8/Cetiat|Cetiat]]
*D [[Sector8/Dibiedin|Dibiedin]] [[Sector8/Didilaer|Didilaer]] [[Sector8/Dienve|Dienve]] [[Sector8/Dieranor|Dieranor]] [[Sector8/Diesdi|Diesdi]] [[Sector8/Diquus|Diquus]] [[Sector8/Diriledi|Diriledi]] [[Sector8/Dirima|Dirima]] [[Sector8/Ditegere|Ditegere]]
*E [[Sector8/Edandi|Edandi]] [[Sector8/Edsoan|Edsoan]] [[Sector8/Edtetiin|Edtetiin]] [[Sector8/Edtizabe|Edtizabe]] [[Sector8/Edzaar|Edzaar]] [[Sector8/Enarines|Enarines]] [[Sector8/Enbeza|Enbeza]] [[Sector8/Endiqu|Endiqu]] [[Sector8/Enedge|Enedge]] [[Sector8/Enenonge|Enenonge]] [[Sector8/Enerqu|Enerqu]] [[Sector8/Enonlebe|Enonlebe]] [[Sector8/Enrienge|Enrienge]] [[Sector8/Enustien|Enustien]] [[Sector8/Enxeleti|Enxeleti]] [[Sector8/Ererso|Ererso]] [[Sector8/Eres|Eres]] [[Sector8/Eresen|Eresen]] [[Sector8/Eresorbe|Eresorbe]] [[Sector8/Ergerexe|Ergerexe]] [[Sector8/Erlabeor|Erlabeor]] [[Sector8/Ertebira|Ertebira]] [[Sector8/Erteenon|Erteenon]] [[Sector8/Erzara|Erzara]] [[Sector8/Esdi|Esdi]] [[Sector8/Esinen|Esinen]] [[Sector8/Esmara|Esmara]] [[Sector8/Esusale|Esusale]] [[Sector8/Esusge|Esusge]] [[Sector8/Esusla|Esusla]] [[Sector8/Esveti|Esveti]] [[Sector8/Esxear|Esxear]]
*G [[Sector8/Geale|Geale]] [[Sector8/Geatiar|Geatiar]] [[Sector8/Geen|Geen]] [[Sector8/Geintiso|Geintiso]] [[Sector8/Geisor|Geisor]] [[Sector8/Gequadi|Gequadi]] [[Sector8/Getiusza|Getiusza]] [[Sector8/Gexeala|Gexeala]] [[Sector8/Gexequon|Gexequon]]
*I [[Sector8/Inbein|Inbein]] [[Sector8/Inceisa|Inceisa]] [[Sector8/Ininlequ|Ininlequ]] [[Sector8/Inisbi|Inisbi]] [[Sector8/Inonin|Inonin]] [[Sector8/Inorle|Inorle]] [[Sector8/Intearbe|Intearbe]] [[Sector8/Intiso|Intiso]] [[Sector8/Inuses|Inuses]] [[Sector8/Inusge|Inusge]] [[Sector8/Inzaan_1|Inzaan]] [[Sector8/Inzaan_2|Inzaan]] [[Sector8/Isaso|Isaso]] [[Sector8/Isdidied|Isdidied]] [[Sector8/Iseror|Iseror]] [[Sector8/Islebeen|Islebeen]] [[Sector8/Isri|Isri]] [[Sector8/Istixeti|Istixeti]] [[Sector8/Isxein|Isxein]]
*L [[Sector8/Laace|Laace]] [[Sector8/Labirior|Labirior]] [[Sector8/Laceus|Laceus]] [[Sector8/Laedat|Laedat]] [[Sector8/Laedon|Laedon]] [[Sector8/Laorlaza|Laorlaza]] [[Sector8/Laxerive|Laxerive]] [[Sector8/Laxesori|Laxesori]] [[Sector8/Leatanre|Leatanre]] [[Sector8/Leater|Leater]] [[Sector8/Leesusen|Leesusen]] [[Sector8/Legean|Legean]] [[Sector8/Legece|Legece]] [[Sector8/Lelemaa|Lelemaa]] [[Sector8/Lequatdi|Lequatdi]] [[Sector8/Letioned|Letioned]]
*M [[Sector8/Maabile|Maabile]] [[Sector8/Maana|Maana]] [[Sector8/Maantege|Maantege]] [[Sector8/Maarabi|Maarabi]] [[Sector8/Maatxeri|Maatxeri]] [[Sector8/Maenes|Maenes]] [[Sector8/Mageesti|Mageesti]] [[Sector8/Maisrais|Maisrais]] [[Sector8/Maletees|Maletees]] [[Sector8/Mausdile|Mausdile]]
*O [[Sector8/Onanqu|Onanqu]] [[Sector8/Onatce|Onatce]] [[Sector8/Ondizaat|Ondizaat]] [[Sector8/Onisain|Onisain]] [[Sector8/Ontear|Ontear]] [[Sector8/Onusra|Onusra]] [[Sector8/Onveat|Onveat]] [[Sector8/Orbira|Orbira]] [[Sector8/Orcece|Orcece]] [[Sector8/Oredaris|Oredaris]] [[Sector8/Oredrier|Oredrier]] [[Sector8/Oresrati|Oresrati]] [[Sector8/Oresreat|Oresreat]] [[Sector8/Orlaaror|Orlaaror]] [[Sector8/Orlatein|Orlatein]] [[Sector8/Orleso|Orleso]] [[Sector8/Ormabiin|Ormabiin]] [[Sector8/Orqure|Orqure]] [[Sector8/Orus|Orus]]
*Q [[Sector8/Quedbiqu|Quedbiqu]] [[Sector8/Querbeis|Querbeis]] [[Sector8/Qumaus|Qumaus]] [[Sector8/Qurixean|Qurixean]] [[Sector8/Quxege|Quxege]]
*R [[Sector8/Raaed|Raaed]] [[Sector8/Raaran|Raaran]] [[Sector8/Raeserre|Raeserre]] [[Sector8/Rain|Rain]] [[Sector8/Ramaa|Ramaa]] [[Sector8/Rear|Rear]] [[Sector8/Rebite|Rebite]] [[Sector8/Reenaten|Reenaten]] [[Sector8/Reisorza|Reisorza]] [[Sector8/Releleat|Releleat]] [[Sector8/Reonar|Reonar]] [[Sector8/Resobi|Resobi]] [[Sector8/Rete|Rete]] [[Sector8/Reusleed|Reusleed]] [[Sector8/Revequ|Revequ]] [[Sector8/Riarquge|Riarquge]] [[Sector8/Riattein|Riattein]] [[Sector8/Riedanen|Riedanen]] [[Sector8/Riladi|Riladi]]
*S [[Sector8/Soaxe|Soaxe]] [[Sector8/Soceorbi|Soceorbi]] [[Sector8/Sodiri|Sodiri]] [[Sector8/Soisqu|Soisqu]] [[Sector8/Soladiar|Soladiar]] [[Sector8/Sorezaqu|Sorezaqu]]
*T [[Sector8/Teat|Teat]] [[Sector8/Tebienla|Tebienla]] [[Sector8/Teenatle|Teenatle]] [[Sector8/Teescear|Teescear]] [[Sector8/Tequenes|Tequenes]] [[Sector8/Tetete|Tetete]] [[Sector8/Teteus|Teteus]] [[Sector8/Tetige|Tetige]] [[Sector8/Tevebebi|Tevebebi]] [[Sector8/Texeare|Texeare]] [[Sector8/Tiatisbi|Tiatisbi]] [[Sector8/Tiatza|Tiatza]] [[Sector8/Tibiri|Tibiri]] [[Sector8/Tilaanes|Tilaanes]] [[Sector8/Tile|Tile]] [[Sector8/Tioned|Tioned]] [[Sector8/Tiqubied|Tiqubied]] [[Sector8/Tirige|Tirige]] [[Sector8/Titiridi|Titiridi]]
*U [[Sector8/Usmaedin|Usmaedin]] [[Sector8/Usreinxe|Usreinxe]] [[Sector8/Usrelain|Usrelain]] [[Sector8/Ustiza|Ustiza]] [[Sector8/Ususoner|Ususoner]] [[Sector8/Uszasora|Uszasora]] [[Sector8/Uszave|Uszave]]
*V [[Sector8/Vebixe|Vebixe]] [[Sector8/Veenen|Veenen]] [[Sector8/Veerbidi|Veerbidi]] [[Sector8/Vegedius|Vegedius]] [[Sector8/Vemaed|Vemaed]] [[Sector8/Veusbi|Veusbi]] [[Sector8/Vezaorla|Vezaorla]]
*X [[Sector8/Xebeis|Xebeis]] [[Sector8/Xeceon|Xeceon]] [[Sector8/Xeerin|Xeerin]] [[Sector8/Xeoresce|Xeoresce]] [[Sector8/Xetila|Xetila]] [[Sector8/Xexean|Xexean]] [[Sector8/Xezaxees|Xezaxees]]
*Z [[Sector8/Zaatquat|Zaatquat]] [[Sector8/Zabeor|Zabeor]] [[Sector8/Zabixedi|Zabixedi]] [[Sector8/Zaeded|Zaeded]] [[Sector8/Zainat|Zainat]] [[Sector8/Zaonrixe|Zaonrixe]] [[Sector8/Zarila|Zarila]] [[Sector8/Zariorte|Zariorte]] [[Sector8/Zaveusge|Zaveusge]]

See [[Sector8/Systems in Galaxy Sector 8|Systems in Galaxy Sector 8]] for a detailed list.

== OXPs ==
* The [[Galactic Navy]] has fourteen Sector Command Stations in Galaxy Sector 8: [[Sector8/Titiridi|Titiridi]] ([[Sector8/Navy Command Station 1|SecCom 1]]), [[Sector8/Xeoresce|Xeoresce]] ([[Sector8/Navy Command Station 2|SecCom 2]]), [[Sector8/Leater|Leater]] ([[Sector8/Navy Command Station 3|SecCom 3]]), [[Sector8/Atmabe|Atmabe]] ([[Sector8/Navy Command Station 4|SecCom 4]]), [[Sector8/Inzaan|Inzaan]] ([[Sector8/Navy Command Station 5|SecCom 5]]), [[Sector8/Esusale|Esusale]] ([[Sector8/Navy Command Station 6|SecCom 6]]), [[Sector8/Inisbi|Inisbi]] ([[Sector8/Navy Command Station 7|SecCom 7]]), [[Sector8/Leesusen|Leesusen]] ([[Sector8/Navy Command Station 8|SecCom 8]]), [[Sector8/Maarabi|Maarabi]] ([[Sector8/Navy Command Station 9|SecCom 9]]), [[Sector8/Teteus|Teteus]] ([[Sector8/Navy Command Station 10|SecCom 10]]), [[Sector8/Belabia|Belabia]] ([[Sector8/Navy Command Station 11|SecCom 11]]), [[Sector8/Vebixe|Vebixe]] ([[Sector8/Navy Command Station 12|SecCom 12]]), [[Sector8/Laorlaza|Laorlaza]] ([[Sector8/Navy Command Station 13|SecCom 13]]) and [[Sector8/Getiusza|Getiusza]] ([[Sector8/Navy Command Station 14|SecCom 14]]).
* DGill's (4 OXP suite) version of the [[Feudal States]] adds '''The Royal Houses of Xrata''', a group of twelve feudal systems across Galaxy Sector 8.
* [[Black Monk Monastery|Bank of the Black Monks]]: Deal with the loan sharks. Begins when docked at any Black Monk Monastary.
* [[Escort Contracts OXP|Escort Contracts OXP]]: Allow players to enter into short-term escort contracts with NPC lone wolf traders.
* [[Galactic Navy OXP|Galactic Navy]]: The Galactic Navy needs you. Begins when docked at any SecCom Station.
* [[Illegal Goods Tweak OXP|Illegal Goods Tweak OXP]]: Short reward missions offered by rescued ex-slaves.
* [[Iron Raven|Iron Raven]]: Multi-stage mission to investigate a dangerous conspiracy on behalf of GalCop High Command.
* [[Military Fiasco]]: A mission for the Navy available to a Commander with more than 1000 kills.
* [[Oo-Haul|Oo-haul Escort Missions]]: Escort a hauler safely to its destination. Must be docked at a Constore. [[Your Ad Here!]] required.
* [[Random Hits OXP|Random Hits]]: Get contracts for bounty hunting at any Seedy Space Bar. Special Missions for successful hunters.
* [[RRS_Group|Rescue Stations]]: Rescue and recovery missions for contract pilots.
* [[Thargoid Wars|Thargoid Wars]]: War with the Thargoids intensifies featuring new attack and defense missions.
* [[UPS Courier|UPS Courier Company]]: Take goods or documents from system to system and be awarded with combat missions.
* [[Vector OXP|Vector]]: Special feature - 'Richmans World' - a unusual mission type. [[Snoopers|Snoopers]] required.
<div style="clear:both"></div>

== Fiction ==
[[File:Map G8 (ClymAngus).png|thumb|right|800px|ClymAngus's Vector Map of G8 (Xrata)]]
=== The Vector Maps ===
This excellent piece of digital art adds routes and regions to every Galaxy Sector. [http://www.crimsonforge.co.uk/cloister/OOmap_G8.pdf Vector Map] -- [http://www.crimsonforge.co.uk/cloister/gOOmap_G8.pdf print version] --[http://s248731467.onlinehome.us/OOmap_G8.pdf US Mirror]

The Crystaline Desolation's New Genesis War is referenced here: "a gene-menace defeated through the unlikely unification of celltec and nano-mechanics" by [[Udian Shulth]].

=== Routes and Regions ===
In Sector 8, there are 5 major Spaceways:
* The [[Sector8/Spaceway L1 "The Nemorican Arc" (Route)|Spaceway L1 "The Nemorican Arc"]] runs from [[Sector8/Releleat|Releleat]] to [[Sector8/Ceanquan|Ceanquan]]
* The [[Sector8/Spaceway L2 (Route)|Spaceway L2]] runs from [[Sector8/Onatce|Onatce]] to [[Sector8/Getiusza|Getiusza]]
* The [[Sector8/Centreward Flight (Route)|Centreward Flight]] runs from [[Sector8/Enerqu|Enerqu]] to [[Sector8/Ormabiin|Ormabiin]]
* [[Sector8/The Hitachi Trade Annex (Route)|The Hitachi Trade Annex]] runs from [[Sector8/Inisbi|Inisbi]] to [[Sector8/Esmara|Esmara]]
* The [[Sector8/Rimward Decamp (Route)|Rimward Decamp]] runs from [[Sector8/Bianbies|Bianbies]] to [[Sector8/Esmara|Esmara]]

There are also 6 established regions in Sector 8:
* [[Sector8/Beggars' Loop (Region)|Beggars' Loop]]
* [[Sector8/The Ladle (Region)|The Ladle]]
* [[Sector8/The Far Arm Star Cluster (Region)|The Far Arm Star Cluster]]
* [[Sector8/The Riven Hitachi Senate (Region)|The Riven Hitachi Senate]]
* [[Sector8/Galcenter G8 (Region)|Galcenter G8]]
* [[Sector8/The Unified Tech-Core (Region)|The Unified Tech-Core]]

== Links ==
*[[The Eight]] for a disquisition on the 8 galaxies
*See [[Sector8/Systems in Galaxy Sector 8|Systems in Galaxy Sector 8]] for a more detailed list.
*See [[Oolite planet list/Galaxy 8]] for charts mapping government type against Tech Level, economy & number of systems within 7ly.
*[[Maps]] for a detailed list of these

Sector7/Index

2026-08-07T11:44:15Z

Cholmondely: Added Feudal States OXP

{{GalaxyGuide/IndexList}}

== Overview over Galaxy Sector 7 ==

<div style="position:relative">{{ClickMapHeader|Sector=7|Image=Sector7_OverViewMap.png}}
{{ClickMapEntry|Name=Dizaen|Sector=7|XPos=128|YPos=150|XPosRel=388|YPosRel=228}}
{{ClickMapEntry|Name=Anenen|Sector=7|XPos=100|YPos=114|XPosRel=303|YPosRel=174}}
{{ClickMapEntry|Name=Ceor|Sector=7|XPos=128|YPos=242|XPosRel=388|YPosRel=366}}
{{ClickMapEntry|Name=Ededer|Sector=7|XPos=255|YPos=64|XPosRel=769|YPosRel=99}}
{{ClickMapEntry|Name=Artesore|Sector=7|XPos=225|YPos=240|XPosRel=679|YPosRel=363}}
{{ClickMapEntry|Name=Enususge|Sector=7|XPos=46|YPos=135|XPosRel=141|YPosRel=205}}
{{ClickMapEntry|Name=Raedre|Sector=7|XPos=99|YPos=200|XPosRel=300|YPosRel=303}}
{{ClickMapEntry|Name=Sorezaan|Sector=7|XPos=14|YPos=56|XPosRel=45|YPosRel=87}}
{{ClickMapEntry|Name=Aaored|Sector=7|XPos=187|YPos=228|XPosRel=565|YPosRel=345}}
{{ClickMapEntry|Name=Lebedixe|Sector=7|XPos=184|YPos=185|XPosRel=556|YPosRel=280}}
{{ClickMapEntry|Name=Gebequat|Sector=7|XPos=162|YPos=173|XPosRel=490|YPosRel=262}}
{{ClickMapEntry|Name=Onaran|Sector=7|XPos=81|YPos=250|XPosRel=246|YPosRel=378}}
{{ClickMapEntry|Name=Inre|Sector=7|XPos=101|YPos=219|XPosRel=306|YPosRel=331}}
{{ClickMapEntry|Name=Eszausve|Sector=7|XPos=154|YPos=0|XPosRel=466|YPosRel=3}}
{{ClickMapEntry|Name=Gexean|Sector=7|XPos=246|YPos=72|XPosRel=742|YPosRel=111}}
{{ClickMapEntry|Name=Onteised|Sector=7|XPos=1|YPos=251|XPosRel=6|YPosRel=379}}
{{ClickMapEntry|Name=Enusbe|Sector=7|XPos=120|YPos=61|XPosRel=363|YPosRel=94}}
{{ClickMapEntry|Name=Esarxeve|Sector=7|XPos=45|YPos=211|XPosRel=138|YPosRel=319}}
{{ClickMapEntry|Name=Geteve|Sector=7|XPos=86|YPos=66|XPosRel=261|YPosRel=102}}
{{ClickMapEntry|Name=Sobeer|Sector=7|XPos=21|YPos=54|XPosRel=66|YPosRel=84}}
{{ClickMapEntry|Name=Erdiares|Sector=7|XPos=204|YPos=112|XPosRel=616|YPosRel=171}}
{{ClickMapEntry|Name=Xevexean|Sector=7|XPos=137|YPos=42|XPosRel=415|YPosRel=66}}
{{ClickMapEntry|Name=Raatbi|Sector=7|XPos=251|YPos=66|XPosRel=757|YPosRel=102}}
{{ClickMapEntry|Name=Edoned|Sector=7|XPos=70|YPos=32|XPosRel=213|YPosRel=51}}
{{ClickMapEntry|Name=Tiarice|Sector=7|XPos=120|YPos=223|XPosRel=363|YPosRel=337}}
{{ClickMapEntry|Name=Betierte|Sector=7|XPos=133|YPos=126|XPosRel=403|YPosRel=192}}
{{ClickMapEntry|Name=Ceenrama|Sector=7|XPos=92|YPos=240|XPosRel=279|YPosRel=363}}
{{ClickMapEntry|Name=Enener|Sector=7|XPos=11|YPos=180|XPosRel=36|YPosRel=273}}
{{ClickMapEntry|Name=Veanso|Sector=7|XPos=212|YPos=240|XPosRel=640|YPosRel=363}}
{{ClickMapEntry|Name=Isriveen|Sector=7|XPos=186|YPos=199|XPosRel=562|YPosRel=301}}
{{ClickMapEntry|Name=Bireso|Sector=7|XPos=50|YPos=246|XPosRel=153|YPosRel=372}}
{{ClickMapEntry|Name=Raormaor|Sector=7|XPos=157|YPos=103|XPosRel=475|YPosRel=157}}
{{ClickMapEntry|Name=Rigete|Sector=7|XPos=121|YPos=11|XPosRel=366|YPosRel=19}}
{{ClickMapEntry|Name=Onanorra|Sector=7|XPos=127|YPos=124|XPosRel=384|YPosRel=189}}
{{ClickMapEntry|Name=Usvera|Sector=7|XPos=116|YPos=249|XPosRel=351|YPosRel=376}}
{{ClickMapEntry|Name=Ribior|Sector=7|XPos=243|YPos=52|XPosRel=733|YPosRel=81}}
{{ClickMapEntry|Name=Ontilain|Sector=7|XPos=63|YPos=153|XPosRel=192|YPosRel=232}}
{{ClickMapEntry|Name=Qutegequ|Sector=7|XPos=236|YPos=149|XPosRel=712|YPosRel=226}}
{{ClickMapEntry|Name=Anquerbi|Sector=7|XPos=90|YPos=163|XPosRel=273|YPosRel=247}}
{{ClickMapEntry|Name=Ateslete|Sector=7|XPos=198|YPos=144|XPosRel=598|YPosRel=219}}
{{ClickMapEntry|Name=Usbimaqu|Sector=7|XPos=60|YPos=1|XPosRel=183|YPosRel=4}}
{{ClickMapEntry|Name=Dirateri|Sector=7|XPos=218|YPos=139|XPosRel=658|YPosRel=211}}
{{ClickMapEntry|Name=Reesvere|Sector=7|XPos=94|YPos=156|XPosRel=285|YPosRel=237}}
{{ClickMapEntry|Name=Diatin|Sector=7|XPos=142|YPos=118|XPosRel=430|YPosRel=180}}
{{ClickMapEntry|Name=Esleve|Sector=7|XPos=203|YPos=172|XPosRel=613|YPosRel=261}}
{{ClickMapEntry|Name=Orermala|Sector=7|XPos=225|YPos=86|XPosRel=679|YPosRel=132}}
{{ClickMapEntry|Name=Enbean|Sector=7|XPos=53|YPos=139|XPosRel=162|YPosRel=211}}
{{ClickMapEntry|Name=Atrexexe|Sector=7|XPos=129|YPos=91|XPosRel=391|YPosRel=139}}
{{ClickMapEntry|Name=Betidi|Sector=7|XPos=130|YPos=2|XPosRel=394|YPosRel=6}}
{{ClickMapEntry|Name=Isgeoror|Sector=7|XPos=88|YPos=109|XPosRel=267|YPosRel=166}}
{{ClickMapEntry|Name=Veesqu|Sector=7|XPos=217|YPos=25|XPosRel=655|YPosRel=40}}
{{ClickMapEntry|Name=Isenes|Sector=7|XPos=154|YPos=58|XPosRel=466|YPosRel=90}}
{{ClickMapEntry|Name=Laorusti|Sector=7|XPos=57|YPos=105|XPosRel=174|YPosRel=160}}
{{ClickMapEntry|Name=Quandixe|Sector=7|XPos=87|YPos=200|XPosRel=264|YPosRel=303}}
{{ClickMapEntry|Name=Maanusre|Sector=7|XPos=130|YPos=237|XPosRel=394|YPosRel=358}}
{{ClickMapEntry|Name=Enarines|Sector=7|XPos=142|YPos=136|XPosRel=430|YPosRel=207}}
{{ClickMapEntry|Name=Veed|Sector=7|XPos=9|YPos=76|XPosRel=30|YPosRel=117}}
{{ClickMapEntry|Name=Ausaso|Sector=7|XPos=184|YPos=224|XPosRel=556|YPosRel=339}}
{{ClickMapEntry|Name=Eded|Sector=7|XPos=167|YPos=175|XPosRel=505|YPosRel=265}}
{{ClickMapEntry|Name=Erusat|Sector=7|XPos=216|YPos=64|XPosRel=652|YPosRel=99}}
{{ClickMapEntry|Name=Geondi|Sector=7|XPos=74|YPos=17|XPosRel=225|YPosRel=28}}
{{ClickMapEntry|Name=Isanesle|Sector=7|XPos=16|YPos=173|XPosRel=51|YPosRel=262}}
{{ClickMapEntry|Name=Ceerti|Sector=7|XPos=1|YPos=9|XPosRel=6|YPosRel=16}}
{{ClickMapEntry|Name=Vetebe|Sector=7|XPos=174|YPos=215|XPosRel=526|YPosRel=325}}
{{ClickMapEntry|Name=Agebi|Sector=7|XPos=147|YPos=32|XPosRel=445|YPosRel=51}}
{{ClickMapEntry|Name=Gegeso|Sector=7|XPos=185|YPos=166|XPosRel=559|YPosRel=252}}
{{ClickMapEntry|Name=Maraus|Sector=7|XPos=135|YPos=160|XPosRel=409|YPosRel=243}}
{{ClickMapEntry|Name=Zalaxe|Sector=7|XPos=8|YPos=72|XPosRel=27|YPosRel=111}}
{{ClickMapEntry|Name=Rabegema|Sector=7|XPos=188|YPos=226|XPosRel=568|YPosRel=342}}
{{ClickMapEntry|Name=Xeatrien|Sector=7|XPos=203|YPos=195|XPosRel=613|YPosRel=295}}
{{ClickMapEntry|Name=Xebeuson|Sector=7|XPos=114|YPos=30|XPosRel=345|YPosRel=48}}
{{ClickMapEntry|Name=Angeriri|Sector=7|XPos=159|YPos=8|XPosRel=481|YPosRel=15}}
{{ClickMapEntry|Name=Leriisis|Sector=7|XPos=222|YPos=190|XPosRel=670|YPosRel=288}}
{{ClickMapEntry|Name=Orramaor|Sector=7|XPos=29|YPos=125|XPosRel=90|YPosRel=190}}
{{ClickMapEntry|Name=Orrienar|Sector=7|XPos=57|YPos=43|XPosRel=174|YPosRel=67}}
{{ClickMapEntry|Name=Antiis|Sector=7|XPos=234|YPos=18|XPosRel=706|YPosRel=30}}
{{ClickMapEntry|Name=Bilain|Sector=7|XPos=80|YPos=29|XPosRel=243|YPosRel=46}}
{{ClickMapEntry|Name=Esisrela|Sector=7|XPos=71|YPos=204|XPosRel=216|YPosRel=309}}
{{ClickMapEntry|Name=Lecean|Sector=7|XPos=149|YPos=110|XPosRel=451|YPosRel=168}}
{{ClickMapEntry|Name=Gelesoma|Sector=7|XPos=34|YPos=219|XPosRel=105|YPosRel=331}}
{{ClickMapEntry|Name=Rasoso|Sector=7|XPos=171|YPos=103|XPosRel=517|YPosRel=157}}
{{ClickMapEntry|Name=Ataneris|Sector=7|XPos=162|YPos=39|XPosRel=490|YPosRel=61}}
{{ClickMapEntry|Name=Estiri|Sector=7|XPos=125|YPos=144|XPosRel=378|YPosRel=219}}
{{ClickMapEntry|Name=Beerxe|Sector=7|XPos=62|YPos=94|XPosRel=189|YPosRel=144}}
{{ClickMapEntry|Name=Quzabibi|Sector=7|XPos=199|YPos=2|XPosRel=601|YPosRel=6}}
{{ClickMapEntry|Name=Enonedar|Sector=7|XPos=70|YPos=134|XPosRel=213|YPosRel=204}}
{{ClickMapEntry|Name=Xezaerti|Sector=7|XPos=42|YPos=56|XPosRel=129|YPosRel=87}}
{{ClickMapEntry|Name=Inlaoran|Sector=7|XPos=247|YPos=16|XPosRel=745|YPosRel=27}}
{{ClickMapEntry|Name=Esrixear|Sector=7|XPos=187|YPos=89|XPosRel=565|YPosRel=136}}
{{ClickMapEntry|Name=Maedrebe|Sector=7|XPos=10|YPos=98|XPosRel=33|YPosRel=150}}
{{ClickMapEntry|Name=Anisinza|Sector=7|XPos=19|YPos=14|XPosRel=60|YPosRel=24}}
{{ClickMapEntry|Name=Reonen|Sector=7|XPos=196|YPos=236|XPosRel=592|YPosRel=357}}
{{ClickMapEntry|Name=Erxebe|Sector=7|XPos=223|YPos=210|XPosRel=673|YPosRel=318}}
{{ClickMapEntry|Name=Istiteat|Sector=7|XPos=135|YPos=179|XPosRel=409|YPosRel=271}}
{{ClickMapEntry|Name=Zaatso|Sector=7|XPos=241|YPos=188|XPosRel=727|YPosRel=285}}
{{ClickMapEntry|Name=Edrilain|Sector=7|XPos=222|YPos=103|XPosRel=670|YPosRel=157}}
{{ClickMapEntry|Name=Xeer|Sector=7|XPos=204|YPos=213|XPosRel=616|YPosRel=322}}
{{ClickMapEntry|Name=Soinsoan|Sector=7|XPos=20|YPos=240|XPosRel=63|YPosRel=363}}
{{ClickMapEntry|Name=Reatte|Sector=7|XPos=187|YPos=231|XPosRel=565|YPosRel=349}}
{{ClickMapEntry|Name=Argema|Sector=7|XPos=60|YPos=124|XPosRel=183|YPosRel=189}}
{{ClickMapEntry|Name=Esreates|Sector=7|XPos=90|YPos=203|XPosRel=273|YPosRel=307}}
{{ClickMapEntry|Name=Arceores|Sector=7|XPos=201|YPos=17|XPosRel=607|YPosRel=28}}
{{ClickMapEntry|Name=Esditi|Sector=7|XPos=169|YPos=57|XPosRel=511|YPosRel=88}}
{{ClickMapEntry|Name=Cerianon|Sector=7|XPos=151|YPos=160|XPosRel=457|YPosRel=243}}
{{ClickMapEntry|Name=Qulaaon|Sector=7|XPos=159|YPos=27|XPosRel=481|YPosRel=43}}
{{ClickMapEntry|Name=Celaqula|Sector=7|XPos=127|YPos=143|XPosRel=384|YPosRel=217}}
{{ClickMapEntry|Name=Zarareso|Sector=7|XPos=53|YPos=90|XPosRel=162|YPosRel=138}}
{{ClickMapEntry|Name=Esrire|Sector=7|XPos=103|YPos=206|XPosRel=312|YPosRel=312}}
{{ClickMapEntry|Name=Geusxe|Sector=7|XPos=246|YPos=46|XPosRel=742|YPosRel=72}}
{{ClickMapEntry|Name=Oresatra|Sector=7|XPos=206|YPos=98|XPosRel=622|YPosRel=150}}
{{ClickMapEntry|Name=Ervean|Sector=7|XPos=20|YPos=241|XPosRel=63|YPosRel=364}}
{{ClickMapEntry|Name=Labeinla|Sector=7|XPos=226|YPos=123|XPosRel=682|YPosRel=187}}
{{ClickMapEntry|Name=Lavele|Sector=7|XPos=245|YPos=108|XPosRel=739|YPosRel=165}}
{{ClickMapEntry|Name=Ceraso|Sector=7|XPos=13|YPos=1|XPosRel=42|YPosRel=4}}
{{ClickMapEntry|Name=Tezaxe|Sector=7|XPos=64|YPos=167|XPosRel=195|YPosRel=253}}
{{ClickMapEntry|Name=Esaan|Sector=7|XPos=3|YPos=162|XPosRel=12|YPosRel=246}}
{{ClickMapEntry|Name=Onerzara|Sector=7|XPos=116|YPos=59|XPosRel=351|YPosRel=91}}
{{ClickMapEntry|Name=Arzageat|Sector=7|XPos=84|YPos=100|XPosRel=255|YPosRel=153}}
{{ClickMapEntry|Name=Orreedon|Sector=7|XPos=241|YPos=35|XPosRel=727|YPosRel=55}}
{{ClickMapEntry|Name=Bionbiin|Sector=7|XPos=127|YPos=184|XPosRel=384|YPosRel=279}}
{{ClickMapEntry|Name=Encezais|Sector=7|XPos=140|YPos=6|XPosRel=424|YPosRel=12}}
{{ClickMapEntry|Name=Soesdiri|Sector=7|XPos=125|YPos=4|XPosRel=378|YPosRel=9}}
{{ClickMapEntry|Name=Vegeedat|Sector=7|XPos=158|YPos=13|XPosRel=478|YPosRel=22}}
{{ClickMapEntry|Name=Inlabe|Sector=7|XPos=209|YPos=184|XPosRel=631|YPosRel=279}}
{{ClickMapEntry|Name=Isbior|Sector=7|XPos=149|YPos=51|XPosRel=451|YPosRel=79}}
{{ClickMapEntry|Name=Israa|Sector=7|XPos=29|YPos=217|XPosRel=90|YPosRel=328}}
{{ClickMapEntry|Name=Gebeti|Sector=7|XPos=0|YPos=15|XPosRel=3|YPosRel=25}}
{{ClickMapEntry|Name=Qulearbi|Sector=7|XPos=47|YPos=23|XPosRel=144|YPosRel=37}}
{{ClickMapEntry|Name=Atxequ|Sector=7|XPos=38|YPos=42|XPosRel=117|YPosRel=66}}
{{ClickMapEntry|Name=Mararere|Sector=7|XPos=142|YPos=90|XPosRel=430|YPosRel=138}}
{{ClickMapEntry|Name=Ataer|Sector=7|XPos=14|YPos=206|XPosRel=45|YPosRel=312}}
{{ClickMapEntry|Name=Erenra|Sector=7|XPos=145|YPos=208|XPosRel=439|YPosRel=315}}
{{ClickMapEntry|Name=Riaronus|Sector=7|XPos=23|YPos=84|XPosRel=72|YPosRel=129}}
{{ClickMapEntry|Name=Enqurale|Sector=7|XPos=232|YPos=127|XPosRel=700|YPosRel=193}}
{{ClickMapEntry|Name=Erbieder|Sector=7|XPos=1|YPos=244|XPosRel=6|YPosRel=369}}
{{ClickMapEntry|Name=Aededle|Sector=7|XPos=176|YPos=88|XPosRel=532|YPosRel=135}}
{{ClickMapEntry|Name=Bedilexe|Sector=7|XPos=129|YPos=24|XPosRel=391|YPosRel=39}}
{{ClickMapEntry|Name=Atlaeser|Sector=7|XPos=2|YPos=193|XPosRel=9|YPosRel=292}}
{{ClickMapEntry|Name=Aesarge|Sector=7|XPos=80|YPos=41|XPosRel=243|YPosRel=64}}
{{ClickMapEntry|Name=Tizaon|Sector=7|XPos=3|YPos=170|XPosRel=12|YPosRel=258}}
{{ClickMapEntry|Name=Teed|Sector=7|XPos=187|YPos=223|XPosRel=565|YPosRel=337}}
{{ClickMapEntry|Name=Esverara|Sector=7|XPos=116|YPos=24|XPosRel=351|YPosRel=39}}
{{ClickMapEntry|Name=Onusan|Sector=7|XPos=180|YPos=20|XPosRel=544|YPosRel=33}}
{{ClickMapEntry|Name=Sobiatri|Sector=7|XPos=195|YPos=59|XPosRel=589|YPosRel=91}}
{{ClickMapEntry|Name=Vebian|Sector=7|XPos=94|YPos=17|XPosRel=285|YPosRel=28}}
{{ClickMapEntry|Name=Orinriza|Sector=7|XPos=151|YPos=251|XPosRel=457|YPosRel=379}}
{{ClickMapEntry|Name=Aenbi|Sector=7|XPos=36|YPos=94|XPosRel=111|YPosRel=144}}
{{ClickMapEntry|Name=Ondira|Sector=7|XPos=231|YPos=6|XPosRel=697|YPosRel=12}}
{{ClickMapEntry|Name=Zaanxege|Sector=7|XPos=66|YPos=20|XPosRel=201|YPosRel=33}}
{{ClickMapEntry|Name=Xeusreor|Sector=7|XPos=131|YPos=98|XPosRel=397|YPosRel=150}}
{{ClickMapEntry|Name=Ertius|Sector=7|XPos=217|YPos=174|XPosRel=655|YPosRel=264}}
{{ClickMapEntry|Name=Arberi|Sector=7|XPos=40|YPos=128|XPosRel=123|YPosRel=195}}
{{ClickMapEntry|Name=Andibia|Sector=7|XPos=126|YPos=83|XPosRel=381|YPosRel=127}}
{{ClickMapEntry|Name=Georinar|Sector=7|XPos=15|YPos=198|XPosRel=48|YPosRel=300}}
{{ClickMapEntry|Name=Atuszais|Sector=7|XPos=74|YPos=172|XPosRel=225|YPosRel=261}}
{{ClickMapEntry|Name=Arinra|Sector=7|XPos=253|YPos=164|XPosRel=763|YPosRel=249}}
{{ClickMapEntry|Name=Areson|Sector=7|XPos=106|YPos=52|XPosRel=321|YPosRel=81}}
{{ClickMapEntry|Name=Iserxeer|Sector=7|XPos=212|YPos=31|XPosRel=640|YPosRel=49}}
{{ClickMapEntry|Name=Xeraso|Sector=7|XPos=48|YPos=2|XPosRel=147|YPosRel=6}}
{{ClickMapEntry|Name=Tegeonon|Sector=7|XPos=159|YPos=231|XPosRel=481|YPosRel=349}}
{{ClickMapEntry|Name=Xeleza|Sector=7|XPos=159|YPos=31|XPosRel=481|YPosRel=49}}
{{ClickMapEntry|Name=Aislaxe|Sector=7|XPos=41|YPos=228|XPosRel=126|YPosRel=345}}
{{ClickMapEntry|Name=Rainza|Sector=7|XPos=130|YPos=85|XPosRel=394|YPosRel=130}}
{{ClickMapEntry|Name=Veis|Sector=7|XPos=5|YPos=68|XPosRel=18|YPosRel=105}}
{{ClickMapEntry|Name=Becedibi|Sector=7|XPos=245|YPos=125|XPosRel=739|YPosRel=190}}
{{ClickMapEntry|Name=Qureaed|Sector=7|XPos=38|YPos=13|XPosRel=117|YPosRel=22}}
{{ClickMapEntry|Name=Tierus|Sector=7|XPos=120|YPos=79|XPosRel=363|YPosRel=121}}
{{ClickMapEntry|Name=Orbelaxe|Sector=7|XPos=232|YPos=48|XPosRel=700|YPosRel=75}}
{{ClickMapEntry|Name=Inzabeza|Sector=7|XPos=130|YPos=181|XPosRel=394|YPosRel=274}}
{{ClickMapEntry|Name=Isveedin|Sector=7|XPos=164|YPos=19|XPosRel=496|YPosRel=31}}
{{ClickMapEntry|Name=Quonbi|Sector=7|XPos=140|YPos=152|XPosRel=424|YPosRel=231}}
{{ClickMapEntry|Name=Cemaer|Sector=7|XPos=192|YPos=166|XPosRel=580|YPosRel=252}}
{{ClickMapEntry|Name=Isare|Sector=7|XPos=161|YPos=48|XPosRel=487|YPosRel=75}}
{{ClickMapEntry|Name=Orxetibe|Sector=7|XPos=59|YPos=238|XPosRel=180|YPosRel=360}}
{{ClickMapEntry|Name=Reoran|Sector=7|XPos=115|YPos=215|XPosRel=348|YPosRel=325}}
{{ClickMapEntry|Name=Oredveus|Sector=7|XPos=195|YPos=27|XPosRel=589|YPosRel=43}}
{{ClickMapEntry|Name=Tilala|Sector=7|XPos=232|YPos=86|XPosRel=700|YPosRel=132}}
{{ClickMapEntry|Name=Dicelaso|Sector=7|XPos=66|YPos=21|XPosRel=201|YPosRel=34}}
{{ClickMapEntry|Name=Xeonar|Sector=7|XPos=39|YPos=181|XPosRel=120|YPosRel=274}}
{{ClickMapEntry|Name=Laindi|Sector=7|XPos=236|YPos=138|XPosRel=712|YPosRel=210}}
{{ClickMapEntry|Name=Essoat|Sector=7|XPos=47|YPos=141|XPosRel=144|YPosRel=214}}
{{ClickMapEntry|Name=Qudior|Sector=7|XPos=209|YPos=128|XPosRel=631|YPosRel=195}}
{{ClickMapEntry|Name=Soleuser|Sector=7|XPos=224|YPos=217|XPosRel=676|YPosRel=328}}
{{ClickMapEntry|Name=Quraa|Sector=7|XPos=240|YPos=104|XPosRel=724|YPosRel=159}}
{{ClickMapEntry|Name=Zarausxe|Sector=7|XPos=143|YPos=64|XPosRel=433|YPosRel=99}}
{{ClickMapEntry|Name=Onarmala|Sector=7|XPos=194|YPos=168|XPosRel=586|YPosRel=255}}
{{ClickMapEntry|Name=Inreerar|Sector=7|XPos=21|YPos=235|XPosRel=66|YPosRel=355}}
{{ClickMapEntry|Name=Usxela|Sector=7|XPos=74|YPos=176|XPosRel=225|YPosRel=267}}
{{ClickMapEntry|Name=Tidice|Sector=7|XPos=96|YPos=213|XPosRel=291|YPosRel=322}}
{{ClickMapEntry|Name=Isdilaon|Sector=7|XPos=170|YPos=133|XPosRel=514|YPosRel=202}}
{{ClickMapEntry|Name=Leveti|Sector=7|XPos=127|YPos=149|XPosRel=384|YPosRel=226}}
{{ClickMapEntry|Name=Ribiraor|Sector=7|XPos=48|YPos=215|XPosRel=147|YPosRel=325}}
{{ClickMapEntry|Name=Belere|Sector=7|XPos=57|YPos=180|XPosRel=174|YPosRel=273}}
{{ClickMapEntry|Name=Becetela|Sector=7|XPos=227|YPos=142|XPosRel=685|YPosRel=216}}
{{ClickMapEntry|Name=Tiared|Sector=7|XPos=21|YPos=124|XPosRel=66|YPosRel=189}}
{{ClickMapEntry|Name=Teabi|Sector=7|XPos=154|YPos=216|XPosRel=466|YPosRel=327}}
{{ClickMapEntry|Name=Usleance|Sector=7|XPos=242|YPos=70|XPosRel=730|YPosRel=108}}
{{ClickMapEntry|Name=Xegearer|Sector=7|XPos=133|YPos=187|XPosRel=403|YPosRel=283}}
{{ClickMapEntry|Name=Riorusle|Sector=7|XPos=16|YPos=74|XPosRel=51|YPosRel=114}}
{{ClickMapEntry|Name=Gedienza|Sector=7|XPos=65|YPos=40|XPosRel=198|YPosRel=63}}
{{ClickMapEntry|Name=Ceteceso|Sector=7|XPos=164|YPos=242|XPosRel=496|YPosRel=366}}
{{ClickMapEntry|Name=Esvesoso|Sector=7|XPos=103|YPos=133|XPosRel=312|YPosRel=202}}
{{ClickMapEntry|Name=Ceraxete|Sector=7|XPos=231|YPos=167|XPosRel=697|YPosRel=253}}
{{ClickMapEntry|Name=Beatle|Sector=7|XPos=156|YPos=194|XPosRel=472|YPosRel=294}}
{{ClickMapEntry|Name=Qugeza|Sector=7|XPos=166|YPos=33|XPosRel=502|YPosRel=52}}
{{ClickMapEntry|Name=Esaqube|Sector=7|XPos=33|YPos=228|XPosRel=102|YPosRel=345}}
{{ClickMapEntry|Name=Ismaan|Sector=7|XPos=83|YPos=58|XPosRel=252|YPosRel=90}}
{{ClickMapEntry|Name=Mamaanat|Sector=7|XPos=228|YPos=27|XPosRel=688|YPosRel=43}}
{{ClickMapEntry|Name=Edcea|Sector=7|XPos=145|YPos=59|XPosRel=439|YPosRel=91}}
{{ClickMapEntry|Name=Leisinma|Sector=7|XPos=12|YPos=79|XPosRel=39|YPosRel=121}}
{{ClickMapEntry|Name=Ladire|Sector=7|XPos=75|YPos=172|XPosRel=228|YPosRel=261}}
{{ClickMapEntry|Name=Maarbi|Sector=7|XPos=16|YPos=46|XPosRel=51|YPosRel=72}}
{{ClickMapEntry|Name=Reenri|Sector=7|XPos=61|YPos=166|XPosRel=186|YPosRel=252}}
{{ClickMapEntry|Name=Enatzaus|Sector=7|XPos=64|YPos=190|XPosRel=195|YPosRel=288}}
{{ClickMapEntry|Name=Riareror|Sector=7|XPos=8|YPos=164|XPosRel=27|YPosRel=249}}
{{ClickMapEntry|Name=Raondile|Sector=7|XPos=217|YPos=112|XPosRel=655|YPosRel=171}}
{{ClickMapEntry|Name=Ditearra|Sector=7|XPos=193|YPos=205|XPosRel=583|YPosRel=310}}
{{ClickMapEntry|Name=Anquarle|Sector=7|XPos=148|YPos=170|XPosRel=448|YPosRel=258}}
{{ClickMapEntry|Name=Sobeteve|Sector=7|XPos=1|YPos=202|XPosRel=6|YPosRel=306}}
{{ClickMapEntry|Name=Biorve|Sector=7|XPos=182|YPos=220|XPosRel=550|YPosRel=333}}
{{ClickMapEntry|Name=Zaerma|Sector=7|XPos=117|YPos=22|XPosRel=354|YPosRel=36}}
{{ClickMapEntry|Name=Isesusa|Sector=7|XPos=161|YPos=11|XPosRel=487|YPosRel=19}}
{{ClickMapEntry|Name=Tiso|Sector=7|XPos=239|YPos=200|XPosRel=721|YPosRel=303}}
{{ClickMapEntry|Name=Usesen|Sector=7|XPos=224|YPos=231|XPosRel=676|YPosRel=349}}
{{ClickMapEntry|Name=Zaed|Sector=7|XPos=242|YPos=233|XPosRel=730|YPosRel=352}}
{{ClickMapEntry|Name=Tiregees|Sector=7|XPos=190|YPos=88|XPosRel=574|YPosRel=135}}
{{ClickMapEntry|Name=Qusoin|Sector=7|XPos=201|YPos=67|XPosRel=607|YPosRel=103}}
{{ClickMapEntry|Name=Xeisa|Sector=7|XPos=78|YPos=140|XPosRel=237|YPosRel=213}}
{{ClickMapEntry|Name=Isteesge|Sector=7|XPos=16|YPos=175|XPosRel=51|YPosRel=265}}
{{ClickMapEntry|Name=Articeso|Sector=7|XPos=3|YPos=137|XPosRel=12|YPosRel=208}}
{{ClickMapEntry|Name=Cebeor|Sector=7|XPos=199|YPos=229|XPosRel=601|YPosRel=346}}
{{ClickMapEntry|Name=Diusace|Sector=7|XPos=185|YPos=64|XPosRel=559|YPosRel=99}}
{{ClickMapEntry|Name=Ribeties|Sector=7|XPos=229|YPos=207|XPosRel=691|YPosRel=313}}
{{ClickMapEntry|Name=Lativege|Sector=7|XPos=73|YPos=23|XPosRel=222|YPosRel=37}}
{{ClickMapEntry|Name=Erarrior|Sector=7|XPos=99|YPos=86|XPosRel=300|YPosRel=132}}
{{ClickMapEntry|Name=Leeden|Sector=7|XPos=153|YPos=254|XPosRel=463|YPosRel=384}}
{{ClickMapEntry|Name=Tivequ|Sector=7|XPos=204|YPos=178|XPosRel=616|YPosRel=270}}
{{ClickMapEntry|Name=Oranisen|Sector=7|XPos=40|YPos=250|XPosRel=123|YPosRel=378}}
{{ClickMapEntry|Name=Intean|Sector=7|XPos=82|YPos=61|XPosRel=249|YPosRel=94}}
{{ClickMapEntry|Name=Isisan|Sector=7|XPos=36|YPos=59|XPosRel=111|YPosRel=91}}
{{ClickMapEntry|Name=Orraes|Sector=7|XPos=91|YPos=192|XPosRel=276|YPosRel=291}}
{{ClickMapEntry|Name=Lavegere|Sector=7|XPos=247|YPos=169|XPosRel=745|YPosRel=256}}
{{ClickMapEntry|Name=Usquen|Sector=7|XPos=142|YPos=67|XPosRel=430|YPosRel=103}}
{{ClickMapEntry|Name=Leeson|Sector=7|XPos=85|YPos=242|XPosRel=258|YPosRel=366}}
{{ClickMapEntry|Name=Beritere|Sector=7|XPos=106|YPos=95|XPosRel=321|YPosRel=145}}
{{ClickMapEntry|Name=Arveaa|Sector=7|XPos=206|YPos=28|XPosRel=622|YPosRel=45}}
{{ClickMapEntry|Name=Laraedle|Sector=7|XPos=79|YPos=15|XPosRel=240|YPosRel=25}}
{{ClickMapEntry|Name=Reesquen|Sector=7|XPos=225|YPos=152|XPosRel=679|YPosRel=231}}
{{ClickMapEntry|Name=Vegeinso|Sector=7|XPos=18|YPos=250|XPosRel=57|YPosRel=378}}
{{ClickMapEntry|Name=Timaesin|Sector=7|XPos=135|YPos=204|XPosRel=409|YPosRel=309}}
{{ClickMapEntry|Name=Xeorusge|Sector=7|XPos=12|YPos=73|XPosRel=39|YPosRel=112}}
{{ClickMapEntry|Name=Zaati|Sector=7|XPos=67|YPos=40|XPosRel=204|YPosRel=63}}
{{ClickMapEntry|Name=Atraat|Sector=7|XPos=171|YPos=247|XPosRel=517|YPosRel=373}}
{{ClickMapEntry|Name=Isbianri|Sector=7|XPos=183|YPos=177|XPosRel=553|YPosRel=268}}
{{ClickMapEntry|Name=Onorti|Sector=7|XPos=126|YPos=155|XPosRel=381|YPosRel=235}}
{{ClickMapEntry|Name=Xemariin|Sector=7|XPos=177|YPos=23|XPosRel=535|YPosRel=37}}
{{ClickMapFooter}}</div>

== Systems in Galaxy Sector 7 ==
*A [[Sector7/Aaored|Aaored]] [[Sector7/Aededle|Aededle]] [[Sector7/Aenbi|Aenbi]] [[Sector7/Aesarge|Aesarge]] [[Sector7/Agebi|Agebi]] [[Sector7/Aislaxe|Aislaxe]] [[Sector7/Andibia|Andibia]] [[Sector7/Anenen|Anenen]] [[Sector7/Angeriri|Angeriri]] [[Sector7/Anisinza|Anisinza]] [[Sector7/Anquarle|Anquarle]] [[Sector7/Anquerbi|Anquerbi]] [[Sector7/Antiis|Antiis]] [[Sector7/Arberi|Arberi]] [[Sector7/Arceores|Arceores]] [[Sector7/Areson|Areson]] [[Sector7/Argema|Argema]] [[Sector7/Arinra|Arinra]] [[Sector7/Artesore|Artesore]] [[Sector7/Articeso|Articeso]] [[Sector7/Arveaa|Arveaa]] [[Sector7/Arzageat|Arzageat]] [[Sector7/Ataer|Ataer]] [[Sector7/Ataneris|Ataneris]] [[Sector7/Ateslete|Ateslete]] [[Sector7/Atlaeser|Atlaeser]] [[Sector7/Atraat|Atraat]] [[Sector7/Atrexexe|Atrexexe]] [[Sector7/Atuszais|Atuszais]] [[Sector7/Atxequ|Atxequ]] [[Sector7/Ausaso|Ausaso]]
*B [[Sector7/Beatle|Beatle]] [[Sector7/Becedibi|Becedibi]] [[Sector7/Becetela|Becetela]] [[Sector7/Bedilexe|Bedilexe]] [[Sector7/Beerxe|Beerxe]] [[Sector7/Belere|Belere]] [[Sector7/Beritere|Beritere]] [[Sector7/Betidi|Betidi]] [[Sector7/Betierte|Betierte]] [[Sector7/Bilain|Bilain]] [[Sector7/Bionbiin|Bionbiin]] [[Sector7/Biorve|Biorve]] [[Sector7/Bireso|Bireso]]
*C [[Sector7/Cebeor|Cebeor]] [[Sector7/Ceenrama|Ceenrama]] [[Sector7/Ceerti|Ceerti]] [[Sector7/Celaqula|Celaqula]] [[Sector7/Cemaer|Cemaer]] [[Sector7/Ceor|Ceor]] [[Sector7/Ceraso|Ceraso]] [[Sector7/Ceraxete|Ceraxete]] [[Sector7/Cerianon|Cerianon]] [[Sector7/Ceteceso|Ceteceso]]
*D [[Sector7/Diatin|Diatin]] [[Sector7/Dicelaso|Dicelaso]] [[Sector7/Dirateri|Dirateri]] [[Sector7/Ditearra|Ditearra]] [[Sector7/Diusace|Diusace]] [[Sector7/Dizaen|Dizaen]]
*E [[Sector7/Edcea|Edcea]] [[Sector7/Eded|Eded]] [[Sector7/Ededer|Ededer]] [[Sector7/Edoned|Edoned]] [[Sector7/Edrilain|Edrilain]] [[Sector7/Enarines|Enarines]] [[Sector7/Enatzaus|Enatzaus]] [[Sector7/Enbean|Enbean]] [[Sector7/Encezais|Encezais]] [[Sector7/Enener|Enener]] [[Sector7/Enonedar|Enonedar]] [[Sector7/Enqurale|Enqurale]] [[Sector7/Enusbe|Enusbe]] [[Sector7/Enususge|Enususge]] [[Sector7/Erarrior|Erarrior]] [[Sector7/Erbieder|Erbieder]] [[Sector7/Erdiares|Erdiares]] [[Sector7/Erenra|Erenra]] [[Sector7/Ertius|Ertius]] [[Sector7/Erusat|Erusat]] [[Sector7/Ervean|Ervean]] [[Sector7/Erxebe|Erxebe]] [[Sector7/Esaan|Esaan]] [[Sector7/Esaqube|Esaqube]] [[Sector7/Esarxeve|Esarxeve]] [[Sector7/Esditi|Esditi]] [[Sector7/Esisrela|Esisrela]] [[Sector7/Esleve|Esleve]] [[Sector7/Esreates|Esreates]] [[Sector7/Esrire|Esrire]] [[Sector7/Esrixear|Esrixear]] [[Sector7/Essoat|Essoat]] [[Sector7/Estiri|Estiri]] [[Sector7/Esverara|Esverara]] [[Sector7/Esvesoso|Esvesoso]] [[Sector7/Eszausve|Eszausve]]
*G [[Sector7/Gebequat|Gebequat]] [[Sector7/Gebeti|Gebeti]] [[Sector7/Gedienza|Gedienza]] [[Sector7/Gegeso|Gegeso]] [[Sector7/Gelesoma|Gelesoma]] [[Sector7/Geondi|Geondi]] [[Sector7/Georinar|Georinar]] [[Sector7/Geteve|Geteve]] [[Sector7/Geusxe|Geusxe]] [[Sector7/Gexean|Gexean]]
*I [[Sector7/Inlabe|Inlabe]] [[Sector7/Inlaoran|Inlaoran]] [[Sector7/Inre|Inre]] [[Sector7/Inreerar|Inreerar]] [[Sector7/Intean|Intean]] [[Sector7/Inzabeza|Inzabeza]] [[Sector7/Isanesle|Isanesle]] [[Sector7/Isare|Isare]] [[Sector7/Isbianri|Isbianri]] [[Sector7/Isbior|Isbior]] [[Sector7/Isdilaon|Isdilaon]] [[Sector7/Isenes|Isenes]] [[Sector7/Iserxeer|Iserxeer]] [[Sector7/Isesusa|Isesusa]] [[Sector7/Isgeoror|Isgeoror]] [[Sector7/Isisan|Isisan]] [[Sector7/Ismaan|Ismaan]] [[Sector7/Israa|Israa]] [[Sector7/Isriveen|Isriveen]] [[Sector7/Isteesge|Isteesge]] [[Sector7/Istiteat|Istiteat]] [[Sector7/Isveedin|Isveedin]]
*L [[Sector7/Labeinla|Labeinla]] [[Sector7/Ladire|Ladire]] [[Sector7/Laindi|Laindi]] [[Sector7/Laorusti|Laorusti]] [[Sector7/Laraedle|Laraedle]] [[Sector7/Lativege|Lativege]] [[Sector7/Lavegere|Lavegere]] [[Sector7/Lavele|Lavele]] [[Sector7/Lebedixe|Lebedixe]] [[Sector7/Lecean|Lecean]] [[Sector7/Leeden|Leeden]] [[Sector7/Leeson|Leeson]] [[Sector7/Leisinma|Leisinma]] [[Sector7/Leriisis|Leriisis]] [[Sector7/Leveti|Leveti]]
*M [[Sector7/Maanusre|Maanusre]] [[Sector7/Maarbi|Maarbi]] [[Sector7/Maedrebe|Maedrebe]] [[Sector7/Mamaanat|Mamaanat]] [[Sector7/Mararere|Mararere]] [[Sector7/Maraus|Maraus]]
*O [[Sector7/Onanorra|Onanorra]] [[Sector7/Onaran|Onaran]] [[Sector7/Onarmala|Onarmala]] [[Sector7/Ondira|Ondira]] [[Sector7/Onerzara|Onerzara]] [[Sector7/Onorti|Onorti]] [[Sector7/Onteised|Onteised]] [[Sector7/Ontilain|Ontilain]] [[Sector7/Onusan|Onusan]] [[Sector7/Oranisen|Oranisen]] [[Sector7/Orbelaxe|Orbelaxe]] [[Sector7/Oredveus|Oredveus]] [[Sector7/Orermala|Orermala]] [[Sector7/Oresatra|Oresatra]] [[Sector7/Orinriza|Orinriza]] [[Sector7/Orraes|Orraes]] [[Sector7/Orramaor|Orramaor]] [[Sector7/Orreedon|Orreedon]] [[Sector7/Orrienar|Orrienar]] [[Sector7/Orxetibe|Orxetibe]]
*Q [[Sector7/Quandixe|Quandixe]] [[Sector7/Qudior|Qudior]] [[Sector7/Qugeza|Qugeza]] [[Sector7/Qulaaon|Qulaaon]] [[Sector7/Qulearbi|Qulearbi]] [[Sector7/Quonbi|Quonbi]] [[Sector7/Quraa|Quraa]] [[Sector7/Qureaed|Qureaed]] [[Sector7/Qusoin|Qusoin]] [[Sector7/Qutegequ|Qutegequ]] [[Sector7/Quzabibi|Quzabibi]]
*R [[Sector7/Raatbi|Raatbi]] [[Sector7/Rabegema|Rabegema]] [[Sector7/Raedre|Raedre]] [[Sector7/Rainza|Rainza]] [[Sector7/Raondile|Raondile]] [[Sector7/Raormaor|Raormaor]] [[Sector7/Rasoso|Rasoso]] [[Sector7/Reatte|Reatte]] [[Sector7/Reenri|Reenri]] [[Sector7/Reesquen|Reesquen]] [[Sector7/Reesvere|Reesvere]] [[Sector7/Reonen|Reonen]] [[Sector7/Reoran|Reoran]] [[Sector7/Riareror|Riareror]] [[Sector7/Riaronus|Riaronus]] [[Sector7/Ribeties|Ribeties]] [[Sector7/Ribior|Ribior]] [[Sector7/Ribiraor|Ribiraor]] [[Sector7/Rigete|Rigete]] [[Sector7/Riorusle|Riorusle]]
*S [[Sector7/Sobeer|Sobeer]] [[Sector7/Sobeteve|Sobeteve]] [[Sector7/Sobiatri|Sobiatri]] [[Sector7/Soesdiri|Soesdiri]] [[Sector7/Soinsoan|Soinsoan]] [[Sector7/Soleuser|Soleuser]] [[Sector7/Sorezaan|Sorezaan]]
*T [[Sector7/Teabi|Teabi]] [[Sector7/Teed|Teed]] [[Sector7/Tegeonon|Tegeonon]] [[Sector7/Tezaxe|Tezaxe]] [[Sector7/Tiared|Tiared]] [[Sector7/Tiarice|Tiarice]] [[Sector7/Tidice|Tidice]] [[Sector7/Tierus|Tierus]] [[Sector7/Tilala|Tilala]] [[Sector7/Timaesin|Timaesin]] [[Sector7/Tiregees|Tiregees]] [[Sector7/Tiso|Tiso]] [[Sector7/Tivequ|Tivequ]] [[Sector7/Tizaon|Tizaon]]
*U [[Sector7/Usbimaqu|Usbimaqu]] [[Sector7/Usesen|Usesen]] [[Sector7/Usleance|Usleance]] [[Sector7/Usquen|Usquen]] [[Sector7/Usvera|Usvera]] [[Sector7/Usxela|Usxela]]
*V [[Sector7/Veanso|Veanso]] [[Sector7/Vebian|Vebian]] [[Sector7/Veed|Veed]] [[Sector7/Veesqu|Veesqu]] [[Sector7/Vegeedat|Vegeedat]] [[Sector7/Vegeinso|Vegeinso]] [[Sector7/Veis|Veis]] [[Sector7/Vetebe|Vetebe]]
*X [[Sector7/Xeatrien|Xeatrien]] [[Sector7/Xebeuson|Xebeuson]] [[Sector7/Xeer|Xeer]] [[Sector7/Xegearer|Xegearer]] [[Sector7/Xeisa|Xeisa]] [[Sector7/Xeleza|Xeleza]] [[Sector7/Xemariin|Xemariin]] [[Sector7/Xeonar|Xeonar]] [[Sector7/Xeorusge|Xeorusge]] [[Sector7/Xeraso|Xeraso]] [[Sector7/Xeusreor|Xeusreor]] [[Sector7/Xevexean|Xevexean]] [[Sector7/Xezaerti|Xezaerti]]
*Z [[Sector7/Zaanxege|Zaanxege]] [[Sector7/Zaati|Zaati]] [[Sector7/Zaatso|Zaatso]] [[Sector7/Zaed|Zaed]] [[Sector7/Zaerma|Zaerma]] [[Sector7/Zalaxe|Zalaxe]] [[Sector7/Zarareso|Zarareso]] [[Sector7/Zarausxe|Zarausxe]]

See [[Sector7/Systems in Galaxy Sector 7|Systems in Galaxy Sector 7]] for a detailed list.

== OXPs ==
* The [[Galactic Navy]] has fourteen Sector Command Stations in Galaxy Sector 7: [[Sector7/Riareror|Riareror]] ([[Sector7/Navy Command Station 1|SecCom 1]]), [[Sector7/Aislaxe|Aislaxe]] ([[Sector7/Navy Command Station 2|SecCom 2]]), [[Sector7/Xeorusge|Xeorusge]] ([[Sector7/Navy Command Station 3|SecCom 3]]), [[Sector7/Qulearbi|Qulearbi]] ([[Sector7/Navy Command Station 4|SecCom 4]]), [[Sector7/Edoned|Edoned]] ([[Sector7/Navy Command Station 5|SecCom 5]]), [[Sector7/Atuszais|Atuszais]] ([[Sector7/Navy Command Station 6|SecCom 6]]), [[Sector7/Erarrior|Erarrior]] ([[Sector7/Navy Command Station 7|SecCom 7]]), [[Sector7/Tiarice|Tiarice]] ([[Sector7/Navy Command Station 8|SecCom 8]]), [[Sector7/Enarines|Enarines]] ([[Sector7/Navy Command Station 9|SecCom 9]]), [[Sector7/Agebi|Agebi]] ([[Sector7/Navy Command Station 10|SecCom 10]]), [[Sector7/Diusace|Diusace]] ([[Sector7/Navy Command Station 11|SecCom 11]]), [[Sector7/Teed|Teed]] ([[Sector7/Navy Command Station 12|SecCom 12]]), [[Sector7/Ceraxete|Ceraxete]] ([[Sector7/Navy Command Station 13|SecCom 13]]) and [[Sector7/Ribior|Ribior]] ([[Sector7/Navy Command Station 14|SecCom 14]]).
* [[The Assassins Guild OXP|Assassins Guild]]: 21 missions involving murder to order. Progress depends on your Elite and Guild Ratings. Also see [[Victim 11]]
* The [[Feudal States]] OXP adds [[Sector7/The Royal Houses of Jaftra|The Royal Houses of Jaftra]], a group of eight feudal systems across Galaxy Sector 7.
* [[Black Monk Monastery|Bank of the Black Monks]]: Deal with the loan sharks. Begins when docked at any Black Monk Monastary.
* [[Escort Contracts OXP|Escort Contracts OXP]]: Allow players to enter into short-term escort contracts with NPC lone wolf traders.
* [[Galactic Navy OXP|Galactic Navy]]: The Galactic Navy needs you. Begins when docked at any SecCom Station.
* [[Illegal Goods Tweak OXP|Illegal Goods Tweak OXP]]: Short reward missions offered by rescued ex-slaves.
* [https://bb.oolite.space/viewtopic.php?f=4&t=9135&hilit=linkg7 LinkG7]: Find a way across the great rift.
* [[Military Fiasco]]: A mission for the Navy available to a Commander with more than 1000 kills.
* [[Oo-Haul|Oo-haul Escort Missions]]: Escort a hauler safely to its destination. Must be docked at a Constore. [[Your Ad Here!]] required.
* [[Random Hits OXP|Random Hits]]: Get contracts for bounty hunting at any Seedy Space Bar. Special Missions for successful hunters.
* [[RRS_Group|Rescue Stations]]: Rescue and recovery missions for contract pilots.
* [[Thargoid Wars|Thargoid Wars]]: War with the Thargoids intensifies featuring new attack and defense missions.
* [[TAU Rockhopper]] - manufacture is based at Tiared
* [[UPS Courier|UPS Courier Company]]: Take goods or documents from system to system and be awarded with combat missions.
* [[Vector OXP|Vector]]: Special feature - 'Richmans World' - a unusual mission type. [[Snoopers|Snoopers]] required.
* [[Victim 11]]: A follow-up mission to [[The Assassins Guild OXP|Assassins Guild]] that picks up some loose ends.
<div style="clear:both"></div>

== Fiction ==
* [[An Ideal Victim]] by [[User:Cody|Cody]] is based around the [[Great Rift]]

[[File:Map G7 (ClymAngus).png|thumb|right|800px|ClymAngus's Vector Map of G7 (Jaftra)]]
=== The Vector Maps ===
This excellent piece of digital art adds routes and regions to every Galaxy Sector. [http://www.crimsonforge.co.uk/cloister/OOmap_G7.pdf Vector Map] -- [http://www.crimsonforge.co.uk/cloister/gOOmap_G7.pdf print version] --[http://s248731467.onlinehome.us/OOmap_G7.pdf US Mirror]

=== Routes and Regions ===
In Sector 7, there are 5 major Spaceways:
* The [[Sector7/Spaceway L1 (Route)|Spaceway L1]] runs from [[Sector7/Cerianon|Cerianon]] to [[Sector7/Oresatra|Oresatra]]
* [[Sector7/The Road (Route)|The Road]] runs from [[Sector7/Tiared|Tiared]] to [[Sector7/Zarausxe|Zarausxe]]
* The [[Sector7/Far Rift Reach (Route)|Far Rift Reach]] runs from [[Sector7/Sobeteve|Sobeteve]] to [[Sector7/Xeonar|Xeonar]]
* [[Sector7/The Isisian Detour (Route)|The Isisian Detour]] runs from [[Sector7/Maarbi|Maarbi]] to [[Sector7/Isisan|Isisan]]
* [[Sector7/The Quandixe Connection (Route)|The Quandixe Connection]] runs from [[Sector7/Enbean|Enbean]] to [[Sector7/Reoran|Reoran]]

There are also 7 established regions in Sector 7:
* [[Sector7/GALCOP Central Intelligence Sector (Region)|GALCOP Central Intelligence Sector]]
* [[Sector7/The Isare Pact (Region)|The Isare Pact]]
* [[Sector7/Galcenter G7 (Region)|Galcenter G7]]
* [[Sector7/The Kleptocratic Swathe (Region)|The Kleptocratic Swathe]]
* [[Sector7/The Rubicon Crossroad (Region)|The Rubicon Crossroad]]
* [[Sector7/The Five Point Trade Barrier (Region)|The Five Point Trade Barrier]]
* [[Sector7/The Lizard's Claw (Region)|The Lizard's Claw]]

== Links ==
*[[The Eight]] for a disquisition on the 8 galaxies
*See [[Sector7/Systems in Galaxy Sector 7|Systems in Galaxy Sector 7]] for a more detailed list.
*See [[Oolite planet list/Galaxy 7]] for charts mapping government type against Tech Level, economy & number of systems within 7ly.
*[[Maps]] for a detailed list of these

Feudal States

2026-08-07T11:37:33Z

Cholmondely: Added notes

{{Infobox OXP| title = Feudal States OXP
|image = [[Image:Titleeagle.jpg|200px]]
|download = [https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc Latest (2021)]
|version = 2.1
|story = N/A
|stations = [[Feudal States#Ships and Stations|Stations]]
|ships = [[Feudal States#Ships and Stations|Ships]]
|mission = [[Feudal States#Elements|Elements]]
|equipment = N/A
|alternativeHUD = None
|soundSet = Some Music
|category = Systems OXPs
|author = [[User:Ramirez|Ramirez]]
}}

== Overview ==

The Feudal States is a flavour OXP that adds various new elements to the ''leading'' feudal systems in Oolite galaxies. The current version covers Galaxies 1, 2, 3, 5, 6 and (incompletely) 7.

== Elements ==

The OXP contains four basic elements:

'''Challenges'''

Pilots can visit [[Royal Hunting Lodge]]s where they are able to challenge nobles in ship-to-ship contact. Bets can be placed on the outcome, giving you an alternative way of making quick money. Use the '''F8''' interface while docked at the Lodge to accept a challenge and bet on it.

'''Missions'''

Good pilots are in high demand amongst the Feudal States. Visit the Royal Court where you can take on missions, ranging from simple deliveries to the capture and ransom of senior nobles. Use the '''F8''' interface for the Royal Court after landing on the planet.

'''Promotions'''

As your standing with the Feudal States increases, you can join their ranks as a knight of one of the royal houses. Further success will see you elevated to the peerage, with the chance of becoming one of the leading members of royal society.

'''Tournaments'''

The Feudal States hold regular tournaments where nobles gather to test their skills in combat. All pilots with noble rank are eligible to take part, with the winner taking home a major cash prize as well as increasing their prestige.

More detailed information on the OXP is available in the PDF readme (see below).

== Lore ==
The sections immediately beneath are taken from Ramirez's included .pdf:
[[File:Feudal inter Digebiti.png|thumb|right|500px|[[Sector1/Digebiti|Digebiti]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibecea.png|thumb|right|500px|[[Sector1/Tibecea|Tibecea]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibedied.png|thumb|right|500px|[[Sector1/Tibedied|Tibedied]] (From DGill's Feudal States Images OXP)]]
=== History ===
The Feudal States were formed in the decades following the first wave of the galaxy’s human colonisation. While the Corporations and Democracies had great success in securing new territory and resources, many individuals found themselves disenfranchised from power, lacking either the political skill or the business acumen to have a real say in the governing of their own affairs. In many systems, breakaway movements soon sprung up, with miners, engineers and farmers agreeing to pool their resources and seek a better life elsewhere.
The risks were great. Much of the galaxy’s unclaimed territory had by this time become a lawless hunting ground for pirates, cruising from system to system preying on unfortunate merchants and passenger liners. With no defence fleet of their own, and little money to pay for mercenary protection, the colonists turned their back on the complex systems of government that had oppressed them, and instead sought to build their strength through the ancient principles of feudalism. The idea was simple: anyone willing to provide military service to the movement would be rewarded with substantial territories in the new systems, with all the wealth and privilege associated with it.

Despite its rather old-fashioned nature, this offer of service was readily accepted by thousands of highly-rated combat pilots, many of whom had also lost out in the galactic land-grab and were having to scrape a living as itinerant freelancers. For them, serving as a knight in one of the Feudal States was an opportunity to further their careers in a more stable environment and finally earn the respect they felt was their due.

Many Feudal States were established in this way, each system forming its own set of houses, ranks, titles and styles based loosely upon those of Old Earth. For several years, the different states supported each other, eager to present a united front to other governments. But as the ranks of knights swelled, the Feudal States became ever more aggressive in character and friendly rivalry often led to war. Unable to challenge the military authority of the more established governments, the Feudal States turned upon each other in a bid to achieve supremacy.

The Feudal Wars, as the conflicts became known, were small, localised affairs and had little impact on the galaxy as a whole, although many dealers in other systems made their fortune by supplying arms and equipment to the belligerent states. Only when fighting spilled over into a nearby Democratic system, resulting in the accidental destruction of a passing freighter convoy, did the Galactic Cooperation act to put an end to the conflict. A ceasefire was enforced, the terms of which included a general embargo on the supply of offensive weapons by members of the Cooperation to any of the Feudal States.

The ceasefire remains in force today, however it is an uneasy truce and hostilities have recently resumed, with the feudal houses mounting frequent raids against each other’s trade convoys and even capturing high-ranking nobles for ransom. So long as any violence is contained within Feudal borders and does not endanger the lives of visitors, [[GalCop]] has tended to turn a blind eye to most inter-house conflict and police patrols do not venture far from the main space stations.

=== Economy ===
The Feudal States operate a range of economic models from industrial to agricultural, but they are all hampered by a lack of valuable raw resources; the systems with the most potential having been colonised long ago. Some states have managed to exploit indigenous flora and fauna with moderate success, but the majority have turned to tourism to boost their income. Particularly popular are the [[Royal Hunting Lodge]]s, small stations set away from the main space lanes where knights and nobles gather to test their combat skills and take part in large inter-house tournaments. For those living in societies where conflict is increasingly frowned upon, and the presence of GalCop is never far away, a visit to the Feudal States offers the chance to experience the life of a warrior, living according to the ancient laws of [[Royal Hunting Lodge|chivalry]].

=== Ships and Equipment ===
The trade embargo enforced by GalCop has left the Feudal States heavily self-sufficient in terms of equipment. Due to their lack of skill in high-tech engineering, the states favour simple but sturdy ships for military service rather than the more complex, high-maintenance models used by other governments. In recent times, most ships have been provided through a special contract with Beckmann-Fleisig AG, an independent shipbuilder with similar views on function over form.

A significant consequence of the Feudal States’ low-tech approach is that pilots are less reliant on the complex missile and defence systems that have become popular on many ship models. As a result, pilots in feudal service are known to be exceptionally good shots and many hold high combat ratings with the Elite Federation. Typically, each Feudal House operates three basic ship classes: the Jäger, Korvette and Zerstörer.

=== From Cim's Ship's Manual ===
''Tucked away inside his [[Ship's Library OXP]]:''

A Feudal System is defined as “a system where the exercise of power is hierarchical in nature”. In practice, since that is virtually tautologous, this status is reserved for those systems which have been unable to come to a satisfactory agreement with the Cooperative over at least one of the terms in the treaties. They may make a few goodwill payments to fund a basic station and patrols, or the Cooperative may provide them from surplus funding elsewhere, but there is no formal agreement.

[[Sector7/Atlaeser|Atlaeser]] in Chart 7 actually follows a traditional feudal model in its government, with the Grand Mover ruling with an inner court of Flock Leaders, and an outer court of Path and Skein Leaders (the planet still uses the traditional avian titles of nobility, from pre-spaceflight migrations). The system has relatively high living standards even for the serf classes, thanks to a well-balanced economy, and excellent natural resources.

At the other end of the scale, [[Sector3/Sovere|Sovere]] in Chart 3 has virtually no natural resources, and even its water is contaminated with hallucinogenic compounds. The corporate government would like to sell the water to other systems, as there is some demand for it, but under Cooperative law it is classified as a Narcotic, and the government's refusal to accept this classification is the crux of the dispute with the Cooperative.

[[Sector8/Cetiat|Cetiat]] in Chart 8 is the sort of system where the Cooperative practice of restricting the supply of technology to Feudal systems makes a lot of sense. The system refuses to sign up to either the non-aggression or mutual defence clauses of the Cooperative treaties, although fortunately its lack of industrial resources means that the nearby systems are not in any great danger from its pitiful navy. The dictatorship's territorial ambitions, while extremely unlikely to get anywhere, are long-standing.

'''NOTE''' that cim's account is at loggerheads with that of Ramirez just above it. One presumes that this is motivated by an uneasiness with the concept of popular feudalism so far in the future. As adumbrated in the musings section beneath, with the collapse of the Golden Age due to Thargoid invasions and the rise of piracy, Feudalism is a perfectly reasonable response.

== Ships and Stations ==

{| cellspacing="3" align="center" border="0" text-align="center"
|align="center" width="200" height="175"|[[Image:Jäger.png |link= Jäger |100px|]] [[Jäger]]
|align="center" width="200" height="175"|[[Image:Korvette.png |link= Korvette |100px|]] [[Korvette]]
|align="center" width="200" height="175"|[[Image:Zerstörer.png |link= Zerstörer |100px|]] [[Zerstörer]]
|align="center" width="200" height="175"|[[Image:Lodge.png |link= Royal Hunting Lodge |100px|]] [[Royal Hunting Lodge]]
|}

== Difficulty ==

Taking part in missions, challenges and tournaments is entirely optional. Missions and tournament events increase in difficulty as you progress, while challenges vary in difficulty depending on the skill and rank of your opponent.

== Requirements ==

Note that the ship models use shaders to help with identification, though the OXP will run with shader options turned off.

[[File:IconPF2.png|right|link=Planetfall2 OXP|PlanetFall2 adds feudal landing sites]]

== Dependencies ==

Requires [[Planetfall_OXP|Planetfall OXP]] (either the 2013 PF1 version ''or'' the 2024 PF2 version).

== Download ==
*v.2.1 Downloadable from [https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc here]
*[[Media:Feudal_States_1.16.3.oxz|Feudal_States_1.16.3.oxz]] (downloaded {{#downloads:Feudal_States_1.16.3.oxz}} times) or through the in-game [[Expansions Manager]].
*The Feudal States OXP is available for download at [http://www.arcadia-digital.net/steve/Oolite/Oolite.html Ramirez' Oolite Pages]
*[[Media:Feudal_States_1.16.2.oxz|Feudal_States_1.16.2.oxz]] for Oolite 1.79 or later (downloaded {{#downloads:Feudal_States_1.16.2.oxz}} times).

[[Image:IconGNN.png|right|48px|link=GNN|DGill's version uses GNN]]
[[Image:IconLib.png|right|48px|link=Library OXP|DGill's version uses Library's PAD]]
[[Image:IconPF2.png|right|48px|link=Planetfall2|DGill's version uses Planetfall2]]
=== DGill's Feudal Suite ===
DGill's Feudal States oxp suite (in Beta, for playtesting) - these 4 OXPs replace Ramirez's original, above. [[File:New.gif]]
*[https://drive.google.com/drive/folders/1lqj6brYWwgR555AcewXgvKpZak7sswTx?usp=sharing Feudal States Extended]
*[https://drive.google.com/drive/folders/1O1_Wpcl2OW-e8dWPTDkq-5py1W2dOyRQ?usp=sharing Feudal States Tibecea]
*[https://drive.google.com/drive/folders/1FeBS8o85YsSRHIpNtmwxI91bXA-Qq5DL?usp=sharing Feudal States Ships]
*[https://drive.google.com/drive/folders/1l8eW-8q27q2bKlanl3-nD7XmtbwTtBVW?usp=sharing Feudal States Images]

"Tibecea" both adds estate management to the game (once one is of high-enough feudal rank) ''and'' flavours the SE corner of G1 (Santaari) around [[Tibecea (Rough Guide)|Tibecea]].

The feudal suite adds in more activities and dovetails beautifully with [[Planetfall2 OXP]], building on the possibilities which Planetfall2 introduces to Oolite. At the time of writing, it is the only OXP which does this. It ''also'' works with the older Planetfall.

== Musings ==
G8 is missing from this OXP (there are 32 feudal states there). It would also be nice to add in some more nationalities (Norwegian? Hungarian? Finnish? Brazilian? Scottish? ''etc''). And maybe one or two of the other species - the batrachians of G8 Rear or the felines of G8 Aanra?

The escutcheons for G7 are likewise missing.

''This is all fixed in DGill's four-piece Feudal States suite''

=== Historic context ===
Feudalism developed in Europe as a response to the downfall of the Roman Empire (≅ GalCop) and the incursions of the barbarians (≅ Thargoids & pirates). As matters in The Eight worsen and presuming that GalCop proves incapable of supporting local regimes, one might well expect more states to take up a feudal system of government as people cry out for protection against the invaders!

== Tweaks ==
OXP's being modifiable, this one, also, can be changed at whim if you have the skills. See the screen shots of DGill's version [https://bb.oolite.space/viewtopic.php?p=278048#p278048 here], with larger hunting lodges, a feudal HUD (!) and a greater variety of different missions.

== PDF ==
Tucked away inside this oxp is one of [[User:Ramirez|Ramirez]]'s famous .pdf's stashed full of information (15 pages!).

To extract it, try here: [[File:The Feudal States.pdf.zip]]

''Or'' you can use the [[Expansions Manager]], or just expand it with your computer's software unzipper and peek into the folder.

== Links ==

*You can find the Feudal States discussion thread on the Oolite Bulletin Boards [https://bb.oolite.space/viewtopic.php?t=5511 here].
*See the Royal Houses box at the bottom of this page
*An earlier Feudal OXP was written by Caracal [https://bb.oolite.space/viewtopic.php?t=4860 Teaser OXP for Feudals: Target Practice] (2008 - download link broken)

This has proved a very popular OXP - together with the main thread there are many others dealing with problems people found. These two are a little different:
*[https://bb.oolite.space/viewtopic.php?f=6&t=13140 Land ownership as reward for missions for Feudal lords?] (2012)
*[https://bb.oolite.space/viewtopic.php?f=2&t=18710 How do you imagine Feudal Systems?] (2017)

{{FeudalStatesRoyalHouses}}

{{station-OXP}}{{ship-OXP}}{{mission-OXP}}

[[Category:The Feudal States| ]] [[Category:Fictional organisations]]

Feudal States

2026-08-07T11:20:22Z

Cholmondely: /* DGill's Feudal Suite */ Updated links

{{Infobox OXP| title = Feudal States OXP
|image = [[Image:Titleeagle.jpg|200px]]
|download = [https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc Latest (2021)]
|version = 2.1
|story = N/A
|stations = [[Feudal States#Ships and Stations|Stations]]
|ships = [[Feudal States#Ships and Stations|Ships]]
|mission = [[Feudal States#Elements|Elements]]
|equipment = N/A
|alternativeHUD = None
|soundSet = Some Music
|category = Systems OXPs
|author = [[User:Ramirez|Ramirez]]
}}

== Overview ==

The Feudal States is a flavour OXP that adds various new elements to the ''leading'' feudal systems in Oolite galaxies. The current version covers Galaxies 1, 2, 3, 5, 6 and (incompletely) 7.

== Elements ==

The OXP contains four basic elements:

'''Challenges'''

Pilots can visit [[Royal Hunting Lodge]]s where they are able to challenge nobles in ship-to-ship contact. Bets can be placed on the outcome, giving you an alternative way of making quick money. Use the '''F8''' interface while docked at the Lodge to accept a challenge and bet on it.

'''Missions'''

Good pilots are in high demand amongst the Feudal States. Visit the Royal Court where you can take on missions, ranging from simple deliveries to the capture and ransom of senior nobles. Use the '''F8''' interface for the Royal Court after landing on the planet.

'''Promotions'''

As your standing with the Feudal States increases, you can join their ranks as a knight of one of the royal houses. Further success will see you elevated to the peerage, with the chance of becoming one of the leading members of royal society.

'''Tournaments'''

The Feudal States hold regular tournaments where nobles gather to test their skills in combat. All pilots with noble rank are eligible to take part, with the winner taking home a major cash prize as well as increasing their prestige.

More detailed information on the OXP is available in the PDF readme (see below).

== Lore ==
The sections immediately beneath are taken from Ramirez's included .pdf:
[[File:Feudal inter Digebiti.png|thumb|right|500px|[[Sector1/Digebiti|Digebiti]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibecea.png|thumb|right|500px|[[Sector1/Tibecea|Tibecea]] (From DGill's Feudal States Images OXP)]]
[[File:Feudal inter Tibedied.png|thumb|right|500px|[[Sector1/Tibedied|Tibedied]] (From DGill's Feudal States Images OXP)]]
=== History ===
The Feudal States were formed in the decades following the first wave of the galaxy’s human colonisation. While the Corporations and Democracies had great success in securing new territory and resources, many individuals found themselves disenfranchised from power, lacking either the political skill or the business acumen to have a real say in the governing of their own affairs. In many systems, breakaway movements soon sprung up, with miners, engineers and farmers agreeing to pool their resources and seek a better life elsewhere.
The risks were great. Much of the galaxy’s unclaimed territory had by this time become a lawless hunting ground for pirates, cruising from system to system preying on unfortunate merchants and passenger liners. With no defence fleet of their own, and little money to pay for mercenary protection, the colonists turned their back on the complex systems of government that had oppressed them, and instead sought to build their strength through the ancient principles of feudalism. The idea was simple: anyone willing to provide military service to the movement would be rewarded with substantial territories in the new systems, with all the wealth and privilege associated with it.

Despite its rather old-fashioned nature, this offer of service was readily accepted by thousands of highly-rated combat pilots, many of whom had also lost out in the galactic land-grab and were having to scrape a living as itinerant freelancers. For them, serving as a knight in one of the Feudal States was an opportunity to further their careers in a more stable environment and finally earn the respect they felt was their due.

Many Feudal States were established in this way, each system forming its own set of houses, ranks, titles and styles based loosely upon those of Old Earth. For several years, the different states supported each other, eager to present a united front to other governments. But as the ranks of knights swelled, the Feudal States became ever more aggressive in character and friendly rivalry often led to war. Unable to challenge the military authority of the more established governments, the Feudal States turned upon each other in a bid to achieve supremacy.

The Feudal Wars, as the conflicts became known, were small, localised affairs and had little impact on the galaxy as a whole, although many dealers in other systems made their fortune by supplying arms and equipment to the belligerent states. Only when fighting spilled over into a nearby Democratic system, resulting in the accidental destruction of a passing freighter convoy, did the Galactic Cooperation act to put an end to the conflict. A ceasefire was enforced, the terms of which included a general embargo on the supply of offensive weapons by members of the Cooperation to any of the Feudal States.

The ceasefire remains in force today, however it is an uneasy truce and hostilities have recently resumed, with the feudal houses mounting frequent raids against each other’s trade convoys and even capturing high-ranking nobles for ransom. So long as any violence is contained within Feudal borders and does not endanger the lives of visitors, [[GalCop]] has tended to turn a blind eye to most inter-house conflict and police patrols do not venture far from the main space stations.

=== Economy ===
The Feudal States operate a range of economic models from industrial to agricultural, but they are all hampered by a lack of valuable raw resources; the systems with the most potential having been colonised long ago. Some states have managed to exploit indigenous flora and fauna with moderate success, but the majority have turned to tourism to boost their income. Particularly popular are the [[Royal Hunting Lodge]]s, small stations set away from the main space lanes where knights and nobles gather to test their combat skills and take part in large inter-house tournaments. For those living in societies where conflict is increasingly frowned upon, and the presence of GalCop is never far away, a visit to the Feudal States offers the chance to experience the life of a warrior, living according to the ancient laws of [[Royal Hunting Lodge|chivalry]].

=== Ships and Equipment ===
The trade embargo enforced by GalCop has left the Feudal States heavily self-sufficient in terms of equipment. Due to their lack of skill in high-tech engineering, the states favour simple but sturdy ships for military service rather than the more complex, high-maintenance models used by other governments. In recent times, most ships have been provided through a special contract with Beckmann-Fleisig AG, an independent shipbuilder with similar views on function over form.

A significant consequence of the Feudal States’ low-tech approach is that pilots are less reliant on the complex missile and defence systems that have become popular on many ship models. As a result, pilots in feudal service are known to be exceptionally good shots and many hold high combat ratings with the Elite Federation. Typically, each Feudal House operates three basic ship classes: the Jäger, Korvette and Zerstörer.

=== From Cim's Ship's Manual ===
''Tucked away inside his [[Ship's Library OXP]]:''

A Feudal System is defined as “a system where the exercise of power is hierarchical in nature”. In practice, since that is virtually tautologous, this status is reserved for those systems which have been unable to come to a satisfactory agreement with the Cooperative over at least one of the terms in the treaties. They may make a few goodwill payments to fund a basic station and patrols, or the Cooperative may provide them from surplus funding elsewhere, but there is no formal agreement.

[[Sector7/Atlaeser|Atlaeser]] in Chart 7 actually follows a traditional feudal model in its government, with the Grand Mover ruling with an inner court of Flock Leaders, and an outer court of Path and Skein Leaders (the planet still uses the traditional avian titles of nobility, from pre-spaceflight migrations). The system has relatively high living standards even for the serf classes, thanks to a well-balanced economy, and excellent natural resources.

At the other end of the scale, [[Sector3/Sovere|Sovere]] in Chart 3 has virtually no natural resources, and even its water is contaminated with hallucinogenic compounds. The corporate government would like to sell the water to other systems, as there is some demand for it, but under Cooperative law it is classified as a Narcotic, and the government's refusal to accept this classification is the crux of the dispute with the Cooperative.

[[Sector8/Cetiat|Cetiat]] in Chart 8 is the sort of system where the Cooperative practice of restricting the supply of technology to Feudal systems makes a lot of sense. The system refuses to sign up to either the non-aggression or mutual defence clauses of the Cooperative treaties, although fortunately its lack of industrial resources means that the nearby systems are not in any great danger from its pitiful navy. The dictatorship's territorial ambitions, while extremely unlikely to get anywhere, are long-standing.

'''NOTE''' that cim's account is at loggerheads with that of Ramirez just above it. One presumes that this is motivated by an uneasiness with the concept of popular feudalism so far in the future. As adumbrated in the musings section beneath, with the collapse of the Golden Age due to Thargoid invasions and the rise of piracy, Feudalism is a perfectly reasonable response.

== Ships and Stations ==

{| cellspacing="3" align="center" border="0" text-align="center"
|align="center" width="200" height="175"|[[Image:Jäger.png |link= Jäger |100px|]] [[Jäger]]
|align="center" width="200" height="175"|[[Image:Korvette.png |link= Korvette |100px|]] [[Korvette]]
|align="center" width="200" height="175"|[[Image:Zerstörer.png |link= Zerstörer |100px|]] [[Zerstörer]]
|align="center" width="200" height="175"|[[Image:Lodge.png |link= Royal Hunting Lodge |100px|]] [[Royal Hunting Lodge]]
|}

== Difficulty ==

Taking part in missions, challenges and tournaments is entirely optional. Missions and tournament events increase in difficulty as you progress, while challenges vary in difficulty depending on the skill and rank of your opponent.

== Requirements ==

Note that the ship models use shaders to help with identification, though the OXP will run with shader options turned off.

[[File:IconPF2.png|right|link=Planetfall2 OXP|PlanetFall2 adds feudal landing sites]]

== Dependencies ==

Requires [[Planetfall_OXP|Planetfall OXP]] (either the 2013 PF1 version ''or'' the 2024 PF2 version).

== Download ==

*v.2.1 Downloadable from [[https://app.box.com/s/n82zni541uj4bazmb7cp43x2lk6wu4sc here]]
*[[Media:Feudal_States_1.16.3.oxz|Feudal_States_1.16.3.oxz]] (downloaded {{#downloads:Feudal_States_1.16.3.oxz}} times) or through the in-game [[Expansions Manager]].
*The Feudal States OXP is available for download at [http://www.arcadia-digital.net/steve/Oolite/Oolite.html Ramirez' Oolite Pages]
*[[Media:Feudal_States_1.16.2.oxz|Feudal_States_1.16.2.oxz]] for Oolite 1.79 or later (downloaded {{#downloads:Feudal_States_1.16.2.oxz}} times).

[[Image:IconGNN.png|right|48px|link=GNN|DGill's version uses GNN]]
[[Image:IconLib.png|right|48px|link=Library OXP|DGill's version uses Library's PAD]]
[[Image:IconPF2.png|right|48px|link=Planetfall2|DGill's version uses Planetfall2]]
=== DGill's Feudal Suite ===
DGill's Feudal States oxp suite (in Beta, for playtesting) - these 4 OXPs replace Ramirez's original, above. [[File:New.gif]]
*[https://drive.google.com/drive/folders/1lqj6brYWwgR555AcewXgvKpZak7sswTx?usp=sharing Feudal States Extended]
*[https://drive.google.com/drive/folders/1O1_Wpcl2OW-e8dWPTDkq-5py1W2dOyRQ?usp=sharing Feudal States Tibecea]
*[https://drive.google.com/drive/folders/1FeBS8o85YsSRHIpNtmwxI91bXA-Qq5DL?usp=sharing Feudal States Ships]
*[https://drive.google.com/drive/folders/1l8eW-8q27q2bKlanl3-nD7XmtbwTtBVW?usp=sharing Feudal States Images]

== Musings ==
G8 is missing from this OXP (there are 32 feudal states there). It would also be nice to add in some more nationalities (Norwegian? Hungarian? Finnish? Brazilian? Scottish? ''etc''). And maybe one or two of the other species - the batrachians of G8 Rear or the felines of G8 Aanra?

The escutcheons for G7 are likewise missing.

=== Historic context ===
Feudalism developed in Europe as a response to the downfall of the Roman Empire (≅ GalCop) and the incursions of the barbarians (≅ Thargoids & pirates). As matters in The Eight worsen and presuming that GalCop proves incapable of supporting local regimes, one might well expect more states to take up a feudal system of government as people cry out for protection against the invaders!

== Tweaks ==
OXP's being modifiable, this one, also, can be changed at whim if you have the skills. See the screen shots of DGill's version [https://bb.oolite.space/viewtopic.php?p=278048#p278048 here], with larger hunting lodges, a feudal HUD (!) and a greater variety of different missions.

== PDF ==
Tucked away inside this oxp is one of [[User:Ramirez|Ramirez]]'s famous .pdf's stashed full of information (15 pages!).

To extract it, try here: [[File:The Feudal States.pdf.zip]]

''Or'' you can use the [[Expansions Manager]], or just expand it with your computer's software unzipper and peek into the folder.

== Links ==

*You can find the Feudal States discussion thread on the Oolite Bulletin Boards [https://bb.oolite.space/viewtopic.php?t=5511 here].
*See the Royal Houses box at the bottom of this page
*An earlier Feudal OXP was written by Caracal [https://bb.oolite.space/viewtopic.php?t=4860 Teaser OXP for Feudals: Target Practice] (2008 - download link broken)

This has proved a very popular OXP - together with the main thread there are many others dealing with problems people found. These two are a little different:
*[https://bb.oolite.space/viewtopic.php?f=6&t=13140 Land ownership as reward for missions for Feudal lords?] (2012)
*[https://bb.oolite.space/viewtopic.php?f=2&t=18710 How do you imagine Feudal Systems?] (2017)

{{FeudalStatesRoyalHouses}}

{{station-OXP}}{{ship-OXP}}{{mission-OXP}}

[[Category:The Feudal States| ]] [[Category:Fictional organisations]]

Materials in Oolite

2026-08-04T06:59:55Z

Cholmondely: Tweaks

Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021. Oolite now supports the basic PBR (Physically Based Rendering) materials, using the new Oolite shaders system. The requirements are light energy conservation, a microfacet surface model and a physically based Bidirectional Reflective Distribution Function (BRDF)

[[File:Viper Griff Specgloss.png|thumb|right|640px|Griff's PBR "SpecGloss Viper"]]
== PBR (Physically Based Rendering) materials: links ==
[https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018)
* [https://bb.oolite.space/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
:Also contains
* [https://bb.oolite.space/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.
=== 2018 New Materials OXPs ===
* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: Griff's SpecGloss models of the Cobra Mk.1, Mk.3, Gecko, Mamba, Sidewinder & Viper
* [[Normal and Specular+Gloss Maps for Oolite v1.88+]] - a_c's update of Griff's 2013 vanilla game set (ships, stations, asteroids etc.).
: This is now incorporated into Oolive v.1.92 as the new vanilla game set
=== Tools ===
* [[Material Test Suite OXP]] — demonstrates most material properties.
* [[Library OXP]] also has a couple of add-on tools ([[MatFinder]] & DevTools) which enable you to play around with all this and see the effects

{{OXPNote|The rest of this page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander|Another commander]]'s work on Oolite described just above}}

Traditionally, the surface appearance of ships in Oolite has been defined entirely by textures specified in the ship’s model file and the ''[[#smooth|smooth]]'' attribute. Test release 1.67 added support for [[Shaders in Oolite|shaders]], and test release 1.69 expanded this to a more flexible '''material model'''. Under the new model, the texture file names in model files have been repurposed as '''material keys'''. A material key specifies an entry in the ship’s '''material dictionary''', specified in the ship’s ''[[shipdata.plist]]'' entry. For backwards compatibility, if no material of a given name is found, a material is generated using the material key as a diffuse texture name – providing the same functionality as previous versions of Oolite.

This page documents the old material model as of Oolite test release 1.74 (2010), and applies to stable release 1.76 (2011) and later.
__TOC__
== Important concepts ==
The following concepts are important in understanding how materials work and how they interact with lights.
* '''Colour''': Oolite uses a basic low dynamic range lighting model. Colours are considered to be lists of three values, representing red, green and blue colours, each ranging from 0 to 1. These are often encoded as integers ranging from 0 to 255 for technical reasons, but 0 to 1 is the true range of values. There may also be an associated ''alpha channel'', which is traditionally used for blending effects. In shaders, any colour channel can be used for any purpose, and textures often encode values that are not treated as colours.
* '''Fragment''': roughty speaking, an on-screen pixel. When objects are rendered, their geometry is used to generate a fragments, which are then coloured based on lighting and materials.
* '''Modulation''': multiplying two colours together, by channel. For instance, if the calculated light colour for a given fragment is pale yellow – [1, 1, 0.8] – and the corresponding part of the diffuse map is turquoise – [0.2, 0.8, 0.8] – the ''diffuse contribution'' is [0.2, 0.8, 0.64] (a greenish tint). In graphics programs, this blending mode is usually called ''Multiply''.
* '''Additive blending''': adding two colours together, by channel. In Oolite’s low dynamic range lighting model, the result is always clipped to the range 0..1. In graphics programs, this blending mode is usually called ''Lighten''.
* '''Normals''': All lighting calculations require a concept of the orientation of a surface relative to a light and, for reflections, relative to the camera. A surface oriented towards the light will be lighter than a surface oriented away from it. The ''normal'' for any given point on a surface is a vector pointing straight out, which for our purposes ''defines'' the concept of “straight out”. By default, Oolite models have constant normals across each face. By setting the <code>smooth</code> attribute in [[shipdata.plist]], normals are instead interpolated across each face, with each vertex having a normal that is a weighted average of surounding faces’ normals, and each point on a surface getting a weighted average of the normals at the corners of the face. Using ''smooth groups'', a model can be divided into regions which are smoothed but have sharp boundaries between them. As of Oolite 1.74, models can also include explicit per-vertex normals instead of having Oolite calculate them – most 3D modellers export this information. When using smoothing, it is important to understand that Oolite does not add any geometry,and will result in each vertex being lit as if it is locally flat. This is generally inappropriate for any sharp corner. If you set <code>smooth</code> on a basic cube, the result will be badly lit.
* '''Diffuse reflection''': light that is reflected evenly in all directions. A “dull” surface primarily reflects diffusely. Because the light is reflected evenly in all directions, the diffuse term is independent of the camera position; it is a function of the light and the surface normal. The standard diffuse reflection term is the cosine of the angle between the direction to the light and the normal, or zero if this is negative – this is known as the [http://en.wikipedia.org/wiki/Lambertian_reflectance Lambertian reflectance model]. This value is then modulated with the material’s diffuse colour and diffuse map.
* '''Specular reflection''': light that is reflected in a particular direction, producing a shiny effect. In real life, this is simply a mirror reflection which is generally darkened and blurred, leaving an enlarged, blurry reflection of bright light sources, with other objects being washed out so they aren’t noticeable. In Oolite, a simpler mathematical model called the [http://en.wikipedia.org/wiki/Blinn–Phong_shading_model Blinn-Phong shading model] is used. [http://www.youtube.com/watch?v=76jvMmV1ih0 This video] demonstrates the effects of specular lighting and specular mapping on the built-in scarred alloy model.

== The material dictionary ==
The '''material dictionary''' is actually specified as two separate dictionaries in the ''shipdata.plist'' entry. The first is called ''materials'', the second ''shaders''. If [[Shaders in Oolite|shader support]] is available and enabled, the entries in ''shaders'' are used in preference to those in ''materials''. Otherwise, ''shaders'' is ignored. The entries in the two dictionaries take exactly the same form, however; it is possible to specify a shader in the ''materials'' dictionary, and it will simply be ignored if shader support is not available. The ''materials'' and ''shaders'' dictionaries, merged together, are known as a ''material dictionary''.

=== Material specifiers ===
The material dictionary is a [[property list]] dictionary whose keys are ''material keys'' as defined below, and whose values are '''material specifiers''', which are either dictionaries or strings. When a string is used as a material specifier, it is equivalent to a dictionary with that string as the value for '''diffuse_map''', and no other properties. Currently-supported material specifier keys are listed here; “texture specifier” and similar are defined below.

Most of these keys have no effect when a custom shader is in effect.

When shaders are disabled or not available, emission and illumination maps are supported only if reduced detail is disabled and the graphics hardware supports multi-texturing. If '''emission_modulate_color''', '''illumination_map''', or '''emission_and_illumination_map''' are used, Oolite must combine them into a single emission map. It is generally preferable to do this in advance (by modulating the illumination map with the diffuse map and blending it additively with the emission map, after applying any colouring). This is more efficient when using shaders, too.

{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ General material attribues
! Name !! Type !! Description
|-
| '''ambient_color''' || [[#Colour specifiers|colour specifier]] || The ambient colour of the entity, that is, the colour reflected evenly in all directions by starlight. If there is a '''diffuse_map''', the '''ambient_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_color''' || [[#Colour specifiers|colour specifier]] || Overall diffuse colour of the entity; that is, the colour reflected in a “non-shiny” way on the sunlit side of the entity. If there is a '''diffuse_map''', the '''diffuse_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the basic colour of the material. This is a “normal” texture, the same as you get without a material dictionary. If not specified, the material key will be used. To specify no texture, use an empty string for '''diffuse_map'''. Ignored when using shaders.
|-
| '''emission_color''' || [[#Colour specifiers|colour specifier]] || The emitted (glow) colour of the material. This is ignored when '''emission_map''' is in use (but see also: '''emission_modulate_color'''). Default: black (0.0, 0.0, 0.0, 1.0).
|-
| '''emission_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying emission (glow) colours. This is blended additively with all other colour terms. If '''emission_modulate_color''' is specified, the emission map is modulated by the modulate colour. Emission maps are used when shaders are active, and without shaders on supported hardware.
|-
| '''emission_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''emission_map'''. If the emission map is in full colour, it is best to apply the colouring in advance using a graphics program. However, if the emission map is a single colour, using a greyscale emission map and a modulate colour will reduce memory usage by a factor of four when shaders are in use. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''emission_and_illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture whose RGB channels act like '''emission_map''', and whose alpha channel acts like '''illumination_map''' (and can be coloured with '''illumination_modulate_color'''). This uses less memory (on systems with shaders) than using separate shaders, although blending the emission and illumination maps into a single emission map, as described above, is still preferable.
|-
| '''illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying local illumination colour, which is added to incoming light. It differs from an emission map in that it is modulated with the diffuse colour before being added to the final colour. See example below.
|-
| '''illumination_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''illumination_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''normal_map''' || [[#Texture specifiers|texture specifier]] || A texture modifying [[#Important concepts|normals]]. The red, green and blue channels are the x, y and z coordinates of normals relative to the underlying normal (“[http://en.wikipedia.org/wiki/Normal_mapping tangent-space normal mapping]”), and the alpha channel is ingored. This is only used when shaders are active and no custom shader is used.
|-
| '''normal_and_parallax_map''' || [[#Texture specifiers|texture specifier]] || Like '''normal_map''', except that the alpha channel is includes a depth value used to add [http://en.wikipedia.org/wiki/Parallax_mapping simulated perspective]. If specified, '''normal_map''' is ignored.
|-
| '''parallax_bias''' || number || A value added to the parallax component of '''normal_and_parallax_map''', after multiplying by '''parallax_scale''' (default: 0).
|-
| '''parallax_scale''' || number || A scale factor for the parallax component of '''normal_and_parallax_map''' (default: 0.01). This value is the depth of the parallax map relative to the size of the texture. For instance, a value of 0.01 on a texture 100 metres wide will produce a maximum indentation of 1 metre. High parallax_scale values tend to lead to unacceptable texture distortion and “creeping” artefacts.
|-
| '''specular_color''' || [[#Colour specifiers|colour specifier]] || The colour to use for specular reflection over the entire model when '''specular_map''' is not used. The specular term is added to the diffuse term; for less intense specular highlights, use a darker colour. Default: black (0.0, 0.0, 0.0, 1.0) if '''shininess''' is zero, (0.2, 0.2, 0.2, 1.0) otherwise.
|-
| '''specular_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the specular highlight colour in its red, green and blue channels, and '''shininess''' in its alpha channel. 1 (fully opaque) means the value of '''shininess''' is used. 0 means a very low shininess is used. This is only used when shaders are active and no custom shader is used.
|-
| '''specular_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''specular_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''shininess''' || integer || The “tightness” of specular reflection, ranging from 0 to 128. 0 means no specular highlight. 128 is maximally shiny. Default: 128 if '''specular_map''' is used, 10 otherwise. '''Limitation:''' to use different shininess values with '''specular_map''' or '''specular_color''', you must either use the default or use different “shaders” and “materials” dictionaries. This should be fixed for 1.75.
|-
| '''vertex_shader''' || file name || name of GLSL vertex program to use.
|-
| '''fragment_shader''' || file name || name of GLSL fragment program to use.
|-
| '''textures''' || array of [[#Texture specifiers|texture specifier]]s || Textures to use in shader program.
|-
| '''uniforms''' || dictionary of uniform variable specifiers || uniform variables to use in shader program.
|-
|}

==== Illumination mapping vs. emission mapping ====
This image demonstrates the distinction between illumination mapping (top row) and emission mapping (bottom row).

[[Image:Emission-vs-illumination.png]]

=== Colour specifiers ===
'''Colour specifiers''' are used to declare colours in material attribute dictionaries, and in other contexts such as lasers in ''[[shipdata.plist]]''. Colour specifiers take any of several forms:

==== Named colours ====
The simplest form of colour specifier is a string containing a colour name. The following names are supported:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Colour names
! Name !! RGBA value
|-
| blackColor || 0, 0, 0, 1
|-
| darkGrayColor || 1/3, 1/3, 1/3, 1
|-
| lightGrayColor || 2/3, 2/3, 2/3, 1
|-
| whiteColor || 1, 1, 1, 1
|-
| grayColor || 1/2, 1/2, 1/2, 1
|-
| redColor || 1, 0, 0, 1
|-
| greenColor || 0, 1, 0, 1
|-
| blueColor || 0, 0, 1, 1
|-
| cyanColor || 0, 1, 1, 1
|-
| yellowColor || 1, 1, 0, 1
|-
| magentaColor || 1, 0, 1, 1
|-
| orangeColor || 1, 1/2, 0, 1
|-
| purpleColor || 1/2, 0, 1/2, 1
|-
| brownColor || 0.6, 0.4, 0.2, 1
|-
| clearColor || 0, 0, 0, 0
|-
|}

==== RGBA tuples ====
Colours may also be specified in RGB or RGBA (red, green, blue, alpha [transparency]). RGB or RGBA tuples may be specified as arrays or as strings separated by spaces. The values may range from 0 to 1 or 0 to 255. (If no value is greater than 1, 0–1 is assumed, otherwise 0–255.) Examples:
* <code>"1 1 0"</code> — yellow
* <code>"0 128 0 128"</code> — medium green at 50% opacity
* <code>(1, 0, 0)</code> – red

==== RGBA dictionaries ====
Just in case you’re unsure of the order the RGB[A] components come in, you can use a dictionary:
{
blue = 0.8;
green = 0.8;
}
Accepted keys are '''red''', '''green''', '''blue''' and '''alpha''' (or '''opacity'''), all optional (default: 0.0 for red, green and blue, 1.0 for alpha).

==== HSBA dictionaries ====
But wait, there’s more! Colours may also be specified as dictionaries in the [http://en.wikipedia.org/wiki/HSB_colour_space HSB colour space]. Accepted keys are '''hue''' (hue angle in degrees, required), '''saturation''', '''brightness''' (or '''value''') and '''alpha''' (or '''opacity'''). The default for the optional keys is 1.0.
{
// Pale magenta
hue = 300;
saturation = 0.3;
}

=== Texture specifiers ===
'''Texture specifiers''' are used to, er, specify textures. The simplest form of texture specifier is a string: <code>"ahruman-example-texture.png"</code>. The very simplest texture specifier is the empty string, <code>""</code>, meaning no texture. More complex texture specifiers are dictionaries, which can be used to specify a number of texture options.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''anisotropy''' || real || The degree of [http://en.wikipedia.org/wiki/Anisotropic_filtering anisotropic filtering] to use. Anisotropic filtering is used to reduce blurriness of MIP mapped textures shown at an angle (and thus only applies to textures whose '''min_filter''' is '''mipmap''' or '''default'''). The '''anisotropy''' setting is multiplied by the maximum anisotropy level specified by the system, and anisotropic filtering is used only if the result is greater than 1. (For example, on a GeForce FX 5200 card, the maximum level is 8, so an anisotropy value of 0.5 means an effective anisotropic filtering strength of 4. The precise meaning of this number is hardware-dependant. Fun, eh?) Anisotropic filtering is disabled in Reduced Detail mode and is not available on all hardware. Default: 0.5.
|-
| '''cube_map''' || boolean || If this is true, and the texture file is six times as high as it is wide, the texture will be treated as a cube map. If cube maps are not supported, it will be converted to a latitude/longitude map; if used as a diffuse map or emission/illumination map, you must ensure the model has appropriate texture coordinates. Note that cube maps are always available if shaders are supported, so custom shaders do not need to worry about this.

'''cube_map''' is always true for planet textures. To convert textures to and from cube maps, see [[planettool]].
|-
| '''extract_channel''' || string || Indicates that one of the channels of the texture should be extracted into a new greyscale texture. Allowed values: '''r''', '''g''', '''b''' and '''a'''.

This obviously involves extra work for Oolite, which is always a bad thing, but it makes it possible to combine multiple effect maps in a single texture for shaders and then extract channels for use as emission or illumination maps without shipping a redundant texture. If this means nothing to you, you probably don’t want to use '''extract_channel'''.
|-
| '''mag_filter''' || string || Specifies how to scale up the texture when it is near the camera. Either of:
* '''nearest''' (use nearest-neighbour sampling, which produces a pixellated effect)
* '''linear''' (use linear interpolation, which produces a blurry effect).
Default: '''linear'''.
|-
| '''min_filter''' || string || Specifies how to scale down the texture when it is far from the camera. One of:
* '''nearest''': nearest-neighbour sampling; generally very ugly, but sometimes useful for shaders using textures for special purposes.
* '''linear''': efficient, but rather ugly for textures with significant contrast or details.
* '''mipmap''': use trilinear MIP map filtering to improve scaling quality; generally also fast and least ugly, but uses 1/3 more memory, potentially slowing down systems with limited RAM or video memory.
* '''default''': '''linear''' in reduced detail mode, otherwise '''mipmap'''.
Default: '''default'''.
|-
| '''name''' || string || The file name of the texture to use. Must be a PNG image, in the Textures folder of Oolite or an OXP. In the specific case of '''diffuse_map''' textures, '''name''' is implicitly the same as the material key; to use no texture, you must specify <code>diffuse_map = ""</code>.
|-
| '''no_shrink''' || boolean || Indicates that Oolite should not scale the texture down, except to meet hardware requirements. Default: false.
|-
| '''repeat_s''' || boolean || Whether Oolite should repeat the texture in the ''s'' (or ''u'') co-ordinate, rather than clamping it. Default: false.
|-
| '''repeat_t''' || boolean || Whether Oolite should repeat the texture in the ''t'' (or ''v'') co-ordinate, rather than clamping it. Default: false.
|-
| '''texture_LOD_bias''' || real || tweak factor for MIP mapping (which does not apply to other '''min_filter''' modes). MIP mapping involves a trade-off between scaling artefacts and blurriness; the LOD (level of detail) bias affects this. Positive values mean more blur, negative ones mean more artefacts. The default value is −0.25 (mostly so people won’t say “hey, why is everything blurrier in the new Oolite?”). Texture LOD bias is not available on all hardware.
|-
|}

=== Uniform specifiers ===
:''Main article: [[Shaders in Oolite: uniforms]]''
A ''uniform specifier'' is used to specify game information to pass to a [[Shaders in Oolite|shader program]]. As with [[#Texture specifiers|texture specifiers]], the simple case is a string, which is treated as <code>{ binding = "the string" }</code>. For instance, uHullHeatLevel = hullHeatLevel</code> will bind a shader’s <code>uHullHeatLevel</code> uniform to a ship’s <code>hullHeatLevel</code> property. Additional properties can be specified in a dictionary.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''asMatrix''' || boolean || For a '''binding''' uniform whose bound property is of type ''quaternion'', setting '''asMatrix''' to true causes the value to be converted to a rotation matrix. If '''asMatrix''' is false, the quaternion will be converted to a vector, whose w, x, y and z values match those of the quaternion. For any other type of uniform, '''asMatrix''' is ignored. Default: true.
|-
| '''binding''' || string || The entity property to bind to, for a '''binding''' uniform. Ignored for other types of uniform.
|-
| '''clamped''' || boolean || For a '''binding''' uniform whose bound property is of type ''float'', setting '''clamped''' to true causes the value to be restricted to the range 0 to 1, inclusive. For a binding of type ''int'', causes the value to be set to either 0 or 1; 1 indicates that the underlying property has any value other than 0. For any other type of uniform, '''clamped''' is ignored. Default: false.
|-
| '''normalized''' || boolean || For a '''binding''' uniform whose bound property is of type ''vector'', setting '''normalized''' to true causes the value to be normalized, that is, scaled to a length of 1. For any other type of uniform, '''normalized''' is ignored. The spelling '''normalised''' is also accepted. Default: false.
|-
| '''type''' || string || One of:
* '''binding''': indicates that the '''binding''' property specifies an entity property to be set dynamically each time the shader is used.
* '''float''' or '''real''': indicates that the '''value''' property is an floating-point number.
* '''int''' or '''integer''': indicates that the '''value''' property is an integer, or whole number.
* '''texture''': indicates that the '''value''' property is an integer specifying a texture unit, that is, an index in the '''textures''' array.
Default: '''float'''.
|-
| '''value''' || number || The value to use for a '''float''', '''int''' or '''texture''' uniform. Ignored for '''binding''' uniforms.
|-
|}

=== Material dictionary example ===
Here is an example from the [[Material Test Suite OXP]]:
materials =
{
"cube-face" =
{
diffuse_map = "oolite_shader_test_suite_7_diffuse.png";
emission_and_illumination_map = "oolite_shader_test_suite_emission_and_illumination.png";
emission_modulate_color = (160, 255, 160);
illumination_modulate_color = (180, 180, 200);
};
};
Here, the “cube-face” material is assigned the diffuse texture “oolite_shader_test_suite_7_diffuse.png” and a combined emission and illumination map (which is a greyscale+alpha texture). The emission and illumination components are then given coloured tints (slightly green and slightly blue, respectively), producing this:

[[File:Oolite Material Test Suite 7.png|thumb|320px|right|[[Material Test Suite OXP]] ]]

[[Category: Oolite]] [[Category:Oolite_scripting]]

Materials in Oolite

2026-08-04T06:19:53Z

Cholmondely: /* See also */ Added relevant OXPs and structure

Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021. Oolite now supports the basic PBR (Physically Based Rendering) materials, using the new Oolite shaders system. The requirements are light energy conservation, a microfacet surface model and a physically based Bidirectional Reflective Distribution Function (BRDF)

{{OXPNote|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}

Traditionally, the surface appearance of ships in Oolite has been defined entirely by textures specified in the ship’s model file and the ''[[#smooth|smooth]]'' attribute. Test release 1.67 added support for [[Shaders in Oolite|shaders]], and test release 1.69 expanded this to a more flexible '''material model'''. Under the new model, the texture file names in model files have been repurposed as '''material keys'''. A material key specifies an entry in the ship’s '''material dictionary''', specified in the ship’s ''[[shipdata.plist]]'' entry. For backwards compatibility, if no material of a given name is found, a material is generated using the material key as a diffuse texture name – providing the same functionality as previous versions of Oolite.

This page documents the material model as of Oolite test release 1.74 (2010), and applies to stable release 1.76 (2011) and later.

== Important concepts ==
The following concepts are important in understanding how materials work and how they interact with lights.
* '''Colour''': Oolite uses a basic low dynamic range lighting model. Colours are considered to be lists of three values, representing red, green and blue colours, each ranging from 0 to 1. These are often encoded as integers ranging from 0 to 255 for technical reasons, but 0 to 1 is the true range of values. There may also be an associated ''alpha channel'', which is traditionally used for blending effects. In shaders, any colour channel can be used for any purpose, and textures often encode values that are not treated as colours.
* '''Fragment''': roughty speaking, an on-screen pixel. When objects are rendered, their geometry is used to generate a fragments, which are then coloured based on lighting and materials.
* '''Modulation''': multiplying two colours together, by channel. For instance, if the calculated light colour for a given fragment is pale yellow – [1, 1, 0.8] – and the corresponding part of the diffuse map is turquoise – [0.2, 0.8, 0.8] – the ''diffuse contribution'' is [0.2, 0.8, 0.64] (a greenish tint). In graphics programs, this blending mode is usually called ''Multiply''.
* '''Additive blending''': adding two colours together, by channel. In Oolite’s low dynamic range lighting model, the result is always clipped to the range 0..1. In graphics programs, this blending mode is usually called ''Lighten''.
* '''Normals''': All lighting calculations require a concept of the orientation of a surface relative to a light and, for reflections, relative to the camera. A surface oriented towards the light will be lighter than a surface oriented away from it. The ''normal'' for any given point on a surface is a vector pointing straight out, which for our purposes ''defines'' the concept of “straight out”. By default, Oolite models have constant normals across each face. By setting the <code>smooth</code> attribute in [[shipdata.plist]], normals are instead interpolated across each face, with each vertex having a normal that is a weighted average of surounding faces’ normals, and each point on a surface getting a weighted average of the normals at the corners of the face. Using ''smooth groups'', a model can be divided into regions which are smoothed but have sharp boundaries between them. As of Oolite 1.74, models can also include explicit per-vertex normals instead of having Oolite calculate them – most 3D modellers export this information. When using smoothing, it is important to understand that Oolite does not add any geometry,and will result in each vertex being lit as if it is locally flat. This is generally inappropriate for any sharp corner. If you set <code>smooth</code> on a basic cube, the result will be badly lit.
* '''Diffuse reflection''': light that is reflected evenly in all directions. A “dull” surface primarily reflects diffusely. Because the light is reflected evenly in all directions, the diffuse term is independent of the camera position; it is a function of the light and the surface normal. The standard diffuse reflection term is the cosine of the angle between the direction to the light and the normal, or zero if this is negative – this is known as the [http://en.wikipedia.org/wiki/Lambertian_reflectance Lambertian reflectance model]. This value is then modulated with the material’s diffuse colour and diffuse map.
* '''Specular reflection''': light that is reflected in a particular direction, producing a shiny effect. In real life, this is simply a mirror reflection which is generally darkened and blurred, leaving an enlarged, blurry reflection of bright light sources, with other objects being washed out so they aren’t noticeable. In Oolite, a simpler mathematical model called the [http://en.wikipedia.org/wiki/Blinn–Phong_shading_model Blinn-Phong shading model] is used. [http://www.youtube.com/watch?v=76jvMmV1ih0 This video] demonstrates the effects of specular lighting and specular mapping on the built-in scarred alloy model.

== The material dictionary ==
The '''material dictionary''' is actually specified as two separate dictionaries in the ''shipdata.plist'' entry. The first is called ''materials'', the second ''shaders''. If [[Shaders in Oolite|shader support]] is available and enabled, the entries in ''shaders'' are used in preference to those in ''materials''. Otherwise, ''shaders'' is ignored. The entries in the two dictionaries take exactly the same form, however; it is possible to specify a shader in the ''materials'' dictionary, and it will simply be ignored if shader support is not available. The ''materials'' and ''shaders'' dictionaries, merged together, are known as a ''material dictionary''.

=== Material specifiers ===
The material dictionary is a [[property list]] dictionary whose keys are ''material keys'' as defined below, and whose values are '''material specifiers''', which are either dictionaries or strings. When a string is used as a material specifier, it is equivalent to a dictionary with that string as the value for '''diffuse_map''', and no other properties. Currently-supported material specifier keys are listed here; “texture specifier” and similar are defined below.

Most of these keys have no effect when a custom shader is in effect.

When shaders are disabled or not available, emission and illumination maps are supported only if reduced detail is disabled and the graphics hardware supports multi-texturing. If '''emission_modulate_color''', '''illumination_map''', or '''emission_and_illumination_map''' are used, Oolite must combine them into a single emission map. It is generally preferable to do this in advance (by modulating the illumination map with the diffuse map and blending it additively with the emission map, after applying any colouring). This is more efficient when using shaders, too.

{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ General material attribues
! Name !! Type !! Description
|-
| '''ambient_color''' || [[#Colour specifiers|colour specifier]] || The ambient colour of the entity, that is, the colour reflected evenly in all directions by starlight. If there is a '''diffuse_map''', the '''ambient_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_color''' || [[#Colour specifiers|colour specifier]] || Overall diffuse colour of the entity; that is, the colour reflected in a “non-shiny” way on the sunlit side of the entity. If there is a '''diffuse_map''', the '''diffuse_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the basic colour of the material. This is a “normal” texture, the same as you get without a material dictionary. If not specified, the material key will be used. To specify no texture, use an empty string for '''diffuse_map'''. Ignored when using shaders.
|-
| '''emission_color''' || [[#Colour specifiers|colour specifier]] || The emitted (glow) colour of the material. This is ignored when '''emission_map''' is in use (but see also: '''emission_modulate_color'''). Default: black (0.0, 0.0, 0.0, 1.0).
|-
| '''emission_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying emission (glow) colours. This is blended additively with all other colour terms. If '''emission_modulate_color''' is specified, the emission map is modulated by the modulate colour. Emission maps are used when shaders are active, and without shaders on supported hardware.
|-
| '''emission_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''emission_map'''. If the emission map is in full colour, it is best to apply the colouring in advance using a graphics program. However, if the emission map is a single colour, using a greyscale emission map and a modulate colour will reduce memory usage by a factor of four when shaders are in use. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''emission_and_illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture whose RGB channels act like '''emission_map''', and whose alpha channel acts like '''illumination_map''' (and can be coloured with '''illumination_modulate_color'''). This uses less memory (on systems with shaders) than using separate shaders, although blending the emission and illumination maps into a single emission map, as described above, is still preferable.
|-
| '''illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying local illumination colour, which is added to incoming light. It differs from an emission map in that it is modulated with the diffuse colour before being added to the final colour. See example below.
|-
| '''illumination_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''illumination_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''normal_map''' || [[#Texture specifiers|texture specifier]] || A texture modifying [[#Important concepts|normals]]. The red, green and blue channels are the x, y and z coordinates of normals relative to the underlying normal (“[http://en.wikipedia.org/wiki/Normal_mapping tangent-space normal mapping]”), and the alpha channel is ingored. This is only used when shaders are active and no custom shader is used.
|-
| '''normal_and_parallax_map''' || [[#Texture specifiers|texture specifier]] || Like '''normal_map''', except that the alpha channel is includes a depth value used to add [http://en.wikipedia.org/wiki/Parallax_mapping simulated perspective]. If specified, '''normal_map''' is ignored.
|-
| '''parallax_bias''' || number || A value added to the parallax component of '''normal_and_parallax_map''', after multiplying by '''parallax_scale''' (default: 0).
|-
| '''parallax_scale''' || number || A scale factor for the parallax component of '''normal_and_parallax_map''' (default: 0.01). This value is the depth of the parallax map relative to the size of the texture. For instance, a value of 0.01 on a texture 100 metres wide will produce a maximum indentation of 1 metre. High parallax_scale values tend to lead to unacceptable texture distortion and “creeping” artefacts.
|-
| '''specular_color''' || [[#Colour specifiers|colour specifier]] || The colour to use for specular reflection over the entire model when '''specular_map''' is not used. The specular term is added to the diffuse term; for less intense specular highlights, use a darker colour. Default: black (0.0, 0.0, 0.0, 1.0) if '''shininess''' is zero, (0.2, 0.2, 0.2, 1.0) otherwise.
|-
| '''specular_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the specular highlight colour in its red, green and blue channels, and '''shininess''' in its alpha channel. 1 (fully opaque) means the value of '''shininess''' is used. 0 means a very low shininess is used. This is only used when shaders are active and no custom shader is used.
|-
| '''specular_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''specular_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''shininess''' || integer || The “tightness” of specular reflection, ranging from 0 to 128. 0 means no specular highlight. 128 is maximally shiny. Default: 128 if '''specular_map''' is used, 10 otherwise. '''Limitation:''' to use different shininess values with '''specular_map''' or '''specular_color''', you must either use the default or use different “shaders” and “materials” dictionaries. This should be fixed for 1.75.
|-
| '''vertex_shader''' || file name || name of GLSL vertex program to use.
|-
| '''fragment_shader''' || file name || name of GLSL fragment program to use.
|-
| '''textures''' || array of [[#Texture specifiers|texture specifier]]s || Textures to use in shader program.
|-
| '''uniforms''' || dictionary of uniform variable specifiers || uniform variables to use in shader program.
|-
|}

==== Illumination mapping vs. emission mapping ====
This image demonstrates the distinction between illumination mapping (top row) and emission mapping (bottom row).

[[Image:Emission-vs-illumination.png]]

=== Colour specifiers ===
'''Colour specifiers''' are used to declare colours in material attribute dictionaries, and in other contexts such as lasers in ''[[shipdata.plist]]''. Colour specifiers take any of several forms:

==== Named colours ====
The simplest form of colour specifier is a string containing a colour name. The following names are supported:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Colour names
! Name !! RGBA value
|-
| blackColor || 0, 0, 0, 1
|-
| darkGrayColor || 1/3, 1/3, 1/3, 1
|-
| lightGrayColor || 2/3, 2/3, 2/3, 1
|-
| whiteColor || 1, 1, 1, 1
|-
| grayColor || 1/2, 1/2, 1/2, 1
|-
| redColor || 1, 0, 0, 1
|-
| greenColor || 0, 1, 0, 1
|-
| blueColor || 0, 0, 1, 1
|-
| cyanColor || 0, 1, 1, 1
|-
| yellowColor || 1, 1, 0, 1
|-
| magentaColor || 1, 0, 1, 1
|-
| orangeColor || 1, 1/2, 0, 1
|-
| purpleColor || 1/2, 0, 1/2, 1
|-
| brownColor || 0.6, 0.4, 0.2, 1
|-
| clearColor || 0, 0, 0, 0
|-
|}

==== RGBA tuples ====
Colours may also be specified in RGB or RGBA (red, green, blue, alpha [transparency]). RGB or RGBA tuples may be specified as arrays or as strings separated by spaces. The values may range from 0 to 1 or 0 to 255. (If no value is greater than 1, 0–1 is assumed, otherwise 0–255.) Examples:
* <code>"1 1 0"</code> — yellow
* <code>"0 128 0 128"</code> — medium green at 50% opacity
* <code>(1, 0, 0)</code> – red

==== RGBA dictionaries ====
Just in case you’re unsure of the order the RGB[A] components come in, you can use a dictionary:
{
blue = 0.8;
green = 0.8;
}
Accepted keys are '''red''', '''green''', '''blue''' and '''alpha''' (or '''opacity'''), all optional (default: 0.0 for red, green and blue, 1.0 for alpha).

==== HSBA dictionaries ====
But wait, there’s more! Colours may also be specified as dictionaries in the [http://en.wikipedia.org/wiki/HSB_colour_space HSB colour space]. Accepted keys are '''hue''' (hue angle in degrees, required), '''saturation''', '''brightness''' (or '''value''') and '''alpha''' (or '''opacity'''). The default for the optional keys is 1.0.
{
// Pale magenta
hue = 300;
saturation = 0.3;
}

=== Texture specifiers ===
'''Texture specifiers''' are used to, er, specify textures. The simplest form of texture specifier is a string: <code>"ahruman-example-texture.png"</code>. The very simplest texture specifier is the empty string, <code>""</code>, meaning no texture. More complex texture specifiers are dictionaries, which can be used to specify a number of texture options.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''anisotropy''' || real || The degree of [http://en.wikipedia.org/wiki/Anisotropic_filtering anisotropic filtering] to use. Anisotropic filtering is used to reduce blurriness of MIP mapped textures shown at an angle (and thus only applies to textures whose '''min_filter''' is '''mipmap''' or '''default'''). The '''anisotropy''' setting is multiplied by the maximum anisotropy level specified by the system, and anisotropic filtering is used only if the result is greater than 1. (For example, on a GeForce FX 5200 card, the maximum level is 8, so an anisotropy value of 0.5 means an effective anisotropic filtering strength of 4. The precise meaning of this number is hardware-dependant. Fun, eh?) Anisotropic filtering is disabled in Reduced Detail mode and is not available on all hardware. Default: 0.5.
|-
| '''cube_map''' || boolean || If this is true, and the texture file is six times as high as it is wide, the texture will be treated as a cube map. If cube maps are not supported, it will be converted to a latitude/longitude map; if used as a diffuse map or emission/illumination map, you must ensure the model has appropriate texture coordinates. Note that cube maps are always available if shaders are supported, so custom shaders do not need to worry about this.

'''cube_map''' is always true for planet textures. To convert textures to and from cube maps, see [[planettool]].
|-
| '''extract_channel''' || string || Indicates that one of the channels of the texture should be extracted into a new greyscale texture. Allowed values: '''r''', '''g''', '''b''' and '''a'''.

This obviously involves extra work for Oolite, which is always a bad thing, but it makes it possible to combine multiple effect maps in a single texture for shaders and then extract channels for use as emission or illumination maps without shipping a redundant texture. If this means nothing to you, you probably don’t want to use '''extract_channel'''.
|-
| '''mag_filter''' || string || Specifies how to scale up the texture when it is near the camera. Either of:
* '''nearest''' (use nearest-neighbour sampling, which produces a pixellated effect)
* '''linear''' (use linear interpolation, which produces a blurry effect).
Default: '''linear'''.
|-
| '''min_filter''' || string || Specifies how to scale down the texture when it is far from the camera. One of:
* '''nearest''': nearest-neighbour sampling; generally very ugly, but sometimes useful for shaders using textures for special purposes.
* '''linear''': efficient, but rather ugly for textures with significant contrast or details.
* '''mipmap''': use trilinear MIP map filtering to improve scaling quality; generally also fast and least ugly, but uses 1/3 more memory, potentially slowing down systems with limited RAM or video memory.
* '''default''': '''linear''' in reduced detail mode, otherwise '''mipmap'''.
Default: '''default'''.
|-
| '''name''' || string || The file name of the texture to use. Must be a PNG image, in the Textures folder of Oolite or an OXP. In the specific case of '''diffuse_map''' textures, '''name''' is implicitly the same as the material key; to use no texture, you must specify <code>diffuse_map = ""</code>.
|-
| '''no_shrink''' || boolean || Indicates that Oolite should not scale the texture down, except to meet hardware requirements. Default: false.
|-
| '''repeat_s''' || boolean || Whether Oolite should repeat the texture in the ''s'' (or ''u'') co-ordinate, rather than clamping it. Default: false.
|-
| '''repeat_t''' || boolean || Whether Oolite should repeat the texture in the ''t'' (or ''v'') co-ordinate, rather than clamping it. Default: false.
|-
| '''texture_LOD_bias''' || real || tweak factor for MIP mapping (which does not apply to other '''min_filter''' modes). MIP mapping involves a trade-off between scaling artefacts and blurriness; the LOD (level of detail) bias affects this. Positive values mean more blur, negative ones mean more artefacts. The default value is −0.25 (mostly so people won’t say “hey, why is everything blurrier in the new Oolite?”). Texture LOD bias is not available on all hardware.
|-
|}

=== Uniform specifiers ===
:''Main article: [[Shaders in Oolite: uniforms]]''
A ''uniform specifier'' is used to specify game information to pass to a [[Shaders in Oolite|shader program]]. As with [[#Texture specifiers|texture specifiers]], the simple case is a string, which is treated as <code>{ binding = "the string" }</code>. For instance, uHullHeatLevel = hullHeatLevel</code> will bind a shader’s <code>uHullHeatLevel</code> uniform to a ship’s <code>hullHeatLevel</code> property. Additional properties can be specified in a dictionary.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''asMatrix''' || boolean || For a '''binding''' uniform whose bound property is of type ''quaternion'', setting '''asMatrix''' to true causes the value to be converted to a rotation matrix. If '''asMatrix''' is false, the quaternion will be converted to a vector, whose w, x, y and z values match those of the quaternion. For any other type of uniform, '''asMatrix''' is ignored. Default: true.
|-
| '''binding''' || string || The entity property to bind to, for a '''binding''' uniform. Ignored for other types of uniform.
|-
| '''clamped''' || boolean || For a '''binding''' uniform whose bound property is of type ''float'', setting '''clamped''' to true causes the value to be restricted to the range 0 to 1, inclusive. For a binding of type ''int'', causes the value to be set to either 0 or 1; 1 indicates that the underlying property has any value other than 0. For any other type of uniform, '''clamped''' is ignored. Default: false.
|-
| '''normalized''' || boolean || For a '''binding''' uniform whose bound property is of type ''vector'', setting '''normalized''' to true causes the value to be normalized, that is, scaled to a length of 1. For any other type of uniform, '''normalized''' is ignored. The spelling '''normalised''' is also accepted. Default: false.
|-
| '''type''' || string || One of:
* '''binding''': indicates that the '''binding''' property specifies an entity property to be set dynamically each time the shader is used.
* '''float''' or '''real''': indicates that the '''value''' property is an floating-point number.
* '''int''' or '''integer''': indicates that the '''value''' property is an integer, or whole number.
* '''texture''': indicates that the '''value''' property is an integer specifying a texture unit, that is, an index in the '''textures''' array.
Default: '''float'''.
|-
| '''value''' || number || The value to use for a '''float''', '''int''' or '''texture''' uniform. Ignored for '''binding''' uniforms.
|-
|}

=== Material dictionary example ===
Here is an example from the [[Material Test Suite OXP]]:
materials =
{
"cube-face" =
{
diffuse_map = "oolite_shader_test_suite_7_diffuse.png";
emission_and_illumination_map = "oolite_shader_test_suite_emission_and_illumination.png";
emission_modulate_color = (160, 255, 160);
illumination_modulate_color = (180, 180, 200);
};
};
Here, the “cube-face” material is assigned the diffuse texture “oolite_shader_test_suite_7_diffuse.png” and a combined emission and illumination map (which is a greyscale+alpha texture). The emission and illumination components are then given coloured tints (slightly green and slightly blue, respectively), producing this:

[[File:Oolite Material Test Suite 7.png|320px]]

[[File:Viper Griff Specgloss.png|thumb|right|640px|Griff's SpecGloss Viper]]
== See also ==
* [https://bb.oolite.space/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
:Also contains
* [https://bb.oolite.space/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.
=== 2018 New Materials OXPs ===
* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: Griff's SpecGloss models of the Cobra Mk.1, Mk.3, Gecko, Mamba, Sidewinder & Viper
* [[Normal and Specular+Gloss Maps for Oolite v1.88+]] - a_c's update of Griff's 2013 vanilla game set (ships, stations, asteroids etc.).
: This is now incorporated into Oolive v.1.92 as the new vanilla game set
=== Tools ===
* [[Material Test Suite OXP]] — demonstrates most material properties.
* [[Library OXP]] also has a couple of add-on tools ([[MatFinder]] & DevTools) which enable you to play around with all this and see the effects

[[Category: Oolite]] [[Category:Oolite_scripting]]

Materials in Oolite

2026-08-03T22:24:01Z

Cholmondely: Edited as per a_c's comments

Since v.1.87 (August 2018), more advanced options have become available. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018), the attached update of Oct 2018 and the clarifications of May 2021. Oolite now supports the basic PBR (Physically Based Rendering) materials, using the new Oolite shaders system. The requirements are light energy conservation, a microfacet surface model and a physically based Bidirectional Reflective Distribution Function (BRDF)

{{OXPNote|This page was last properly edited in 2013, well after the introduction of shaders but before [[User:Another commander|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''}}

Traditionally, the surface appearance of ships in Oolite has been defined entirely by textures specified in the ship’s model file and the ''[[#smooth|smooth]]'' attribute. Test release 1.67 added support for [[Shaders in Oolite|shaders]], and test release 1.69 expanded this to a more flexible '''material model'''. Under the new model, the texture file names in model files have been repurposed as '''material keys'''. A material key specifies an entry in the ship’s '''material dictionary''', specified in the ship’s ''[[shipdata.plist]]'' entry. For backwards compatibility, if no material of a given name is found, a material is generated using the material key as a diffuse texture name – providing the same functionality as previous versions of Oolite.

This page documents the material model as of Oolite test release 1.74 (2010), and applies to stable release 1.76 (2011) and later.

== Important concepts ==
The following concepts are important in understanding how materials work and how they interact with lights.
* '''Colour''': Oolite uses a basic low dynamic range lighting model. Colours are considered to be lists of three values, representing red, green and blue colours, each ranging from 0 to 1. These are often encoded as integers ranging from 0 to 255 for technical reasons, but 0 to 1 is the true range of values. There may also be an associated ''alpha channel'', which is traditionally used for blending effects. In shaders, any colour channel can be used for any purpose, and textures often encode values that are not treated as colours.
* '''Fragment''': roughty speaking, an on-screen pixel. When objects are rendered, their geometry is used to generate a fragments, which are then coloured based on lighting and materials.
* '''Modulation''': multiplying two colours together, by channel. For instance, if the calculated light colour for a given fragment is pale yellow – [1, 1, 0.8] – and the corresponding part of the diffuse map is turquoise – [0.2, 0.8, 0.8] – the ''diffuse contribution'' is [0.2, 0.8, 0.64] (a greenish tint). In graphics programs, this blending mode is usually called ''Multiply''.
* '''Additive blending''': adding two colours together, by channel. In Oolite’s low dynamic range lighting model, the result is always clipped to the range 0..1. In graphics programs, this blending mode is usually called ''Lighten''.
* '''Normals''': All lighting calculations require a concept of the orientation of a surface relative to a light and, for reflections, relative to the camera. A surface oriented towards the light will be lighter than a surface oriented away from it. The ''normal'' for any given point on a surface is a vector pointing straight out, which for our purposes ''defines'' the concept of “straight out”. By default, Oolite models have constant normals across each face. By setting the <code>smooth</code> attribute in [[shipdata.plist]], normals are instead interpolated across each face, with each vertex having a normal that is a weighted average of surounding faces’ normals, and each point on a surface getting a weighted average of the normals at the corners of the face. Using ''smooth groups'', a model can be divided into regions which are smoothed but have sharp boundaries between them. As of Oolite 1.74, models can also include explicit per-vertex normals instead of having Oolite calculate them – most 3D modellers export this information. When using smoothing, it is important to understand that Oolite does not add any geometry,and will result in each vertex being lit as if it is locally flat. This is generally inappropriate for any sharp corner. If you set <code>smooth</code> on a basic cube, the result will be badly lit.
* '''Diffuse reflection''': light that is reflected evenly in all directions. A “dull” surface primarily reflects diffusely. Because the light is reflected evenly in all directions, the diffuse term is independent of the camera position; it is a function of the light and the surface normal. The standard diffuse reflection term is the cosine of the angle between the direction to the light and the normal, or zero if this is negative – this is known as the [http://en.wikipedia.org/wiki/Lambertian_reflectance Lambertian reflectance model]. This value is then modulated with the material’s diffuse colour and diffuse map.
* '''Specular reflection''': light that is reflected in a particular direction, producing a shiny effect. In real life, this is simply a mirror reflection which is generally darkened and blurred, leaving an enlarged, blurry reflection of bright light sources, with other objects being washed out so they aren’t noticeable. In Oolite, a simpler mathematical model called the [http://en.wikipedia.org/wiki/Blinn–Phong_shading_model Blinn-Phong shading model] is used. [http://www.youtube.com/watch?v=76jvMmV1ih0 This video] demonstrates the effects of specular lighting and specular mapping on the built-in scarred alloy model.

== The material dictionary ==
The '''material dictionary''' is actually specified as two separate dictionaries in the ''shipdata.plist'' entry. The first is called ''materials'', the second ''shaders''. If [[Shaders in Oolite|shader support]] is available and enabled, the entries in ''shaders'' are used in preference to those in ''materials''. Otherwise, ''shaders'' is ignored. The entries in the two dictionaries take exactly the same form, however; it is possible to specify a shader in the ''materials'' dictionary, and it will simply be ignored if shader support is not available. The ''materials'' and ''shaders'' dictionaries, merged together, are known as a ''material dictionary''.

=== Material specifiers ===
The material dictionary is a [[property list]] dictionary whose keys are ''material keys'' as defined below, and whose values are '''material specifiers''', which are either dictionaries or strings. When a string is used as a material specifier, it is equivalent to a dictionary with that string as the value for '''diffuse_map''', and no other properties. Currently-supported material specifier keys are listed here; “texture specifier” and similar are defined below.

Most of these keys have no effect when a custom shader is in effect.

When shaders are disabled or not available, emission and illumination maps are supported only if reduced detail is disabled and the graphics hardware supports multi-texturing. If '''emission_modulate_color''', '''illumination_map''', or '''emission_and_illumination_map''' are used, Oolite must combine them into a single emission map. It is generally preferable to do this in advance (by modulating the illumination map with the diffuse map and blending it additively with the emission map, after applying any colouring). This is more efficient when using shaders, too.

{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ General material attribues
! Name !! Type !! Description
|-
| '''ambient_color''' || [[#Colour specifiers|colour specifier]] || The ambient colour of the entity, that is, the colour reflected evenly in all directions by starlight. If there is a '''diffuse_map''', the '''ambient_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_color''' || [[#Colour specifiers|colour specifier]] || Overall diffuse colour of the entity; that is, the colour reflected in a “non-shiny” way on the sunlit side of the entity. If there is a '''diffuse_map''', the '''diffuse_color''' is modulated by the '''diffuse_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''diffuse_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the basic colour of the material. This is a “normal” texture, the same as you get without a material dictionary. If not specified, the material key will be used. To specify no texture, use an empty string for '''diffuse_map'''. Ignored when using shaders.
|-
| '''emission_color''' || [[#Colour specifiers|colour specifier]] || The emitted (glow) colour of the material. This is ignored when '''emission_map''' is in use (but see also: '''emission_modulate_color'''). Default: black (0.0, 0.0, 0.0, 1.0).
|-
| '''emission_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying emission (glow) colours. This is blended additively with all other colour terms. If '''emission_modulate_color''' is specified, the emission map is modulated by the modulate colour. Emission maps are used when shaders are active, and without shaders on supported hardware.
|-
| '''emission_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''emission_map'''. If the emission map is in full colour, it is best to apply the colouring in advance using a graphics program. However, if the emission map is a single colour, using a greyscale emission map and a modulate colour will reduce memory usage by a factor of four when shaders are in use. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''emission_and_illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture whose RGB channels act like '''emission_map''', and whose alpha channel acts like '''illumination_map''' (and can be coloured with '''illumination_modulate_color'''). This uses less memory (on systems with shaders) than using separate shaders, although blending the emission and illumination maps into a single emission map, as described above, is still preferable.
|-
| '''illumination_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying local illumination colour, which is added to incoming light. It differs from an emission map in that it is modulated with the diffuse colour before being added to the final colour. See example below.
|-
| '''illumination_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''illumination_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''normal_map''' || [[#Texture specifiers|texture specifier]] || A texture modifying [[#Important concepts|normals]]. The red, green and blue channels are the x, y and z coordinates of normals relative to the underlying normal (“[http://en.wikipedia.org/wiki/Normal_mapping tangent-space normal mapping]”), and the alpha channel is ingored. This is only used when shaders are active and no custom shader is used.
|-
| '''normal_and_parallax_map''' || [[#Texture specifiers|texture specifier]] || Like '''normal_map''', except that the alpha channel is includes a depth value used to add [http://en.wikipedia.org/wiki/Parallax_mapping simulated perspective]. If specified, '''normal_map''' is ignored.
|-
| '''parallax_bias''' || number || A value added to the parallax component of '''normal_and_parallax_map''', after multiplying by '''parallax_scale''' (default: 0).
|-
| '''parallax_scale''' || number || A scale factor for the parallax component of '''normal_and_parallax_map''' (default: 0.01). This value is the depth of the parallax map relative to the size of the texture. For instance, a value of 0.01 on a texture 100 metres wide will produce a maximum indentation of 1 metre. High parallax_scale values tend to lead to unacceptable texture distortion and “creeping” artefacts.
|-
| '''specular_color''' || [[#Colour specifiers|colour specifier]] || The colour to use for specular reflection over the entire model when '''specular_map''' is not used. The specular term is added to the diffuse term; for less intense specular highlights, use a darker colour. Default: black (0.0, 0.0, 0.0, 1.0) if '''shininess''' is zero, (0.2, 0.2, 0.2, 1.0) otherwise.
|-
| '''specular_map''' || [[#Texture specifiers|texture specifier]] || A texture specifying the specular highlight colour in its red, green and blue channels, and '''shininess''' in its alpha channel. 1 (fully opaque) means the value of '''shininess''' is used. 0 means a very low shininess is used. This is only used when shaders are active and no custom shader is used.
|-
| '''specular_modulate_color''' || [[#Colour specifiers|colour specifier]] || A colour with which to modulate the '''specular_map'''. Default: white (1.0, 1.0, 1.0, 1.0).
|-
| '''shininess''' || integer || The “tightness” of specular reflection, ranging from 0 to 128. 0 means no specular highlight. 128 is maximally shiny. Default: 128 if '''specular_map''' is used, 10 otherwise. '''Limitation:''' to use different shininess values with '''specular_map''' or '''specular_color''', you must either use the default or use different “shaders” and “materials” dictionaries. This should be fixed for 1.75.
|-
| '''vertex_shader''' || file name || name of GLSL vertex program to use.
|-
| '''fragment_shader''' || file name || name of GLSL fragment program to use.
|-
| '''textures''' || array of [[#Texture specifiers|texture specifier]]s || Textures to use in shader program.
|-
| '''uniforms''' || dictionary of uniform variable specifiers || uniform variables to use in shader program.
|-
|}

==== Illumination mapping vs. emission mapping ====
This image demonstrates the distinction between illumination mapping (top row) and emission mapping (bottom row).

[[Image:Emission-vs-illumination.png]]

=== Colour specifiers ===
'''Colour specifiers''' are used to declare colours in material attribute dictionaries, and in other contexts such as lasers in ''[[shipdata.plist]]''. Colour specifiers take any of several forms:

==== Named colours ====
The simplest form of colour specifier is a string containing a colour name. The following names are supported:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Colour names
! Name !! RGBA value
|-
| blackColor || 0, 0, 0, 1
|-
| darkGrayColor || 1/3, 1/3, 1/3, 1
|-
| lightGrayColor || 2/3, 2/3, 2/3, 1
|-
| whiteColor || 1, 1, 1, 1
|-
| grayColor || 1/2, 1/2, 1/2, 1
|-
| redColor || 1, 0, 0, 1
|-
| greenColor || 0, 1, 0, 1
|-
| blueColor || 0, 0, 1, 1
|-
| cyanColor || 0, 1, 1, 1
|-
| yellowColor || 1, 1, 0, 1
|-
| magentaColor || 1, 0, 1, 1
|-
| orangeColor || 1, 1/2, 0, 1
|-
| purpleColor || 1/2, 0, 1/2, 1
|-
| brownColor || 0.6, 0.4, 0.2, 1
|-
| clearColor || 0, 0, 0, 0
|-
|}

==== RGBA tuples ====
Colours may also be specified in RGB or RGBA (red, green, blue, alpha [transparency]). RGB or RGBA tuples may be specified as arrays or as strings separated by spaces. The values may range from 0 to 1 or 0 to 255. (If no value is greater than 1, 0–1 is assumed, otherwise 0–255.) Examples:
* <code>"1 1 0"</code> — yellow
* <code>"0 128 0 128"</code> — medium green at 50% opacity
* <code>(1, 0, 0)</code> – red

==== RGBA dictionaries ====
Just in case you’re unsure of the order the RGB[A] components come in, you can use a dictionary:
{
blue = 0.8;
green = 0.8;
}
Accepted keys are '''red''', '''green''', '''blue''' and '''alpha''' (or '''opacity'''), all optional (default: 0.0 for red, green and blue, 1.0 for alpha).

==== HSBA dictionaries ====
But wait, there’s more! Colours may also be specified as dictionaries in the [http://en.wikipedia.org/wiki/HSB_colour_space HSB colour space]. Accepted keys are '''hue''' (hue angle in degrees, required), '''saturation''', '''brightness''' (or '''value''') and '''alpha''' (or '''opacity'''). The default for the optional keys is 1.0.
{
// Pale magenta
hue = 300;
saturation = 0.3;
}

=== Texture specifiers ===
'''Texture specifiers''' are used to, er, specify textures. The simplest form of texture specifier is a string: <code>"ahruman-example-texture.png"</code>. The very simplest texture specifier is the empty string, <code>""</code>, meaning no texture. More complex texture specifiers are dictionaries, which can be used to specify a number of texture options.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''anisotropy''' || real || The degree of [http://en.wikipedia.org/wiki/Anisotropic_filtering anisotropic filtering] to use. Anisotropic filtering is used to reduce blurriness of MIP mapped textures shown at an angle (and thus only applies to textures whose '''min_filter''' is '''mipmap''' or '''default'''). The '''anisotropy''' setting is multiplied by the maximum anisotropy level specified by the system, and anisotropic filtering is used only if the result is greater than 1. (For example, on a GeForce FX 5200 card, the maximum level is 8, so an anisotropy value of 0.5 means an effective anisotropic filtering strength of 4. The precise meaning of this number is hardware-dependant. Fun, eh?) Anisotropic filtering is disabled in Reduced Detail mode and is not available on all hardware. Default: 0.5.
|-
| '''cube_map''' || boolean || If this is true, and the texture file is six times as high as it is wide, the texture will be treated as a cube map. If cube maps are not supported, it will be converted to a latitude/longitude map; if used as a diffuse map or emission/illumination map, you must ensure the model has appropriate texture coordinates. Note that cube maps are always available if shaders are supported, so custom shaders do not need to worry about this.

'''cube_map''' is always true for planet textures. To convert textures to and from cube maps, see [[planettool]].
|-
| '''extract_channel''' || string || Indicates that one of the channels of the texture should be extracted into a new greyscale texture. Allowed values: '''r''', '''g''', '''b''' and '''a'''.

This obviously involves extra work for Oolite, which is always a bad thing, but it makes it possible to combine multiple effect maps in a single texture for shaders and then extract channels for use as emission or illumination maps without shipping a redundant texture. If this means nothing to you, you probably don’t want to use '''extract_channel'''.
|-
| '''mag_filter''' || string || Specifies how to scale up the texture when it is near the camera. Either of:
* '''nearest''' (use nearest-neighbour sampling, which produces a pixellated effect)
* '''linear''' (use linear interpolation, which produces a blurry effect).
Default: '''linear'''.
|-
| '''min_filter''' || string || Specifies how to scale down the texture when it is far from the camera. One of:
* '''nearest''': nearest-neighbour sampling; generally very ugly, but sometimes useful for shaders using textures for special purposes.
* '''linear''': efficient, but rather ugly for textures with significant contrast or details.
* '''mipmap''': use trilinear MIP map filtering to improve scaling quality; generally also fast and least ugly, but uses 1/3 more memory, potentially slowing down systems with limited RAM or video memory.
* '''default''': '''linear''' in reduced detail mode, otherwise '''mipmap'''.
Default: '''default'''.
|-
| '''name''' || string || The file name of the texture to use. Must be a PNG image, in the Textures folder of Oolite or an OXP. In the specific case of '''diffuse_map''' textures, '''name''' is implicitly the same as the material key; to use no texture, you must specify <code>diffuse_map = ""</code>.
|-
| '''no_shrink''' || boolean || Indicates that Oolite should not scale the texture down, except to meet hardware requirements. Default: false.
|-
| '''repeat_s''' || boolean || Whether Oolite should repeat the texture in the ''s'' (or ''u'') co-ordinate, rather than clamping it. Default: false.
|-
| '''repeat_t''' || boolean || Whether Oolite should repeat the texture in the ''t'' (or ''v'') co-ordinate, rather than clamping it. Default: false.
|-
| '''texture_LOD_bias''' || real || tweak factor for MIP mapping (which does not apply to other '''min_filter''' modes). MIP mapping involves a trade-off between scaling artefacts and blurriness; the LOD (level of detail) bias affects this. Positive values mean more blur, negative ones mean more artefacts. The default value is −0.25 (mostly so people won’t say “hey, why is everything blurrier in the new Oolite?”). Texture LOD bias is not available on all hardware.
|-
|}

=== Uniform specifiers ===
:''Main article: [[Shaders in Oolite: uniforms]]''
A ''uniform specifier'' is used to specify game information to pass to a [[Shaders in Oolite|shader program]]. As with [[#Texture specifiers|texture specifiers]], the simple case is a string, which is treated as <code>{ binding = "the string" }</code>. For instance, uHullHeatLevel = hullHeatLevel</code> will bind a shader’s <code>uHullHeatLevel</code> uniform to a ship’s <code>hullHeatLevel</code> property. Additional properties can be specified in a dictionary.
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Texture specifier attributes
! Name !! Type !! Description
|-
| '''asMatrix''' || boolean || For a '''binding''' uniform whose bound property is of type ''quaternion'', setting '''asMatrix''' to true causes the value to be converted to a rotation matrix. If '''asMatrix''' is false, the quaternion will be converted to a vector, whose w, x, y and z values match those of the quaternion. For any other type of uniform, '''asMatrix''' is ignored. Default: true.
|-
| '''binding''' || string || The entity property to bind to, for a '''binding''' uniform. Ignored for other types of uniform.
|-
| '''clamped''' || boolean || For a '''binding''' uniform whose bound property is of type ''float'', setting '''clamped''' to true causes the value to be restricted to the range 0 to 1, inclusive. For a binding of type ''int'', causes the value to be set to either 0 or 1; 1 indicates that the underlying property has any value other than 0. For any other type of uniform, '''clamped''' is ignored. Default: false.
|-
| '''normalized''' || boolean || For a '''binding''' uniform whose bound property is of type ''vector'', setting '''normalized''' to true causes the value to be normalized, that is, scaled to a length of 1. For any other type of uniform, '''normalized''' is ignored. The spelling '''normalised''' is also accepted. Default: false.
|-
| '''type''' || string || One of:
* '''binding''': indicates that the '''binding''' property specifies an entity property to be set dynamically each time the shader is used.
* '''float''' or '''real''': indicates that the '''value''' property is an floating-point number.
* '''int''' or '''integer''': indicates that the '''value''' property is an integer, or whole number.
* '''texture''': indicates that the '''value''' property is an integer specifying a texture unit, that is, an index in the '''textures''' array.
Default: '''float'''.
|-
| '''value''' || number || The value to use for a '''float''', '''int''' or '''texture''' uniform. Ignored for '''binding''' uniforms.
|-
|}

=== Material dictionary example ===
Here is an example from the [[Material Test Suite OXP]]:
materials =
{
"cube-face" =
{
diffuse_map = "oolite_shader_test_suite_7_diffuse.png";
emission_and_illumination_map = "oolite_shader_test_suite_emission_and_illumination.png";
emission_modulate_color = (160, 255, 160);
illumination_modulate_color = (180, 180, 200);
};
};
Here, the “cube-face” material is assigned the diffuse texture “oolite_shader_test_suite_7_diffuse.png” and a combined emission and illumination map (which is a greyscale+alpha texture). The emission and illumination components are then given coloured tints (slightly green and slightly blue, respectively), producing this:

[[File:Oolite Material Test Suite 7.png|320px]]

[[File:Viper Griff Specgloss.png|thumb|right|640px|Griff's SpecGloss Viper]]
== See also ==
* [[Material Test Suite OXP]] — demonstrates most material properties.
* [[Library OXP]] also has a couple of add-on tools ([[MatFinder]] & DevTools) which enable you to play around with all this and see the effects
* [https://bb.oolite.space/viewtopic.php?p=285081#p285081 Specular Maps Alpha channel]: more by a_c_ (2022)
* [https://bb.oolite.space/viewtopic.php?f=4&t=21170 griff SpecGloss ships]: some q's & a's about colour corrections (2022)
:Also contains Griff's SpecGloss models of the Cobra Mk.1, Gecko, Mamba, Sidewinder & Viper
* [https://bb.oolite.space/viewtopic.php?p=293033#p293033 Is there a (shipdata) variable with which I can reduce the amount of influence an emission or illumination map has?] (2023) Answers involve using the varieties of "_modulate_color" listed above - and shows an example of what happens.

[[Category: Oolite]] [[Category:Oolite_scripting]]

Griff Industries

2026-08-03T22:18:49Z

Cholmondely: /* Griff's Ship Sets */ Added a_c's suggestions

== About ==

Griff produced some fantastic models of ships, using normalmapping and shaders to produce some of the best-looking ships available in Oolite. All vanilla-game ships and stations are supported.

== Gallery ==
<center>
{| align=center width=100% style="background: black;"
| [[Image:Griff_adder.jpg |link=Adder (Oolite) |200px]]
| [[Image:Griff_anaconda.jpg |link=Anaconda (Oolite) |200px]]
| [[Image:Griff_asp_mk2.jpg |link=Asp (Oolite) |200px]]
| [[Image:Griff_missile.jpg |link=Missile |200px]]
|-
| [[Image:Griff_asteroid.jpg|link=Asteroid_(Oolite) |200px]]
| [[Image:Griff_boulder.jpg‎ |link=Boulder_(Oolite) |200px]]
| [[Image:Griff_splinters.jpg‎|link=Splinters_(Oolite) |200px]]
| [[Image:Griff_alloy.jpg‎ |link=Metal_Fragment_(Oolite) |200px]]
|-
| [[Image:Griff_boa.jpg |link=Griff Boa |200px]]
| [[Image:Griff_boa_screenshot2.jpg |link=Boa (Oolite) |200px]]
| [[Image:Griff_boa_mk2.jpg |link=Boa 2 Class Cruiser |200px]]
| [[Image:Griff_barrel.jpg |link=Cargo Container (Oolite) |200px]]
|-
| [[Image:Griff_cobra_mk1.jpg |link=Cobra Mk.1 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3_scuffed.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff cobra mk3 alt.jpg |link=Cobra Mk.3 (Oolite) |200px]]
|-
| [[Image:Griff_constrictor.jpg |link=Constrictor_(Oolite) |200px]]
| [[Image:Griff_coriolis_alt.jpg |link=Alternative Coriolis station (Oolite) |200px]]
| [[Image:Griff_ico.jpg |link=Icosahedron_Station_(Oolite) |200px]]
| [[Image:Griff_dodo_thumbnail.jpg |link=Dodo station (Oolite) |200px]]
|-
| [[Image:Griff_fer-de-lance_blinged.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_fer-de-lance_scuffed.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_gecko_sharkteeth.jpg |link=Gecko (Oolite) |200px]]
| [[Image:Griff_gecko.jpg |link=Gecko (Oolite) |200px]]
|-
| [[Image:Griff_krait.jpg |link=Krait (Oolite) |200px]]
| [[Image:Griff-krait.jpg |link=Griff Krait |200px]]
| [[Image:Griff_mamba.jpg |link=Mamba (Oolite) |200px]]
| [[Image:Griff_moray.jpg |link=Moray Star Boat (Oolite) |200px]]
|-
| [[Image:Griff_python.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_python_alternative.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_Rock_Hermit.jpg |link=Rock Hermit (Oolite) |200px]]
| [[Image:Griff_escape_capsule.jpg |link=Escape Pod |200px]]
|-
| [[Image:Griff_sidewinder.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_sidewinder_alternative.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_shuttle.jpg |link=Shuttle (Oolite) |200px]]
| [[Image:Griff_transporter.jpg |link=Transporter (Oolite) |200px]]
|-
| [[Image:Griff_thargoid.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_thargoid_organic.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_Thargon.png |link=Thargoid Robot Fighter (Oolite) |200px]]
| [[Image:Griff_tharglet_organic2.jpg |link=Thargoid Robot Fighter (Oolite) |200px]]
|-
| [[Image:Griff_viper.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_viper_interceptor.jpg |link=Viper Interceptor |200px]]
| [[Image:Griff_viper_pursuit.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_worm.jpg |link=Worm (Oolite) |200px]]
|-
| [[Image:Sainsboorys.png |link=Your Ad Here! |250px]]
| [[Image:Griff_dodo.png |link=Dodo station (Oolite) |200px]]
| [[Image:Griff Elite2 bug.jpg |Bug ship from an Elite 2 that didn't get made |200px]]
| [[Image:Griff_wolf_mkII.jpg |link=Wolf_Mk.2_(Oolite)|200px]]
|-
| [[Image:Griffhognose.jpg |link=Hognose |250px]]
| [[Image:Griff_viper_alt_wiki.jpg |link=Viper_(Oolite) |250px]]
| [[Image:Griff ophidian.jpg|link=Ophidian_(Classic) |250px]]
| [[Image:Griff elite2 griffin mk1.jpg|link=Griffin_Two_(Oolite) |250px]]
|-
| [[Image:Griff gnat.jpg |link=Classic_Elite_ships |250px]]
| [[Image:Griff Viper interceptor alt.jpg |link=Viper Interceptor |250px]]
|}
</center>
 
----
== Griff's Ship Sets ==
There are ''four'' sets of Griff ships!
*The Vanilla game ships in Oolite v.1.92 and later
::2026
:These are taken from the [[Oolite v1.88 Base Shipset Normal and Specular/Gloss Maps]] OXP. They are the exact versions of this OXP on the Expansions Manager with support for '''PBR''' (Physically Based Rendering) materials, using the new Oolite shaders system.
:'''PBR''' has been progressively introduced with Oolite versions 1.88, 1.90 & 1.92. The basic PBR requirements are light energy conservation, microfacet surface modelling and a physically based Bidirectional Reflective Distribution Function (BRDF)
*The Vanilla game ships in Oolite v.1.90 and earlier
::2013
:These are simplified versions of Griff's OXPs on the Expansions Manager
*The OXPs on the Expansions Manager (excluding the "specials" such as Griff Clippers, Griff Prototype Boa, Griff's Glowroids ''etc''.)
::2013
:These do not have specular maps, but do have normal maps. These ship models are more complex - and the textures and the shaders are ''much'' more complex. But they use the older Oolite shaders system.
:They also have special effects: more realistic exhausts, running lights and emergency lights (which dim when power is low), the Thargoids have special reflecting hulls, ''etc''.
*The unfinished very high poly "SpecGloss" series (only the SpecGloss Sidewinder is on the Expansions Manager - the other ships are on Box.com - see below).
::In Progress (2022 - date)
:These resemble Griff's OXPs but with much much more detail - and adding in '''PBR''' materials. They also use the newer Oolite shaders system. See [https://drive.google.com/drive/folders/1_8EtoVvwNyXXvqe5GCGy1HuFRRw3NxB7?usp=sharing here] for downloads.
----

== Griff's "Expansions Manager" Downloads ==
All these ships are available in the Oolite [[Expansions Manager|Expansion Pack Manager]].

=== "Retextured" ship OXPs ("Normalmapped") ===
:These constitute the third set mentioned above. These OXPs were created when normal mapping (allowing "bumps" and other such) was added into Oolite.
*'''Griff's Normalmapped Ships (Replace):'''
:'''Note''': Spara's rebalanced bundle 'Meta-OXZ'. Available via the Oolite Expansion Pack manager, provides a single click install for all the Griff core shipset ships, bugfixed and rebalanced for better gameplay! This expansion pack is highly recommended over installing the shipset ships individually

*'''Griff Adder, Griff Alloys and Wreckage, Griff Anaconda, Griff Asp, Griff Asteroids, Griff Boa, Griff Boa MkII, Griff Cargopod, Griff Cobra MkI, Griff Cobra MkIII, Griff Cobra MkIII Alt, Griff Constrictor, Griff Escape Capsule, Griff Ferdelance, Griff Gecko, Griff Krait, Griff Mamba, Griff Mamba Alternative, Griff Missiles, Griff Moray, Griff Python, Griff Shuttle, Griff Sidewinder, Griff Station Bundle, Griff Thargoids, Griff Transporter, Griff Viper, Griff Worm
:The individual ship OXPs included in "Griff's Normalmapped Ships (Replace)" but with minor bugs in places.

=== Other OXPs ===
*Griff Shipset Decals - this OXP is for adding Decals to Griff's ships (and is needed by his OXPs). See [[Decal]] for more on this

*Griff Clippers - Griffifies the Boa Clipper and Python Clipper from Smivs' earlier [[Clippers]] OXP
*[[Griff Boa|Griff Prototype Boa]] - the famous, utterly different "Griff Boa" - as below, under "Other OXPs"
*[[Griff's Glowroids]] - massive asteroids with a difference!

=== Relevant resources not on the Expansions Manager ===
* '''Resources''' - ''Not needed for gameplay'' - this folder contains various ship meshes and textures in .obj and .png format for interested modders
:[https://app.box.com/shared/rpkms25cc9 ''Griff Ship Downloads''] on Box.com
----
== Griff's Other OXPs ==
[http://app.box.com/shared/jf1et41yu3 ''Dodo Stations OXP by Griff and CaptKev''] (1.4Mb). 
Retextured Dodecahedron stations OXP, v1.1. Updated version released 18th May 2010, Griff has fixed a problem with the shaders.

''[[Flying Dutchman OXP]]'' (31.0Kb). 
Featuring Griff's Wireframe Cobra. 
Adds the small chance to meet a Ghost Ship in the Ooniverse. What is it? Some claim that it's the ghost of Commander Peter Jameson, reported lost at the end of the last Thargoid War, others that it is simply a manifestation of all those lost souls who were trapped in the trackless depths of interstellar space. One common story is the trail of bad luck and hideous deaths that follow in the wake of the ship's sightings...

[[Griff ArcElite|''Griff's ArcElite'']] (201.2 Kb). 
Adds all the ships from the Acorn Archimedes version of Elite, textured & shaded to resemble how they originally appeared in that version of the game.
Version 2.0 adds extra ships from Elite 'A', Elite 2 and the Amiga version of Elite

[[Griff Boa|''Griff's Boa OXP'']] (2.7Mb). 
Wiki link containing the famous Griff Boa, as featured in the ''"Oolite - It's not just for triangles anymore"'' images. Note: the Boa is not included in the ''Normalmapped Ships OXP'' as above. Note also that this OXP only works on Oolite 1.74 and higher.

[[Griff Krait|''Griff's Krait OXP'']] (2.5Mb). 
A heavily modified Krait, similar in design to the Griff Boa. Note: ''this'' Krait is not included in the ''Normalmapped Ships OXP'' as above.

[https://www.box.com/s/162d02b7e79b1202689c ''Griff's Alloys & Wreckage OXP''] (1.5mb). 
Box.com link to an OXP for Oolite v1.75 and higher that adds a new models & texture for the 'Alloys'. The OXP also generates extra clouds of burning wreckage whenever ships explode. This OXP was updated on 24th March 2013 for more compatibility with the Griff Normalmapped Ships, Replacement version, and should be used in preference to the old ''Griff's Explosion Debris OXP''.

There are other non-normal mapped OXPs linked in Griff's "Complete Catalogue" beneath.
----
== OXPs using Griff's ships ==

[http://app.box.com/shared/t3n98yhk6n ''Illicit Unlock - Griff Version''] by ADCK (3.5Kb). 
Based on the original Illicit Unlock, Allows the player to fly Griffs pirate/viper Ships. (Requires ''Griff's Normalmapped Ships, above'' )

Bugfixed and updated files for the oxp by Dertien (requires overwriting files in ADCK's original oxp) - [http://app.box.com/shared/jq8biuf21o ''Download'']

[[Black_Monk_Monastery|''Bank of the Black Monks'']] by LittleBear. The station and Gunships are Griff's.

''[[Random Hits OXP]]''. 
Featuring many Ships/Stations made by Griff.

[[Your_Ad_Here!|''Your Ad Here! OXP'']]. 
Featuring Griff's Tradestations.

[[Staer9%27s_Shipset|''Staer9's Shipset'']]. 
Adds more ships based on Griffs models.

[https://bb.oolite.space/viewtopic.php?f=4&t=9306 ''ZGrOovy Griff System Stations OXP''] by Dertien (on the Oolite BB). 
Using Griff's station textures, adds five new model stations, from the small Tetrahedron and Octahedrons, through the standard sized Coriolis, to the large Dodecahedron and Icosahedron stations. 

----
== Lore ==
Added by [[The Assassins Guild OXP]]

The [[Sector7/Ateslete|Ateslete]] system in galaxy 7 is reasonably noted for the ice-world, Stymphal. The well known robotics company, '''Griff Research Ltd''', operates factories over most of the planet and maintains an orbital research station near Stymphal.

The company was originally founded to produce droids and other artificial life forms, enjoying much success winning the coveted “Which Droid?” award for a decade. Perhaps their most famous design was the [[Griff Robotic Cargo Loader|Robotic Cargo Loader]] which is still in service in all sectors. In recent years the company has diversified into building high specification ships and stations to order. Examples of their known designs include providing the Bank of the Black Monks of St Herod with a fearsome [[Black Monk Monastery|armed orbital platform]] and the [[Black Monk Gunship|Holy Avenger Mark II Tri-Laser Gunship]].

The company's main ship design work is however highly classified, their most regular client being the [[Galactic Navy]]. Griff Research Ltd has constructed several Frigate Class vessels for the Navy, in addition to new types of weapons. No further details are available, although it is rumored that the Company is returning to its roots as a robotics company, in a current design brief.

----
== Complete Catalogue of Griff's oeuvre (2006 - date) ==
See here: [[User:Griff/OXP Catalogue‎]] for an attempt at this (not fully formatted yet)

{{Retextures-OXP}}
{{Ship-OXP}}

[[Category:Griff Industries| ]]

Shaders in Oolite

2026-08-03T22:06:59Z

Cholmondely: Added a_c's "update" synopsis

Update!
* The first major shader revision occurred with Oolite v1.88 (2018) with the introduction of materials supporting Physically Based Rendering (PBR).
The basic PBR requirements are light energy conservation, microfacet surface model and physically based Bidirectional Reflective Distribution Function (BRDF)
* Shaders changed further in Oolite v1.90 (2020) with the addition of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
* Shaders changed again in Oolite v1.92 (2026) with a reworked renderer combining all the above plus adoption of PBR for all core ships and planets, full post-processing effects support including FXAA, specular anti-aliasing, HDR output support (Windows only), multiple tonemapper options both for SDR and HDR, optional alternative Burley diffuse light model and more.

'''''This page was written by Ahruman between 2007-10 
'''''See also:''' [[Materials in Oolite]]''

'''Shaders''' are programs which run on a graphics processing unit. They provide a more flexible alternative or supplement to textures for specifying objects’ appearance. There are two widely-used types of shader, '''vertex shaders''' and '''fragment shaders''' (also known, less accurately, as '''pixel shaders'''), which are generally used in combination. Shaders can be implemented in a number of special-purpose programming languages; [[Oolite]] uses the '''[http://en.wikipedia.org/wiki/GLSL OpenGL Shading Language]''', also known as '''GLslang''' or '''GLSL'''.

Shaders are supported in Oolite 1.67 for Mac OS X and later, and from 1.68 on other platforms. However, the shader support is still evolving. This page currently documents the state in Oolite 1.72.

This page was last worked on in 2010.

== Specifying shaders ==
Shaders are specified in a dictionary named ''shaders'' in the ship’s definition in ''[[shipdata.plist]]''. The keys of this dictionary are names of textures used in the ship’s or entity’s .dat file, and the values are dictionaries specifying shaders to use instead. The elements are:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ ''shaders'' dictionary values
! Name !! Type !! Description
|-
| ''textures'' || array of strings || A list of textures used by the shader.
|-
| ''vertex_shader'' || string || The name of a vertex shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
|-
| ''fragment_shader'' || string || The name of a fragment shader file to use. Oolite will search the Shaders folder of all installed OXPs for a shader of the appropriate name. (Requires Oolite 1.68 or later.)
|-
| ''uniforms'' || dictionary || Uniforms to pass to the shaders.
|}

== An example ==
A full explanation of GLslang is beyond the scope of this article, but for illustrative purposes, here is an overview of the fragment shader code in the [[Freaky Thargoids OXP|Freaky Thargoids]] example OXP.

=== Vertex shader ===
This vertex shader, like many vertex shaders, exists primarily to prepare information for the fragment shader.
<pre>varying vec3 v_normal;

void main()
{
v_normal = normalize(gl_NormalMatrix * gl_Normal);

gl_TexCoord[0] = gl_TextureMatrix[0] * gl_MultiTexCoord0;
gl_Position = ftransform();
}
</pre>
The first line declares a '''varying variable'''. This may sound like an oxymoron, but varying variables have the special property that they are interpolated across geometry and passed to the fragment shader. For instance, if you set a varying variable to red at one corner of a triangle, green at a second corner, and blue at the third, the colour as seen by the fragment shader will vary smoothly across the triangle: 
[[Image:Glsl varying demo.png]] 
This is followed by the function <code>main()</code>, which is the function that will be called by the GPU for each vertex. This sets the varying normal (direction facing out from the surface), and performs additional set-up required for positions and texture co-ordinates to make sense in the fragment shader.

=== Fragment shader ===
A fragment shader is called for each fragment of a generated polygon. A '''fragment''' is a pixel, in screen space, on which the polygon is potentially visible. (It is ''potentially'' visible because the shader may discard the fragment, and later polygons which are closer to the camera may draw over it.)
<pre>// Information from Oolite.
uniform sampler2D tex0;
uniform sampler2D tex1;
uniform float time;

// Information from shipdata.plist.
uniform float reciprocalFrequency;

// Information from vertex shader.
varying vec3 v_normal;

float wave(float t)
{
return sin(t * 6.28318530718) * 0.5 + 0.25;
}

#define LIGHT(idx) \
{ \
vec3 lightVector = normalize(gl_LightSource[idx].position.xyz); \
color += gl_FrontMaterial.diffuse * gl_LightSource[idx].diffuse * max(dot(v_normal, lightVector), 0.0); \
}

void main(void)
{
// Calculate illumination.
vec4 color = gl_FrontMaterial.ambient * gl_LightSource[0].ambient;
// LIGHT(0);
LIGHT(1);

// Load texture data
vec2 texCoord = gl_TexCoord[0].st;
vec4 colorMap = texture2D(tex0, texCoord);
vec4 glowMap = texture2D(tex1, texCoord);

// Multiply illumination by base colour
color *= colorMap;

// Calculate glow intensity
float t1 = reciprocalFrequency * time + glowMap.a;
float lightLevel = wave(t1);

// Add glow.
color += lightLevel * glowMap;

gl_FragColor = vec4(color.rgb, 1.0);
}
</pre>

The first section declares several ''uniform variables'', which are used to pass information from Oolite to the shader. The two <code>sampler2D</code> variables are used to read from the two textures used by the shader. The <code>float</code> variable <code>timer</code> is a number which increases by 1.0 each second. The <code>float</code> <code>reciprocalFrequency</code> is set in <code>shipData.plist</code>; this allows a shader to be used for different ships (or different shaders on the same ship) with small variations. Uniform variables can only be read, not written to.

The <code>varying</code> declaration is the same as in the vertex shader, but fragment shaders can only read varying variables, not write to them.

The custom function <code>wave()</code> is used to smoothly vary the glow map from on to off.

This is followed by a macro definition, <code>LIGHT</code>. A macro is substituted into the code each time it occurs; in <code>main()</code>, <code>LIGHT(0)</code> and <code>LIGHT(1)</code> will be replaced by the text of the macro definition, with <code>idx</code> in the macro being replaced with 0 or 1 respectively. Ideally, this would be a function, like <code>wave()</code>, but for technical reasons this causes performance problems. Specifically, under Apple’s implementation of GLSL (and probably others), this causes a set of uniforms for every light the graphics card supports to be pulled into the shader.

The last part is the function <code>main()</code>, which is the function executed by the GPU. It first calculates the contribution of light source 1, using the information prepared in the vertex shader and interpolated by the GPU. (Light 0 is used for the demo screen and shipyard; light 1 is the sun, or an arbitrary light source when in witchspace. Future versions of Oolite may change this, though. Ideally, the shader would check light 0, but in current versions of Oolite this causes problems.) It then loads values from the two textures. The first, the colour map value, is simply multiplied by the incoming light. For the second, the glow map, an intensity value is calculated based on the time, the <code>reciprocalFrequency</code> uniform and the alpha channel of the glow map, which specifies animation phase. The glow map is likewise multiplied by its intensity value, and added to the total light. Finally, the combined alpha channel is forced to 1.0, and the result assigned to the special variable <code>gl_FragColor</code>, which determines the colour of the generated fragment.

== Uniforms ==
Uniforms are variables whose value is set by the host application, i.e. Oolite. Oolite automatically supplies one uniform of type <code>sampler2D</code> for each texture, named <code>tex0</code>, <code>tex1</code> etc. It is also possible to bind uniforms to certain properties of the entity the shader is being applied to, for instance, its engine level. Additionally, constant values can be specified for uniforms, allowing a single shader to be used on different entities with differences in configuration.

For more information on uniforms, see [[Shaders in Oolite: uniforms]].

== Macros ==
These preprocessor macros are defined by Oolite and may be used with the <code>#if</code>/<code>#endif</code> directives to selectively remove sections of code.

{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Macros
! Name !! Description
|-
| <code>OO_LIGHT_0_FIX</code>||In current versions of Oolite, light number 0 is effectively always attached to the camera, giving the effect of the player shining a light on anything they’re looking at. When this is fixed, <code>OO_LIGHT_0_FIX</code> will be defined. (Not yet defined in any version of Oolite.)
|-
| <code>OO_REDUCED_COMPLEXITY</code>||Defined if user has selected lower-complexity shaders.
|-
| <code>OO_TEXTURE_UNIT_COUNT</code>||An integer specifying the number of texture units supported by hardware, which is the maximum number of ''tex'''N''''' uniforms that will be meaningful. This should be the same as ''gl_MaxTextureUnits'', but a macro has the advantage that it can be used to completely exclude parts of the shader. (Defined in Oolite 1.69 and later.)
|-
| <code>OO_USER_DEFINED_BINDINGS</code>||Defined to indicate that [[Shaders in Oolite: uniforms|arbitrary uniform bindings]] are available. (Defined in Oolite 1.69 and later.)
|-
| <code>OO_TANGENT_ATTR</code>||Defined to indicate that the <code>tangent</code> vertex attribute is available. (Defined in Oolite 1.73 and later.)
|}

== Limitations ==
The current implementation does not provide the information necessary to implement the most common form of [http://en.wikipedia.org/wiki/Normal_mapping normal mapping].

== Links ==
*[[OXP howto texture]] (mostly 2006, but with up-to-date links)
*[https://bb.oolite.space/viewtopic.php?f=4&t=3460 Shader's Outpost thread] (2007-date) with links and downloadable .oxp examples
*[https://bb.oolite.space/viewtopic.php?f=4&t=13815 A request for a simple example of using shaders] (2013)
*[https://www.youtube.com/watch?v=hWeN_66guzg Oolite Crosire's Reshade Tutorial] (2015 YouTube video - by Getafix - using Crosire's Reshade v1.0.0 post-processing injector)

*[https://thebookofshaders.com/ The book of Shaders] - with working examples of complex shaders (2015 - by Patricio Gonzalez Vivo & Jen Lowe)

[[Category:Oolite]]
[[Category:Oolite scripting]]

Shaders in Oolite: uniforms

2026-08-03T22:04:20Z

Cholmondely: Edited as per a_c's suggestions

Update!
* The first major shader revision occurred with Oolite v1.88 (2018) with the introduction of materials supporting Physically Based Rendering (PBR).
The basic PBR requirements are light energy conservation, microfacet surface model and physically based Bidirectional Reflective Distribution Function (BRDF)
* Shaders changed further in Oolite v1.90 (2020) with the addition of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
* Shaders changed again in Oolite v1.92 (2026) with a reworked renderer combining all the above plus adoption of PBR for all core ships and planets, full post-processing effects support including FXAA, specular anti-aliasing, HDR output support (Windows only), multiple tonemapper options both for SDR and HDR, optional alternative Burley diffuse light model and more.

:The information presented on ''this'' page applies to Oolite test release v.1.69 (2007) and later. It was last added to by somebody ''knowledgeable'' in 2016

A '''uniform''' in a [[Shaders in Oolite|shader]] is a variable whose value is specified by the host application – in this case, [[Oolite]]. Oolite allows arbitrary uniforms to be specified for shaders applied to ships, and these may either take constant values specified in ''shipdata.plist'', or be “bound” to an attribute of the ship. This allows shader authors to access numerous properties of a game entity without having to ask for them and wait for an updated version of Oolite. ('''Note:''' in the case of subentities, bound properties are fetched from the parent ship.)

=== Basic syntax ===
Uniforms are specified in the ''materials'' or ''shaders'' dictionary of a ship’s ''shipdata.plist'' entry:
"ahruman_shady_cobra_example" =
{
 like_ship = "cobra3-player";
 shaders =
 {
 "cobra3_redux.png" =
 {
 textures = ( "cobra3_redux.png" );
 fragment_shader = "ahruman_shady_cobra_example.fragment";
uniforms =
{
shininess =
{
type = float;
value = 42.0;
};
withinAegis = "withinStationAegis";
compassMode = "compassMode";
}
 }
 }
}
This contrived example declares three uniforms, ''shininess'', ''withinAegis'' and ''compassMode''. ''shininess'' is a constant <code>float</code>; it is always 42. ''withinAegis'' is bound to the ship’s ''withinStationAegis'' property. (See below for information on available properties.) This is a boolean, that is, a number whose value is either 0 (meaning no) or 1 (meaning yes). ''compassMode'' is a binding to the ''compassMode'' property. To use the uniforms within a shader (either a vertex shader or a fragment shader), they are declared as follows:
uniform float shininess;
uniform int withinAegis;
uniform int compassMode;
...
void main(void)
{
if (withinAegis)
{
// Do aegis-specific effect here
}
...
}

=== Uniform property types ===
Every bindable property has a '''type'''. The simplest types, ''int'' and ''float'', correspond directly to the same types in GLSL. Both represent numbers, with the difference that a ''float'' can represent fractional values and very large values, but always has the same level of precision (about six digits), while ''int''s can represent any integer (non-fractional value) in a limited range. A ''bool'' is an integer whose value can be only 0 (meaning no or false) or 1 (meaning yes or true). ('''Note:''' the GLSL specification is deliberately vague on the ranges of the number types. It also points out that most hardware will actually use floating-point calculations for ''int'' variables, which implies that integer calculations will incur rounding overhead.)

The ''vector'' type is translated to a GLSL ''vec4'', whose ''x'', ''y'' and ''z'' components correspond to those of the Oolite vector, and whose ''w'' component is always 1.0.

The ''quaternion'' type can be translated to a ''mat4x4'' representing a rotation matrix, or to a ''vec4'' whose ''x'', ''y'', ''z'' and ''w'' components correspond to those of the Oolite quaternion.

The ''matrix'' type is translated into a GLSL ''mat4x4''.

The ''colour'' type is translated into a GLSL ''vec4'' type, whose ''r'', ''g'', ''b'' and ''a'' components correspond to those of the Oolite colour object.

==== Conversions ====
Several types of binding can be modified by conversion options, specified in the '''uniforms''' dictionary, for example:
haveFuel =
{
binding = "fuel";
clamped = true;
};
The '''clamped''' conversion option, when applied to a property of type ''float'', causes the value to be clamped to the range [0, 1]. When applied to an ''int'' property, any value other than 0 (including negative values) is converted to 1. The default value is ''false''.

The '''normalized''' option causes vector properties to be normalized, that is, scaled so they have the same direction but length 1. The default value is ''false''.

The '''asMatrix''' option causes quaternion properties to be converted to rotation matrix, rather than having their components packed into a ''vec4''. The default value is ''true''.

=== Bindable property reference ===
The following sections list entity properties which can be used in a uniform binding, regardless of apparent usefullness. Note, however, that '''some of these names may change before the next stable release'''.

==== Entity ====
The following properties are available for all entities:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable entity properties
! Name !! Type !! Description
|-
| ''position'' || vector || The location of the entity in system co-ordinates.
|-
| ''orientation'' || quaternion || The orientation of the entity.
|-
| ''relativePosition'' || vector || The location of the entity, relative to the player.
|-
| ''viewpointOffset'' || vector || The location of the current camera, in entity co-ordinates. Although this is defined for all entities, it is only meaningful for the player ship.
|-
| ''collisionRadius'' || float || Together with the ''position'', specifies a sphere completely containing the collidable volume of the entity.
|-
| ''mass'' || float || The mass of the entity.
|-
| ''energy'' || float || The current energy level of the entity.
|-
| ''maxEnergy'' || float || The current maximum energy level of the entity.
|-
| ''universalTime'' || float || The [[Time scales in Oolite#game real time|game real time]] clock. The value is the same for all entities and updates once per frame.
|-
| ''spawnTime'' || float || The [[Time scales in Oolite#game real time|game real time]] at which the entity came into existance.
|-
| ''timeElapsedSinceSpawn'' || float || The number of seconds (in the [[Time scales in Oolite#game real time|game real time]] scale) since the entity came into existance – the difference between ''universalTime'' and ''spawnTime''.
|-
| ''throwingSparks'' || bool || Whether the entity is generating sparks (for instance, a ship about to explode).
|-
| ''fogUniform'' (version 1.83) || vector || Atmosphere colour rgba for applying fog effect. Alpha channel is zero for no fogging to 1 for full fogging.
|-
|}

==== Ship ====
Ships (i.e., anything set up in ''shipdata.plist'', regardless of function) have all the properties of [[#Entity|entities]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable ship properties
! Name !! Type !! Description
|-
| ''isBeacon'' || bool || True if the entity is a beacon.
|-
| ''isFrangible'' || bool || True if the entity is frangible, i.e. subentities can be shot off.
|-
| ''isCloaked'' || bool || True if the entity is cloaked. [b]Note:[/b] a cloaked ship will only be drawn approximately once per ten frames, regardless of shaders.
|-
| ''isJammingScanning'' || bool || True if the ship has an active military jammer.
|-
| ''hasMilitaryScannerFilter'' || bool || True if the ship has a military scanner filter.
|-
| ''messageTime'' || float || Time before a radio message may be sent, in seconds. (This is set to 6.0 seconds when an NPC ship sends a message, and decreases over time.)
|-
| ''groupID'' || int || Unique identifier for the escort group the ship belongs to.
|-
| ''escortCount'' || int || The number of active escorts the ship has.
|-
| ''hasHostileTarget'' || bool || True if the ship has a target and the ship’s current AI behaviour is one of hostile intent.
|-
| ''weaponRange'' || float || Maximum range (in metres) of the ship’s main weapon. [b]Note:[/b] since subentities’ shaders get the parent ship’s properties, this may not work as expected.
|-
| ''scannerRange'' || float || The distance (in metres) in which the ship will scan for enemies.
|-
| ''withinStationAegis'' || bool || True if the ship is within the aegis of the system’s main station.
|-
| ''fuel'' || int || Ship’s fuel level, in tenths of a light year.
|-
| ''flightPitch'' || float || Current pitch rate.
|-
| ''flightRoll'' || float || Current roll rate.
|-
| ''flightYaw'' || float || Current yaw rate. Currently always 0 for NPC ships.
|-
| ''flightSpeed'' || float || Ship’s current speed.
|-
| ''maxFlightSpeed'' || float || Ship’s speed at full throttle. Something of a misnomer – actual speed may be higher using afterburners or hyperspeed.
|-
| ''speedFactor'' || float || ''flightSpeed'' divided by ''maxFlightSpeed''. May be greater than 1.0 (unless [[#Conversions|clamped]] is used).
|-
| ''damage'' || int || ''energy'' expressed as a percentage of ''maxEnergy''.
|-
| ''laserHeatLevel'' || float || The temperature level of the current weapon.
|-
| ''hullHeatLevel'' || float || The temperature level of the hull, due to proximity to stars, atmospheric drag or combat hits. When it reaches 1.0, the ship starts taking damage rapidly.
|-
| ''entityPersonality'' || float || A randomly-generated value in the range 0.0 to 1.0 that stays with the entity for its lifetime. Useful for adding random variations.
|-
| ''entityPersonalityInt'' || float || Same as ''entity_personality'', scaled to the range 0 to 32767.
|-
| ''numberOfScannedShips'' || int || The number of ships within scanner range (but no more than 16).
|-
| ''destination'' || vector || The location, in system co-ordinates, that the AI is trying to fly to. This may not always be meaningful depending on AI state.
|-
| ''rangeToDestination'' || float || The distance in metres between ''position'' and ''destination''.
|-
| ''rangeToPrimaryTarget'' || float || The distance in metres to the AI’s target (i.e., the ship it is trying to shoot). 0 if no target.
|-
| ''laserColor'' || colour || The colour of the ship’s laser.
|-
| ''isHulk'' || bool || True if the ship has been abandoned.
|-
| ''lightsActive'' || bool || True if flashers are turned on, false otherwise.
|-
| ''alertCondition'' (1.77 or later) || int || Current alert condition – 0 for docked, 2 for yellow, 3 for red.
|-
|}

==== Player ship ====
The player ship has all the properties of [[#Entity|entities]] and [[#Ship|ships]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable player ship properties
! Name !! Type !! Description
|-
| ''massLocked'' || bool || True if the ship is too close to a large object to be able to make a witchspace jump.
|-
| ''atHyperspeed'' || bool || True if the ship is at hyperspeed.
|-
| ''velocityVector'' || vector || The ship’s velocity.
|-
| ''dialForwardShield'' || float || The forward shield level, ranging from 0.0 to 1.0.
|-
| ''dialAftShield'' || float || The aft shield level, ranging from 0.0 to 1.0.
|-
| ''dialMissileStatus'' || int || State of selected missile – 0 for safe/no missile, 1 for active, 2 for locked.
|-
| ''dialFuelScoopStatus'' || int || State of cargo scoop – 0 for no scoop installed, 1 for full hold, 2 for idle with space in hold, 3 for actively scooping.
|-
| ''compassMode'' || int || State of advanced space compass – 0 for no advanced space compass installed, 1 for planet mode, 2 for station mode, 3 for sun mode, 4 for target mode, 5 for any beacon. More may be added in future.
|-
| ''activeMissile'' || int || Which missile slot is currently selected, from 0 to ''dialMaxMissiles'' - 1.
|-
| ''dialMaxMissiles'' || int || The number of missile slots on the ship.
|-
| ''dialIdentEngaged'' || bool || True if ident (targeting) mode is active.
|-
| ''alertCondition'' || int || Current alert condition – 0 for docked, 1 for green, 2 for yellow, 3 for red.
|-
| ''trumbleCount'' || int || Number of trumbles with which the player’s ship is infected.
|-
|}
Additionally, all [[Methods#Querying states|state query scripting methods]] ending with ''_number'' may be used for the player.

== Links ==
*[[Shaders in Oolite]] - dates to Oolite v.1.72 (wiki page written between 2008-10)
*[[OXP howto texture]] has some up-to-date links

[[Category:Oolite]]
[[Category:Oolite scripting]]

Shaders in Oolite: uniforms

2026-08-03T07:39:54Z

Cholmondely: /* Links */ Tweak

Update!
*Shaders changed in Oolite v.1.90 (2020) with the introduction of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
*Shaders changed again in Oolite v.1.92 (2026) with a [https://www.oolite.space/community/#whatsnew Reworked Renderer]

:The information presented on this page applies to Oolite test release v.1.69 (2007) and later. It was last edited by somebody knowledgeable in 2016

A '''uniform''' in a [[Shaders in Oolite|shader]] is a variable whose value is specified by the host application – in this case, [[Oolite]]. Oolite allows arbitrary uniforms to be specified for shaders applied to ships, and these may either take constant values specified in ''shipdata.plist'', or be “bound” to an attribute of the ship. This allows shader authors to access numerous properties of a game entity without having to ask for them and wait for an updated version of Oolite. ('''Note:''' in the case of subentities, bound properties are fetched from the parent ship.)

=== Basic syntax ===
Uniforms are specified in the ''materials'' or ''shaders'' dictionary of a ship’s ''shipdata.plist'' entry:
"ahruman_shady_cobra_example" =
{
 like_ship = "cobra3-player";
 shaders =
 {
 "cobra3_redux.png" =
 {
 textures = ( "cobra3_redux.png" );
 fragment_shader = "ahruman_shady_cobra_example.fragment";
uniforms =
{
shininess =
{
type = float;
value = 42.0;
};
withinAegis = "withinStationAegis";
compassMode = "compassMode";
}
 }
 }
}
This contrived example declares three uniforms, ''shininess'', ''withinAegis'' and ''compassMode''. ''shininess'' is a constant <code>float</code>; it is always 42. ''withinAegis'' is bound to the ship’s ''withinStationAegis'' property. (See below for information on available properties.) This is a boolean, that is, a number whose value is either 0 (meaning no) or 1 (meaning yes). ''compassMode'' is a binding to the ''compassMode'' property. To use the uniforms within a shader (either a vertex shader or a fragment shader), they are declared as follows:
uniform float shininess;
uniform int withinAegis;
uniform int compassMode;
...
void main(void)
{
if (withinAegis)
{
// Do aegis-specific effect here
}
...
}

=== Uniform property types ===
Every bindable property has a '''type'''. The simplest types, ''int'' and ''float'', correspond directly to the same types in GLSL. Both represent numbers, with the difference that a ''float'' can represent fractional values and very large values, but always has the same level of precision (about six digits), while ''int''s can represent any integer (non-fractional value) in a limited range. A ''bool'' is an integer whose value can be only 0 (meaning no or false) or 1 (meaning yes or true). ('''Note:''' the GLSL specification is deliberately vague on the ranges of the number types. It also points out that most hardware will actually use floating-point calculations for ''int'' variables, which implies that integer calculations will incur rounding overhead.)

The ''vector'' type is translated to a GLSL ''vec4'', whose ''x'', ''y'' and ''z'' components correspond to those of the Oolite vector, and whose ''w'' component is always 1.0.

The ''quaternion'' type can be translated to a ''mat4x4'' representing a rotation matrix, or to a ''vec4'' whose ''x'', ''y'', ''z'' and ''w'' components correspond to those of the Oolite quaternion.

The ''matrix'' type is translated into a GLSL ''mat4x4''.

The ''colour'' type is translated into a GLSL ''vec4'' type, whose ''r'', ''g'', ''b'' and ''a'' components correspond to those of the Oolite colour object.

==== Conversions ====
Several types of binding can be modified by conversion options, specified in the '''uniforms''' dictionary, for example:
haveFuel =
{
binding = "fuel";
clamped = true;
};
The '''clamped''' conversion option, when applied to a property of type ''float'', causes the value to be clamped to the range [0, 1]. When applied to an ''int'' property, any value other than 0 (including negative values) is converted to 1. The default value is ''false''.

The '''normalized''' option causes vector properties to be normalized, that is, scaled so they have the same direction but length 1. The default value is ''false''.

The '''asMatrix''' option causes quaternion properties to be converted to rotation matrix, rather than having their components packed into a ''vec4''. The default value is ''true''.

=== Bindable property reference ===
The following sections list entity properties which can be used in a uniform binding, regardless of apparent usefullness. Note, however, that '''some of these names may change before the next stable release'''.

==== Entity ====
The following properties are available for all entities:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable entity properties
! Name !! Type !! Description
|-
| ''position'' || vector || The location of the entity in system co-ordinates.
|-
| ''orientation'' || quaternion || The orientation of the entity.
|-
| ''relativePosition'' || vector || The location of the entity, relative to the player.
|-
| ''viewpointOffset'' || vector || The location of the current camera, in entity co-ordinates. Although this is defined for all entities, it is only meaningful for the player ship.
|-
| ''collisionRadius'' || float || Together with the ''position'', specifies a sphere completely containing the collidable volume of the entity.
|-
| ''mass'' || float || The mass of the entity.
|-
| ''energy'' || float || The current energy level of the entity.
|-
| ''maxEnergy'' || float || The current maximum energy level of the entity.
|-
| ''universalTime'' || float || The [[Time scales in Oolite#game real time|game real time]] clock. The value is the same for all entities and updates once per frame.
|-
| ''spawnTime'' || float || The [[Time scales in Oolite#game real time|game real time]] at which the entity came into existance.
|-
| ''timeElapsedSinceSpawn'' || float || The number of seconds (in the [[Time scales in Oolite#game real time|game real time]] scale) since the entity came into existance – the difference between ''universalTime'' and ''spawnTime''.
|-
| ''throwingSparks'' || bool || Whether the entity is generating sparks (for instance, a ship about to explode).
|-
| ''fogUniform'' (version 1.83) || vector || Atmosphere colour rgba for applying fog effect. Alpha channel is zero for no fogging to 1 for full fogging.
|-
|}

==== Ship ====
Ships (i.e., anything set up in ''shipdata.plist'', regardless of function) have all the properties of [[#Entity|entities]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable ship properties
! Name !! Type !! Description
|-
| ''isBeacon'' || bool || True if the entity is a beacon.
|-
| ''isFrangible'' || bool || True if the entity is frangible, i.e. subentities can be shot off.
|-
| ''isCloaked'' || bool || True if the entity is cloaked. [b]Note:[/b] a cloaked ship will only be drawn approximately once per ten frames, regardless of shaders.
|-
| ''isJammingScanning'' || bool || True if the ship has an active military jammer.
|-
| ''hasMilitaryScannerFilter'' || bool || True if the ship has a military scanner filter.
|-
| ''messageTime'' || float || Time before a radio message may be sent, in seconds. (This is set to 6.0 seconds when an NPC ship sends a message, and decreases over time.)
|-
| ''groupID'' || int || Unique identifier for the escort group the ship belongs to.
|-
| ''escortCount'' || int || The number of active escorts the ship has.
|-
| ''hasHostileTarget'' || bool || True if the ship has a target and the ship’s current AI behaviour is one of hostile intent.
|-
| ''weaponRange'' || float || Maximum range (in metres) of the ship’s main weapon. [b]Note:[/b] since subentities’ shaders get the parent ship’s properties, this may not work as expected.
|-
| ''scannerRange'' || float || The distance (in metres) in which the ship will scan for enemies.
|-
| ''withinStationAegis'' || bool || True if the ship is within the aegis of the system’s main station.
|-
| ''fuel'' || int || Ship’s fuel level, in tenths of a light year.
|-
| ''flightPitch'' || float || Current pitch rate.
|-
| ''flightRoll'' || float || Current roll rate.
|-
| ''flightYaw'' || float || Current yaw rate. Currently always 0 for NPC ships.
|-
| ''flightSpeed'' || float || Ship’s current speed.
|-
| ''maxFlightSpeed'' || float || Ship’s speed at full throttle. Something of a misnomer – actual speed may be higher using afterburners or hyperspeed.
|-
| ''speedFactor'' || float || ''flightSpeed'' divided by ''maxFlightSpeed''. May be greater than 1.0 (unless [[#Conversions|clamped]] is used).
|-
| ''damage'' || int || ''energy'' expressed as a percentage of ''maxEnergy''.
|-
| ''laserHeatLevel'' || float || The temperature level of the current weapon.
|-
| ''hullHeatLevel'' || float || The temperature level of the hull, due to proximity to stars, atmospheric drag or combat hits. When it reaches 1.0, the ship starts taking damage rapidly.
|-
| ''entityPersonality'' || float || A randomly-generated value in the range 0.0 to 1.0 that stays with the entity for its lifetime. Useful for adding random variations.
|-
| ''entityPersonalityInt'' || float || Same as ''entity_personality'', scaled to the range 0 to 32767.
|-
| ''numberOfScannedShips'' || int || The number of ships within scanner range (but no more than 16).
|-
| ''destination'' || vector || The location, in system co-ordinates, that the AI is trying to fly to. This may not always be meaningful depending on AI state.
|-
| ''rangeToDestination'' || float || The distance in metres between ''position'' and ''destination''.
|-
| ''rangeToPrimaryTarget'' || float || The distance in metres to the AI’s target (i.e., the ship it is trying to shoot). 0 if no target.
|-
| ''laserColor'' || colour || The colour of the ship’s laser.
|-
| ''isHulk'' || bool || True if the ship has been abandoned.
|-
| ''lightsActive'' || bool || True if flashers are turned on, false otherwise.
|-
| ''alertCondition'' (1.77 or later) || int || Current alert condition – 0 for docked, 2 for yellow, 3 for red.
|-
|}

==== Player ship ====
The player ship has all the properties of [[#Entity|entities]] and [[#Ship|ships]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable player ship properties
! Name !! Type !! Description
|-
| ''massLocked'' || bool || True if the ship is too close to a large object to be able to make a witchspace jump.
|-
| ''atHyperspeed'' || bool || True if the ship is at hyperspeed.
|-
| ''velocityVector'' || vector || The ship’s velocity.
|-
| ''dialForwardShield'' || float || The forward shield level, ranging from 0.0 to 1.0.
|-
| ''dialAftShield'' || float || The aft shield level, ranging from 0.0 to 1.0.
|-
| ''dialMissileStatus'' || int || State of selected missile – 0 for safe/no missile, 1 for active, 2 for locked.
|-
| ''dialFuelScoopStatus'' || int || State of cargo scoop – 0 for no scoop installed, 1 for full hold, 2 for idle with space in hold, 3 for actively scooping.
|-
| ''compassMode'' || int || State of advanced space compass – 0 for no advanced space compass installed, 1 for planet mode, 2 for station mode, 3 for sun mode, 4 for target mode, 5 for any beacon. More may be added in future.
|-
| ''activeMissile'' || int || Which missile slot is currently selected, from 0 to ''dialMaxMissiles'' - 1.
|-
| ''dialMaxMissiles'' || int || The number of missile slots on the ship.
|-
| ''dialIdentEngaged'' || bool || True if ident (targeting) mode is active.
|-
| ''alertCondition'' || int || Current alert condition – 0 for docked, 1 for green, 2 for yellow, 3 for red.
|-
| ''trumbleCount'' || int || Number of trumbles with which the player’s ship is infected.
|-
|}
Additionally, all [[Methods#Querying states|state query scripting methods]] ending with ''_number'' may be used for the player.

== Links ==
*[[Shaders in Oolite]] - dates to Oolite v.1.72 (wiki page written between 2008-10)
*[[OXP howto texture]] has some up-to-date links

[[Category:Oolite]]
[[Category:Oolite scripting]]

Shaders in Oolite: uniforms

2026-08-03T07:38:44Z

Cholmondely: Tweak

Update!
*Shaders changed in Oolite v.1.90 (2020) with the introduction of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
*Shaders changed again in Oolite v.1.92 (2026) with a [https://www.oolite.space/community/#whatsnew Reworked Renderer]

:The information presented on this page applies to Oolite test release v.1.69 (2007) and later. It was last edited by somebody knowledgeable in 2016

A '''uniform''' in a [[Shaders in Oolite|shader]] is a variable whose value is specified by the host application – in this case, [[Oolite]]. Oolite allows arbitrary uniforms to be specified for shaders applied to ships, and these may either take constant values specified in ''shipdata.plist'', or be “bound” to an attribute of the ship. This allows shader authors to access numerous properties of a game entity without having to ask for them and wait for an updated version of Oolite. ('''Note:''' in the case of subentities, bound properties are fetched from the parent ship.)

=== Basic syntax ===
Uniforms are specified in the ''materials'' or ''shaders'' dictionary of a ship’s ''shipdata.plist'' entry:
"ahruman_shady_cobra_example" =
{
 like_ship = "cobra3-player";
 shaders =
 {
 "cobra3_redux.png" =
 {
 textures = ( "cobra3_redux.png" );
 fragment_shader = "ahruman_shady_cobra_example.fragment";
uniforms =
{
shininess =
{
type = float;
value = 42.0;
};
withinAegis = "withinStationAegis";
compassMode = "compassMode";
}
 }
 }
}
This contrived example declares three uniforms, ''shininess'', ''withinAegis'' and ''compassMode''. ''shininess'' is a constant <code>float</code>; it is always 42. ''withinAegis'' is bound to the ship’s ''withinStationAegis'' property. (See below for information on available properties.) This is a boolean, that is, a number whose value is either 0 (meaning no) or 1 (meaning yes). ''compassMode'' is a binding to the ''compassMode'' property. To use the uniforms within a shader (either a vertex shader or a fragment shader), they are declared as follows:
uniform float shininess;
uniform int withinAegis;
uniform int compassMode;
...
void main(void)
{
if (withinAegis)
{
// Do aegis-specific effect here
}
...
}

=== Uniform property types ===
Every bindable property has a '''type'''. The simplest types, ''int'' and ''float'', correspond directly to the same types in GLSL. Both represent numbers, with the difference that a ''float'' can represent fractional values and very large values, but always has the same level of precision (about six digits), while ''int''s can represent any integer (non-fractional value) in a limited range. A ''bool'' is an integer whose value can be only 0 (meaning no or false) or 1 (meaning yes or true). ('''Note:''' the GLSL specification is deliberately vague on the ranges of the number types. It also points out that most hardware will actually use floating-point calculations for ''int'' variables, which implies that integer calculations will incur rounding overhead.)

The ''vector'' type is translated to a GLSL ''vec4'', whose ''x'', ''y'' and ''z'' components correspond to those of the Oolite vector, and whose ''w'' component is always 1.0.

The ''quaternion'' type can be translated to a ''mat4x4'' representing a rotation matrix, or to a ''vec4'' whose ''x'', ''y'', ''z'' and ''w'' components correspond to those of the Oolite quaternion.

The ''matrix'' type is translated into a GLSL ''mat4x4''.

The ''colour'' type is translated into a GLSL ''vec4'' type, whose ''r'', ''g'', ''b'' and ''a'' components correspond to those of the Oolite colour object.

==== Conversions ====
Several types of binding can be modified by conversion options, specified in the '''uniforms''' dictionary, for example:
haveFuel =
{
binding = "fuel";
clamped = true;
};
The '''clamped''' conversion option, when applied to a property of type ''float'', causes the value to be clamped to the range [0, 1]. When applied to an ''int'' property, any value other than 0 (including negative values) is converted to 1. The default value is ''false''.

The '''normalized''' option causes vector properties to be normalized, that is, scaled so they have the same direction but length 1. The default value is ''false''.

The '''asMatrix''' option causes quaternion properties to be converted to rotation matrix, rather than having their components packed into a ''vec4''. The default value is ''true''.

=== Bindable property reference ===
The following sections list entity properties which can be used in a uniform binding, regardless of apparent usefullness. Note, however, that '''some of these names may change before the next stable release'''.

==== Entity ====
The following properties are available for all entities:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable entity properties
! Name !! Type !! Description
|-
| ''position'' || vector || The location of the entity in system co-ordinates.
|-
| ''orientation'' || quaternion || The orientation of the entity.
|-
| ''relativePosition'' || vector || The location of the entity, relative to the player.
|-
| ''viewpointOffset'' || vector || The location of the current camera, in entity co-ordinates. Although this is defined for all entities, it is only meaningful for the player ship.
|-
| ''collisionRadius'' || float || Together with the ''position'', specifies a sphere completely containing the collidable volume of the entity.
|-
| ''mass'' || float || The mass of the entity.
|-
| ''energy'' || float || The current energy level of the entity.
|-
| ''maxEnergy'' || float || The current maximum energy level of the entity.
|-
| ''universalTime'' || float || The [[Time scales in Oolite#game real time|game real time]] clock. The value is the same for all entities and updates once per frame.
|-
| ''spawnTime'' || float || The [[Time scales in Oolite#game real time|game real time]] at which the entity came into existance.
|-
| ''timeElapsedSinceSpawn'' || float || The number of seconds (in the [[Time scales in Oolite#game real time|game real time]] scale) since the entity came into existance – the difference between ''universalTime'' and ''spawnTime''.
|-
| ''throwingSparks'' || bool || Whether the entity is generating sparks (for instance, a ship about to explode).
|-
| ''fogUniform'' (version 1.83) || vector || Atmosphere colour rgba for applying fog effect. Alpha channel is zero for no fogging to 1 for full fogging.
|-
|}

==== Ship ====
Ships (i.e., anything set up in ''shipdata.plist'', regardless of function) have all the properties of [[#Entity|entities]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable ship properties
! Name !! Type !! Description
|-
| ''isBeacon'' || bool || True if the entity is a beacon.
|-
| ''isFrangible'' || bool || True if the entity is frangible, i.e. subentities can be shot off.
|-
| ''isCloaked'' || bool || True if the entity is cloaked. [b]Note:[/b] a cloaked ship will only be drawn approximately once per ten frames, regardless of shaders.
|-
| ''isJammingScanning'' || bool || True if the ship has an active military jammer.
|-
| ''hasMilitaryScannerFilter'' || bool || True if the ship has a military scanner filter.
|-
| ''messageTime'' || float || Time before a radio message may be sent, in seconds. (This is set to 6.0 seconds when an NPC ship sends a message, and decreases over time.)
|-
| ''groupID'' || int || Unique identifier for the escort group the ship belongs to.
|-
| ''escortCount'' || int || The number of active escorts the ship has.
|-
| ''hasHostileTarget'' || bool || True if the ship has a target and the ship’s current AI behaviour is one of hostile intent.
|-
| ''weaponRange'' || float || Maximum range (in metres) of the ship’s main weapon. [b]Note:[/b] since subentities’ shaders get the parent ship’s properties, this may not work as expected.
|-
| ''scannerRange'' || float || The distance (in metres) in which the ship will scan for enemies.
|-
| ''withinStationAegis'' || bool || True if the ship is within the aegis of the system’s main station.
|-
| ''fuel'' || int || Ship’s fuel level, in tenths of a light year.
|-
| ''flightPitch'' || float || Current pitch rate.
|-
| ''flightRoll'' || float || Current roll rate.
|-
| ''flightYaw'' || float || Current yaw rate. Currently always 0 for NPC ships.
|-
| ''flightSpeed'' || float || Ship’s current speed.
|-
| ''maxFlightSpeed'' || float || Ship’s speed at full throttle. Something of a misnomer – actual speed may be higher using afterburners or hyperspeed.
|-
| ''speedFactor'' || float || ''flightSpeed'' divided by ''maxFlightSpeed''. May be greater than 1.0 (unless [[#Conversions|clamped]] is used).
|-
| ''damage'' || int || ''energy'' expressed as a percentage of ''maxEnergy''.
|-
| ''laserHeatLevel'' || float || The temperature level of the current weapon.
|-
| ''hullHeatLevel'' || float || The temperature level of the hull, due to proximity to stars, atmospheric drag or combat hits. When it reaches 1.0, the ship starts taking damage rapidly.
|-
| ''entityPersonality'' || float || A randomly-generated value in the range 0.0 to 1.0 that stays with the entity for its lifetime. Useful for adding random variations.
|-
| ''entityPersonalityInt'' || float || Same as ''entity_personality'', scaled to the range 0 to 32767.
|-
| ''numberOfScannedShips'' || int || The number of ships within scanner range (but no more than 16).
|-
| ''destination'' || vector || The location, in system co-ordinates, that the AI is trying to fly to. This may not always be meaningful depending on AI state.
|-
| ''rangeToDestination'' || float || The distance in metres between ''position'' and ''destination''.
|-
| ''rangeToPrimaryTarget'' || float || The distance in metres to the AI’s target (i.e., the ship it is trying to shoot). 0 if no target.
|-
| ''laserColor'' || colour || The colour of the ship’s laser.
|-
| ''isHulk'' || bool || True if the ship has been abandoned.
|-
| ''lightsActive'' || bool || True if flashers are turned on, false otherwise.
|-
| ''alertCondition'' (1.77 or later) || int || Current alert condition – 0 for docked, 2 for yellow, 3 for red.
|-
|}

==== Player ship ====
The player ship has all the properties of [[#Entity|entities]] and [[#Ship|ships]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable player ship properties
! Name !! Type !! Description
|-
| ''massLocked'' || bool || True if the ship is too close to a large object to be able to make a witchspace jump.
|-
| ''atHyperspeed'' || bool || True if the ship is at hyperspeed.
|-
| ''velocityVector'' || vector || The ship’s velocity.
|-
| ''dialForwardShield'' || float || The forward shield level, ranging from 0.0 to 1.0.
|-
| ''dialAftShield'' || float || The aft shield level, ranging from 0.0 to 1.0.
|-
| ''dialMissileStatus'' || int || State of selected missile – 0 for safe/no missile, 1 for active, 2 for locked.
|-
| ''dialFuelScoopStatus'' || int || State of cargo scoop – 0 for no scoop installed, 1 for full hold, 2 for idle with space in hold, 3 for actively scooping.
|-
| ''compassMode'' || int || State of advanced space compass – 0 for no advanced space compass installed, 1 for planet mode, 2 for station mode, 3 for sun mode, 4 for target mode, 5 for any beacon. More may be added in future.
|-
| ''activeMissile'' || int || Which missile slot is currently selected, from 0 to ''dialMaxMissiles'' - 1.
|-
| ''dialMaxMissiles'' || int || The number of missile slots on the ship.
|-
| ''dialIdentEngaged'' || bool || True if ident (targeting) mode is active.
|-
| ''alertCondition'' || int || Current alert condition – 0 for docked, 1 for green, 2 for yellow, 3 for red.
|-
| ''trumbleCount'' || int || Number of trumbles with which the player’s ship is infected.
|-
|}
Additionally, all [[Methods#Querying states|state query scripting methods]] ending with ''_number'' may be used for the player.

== Links ==
*[[Shaders in Oolite]] - dates to Oolite v.1.72 (2008, but written in 2010)
*[[OXP howto texture]] has some up-to-date links

[[Category:Oolite]]
[[Category:Oolite scripting]]

Griff Industries

2026-08-03T06:59:06Z

Cholmondely: Tweaks

== About ==

Griff produced some fantastic models of ships, using normalmapping and shaders to produce some of the best-looking ships available in Oolite. All vanilla-game ships and stations are supported.

== Gallery ==
<center>
{| align=center width=100% style="background: black;"
| [[Image:Griff_adder.jpg |link=Adder (Oolite) |200px]]
| [[Image:Griff_anaconda.jpg |link=Anaconda (Oolite) |200px]]
| [[Image:Griff_asp_mk2.jpg |link=Asp (Oolite) |200px]]
| [[Image:Griff_missile.jpg |link=Missile |200px]]
|-
| [[Image:Griff_asteroid.jpg|link=Asteroid_(Oolite) |200px]]
| [[Image:Griff_boulder.jpg‎ |link=Boulder_(Oolite) |200px]]
| [[Image:Griff_splinters.jpg‎|link=Splinters_(Oolite) |200px]]
| [[Image:Griff_alloy.jpg‎ |link=Metal_Fragment_(Oolite) |200px]]
|-
| [[Image:Griff_boa.jpg |link=Griff Boa |200px]]
| [[Image:Griff_boa_screenshot2.jpg |link=Boa (Oolite) |200px]]
| [[Image:Griff_boa_mk2.jpg |link=Boa 2 Class Cruiser |200px]]
| [[Image:Griff_barrel.jpg |link=Cargo Container (Oolite) |200px]]
|-
| [[Image:Griff_cobra_mk1.jpg |link=Cobra Mk.1 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3_scuffed.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff cobra mk3 alt.jpg |link=Cobra Mk.3 (Oolite) |200px]]
|-
| [[Image:Griff_constrictor.jpg |link=Constrictor_(Oolite) |200px]]
| [[Image:Griff_coriolis_alt.jpg |link=Alternative Coriolis station (Oolite) |200px]]
| [[Image:Griff_ico.jpg |link=Icosahedron_Station_(Oolite) |200px]]
| [[Image:Griff_dodo_thumbnail.jpg |link=Dodo station (Oolite) |200px]]
|-
| [[Image:Griff_fer-de-lance_blinged.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_fer-de-lance_scuffed.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_gecko_sharkteeth.jpg |link=Gecko (Oolite) |200px]]
| [[Image:Griff_gecko.jpg |link=Gecko (Oolite) |200px]]
|-
| [[Image:Griff_krait.jpg |link=Krait (Oolite) |200px]]
| [[Image:Griff-krait.jpg |link=Griff Krait |200px]]
| [[Image:Griff_mamba.jpg |link=Mamba (Oolite) |200px]]
| [[Image:Griff_moray.jpg |link=Moray Star Boat (Oolite) |200px]]
|-
| [[Image:Griff_python.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_python_alternative.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_Rock_Hermit.jpg |link=Rock Hermit (Oolite) |200px]]
| [[Image:Griff_escape_capsule.jpg |link=Escape Pod |200px]]
|-
| [[Image:Griff_sidewinder.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_sidewinder_alternative.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_shuttle.jpg |link=Shuttle (Oolite) |200px]]
| [[Image:Griff_transporter.jpg |link=Transporter (Oolite) |200px]]
|-
| [[Image:Griff_thargoid.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_thargoid_organic.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_Thargon.png |link=Thargoid Robot Fighter (Oolite) |200px]]
| [[Image:Griff_tharglet_organic2.jpg |link=Thargoid Robot Fighter (Oolite) |200px]]
|-
| [[Image:Griff_viper.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_viper_interceptor.jpg |link=Viper Interceptor |200px]]
| [[Image:Griff_viper_pursuit.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_worm.jpg |link=Worm (Oolite) |200px]]
|-
| [[Image:Sainsboorys.png |link=Your Ad Here! |250px]]
| [[Image:Griff_dodo.png |link=Dodo station (Oolite) |200px]]
| [[Image:Griff Elite2 bug.jpg |Bug ship from an Elite 2 that didn't get made |200px]]
| [[Image:Griff_wolf_mkII.jpg |link=Wolf_Mk.2_(Oolite)|200px]]
|-
| [[Image:Griffhognose.jpg |link=Hognose |250px]]
| [[Image:Griff_viper_alt_wiki.jpg |link=Viper_(Oolite) |250px]]
| [[Image:Griff ophidian.jpg|link=Ophidian_(Classic) |250px]]
| [[Image:Griff elite2 griffin mk1.jpg|link=Griffin_Two_(Oolite) |250px]]
|-
| [[Image:Griff gnat.jpg |link=Classic_Elite_ships |250px]]
| [[Image:Griff Viper interceptor alt.jpg |link=Viper Interceptor |250px]]
|}
</center>
 
----
== Griff's Ship Sets ==
There are ''four'' sets of Griff ships!
*The Vanilla game ships in Oolite v.1.92 and later
::2026
:These are taken from the [[Oolite v1.88 Base Shipset Normal and Specular/Gloss Maps]] OXP
:They are simplified versions of the OXPs on the Expansions Manager but with normal, specular & gloss texture maps added - and using the new Oolite shaders system.
*The Vanilla game ships in Oolite v.1.90 and earlier
::2013
:These are simplified versions of Griff's OXPs on the Expansions Manager
*The OXPs on the Expansions Manager (excluding the "specials" such as Griff Clippers, Griff Prototype Boa, Griff's Glowroids ''etc''.)
::2013
:These do not have specular maps, but do have normal maps. These ship models are more complex - and the textures and the shaders are ''much'' more complex. But they use the older Oolite shaders system.
:They also have special effects: more realistic exhausts, running lights and emergency lights (which dim when power is low), the Thargoids have special reflecting hulls, ''etc''.
*The unfinished very high poly "SpecGloss" series (only the SpecGloss Sidewinder is on the Expansions Manager - the other ships are on Box.com - see below).
::In Progress (2022 - date)
:These resemble Griff's OXPs but with much ''much'' more detail - and adding in SpecGloss and Glowmaps. They also use the newer Oolite shaders system. See [https://drive.google.com/drive/folders/1_8EtoVvwNyXXvqe5GCGy1HuFRRw3NxB7?usp=sharing here] for downloads.
----
== Griff's "Expansions Manager" Downloads ==
All these ships are available in the Oolite [[Expansions Manager|Expansion Pack Manager]].

=== "Retextured" ship OXPs ("Normalmapped") ===
:These constitute the third set mentioned above. These OXPs were created when normal mapping (allowing "bumps" and other such) was added into Oolite.
*'''Griff's Normalmapped Ships (Replace):'''
:'''Note''': Spara's rebalanced bundle 'Meta-OXZ'. Available via the Oolite Expansion Pack manager, provides a single click install for all the Griff core shipset ships, bugfixed and rebalanced for better gameplay! This expansion pack is highly recommended over installing the shipset ships individually

*'''Griff Adder, Griff Alloys and Wreckage, Griff Anaconda, Griff Asp, Griff Asteroids, Griff Boa, Griff Boa MkII, Griff Cargopod, Griff Cobra MkI, Griff Cobra MkIII, Griff Cobra MkIII Alt, Griff Constrictor, Griff Escape Capsule, Griff Ferdelance, Griff Gecko, Griff Krait, Griff Mamba, Griff Mamba Alternative, Griff Missiles, Griff Moray, Griff Python, Griff Shuttle, Griff Sidewinder, Griff Station Bundle, Griff Thargoids, Griff Transporter, Griff Viper, Griff Worm
:The individual ship OXPs included in "Griff's Normalmapped Ships (Replace)" but with minor bugs in places.

=== Other OXPs ===
*Griff Shipset Decals - this OXP is for adding Decals to Griff's ships (and is needed by his OXPs). See [[Decal]] for more on this

*Griff Clippers - Griffifies the Boa Clipper and Python Clipper from Smivs' earlier [[Clippers]] OXP
*[[Griff Boa|Griff Prototype Boa]] - the famous, utterly different "Griff Boa" - as below, under "Other OXPs"
*[[Griff's Glowroids]] - massive asteroids with a difference!

=== Relevant resources not on the Expansions Manager ===
* '''Resources''' - ''Not needed for gameplay'' - this folder contains various ship meshes and textures in .obj and .png format for interested modders
:[https://app.box.com/shared/rpkms25cc9 ''Griff Ship Downloads''] on Box.com
----
== Griff's Other OXPs ==
[http://app.box.com/shared/jf1et41yu3 ''Dodo Stations OXP by Griff and CaptKev''] (1.4Mb). 
Retextured Dodecahedron stations OXP, v1.1. Updated version released 18th May 2010, Griff has fixed a problem with the shaders.

''[[Flying Dutchman OXP]]'' (31.0Kb). 
Featuring Griff's Wireframe Cobra. 
Adds the small chance to meet a Ghost Ship in the Ooniverse. What is it? Some claim that it's the ghost of Commander Peter Jameson, reported lost at the end of the last Thargoid War, others that it is simply a manifestation of all those lost souls who were trapped in the trackless depths of interstellar space. One common story is the trail of bad luck and hideous deaths that follow in the wake of the ship's sightings...

[[Griff ArcElite|''Griff's ArcElite'']] (201.2 Kb). 
Adds all the ships from the Acorn Archimedes version of Elite, textured & shaded to resemble how they originally appeared in that version of the game.
Version 2.0 adds extra ships from Elite 'A', Elite 2 and the Amiga version of Elite

[[Griff Boa|''Griff's Boa OXP'']] (2.7Mb). 
Wiki link containing the famous Griff Boa, as featured in the ''"Oolite - It's not just for triangles anymore"'' images. Note: the Boa is not included in the ''Normalmapped Ships OXP'' as above. Note also that this OXP only works on Oolite 1.74 and higher.

[[Griff Krait|''Griff's Krait OXP'']] (2.5Mb). 
A heavily modified Krait, similar in design to the Griff Boa. Note: ''this'' Krait is not included in the ''Normalmapped Ships OXP'' as above.

[https://www.box.com/s/162d02b7e79b1202689c ''Griff's Alloys & Wreckage OXP''] (1.5mb). 
Box.com link to an OXP for Oolite v1.75 and higher that adds a new models & texture for the 'Alloys'. The OXP also generates extra clouds of burning wreckage whenever ships explode. This OXP was updated on 24th March 2013 for more compatibility with the Griff Normalmapped Ships, Replacement version, and should be used in preference to the old ''Griff's Explosion Debris OXP''.

There are other non-normal mapped OXPs linked in Griff's "Complete Catalogue" beneath.
----
== OXPs using Griff's ships ==

[http://app.box.com/shared/t3n98yhk6n ''Illicit Unlock - Griff Version''] by ADCK (3.5Kb). 
Based on the original Illicit Unlock, Allows the player to fly Griffs pirate/viper Ships. (Requires ''Griff's Normalmapped Ships, above'' )

Bugfixed and updated files for the oxp by Dertien (requires overwriting files in ADCK's original oxp) - [http://app.box.com/shared/jq8biuf21o ''Download'']

[[Black_Monk_Monastery|''Bank of the Black Monks'']] by LittleBear. The station and Gunships are Griff's.

''[[Random Hits OXP]]''. 
Featuring many Ships/Stations made by Griff.

[[Your_Ad_Here!|''Your Ad Here! OXP'']]. 
Featuring Griff's Tradestations.

[[Staer9%27s_Shipset|''Staer9's Shipset'']]. 
Adds more ships based on Griffs models.

[https://bb.oolite.space/viewtopic.php?f=4&t=9306 ''ZGrOovy Griff System Stations OXP''] by Dertien (on the Oolite BB). 
Using Griff's station textures, adds five new model stations, from the small Tetrahedron and Octahedrons, through the standard sized Coriolis, to the large Dodecahedron and Icosahedron stations. 

----
== Lore ==
Added by [[The Assassins Guild OXP]]

The [[Sector7/Ateslete|Ateslete]] system in galaxy 7 is reasonably noted for the ice-world, Stymphal. The well known robotics company, '''Griff Research Ltd''', operates factories over most of the planet and maintains an orbital research station near Stymphal.

The company was originally founded to produce droids and other artificial life forms, enjoying much success winning the coveted “Which Droid?” award for a decade. Perhaps their most famous design was the [[Griff Robotic Cargo Loader|Robotic Cargo Loader]] which is still in service in all sectors. In recent years the company has diversified into building high specification ships and stations to order. Examples of their known designs include providing the Bank of the Black Monks of St Herod with a fearsome [[Black Monk Monastery|armed orbital platform]] and the [[Black Monk Gunship|Holy Avenger Mark II Tri-Laser Gunship]].

The company's main ship design work is however highly classified, their most regular client being the [[Galactic Navy]]. Griff Research Ltd has constructed several Frigate Class vessels for the Navy, in addition to new types of weapons. No further details are available, although it is rumored that the Company is returning to its roots as a robotics company, in a current design brief.

----
== Complete Catalogue of Griff's oeuvre (2006 - date) ==
See here: [[User:Griff/OXP Catalogue‎]] for an attempt at this (not fully formatted yet)

{{Retextures-OXP}}
{{Ship-OXP}}

[[Category:Griff Industries| ]]

Shaders in Oolite: uniforms

2026-08-02T15:34:32Z

Cholmondely: Added historical context, Links

Update!
*Shaders changed in Oolite v.1.90 (2020) with the introduction of filmic tone mapping, Oren-Nayar diffuse light model and increased light source radiance
*Shaders changed again in Oolite v.1.92 (2026) with a [https://www.oolite.space/community/#whatsnew Reworked Renderer]

:The information presented on this page applies to Oolite test release v.1.69 (2007) and later.

A '''uniform''' in a [[Shaders in Oolite|shader]] is a variable whose value is specified by the host application – in this case, [[Oolite]]. Oolite allows arbitrary uniforms to be specified for shaders applied to ships, and these may either take constant values specified in ''shipdata.plist'', or be “bound” to an attribute of the ship. This allows shader authors to access numerous properties of a game entity without having to ask for them and wait for an updated version of Oolite. ('''Note:''' in the case of subentities, bound properties are fetched from the parent ship.)

=== Basic syntax ===
Uniforms are specified in the ''materials'' or ''shaders'' dictionary of a ship’s ''shipdata.plist'' entry:
"ahruman_shady_cobra_example" =
{
 like_ship = "cobra3-player";
 shaders =
 {
 "cobra3_redux.png" =
 {
 textures = ( "cobra3_redux.png" );
 fragment_shader = "ahruman_shady_cobra_example.fragment";
uniforms =
{
shininess =
{
type = float;
value = 42.0;
};
withinAegis = "withinStationAegis";
compassMode = "compassMode";
}
 }
 }
}
This contrived example declares three uniforms, ''shininess'', ''withinAegis'' and ''compassMode''. ''shininess'' is a constant <code>float</code>; it is always 42. ''withinAegis'' is bound to the ship’s ''withinStationAegis'' property. (See below for information on available properties.) This is a boolean, that is, a number whose value is either 0 (meaning no) or 1 (meaning yes). ''compassMode'' is a binding to the ''compassMode'' property. To use the uniforms within a shader (either a vertex shader or a fragment shader), they are declared as follows:
uniform float shininess;
uniform int withinAegis;
uniform int compassMode;
...
void main(void)
{
if (withinAegis)
{
// Do aegis-specific effect here
}
...
}

=== Uniform property types ===
Every bindable property has a '''type'''. The simplest types, ''int'' and ''float'', correspond directly to the same types in GLSL. Both represent numbers, with the difference that a ''float'' can represent fractional values and very large values, but always has the same level of precision (about six digits), while ''int''s can represent any integer (non-fractional value) in a limited range. A ''bool'' is an integer whose value can be only 0 (meaning no or false) or 1 (meaning yes or true). ('''Note:''' the GLSL specification is deliberately vague on the ranges of the number types. It also points out that most hardware will actually use floating-point calculations for ''int'' variables, which implies that integer calculations will incur rounding overhead.)

The ''vector'' type is translated to a GLSL ''vec4'', whose ''x'', ''y'' and ''z'' components correspond to those of the Oolite vector, and whose ''w'' component is always 1.0.

The ''quaternion'' type can be translated to a ''mat4x4'' representing a rotation matrix, or to a ''vec4'' whose ''x'', ''y'', ''z'' and ''w'' components correspond to those of the Oolite quaternion.

The ''matrix'' type is translated into a GLSL ''mat4x4''.

The ''colour'' type is translated into a GLSL ''vec4'' type, whose ''r'', ''g'', ''b'' and ''a'' components correspond to those of the Oolite colour object.

==== Conversions ====
Several types of binding can be modified by conversion options, specified in the '''uniforms''' dictionary, for example:
haveFuel =
{
binding = "fuel";
clamped = true;
};
The '''clamped''' conversion option, when applied to a property of type ''float'', causes the value to be clamped to the range [0, 1]. When applied to an ''int'' property, any value other than 0 (including negative values) is converted to 1. The default value is ''false''.

The '''normalized''' option causes vector properties to be normalized, that is, scaled so they have the same direction but length 1. The default value is ''false''.

The '''asMatrix''' option causes quaternion properties to be converted to rotation matrix, rather than having their components packed into a ''vec4''. The default value is ''true''.

=== Bindable property reference ===
The following sections list entity properties which can be used in a uniform binding, regardless of apparent usefullness. Note, however, that '''some of these names may change before the next stable release'''.

==== Entity ====
The following properties are available for all entities:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable entity properties
! Name !! Type !! Description
|-
| ''position'' || vector || The location of the entity in system co-ordinates.
|-
| ''orientation'' || quaternion || The orientation of the entity.
|-
| ''relativePosition'' || vector || The location of the entity, relative to the player.
|-
| ''viewpointOffset'' || vector || The location of the current camera, in entity co-ordinates. Although this is defined for all entities, it is only meaningful for the player ship.
|-
| ''collisionRadius'' || float || Together with the ''position'', specifies a sphere completely containing the collidable volume of the entity.
|-
| ''mass'' || float || The mass of the entity.
|-
| ''energy'' || float || The current energy level of the entity.
|-
| ''maxEnergy'' || float || The current maximum energy level of the entity.
|-
| ''universalTime'' || float || The [[Time scales in Oolite#game real time|game real time]] clock. The value is the same for all entities and updates once per frame.
|-
| ''spawnTime'' || float || The [[Time scales in Oolite#game real time|game real time]] at which the entity came into existance.
|-
| ''timeElapsedSinceSpawn'' || float || The number of seconds (in the [[Time scales in Oolite#game real time|game real time]] scale) since the entity came into existance – the difference between ''universalTime'' and ''spawnTime''.
|-
| ''throwingSparks'' || bool || Whether the entity is generating sparks (for instance, a ship about to explode).
|-
| ''fogUniform'' (version 1.83) || vector || Atmosphere colour rgba for applying fog effect. Alpha channel is zero for no fogging to 1 for full fogging.
|-
|}

==== Ship ====
Ships (i.e., anything set up in ''shipdata.plist'', regardless of function) have all the properties of [[#Entity|entities]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable ship properties
! Name !! Type !! Description
|-
| ''isBeacon'' || bool || True if the entity is a beacon.
|-
| ''isFrangible'' || bool || True if the entity is frangible, i.e. subentities can be shot off.
|-
| ''isCloaked'' || bool || True if the entity is cloaked. [b]Note:[/b] a cloaked ship will only be drawn approximately once per ten frames, regardless of shaders.
|-
| ''isJammingScanning'' || bool || True if the ship has an active military jammer.
|-
| ''hasMilitaryScannerFilter'' || bool || True if the ship has a military scanner filter.
|-
| ''messageTime'' || float || Time before a radio message may be sent, in seconds. (This is set to 6.0 seconds when an NPC ship sends a message, and decreases over time.)
|-
| ''groupID'' || int || Unique identifier for the escort group the ship belongs to.
|-
| ''escortCount'' || int || The number of active escorts the ship has.
|-
| ''hasHostileTarget'' || bool || True if the ship has a target and the ship’s current AI behaviour is one of hostile intent.
|-
| ''weaponRange'' || float || Maximum range (in metres) of the ship’s main weapon. [b]Note:[/b] since subentities’ shaders get the parent ship’s properties, this may not work as expected.
|-
| ''scannerRange'' || float || The distance (in metres) in which the ship will scan for enemies.
|-
| ''withinStationAegis'' || bool || True if the ship is within the aegis of the system’s main station.
|-
| ''fuel'' || int || Ship’s fuel level, in tenths of a light year.
|-
| ''flightPitch'' || float || Current pitch rate.
|-
| ''flightRoll'' || float || Current roll rate.
|-
| ''flightYaw'' || float || Current yaw rate. Currently always 0 for NPC ships.
|-
| ''flightSpeed'' || float || Ship’s current speed.
|-
| ''maxFlightSpeed'' || float || Ship’s speed at full throttle. Something of a misnomer – actual speed may be higher using afterburners or hyperspeed.
|-
| ''speedFactor'' || float || ''flightSpeed'' divided by ''maxFlightSpeed''. May be greater than 1.0 (unless [[#Conversions|clamped]] is used).
|-
| ''damage'' || int || ''energy'' expressed as a percentage of ''maxEnergy''.
|-
| ''laserHeatLevel'' || float || The temperature level of the current weapon.
|-
| ''hullHeatLevel'' || float || The temperature level of the hull, due to proximity to stars, atmospheric drag or combat hits. When it reaches 1.0, the ship starts taking damage rapidly.
|-
| ''entityPersonality'' || float || A randomly-generated value in the range 0.0 to 1.0 that stays with the entity for its lifetime. Useful for adding random variations.
|-
| ''entityPersonalityInt'' || float || Same as ''entity_personality'', scaled to the range 0 to 32767.
|-
| ''numberOfScannedShips'' || int || The number of ships within scanner range (but no more than 16).
|-
| ''destination'' || vector || The location, in system co-ordinates, that the AI is trying to fly to. This may not always be meaningful depending on AI state.
|-
| ''rangeToDestination'' || float || The distance in metres between ''position'' and ''destination''.
|-
| ''rangeToPrimaryTarget'' || float || The distance in metres to the AI’s target (i.e., the ship it is trying to shoot). 0 if no target.
|-
| ''laserColor'' || colour || The colour of the ship’s laser.
|-
| ''isHulk'' || bool || True if the ship has been abandoned.
|-
| ''lightsActive'' || bool || True if flashers are turned on, false otherwise.
|-
| ''alertCondition'' (1.77 or later) || int || Current alert condition – 0 for docked, 2 for yellow, 3 for red.
|-
|}

==== Player ship ====
The player ship has all the properties of [[#Entity|entities]] and [[#Ship|ships]], and several others:
{| class="wikitable" border="1" cellpadding="3" cellspacing="0"
|+ Bindable player ship properties
! Name !! Type !! Description
|-
| ''massLocked'' || bool || True if the ship is too close to a large object to be able to make a witchspace jump.
|-
| ''atHyperspeed'' || bool || True if the ship is at hyperspeed.
|-
| ''velocityVector'' || vector || The ship’s velocity.
|-
| ''dialForwardShield'' || float || The forward shield level, ranging from 0.0 to 1.0.
|-
| ''dialAftShield'' || float || The aft shield level, ranging from 0.0 to 1.0.
|-
| ''dialMissileStatus'' || int || State of selected missile – 0 for safe/no missile, 1 for active, 2 for locked.
|-
| ''dialFuelScoopStatus'' || int || State of cargo scoop – 0 for no scoop installed, 1 for full hold, 2 for idle with space in hold, 3 for actively scooping.
|-
| ''compassMode'' || int || State of advanced space compass – 0 for no advanced space compass installed, 1 for planet mode, 2 for station mode, 3 for sun mode, 4 for target mode, 5 for any beacon. More may be added in future.
|-
| ''activeMissile'' || int || Which missile slot is currently selected, from 0 to ''dialMaxMissiles'' - 1.
|-
| ''dialMaxMissiles'' || int || The number of missile slots on the ship.
|-
| ''dialIdentEngaged'' || bool || True if ident (targeting) mode is active.
|-
| ''alertCondition'' || int || Current alert condition – 0 for docked, 1 for green, 2 for yellow, 3 for red.
|-
| ''trumbleCount'' || int || Number of trumbles with which the player’s ship is infected.
|-
|}
Additionally, all [[Methods#Querying states|state query scripting methods]] ending with ''_number'' may be used for the player.

== Links ==
*[[Shaders in Oolite]] - dates to Oolite v.1.72 (2008, but written in 2010)
*[[OXP howto texture]] has some up-to-date links

[[Category:Oolite]]
[[Category:Oolite scripting]]

OXP howto texture

2026-08-02T15:02:41Z

Cholmondely: /* Ideas */ Added structure and Griff's shaders display

[[File:Untextured Odyssey.png|thumb|right|200px|Maaarcooose's finished model of the Odyssey, prior to texturing]]
[[File:U31 odyssey.png|thumb|right|200px|Textured Odyssey]]
Note that possibilities have increased immensely since this was written in 2006. See [https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018-21) for details.
__TOC__

<div style="clear:both"></div>
{{OXPNote|This page was last properly edited in 2006, before the introduction of shaders and well before [[User:Another commander|Another commander]]'s work on Oolite introducing specular & gloss maps, the new Oren-Nayar diffuse light model, high-definition graphic resolution ''etc''. The links are more up-to-date.}}

== Simple introduction ==
A simpler way into this might be experimenting with the [[Ship Respray OXP]] - or just adding a [[Decal]] to your ship.

== Terminology ==
A '''normal texture''' specifies a single property of the model’s material at each point – specifically, its diffuse colour, or albedo. '''Specular maps''', '''glow maps''' (''eg'' for the engine exhaust glows) and other effect maps are auxiliary textures specifying additional material properties. Extra detail can be added into the '''alpha layer/channel''' (eg for the city night lights for planets in Oolite v.1.90: the illumination map should get embedded in the alpha channel of the planet's diffuse map).

See [[Shaders in Oolite]] (2010) for explanations of vertex shaders, fragment shaders and uniforms.

== Step 1 ==

Open a good [[List of software|graphic editing application]], something a bit more elaborate than MS-paint.

Tip: [https://bb.oolite.space/viewtopic.php?p=258574#p258574 Gsagostinho (2017)]: I think I am addicted to Wings3D, learned how to use it in just a few days after banging my head against Blender's wall for years.

=== Custom texture native models ===

You can create custom textures for any Oolite native entities, the steps to follow are:
*Edit the chosen native texture to your own liking.
*Duplicate the chosen ''Xnative_ship''.dat model, and alter the file name. Open the copy in a text editor, and change all referances from ''Xnative_ship''.png to the name of your ''custom_texture''.png.
*Create a custom [[shipdata.plist]], with a [[like_ship shipdata.plist example|like_ship]] entry which refers to the original, and place your components into the appropriate folders, making a complete, [[OXP_howto|funcional OXP]].

=== Textures from a wings3D model ===

After you have created a model, you need to apply an [http://en.wikipedia.org/wiki/UV_mapping UV-Map], this defines the way your future texture-file will be stretched across your model.
Use hard edges to mark where to 'cut' the textures.

There are two ways Wings-3D will extract an UV-Map:

(1) Fold: like a papermodel, the model is folded out to the flat plane of the texture. Can be usefull for small details, but may be difficult to line up correctly.

(2) Projection: the less complicated approach, will project (average normal) the sections unto the texture canvas.

Move around the sections untill you are satisfied. Then create a texturemap from the UV-Map, do not forget to set 'draw all lines' in the options.
Repeat this for all UV's the model uses. Close the UV-window and rename the texture file in the 'outliner'. Export the file.
(note: win-wings does not support PNG-format, use BMP)

You may want to look at Daniel Walker's [[F_C_Textures|texture guide]] (2006).

*Beginners and non-2D-artists may prefer to begin here: [[Modelling_103:_Texturing_for_the_2D_Challenged]] (2006), instead.
*There is also an old BB thread [https://bb.oolite.space/viewtopic.php?t=4718 Texturing with Wings3D] (2008-13)

== Step 2 ==

Now edit the file in your graphic software.

When you are satisfied with your results, save and go back to wings3D.
Most probably you have saved under a new filename, so 'import-image' it.
Now drag the edited texture to it's corresponding UV-Map.
Your texture should now appear on the model (place some light sources first).
Check if all the various parts line up correctly.

Edit the texture some more if you are not impressed with your results, save under the same name and in wings3D select 'refresh' image in the outliner.

== Export model ==

Before you export, make sure the texture images are 'internal'.
Export in *.dat-format.

win-wings users:
* Export in *.obj + *.mtl.
* Rename the texture references in the mtl-file from *.bmp to *.png)
* Open texturefiles and save as *.png.
* [[Oolite converters|Convert]] the obj+mtl files to *.dat format via Obj2DatTexNorm.py.

== Important comment from a_c ==
[[File:Gal-Tech-Arachnid-Mark1.png|thumb|right|320px|Arachnid Mark 1 (custom shaders disabled, used Oolite shaders)]]
[[File:Serpent Class Cruiser 2.png|thumb|right|320px|Serpent Class Cruiser]]
Some lighting and material tips here:

1. Decide what your ship should look like early on. Decide on the type of materials you need for each single part of it. Don't just go with it thinking that you just need to "dress it up" with a texture. If you do, it will most likely end up looking like the texture is a piece of color paper wrapped around a model.

2. Materials are divided into two major categories: metals and dielectrics (i.e. non-metals). Here are some basic guidelines for each:

'''Metals''':
- Specular: Usually white or some shade of gray, values usually in the range of 0.65 - 0.75. Metals can have tinted specular too, e.g. gold, copper. You define this tint in the specular map or with specular_color.
- Gloss: Up to the artist. Experiment until you see something you like.
- Diffuse: Pure metals always have black diffuse color.

'''Dielectrics''':
- Specular: Very low. Usually around (0.04, 0.04, 0.04). Dielectrics never have tinted specular, unless you are trying to create impossible materials. Things like water have even less specular. For example, the specular value used for the ocean specular reflections in the Lave is Earth OXP is 0.02. Some materials may have slightly different specular values, but normally they are low and materials with specular at around 0.4-0.5 are extremely rare to non-existent. If you are unsure what value to use for your material and you know it is a dielectric, use 0.04.
- Gloss: Depends. Normally on the artist and the appearance they want to achieve. Plastic for example usually has high gloss values but it is not a rule, just a guideline.
- Diffuse: Whatever color your material is. Important - DO NOT include lighting information in a diffuse map - it will look totally off when viewed from the wrong angles. Just put the color of the material there and let the shaders decide on how the lighting will look.

3. The type of material you want to use is not what your object of interest is made of, but what it is on the surface that will reflect the light. Practical example: If your ship is made of titanium and has a coat of paint all over it, the material you want to try to reproduce is paint (which is dielectric) and not titanium.

4. Re normal maps - Try to make details that have a purpose on them. The Arachnid above has a normal map with lots of details, but they are just fluff without purpose. Griff's ships have details on the normal map that seem to outline objects that "do something". The Serpent class above also.

5. Generally speaking, you will get much better results if you use spec and gloss maps rather than numeric values for spec and gloss in the material definition. The reason is that you can describe much better the variations of materials over your surface. You can also describe variations within the same material (e.g. a shiny ship that has a part of a wing that's rusty or dusty - this can be achieved only by texture).

6. Gloss is where an artist has completely free reign. While the other properties are more or less governed by physics, gloss is whatever you want it to be. That is your chance to be truly creative.

*[https://bb.oolite.space/viewtopic.php?p=271594#p271594 Some lighting and material tips] ([[User:Another_commander|Another_commander]] 2020)
*[https://bb.oolite.space/viewtopic.php?p=284933#p284933 Some experiments with Specular, Gloss & Diffuse textures (several posts)] ([[User:Cbr|Cbr]] 2022)

=== Planet textures ===
*[https://bb.oolite.space/viewtopic.php?f=2&t=21259 Planet illumination user defined colors] ([[User:Another_commander|Another_commander]] 2022)
*It should be possible to register places on the rotating planet texture ([https://bb.oolite.space/viewtopic.php?p=305966#p305966 Phkb, 2026])

== Internal Links ==
*[[OXP]]
*[[OXP howto]]
*[[OXP howto model]]
*[[Viewing a Texture or Model]]
*[[Modifying a Texture‎]] - old unedited page from 2009

=== Texture/Shaders related ===
*[[Shaders in Oolite]] (2010)
*[[Shaders in Oolite: uniforms]] (2007, updated in 2012 & 2016)
*[https://bb.oolite.space/viewtopic.php?f=2&t=19881 A Description of the Improved Lighting and Materials System] (2018)
*[https://bb.oolite.space/viewtopic.php?p=265300#p265300 Filmic Tonemapping] (2018)
*[[Materials in Oolite]] (2013)
==== Memory ====
*[https://bb.oolite.space/viewtopic.php?t=11913 Unoptimised textures] (2012) - reducing the byte-size of your texture
*[https://bb.oolite.space/viewtopic.php?t=7117 Do unused parts of texture hog memory?] (2009)

=== Other texture tutorials ===
*[[Smivs'_texture_tutorial]] (2010)
*[[Texturing tips and tricks by Theta Seven]] (2017 - a follow-up to Smivs' tutorial)
*[https://bb.oolite.space/viewtopic.php?f=4&t=11627 Understanding visual effects] (Smiv's cut and paste of tips, 2012) - achieving Griffification without shaders (See [[Dertien]]'s OXPs for other examples)
*[http://zgroovy.blogspot.com/p/notes.html Dertien's tutorial] (2012) includes tips on how to use the .dat converters.
*Shipbuilder's 2013 tutorial using his [[Arachnid Mark 1]] as a model:
:: His tutorial document can be downloaded in pdf format here https://app.box.com/s/adl2gw654juwlkamyeol
::The accompanying resource packs can be downloaded here https://app.box.com/s/njsbp935aseegsegh18l
*[https://bb.oolite.space/viewtopic.php?f=2&t=6054 SimonB's Tutorial] (2009) UV map, diffuse map, effects map, normal map.
*[[F C Textures]]: howto texture by Flying Circus (2006: pre-shaders; mirror planing a texture using Wings3D & Gimp)

*[https://bb.oolite.space/viewtopic.php?p=257563#p257563 Query & answer ''re'' the use of transparent texture files] (2017)

=== Planet textures ===
*Planets can now (v.1.90) have differently coloured atmospheres & city nightlights! See [https://bb.oolite.space/viewtopic.php?f=2&t=21259 Planet illumination user defined colors] (2022+).
:[[User:Phkb|Phkb]] has updated some half-dozen OXPs with such textures ([[Lave OXP]], [[Riredi]], [[Taranis]], [[Tianve OXP]], [[Sector1/Digebiti|Digebiti]], [[Draven]]; and Submersible's [[BPlanets]] also has them. See also a_c's [https://bb.oolite.space/viewtopic.php?t=21899 Reorte is Hot Giant] (2025).
*[[Blender Planet Textures]] (2016 but with more recent links)
*[https://drive.google.com/drive/folders/0B_OS-FIJTVDXY1BUZjkxSndDZUU?resourcekey=0-HSmNsvehVEmx-D9wELbH2Q Lave Texture Creation] (2014 how-to essay in Russian by Stranger)
*[https://bb.oolite.space/viewtopic.php?p=95355#p95355 Griff's Planet shader example] (2009) - based on planet Earth.
*[https://bb.oolite.space/viewtopic.php?p=69399#p69399 SimonB's GIMP tutorial] (2009) - starts with moons, and then Ahruman moves it onto planets.

==== Non-Oolite resources ====
*[https://forum.kerbalspaceprogram.com/index.php?/topic/165285-planetary-texturing-guide-repository/#comment-3167423 Planet texturing guide repository (KSP)] (2023)
*[https://bb.oolite.space/viewtopic.php?f=2&t=18638&start=15 Libnoise] (2017) A portable, open-source, coherent noise-generating library for C++ (Windows, Gentoo Linux)
*[https://www.cgtrader.com/free-3d-models/space/planet/nar-shaddaa-4k-star-wars-planet-texture Links to free planet textures (CGTrader.com)] - discussion on "what to do with them" starts [https://bb.oolite.space/viewtopic.php?p=285823#p285823 here]
*[https://jsplacementweb.pages.dev/# JSplacement] makes randomised hull panel-type and piping things if you're wanting to texture models.
:The little nine-dots at the top left gives you access to the different generators, ''Classic'' and ''2'' are plating and ''Wyre'' is for pipes
each has a bit of help guide if you change to it then go back to the nine-dots and click Digital Guide.
:''Save Height'' saves the image and it also gens up the normal map if you click ''Save Normal''.
[[File:Trade-Factor-Animation.gif |thumb|right|Ideas: Griff's SpecGloss Sidewinder showing deterioration due to lack of maintenance]]
[[File:Smivs'-cobra3-alternate-damaged.png|thumb|right|Ideas: Smiv's "damaged Cobra" texture]]

=== Ideas ===
==== Shaders ====
*[https://bb.oolite.space/viewtopic.php?f=4&t=21170 Griff's SpecGloss Sidewinder] shows the effects of changing [[Maintenance]] levels (2022)
:See his comment [https://bb.oolite.space/viewtopic.php?p=295645#p295645 here] on how he did it (2024)
*Griff's Shaders Treasury: a collection of 6 gifs/mp4's showing what can be done with shaders [https://drive.google.com/drive/folders/1ZCjoEBnXPo9qijN_Ek7V8NmkjXNSgI3N Download HERE!]
:changing maintenance levels (as above), engine glow, engine glow colour, gun and hull heat, Alert Status and Damage amount & finally, paint colour and Decals

==== Textures ====
*Smivs created a [[Smivs' ShipSet|damaged ship set]] which worked with the older versions of his [[BattleDamage|Battle Damage OXP]]. (2012)
*Griff's [https://bb.oolite.space/viewtopic.php?p=206321#p206321 experimental damaged textures] (2013)

[[File:Lib MatFinder Pos02.png|thumb|right|200px|Library OXP "MatFinder" add-on for aligning exhausts]]

=== Other help ===
*[[Oolite converters]] (links to helper scripts ''etc'')
*[[MatFinder]] for [[Library OXP]] - A developer-tool to work out materials entries
*Library_devtools.oxp for [[Library OXP]] - A developer-tool to test for all kinds of things
*[https://app.box.com/s/5xbksy48qr9cp31z2wpef6wjla05s3ih/folder/26357445023 Test Ship Model OXP (2023)] by [[User:Phkb|Phkb]] for viewing new ships (needs Oolite v.1.91).

== External Links ==
=== Wings 3D ===
*[http://www.wings3d.com/ Wings3D official home]
*[http://www.wings3d.com/paulthepuzzles/aardvarks.html Tuts and tips Wings3D (2008), by Aardvark]
*[https://www.youtube.com/user/MrDertien/videos YouTube classes in Wings3D] (2013-4) by [[Dertien]]

=== Blender ===
*[https://bb.oolite.space/viewtopic.php?f=4&t=10041 Blender 3d Modeling Tutorials] (2011-22), originally by [[User:Staer9|Staer9]], includes texturing
*[https://bb.oolite.space/viewtopic.php?f=4&t=13144 XYZ coordinates Blender to Oolite] (2012)
*[https://bb.oolite.space/viewtopic.php?f=4&t=18159 Textures in .dat-files / blender] (2016)

=== GIMP ===
*[https://bb.oolite.space/viewtopic.php?p=69600#69600 Textures in GIMP] (2009) by SimonB

=== GeeXLab (shaders) ===
*[https://www.geeks3d.com/geexlab GeeXLab] - recommended by [[User:Tricky|Tricky]] back in [https://bb.oolite.space/viewtopic.php?p=176638#p176638 2012]

=== General ===
*[[Modifying a Texture]] from 2009
*[https://bb.oolite.space/viewtopic.php?f=4&t=11627 Understanding visual effects] a 2012 compilation including a discussion on specular mapping
*[https://bb.oolite.space/viewtopic.php?f=4&t=5580 Skinner's Den] 11 pages of texturing tips (2009-date)
*[https://bb.oolite.space/viewtopic.php?p=264830#p264830 Putting it all together] (2018) by [[User:Phkb|Phkb]]
*[https://bb.oolite.space/viewtopic.php?p=271594#p271594 Lighting & Materials tips] for the newer versions of Oolite (2020) by [[User:Another_commander|Another_commander]]
*[https://bb.oolite.space/viewtopic.php?p=295581#p295581 Suppressing the sun's shadows] (2024) by [[User:Another_commander|Another_commander]]

=== Free textures ===
Eric Mayas has thousands of free textures here: https://soundimage.org/images-home-page/ (SciFi, metal, stone, vegetation ''etc''.)

=== Models needing texturing ===
There are a number of half finished models which just need texturing! some of which can be found here: [[Brilliant but broken...]] - see specifically Gsagostinho's station experiments, but there are also a number of ships.
==== Ships ====
*[[GHOST Gunship|GHOST (ASAD) Gunship]]
==== Stations/Dockables ====
*[https://bb.oolite.space/viewtopic.php?p=281398#p281398 Amaranth's Refinery Station] (2013) - originally part of a projected Corporate States oxp
*[[Colonization]], Okti (2012, CC BY-SA 3.0) - originally part of a projected activity/mission
*'''Gsagostinho's station experiments''' ("Public Domain", 2017) [https://bb.oolite.space/viewtopic.php?f=4&t=18977 here].
*[https://bb.oolite.space/viewtopic.php?f=4&t=11711 Oolific Princess] adds a dockable starliner, [[User:Simon_B|SimonB]], 2012
==== Other ====
There are also many untextured models here: https://www.solcommand.com/ including stations, ships, greebles, floating gas giant cities ''etc''.

The other thing which would be great would be more moons (there are only 20 or so of them) and more planets with city lights added in!

[[Category:Oolite]] [[Category:Factual]] [[Category:Oolite scripting]]

Expansions Manager

2026-08-02T14:07:32Z

Cholmondely: Commented out the warning box (oolite.org being down)

[[File:Expansions Manager.png|right|thumb|500px|In-game Expansions Manager (Surround is from [[XenonUI]])]]
The Expansion Pack Manager was devised by [[User:Cim|Cim]] for Oolite v.1.80 (2014), and ushered in the move from [[OXP]]s to OXZs.

== Expansion Packs and Catalog ==

*Note that there are many Expansions (OXPs/OXZs) which are not listed in the Manager. See [[Guide to Unlisted OXPs]]
*Note that the Expansions Manager depends on ''this'' wiki - if this wiki is down (and you are - for example - looking at a backup of this page), you will need a [https://bb.oolite.space/viewtopic.php?p=273722#p273722 workaround].

Oolite allows to be extended via Addons and [[OXP]]s. Expansion packs that are registered to the [https://github.com/OoliteProject/oolite-expansion-catalog Expansions Catalog] and it's [https://ooliteproject.github.io/oolite-expansion-catalog/index.html browsable version]
can be downloaded and installed automatically.

== Using the builtin Expansion Pack Manager (EPM) ==

This is about the expansion manager that is available within Oolite.

'''The arrow keys ← & → skip between pages - and the arrow keys ↓ & ↑ move up and down within a page.'''

'''Press i for more information on your chosen expansion pack''': The URL for even more information is copied to your clipboard automatically when you do this (unless your computer runs Unix and you are playing Oolite v.1.90 or older).

'''Press f to filter the selection of 700-odd listed expansion packs.''' (''eg'' Search for keyword, Search for author, list only uninstalled packs ''etc'')

----



{| border="2" style="margin: 1em auto 1em auto;"
|style="background-color: #aabbbb;padding: .6em 3em 1em;"|
<center>'''Important Note'''</center>
The current Windows Pre-releases/"nightlies" now allow you to directly skip to the OXP category (''eg'' .Ambience, Ships, Weapons ''etc''.), rather than scroll through dozens of pages to get there! 
They can be downloaded from the very bottom of the [https://oolite.space/#download Downloads page] or directly from GitHub, [https://github.com/OoliteProject/oolite/releases here].
|}

[[File:XenonUI (Expansions Manager).png|thumb|right|500px|The [[XenonUI]] OXP now provides all this information on your screen! 
On the left (Sub-Commands): filter/information/extract contents 
On the right: guide to colours]]
=== Guide to Expansions Manager list colours ===
:'''Yellow''' Ready to download and install.
:'''White''' Installed and at the current version.

:'''Cyan''' Installed; updated pack available for download.
:'''Orange''' Ready to download, but Oolite will also download extra packs to make it work.
:'''Brown''' Conflicts with an already installed pack.
:'''Gray''' Incompatible with this version of Oolite.

:'''Red''' Manually installed: cannot also be installed automatically (''eg''. a tweaked oxp in the AddOns folder)
:'''Blue''' Installed but no longer available for download.

----
=== Downloading and Unzipping an Expansion for Tweaking ===

''or for extracting information - for example, [[User:Ramirez|Ramirez]]'s oxz's contain glorious .pdf's stashed full of information!''

*Go to the '''Expansion Pack Manager''' in game.
*Select '''List installed expansion packs''' (the ''second'' choice at the bottom of the screen).
*It will now show you the list of OXZ files in your ManagedAddOns folder.
*Highlight the one you want to fiddle with and press '''x'''.

*Oolite will then extract the OZX to your AddOns folder and add .off to the end of the expanded (was .oxz but is now .oxp) folder.
*Change this '''.off''' to '''.oxp''' or '''.txt''' and tweak away to your heart's delight!

*Oolite will now ignore the original version and will run the newly-expanded OXP version in AddOns (with any changes you now make to it).
''If you make a mess of it, deleting the .oxp version (in the AddOns folder) will cause Oolite to go back to using the OXZ version (in the Managed AddOns folder).''

== Out-game Expansions Manager ("Oolite Starter") ==

[[File:Oolite Start v.0.1.7.png|right]]

The [[Oolite Starter]] allows easy switching between bnuches of Oolite versions, OXPs and savegames. Mr. Gimlet guides novice users (and does not hold back advising experienced ones).
See v0.1.35 (Mar '26) at [https://github.com/OoliteProject/OoliteStarter this Github repository]. There are installers for Linux, Mac and Windows.

'''Reference''': Thread with posts starts [https://bb.oolite.space/viewtopic.php?p=289311#p289311 here] (May 2023)

== Tweaking OXPs ==
(''adapted from LittleBear's [https://bb.oolite.space/viewtopic.php?p=273769#p273769 BB post]'')
*The Windows text editor sneaks in invisible bits of code which muck up the OXPs: '''Avoid it like the plague!'''
*To edit I'd recommend Edit Pad Lite 8. It's free, won't mess up the file format and is colour coded (so will highlight code typos).
*''Eg''. If you have missed a ''',''' or a '''"''' in a text string, it will show up as ''white'' rather than ''yellow'', so you can quickly see the mistake. ;-)

*Been a bit of a blessing when I've been C&Ping long lists of procedurally generated text from my latest.log to my array file.

*See discussion [https://bb.oolite.space/viewtopic.php?p=273782#p273782 here] for AppleMac suggestions.
*See [[How to tweak OXZ's]] for more tweakish details.

== Scenario OXP's ==
These OXP's create a scenario and force all other oxp's out of the game (unless you tweak the scenario to let one or two back in!). The only examples so far are the SOTL oxp's. There is an issue with the Expansions Manager:
But ... one reason I didn't put SOTL in the manager is that [[SOTL Exploration]] depends on Loader, so if you install Exploration, you get the Loader OXP too (ie: Song_of_the_Labyrinth_Startup_1.1). Loader can't depend on Exploration, because if it did, Exploration won't load in the core scenario, and then Loader won't load because Exploration isn't there, and then you can't actually start the scenario game. But that means when you're installing from the manager, if you install Loader it can't then auto-install Exploration ... and then if you try to run Loader it'll probably go wrong with an entirely unhelpful error message.

The manager ideally needs a new relationship type adding to handle that sort of "install-time but not run-time" dependency, but I never got round to that. (Cim 2021).

== Links ==
*[https://bb.oolite.space/viewtopic.php?p=273236#p273236 Expansion Manager Pack] Suggestions for change (2020).
*[https://bb.oolite.space/viewtopic.php?f=6&t=18077 copy information_url to clipboard] (2016-21).
*[https://bb.oolite.space/viewtopic.php?f=6&t=16888 User tags for expansions] (2014)
*[https://bb.oolite.space/viewtopic.php?f=2&t=16790 Are OXZ's an improvement ...] over OXP's (2014).
*[https://bb.oolite.space/viewtopic.php?f=2&t=16610 OXZ and balance] What should go on the Expansions Manager? (2014)
*[https://bb.oolite.space/viewtopic.php?p=210354#p210354 Cim's announcement] of the concept (2013)

*[https://bb.oolite.space/viewtopic.php?f=4&t=20932 Oolite's interaction with Expansion Packs] (2021)

=== Download Counter for oxp's ===
*[https://bb.oolite.space/viewtopic.php?p=287386#p287386 Suggestions for fixing it] (2022)

[[Category:Oolite]][[Category:Factual]][[Category:Help pages]]

Griff Industries

2026-08-02T13:49:36Z

Cholmondely: /* Griff's OXP Downloads */ Added more, tweaks

== About ==

Griff has been working on producing some fantastic models of ships, which use normalmapping and shaders to produce some of the best looking ships available in Oolite. All core ships and stations are now supported, with the release on the 3rd of November 2012 of the Ico station. Announcements are made on the forum, so keep an eye on [https://bb.oolite.space/viewtopic.php?t=6586 this thread].

== Gallery ==
<center>
{| align=center width=100% style="background: black;"
| [[Image:Griff_adder.jpg |link=Adder (Oolite) |200px]]
| [[Image:Griff_anaconda.jpg |link=Anaconda (Oolite) |200px]]
| [[Image:Griff_asp_mk2.jpg |link=Asp (Oolite) |200px]]
| [[Image:Griff_missile.jpg |link=Missile |200px]]
|-
| [[Image:Griff_asteroid.jpg|link=Asteroid_(Oolite) |200px]]
| [[Image:Griff_boulder.jpg‎ |link=Boulder_(Oolite) |200px]]
| [[Image:Griff_splinters.jpg‎|link=Splinters_(Oolite) |200px]]
| [[Image:Griff_alloy.jpg‎ |link=Metal_Fragment_(Oolite) |200px]]
|-
| [[Image:Griff_boa.jpg |link=Griff Boa |200px]]
| [[Image:Griff_boa_screenshot2.jpg |link=Boa (Oolite) |200px]]
| [[Image:Griff_boa_mk2.jpg |link=Boa 2 Class Cruiser |200px]]
| [[Image:Griff_barrel.jpg |link=Cargo Container (Oolite) |200px]]
|-
| [[Image:Griff_cobra_mk1.jpg |link=Cobra Mk.1 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff_cobra_mk3_scuffed.jpg |link=Cobra Mk.3 (Oolite) |200px]]
| [[Image:Griff cobra mk3 alt.jpg |link=Cobra Mk.3 (Oolite) |200px]]
|-
| [[Image:Griff_constrictor.jpg |link=Constrictor_(Oolite) |200px]]
| [[Image:Griff_coriolis_alt.jpg |link=Alternative Coriolis station (Oolite) |200px]]
| [[Image:Griff_ico.jpg |link=Icosahedron_Station_(Oolite) |200px]]
| [[Image:Griff_dodo_thumbnail.jpg |link=Dodo station (Oolite) |200px]]
|-
| [[Image:Griff_fer-de-lance_blinged.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_fer-de-lance_scuffed.jpg |link=Fer-de-Lance (Oolite) |200px]]
| [[Image:Griff_gecko_sharkteeth.jpg |link=Gecko (Oolite) |200px]]
| [[Image:Griff_gecko.jpg |link=Gecko (Oolite) |200px]]
|-
| [[Image:Griff_krait.jpg |link=Krait (Oolite) |200px]]
| [[Image:Griff-krait.jpg |link=Griff Krait |200px]]
| [[Image:Griff_mamba.jpg |link=Mamba (Oolite) |200px]]
| [[Image:Griff_moray.jpg |link=Moray Star Boat (Oolite) |200px]]
|-
| [[Image:Griff_python.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_python_alternative.jpg |link=Python (Oolite) |200px]]
| [[Image:Griff_Rock_Hermit.jpg |link=Rock Hermit (Oolite) |200px]]
| [[Image:Griff_escape_capsule.jpg |link=Escape Pod |200px]]
|-
| [[Image:Griff_sidewinder.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_sidewinder_alternative.jpg |link=Sidewinder (Oolite) |200px]]
| [[Image:Griff_shuttle.jpg |link=Shuttle (Oolite) |200px]]
| [[Image:Griff_transporter.jpg |link=Transporter (Oolite) |200px]]
|-
| [[Image:Griff_thargoid.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_thargoid_organic.jpg |link=Thargoid Warship (Oolite) |200px]]
| [[Image:Griff_Thargon.png |link=Thargoid Robot Fighter (Oolite) |200px]]
| [[Image:Griff_tharglet_organic2.jpg |link=Thargoid Robot Fighter (Oolite) |200px]]
|-
| [[Image:Griff_viper.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_viper_interceptor.jpg |link=Viper Interceptor |200px]]
| [[Image:Griff_viper_pursuit.jpg |link=Viper (Oolite) |200px]]
| [[Image:Griff_worm.jpg |link=Worm (Oolite) |200px]]
|-
| [[Image:Sainsboorys.png |link=Your Ad Here! |250px]]
| [[Image:Griff_dodo.png |link=Dodo station (Oolite) |200px]]
| [[Image:Griff Elite2 bug.jpg |Bug ship from an Elite 2 that didn't get made |200px]]
| [[Image:Griff_wolf_mkII.jpg |link=Wolf_Mk.2_(Oolite)|200px]]
|-
| [[Image:Griffhognose.jpg |link=Hognose |250px]]
| [[Image:Griff_viper_alt_wiki.jpg |link=Viper_(Oolite) |250px]]
| [[Image:Griff ophidian.jpg|link=Ophidian_(Classic) |250px]]
| [[Image:Griff elite2 griffin mk1.jpg|link=Griffin_Two_(Oolite) |250px]]
|-
| [[Image:Griff gnat.jpg |link=Classic_Elite_ships |250px]]
| [[Image:Griff Viper interceptor alt.jpg |link=Viper Interceptor |250px]]
|}
</center>
 

== Griff's Ship Sets ==
There are ''four'' sets of Griff ships!
*The Vanilla game ships in Oolite v.1.92 and later
:2026
:These are taken from the [[Oolite v1.88 Base Shipset Normal and Specular/Gloss Maps]] OXP
:They are simplified versions of the OXPs on the Expansions Manager but with normal, specular & gloss texture maps added - and using the new Oolite shaders system.
*The Vanilla game ships in Oolite v.1.90 and earlier
:2013
:These are simplified versions of Griff's OXPs on the Expansions Manager
*The OXPs on the Expansions Manager (excluding his specials such as Griff Clippers, Griff Prototype Boa, Griff's Glowroids ''etc''.)
:2013
:These do not have specular maps, but the ship models are more complex, and the textures and the shaders are ''much'' more complex. But they use the older Oolite shaders system.
:They also have special effects: more realistic exhausts, running lights and emergency lights (which dim when power is low), the Thargoids have special reflecting hulls, ''etc''.
*The unfinished SpecGloss series (only the SpecGloss Sidewinder is on the Expansions Manager - the other ships are on Box.com - see below).
:In Progress (2022 - date)
:These resemble Griff's OXPs but with much more detailed textures added - and adding in SpecGloss and Glowmaps. They also use the newer Oolite shaders system. See [https://drive.google.com/drive/folders/1_8EtoVvwNyXXvqe5GCGy1HuFRRw3NxB7?usp=sharing here] for downloads.

== Griff's "Expansions Manager" Downloads ==
All these ships are available in the Oolite [[Expansions Manager|Expansion Pack Manager]].

*'''Category:''' Retextures
*'''Griff Adder, Griff Alloys and Wreckage, Griff Anaconda, Griff Asp, Griff Asteroids, Griff Boa, Griff Boa MkII, Griff Cargopod, Griff Cobra MkI, Griff Cobra MkIII, Griff Cobra MkIII Alt, Griff Constrictor, Griff Escape Capsule, Griff Ferdelance, Griff Gecko, Griff Krait, Griff Mamba, Griff Mamba Alternative, Griff Missiles, Griff Moray, Griff Python, Griff Shuttle, Griff Sidewinder, Griff Station Bundle, Griff Thargoids, Griff Transporter, Griff Viper, Griff Worm
:These constitute the third set mentioned above.

*'''Griff's Normalmapped Ships (Replace):'''
:This is a meta-OXP, downloading all the individual OXPs listed above

*'''Note''': Spara's rebalanced bundle 'Meta-OXZ'. Available via the Oolite Expansion Pack manager, provides a single click install for all the Griff core shipset ships, bugfixed and rebalanced for better gameplay! This expansion pack is highly recommended over installing the shipset ships individually

*Griff Shipset Decals - this OXP is for adding Decals to Griff's ships (and is needed by his OXPs). See [[Decal]] for more on this

*Griff Clippers - Griffifies the Boa Clipper and Python Clipper from Smivs' earlier [[Clippers]] OXP
*[[Griff Boa|Griff Prototype Boa]] - the famous, utterly different "Griff Boa" - as below, under "Other OXPs"
*[[Griff's Glowroids]] - massive asteroids with a difference!

[https://app.box.com/shared/rpkms25cc9 ''Griff Ship Downloads''] on Box.com
* '''Resources''' - ''Not needed for gameplay'' - this folder contains various ship meshes and textures in .obj and .png format for interested modders

== Griff's Other OXPs ==
[http://www.box.com/shared/jf1et41yu3 ''Dodo Stations OXP by Griff and CaptKev''] (1.4Mb). 
Retextured Dodecahedron stations OXP, v1.1. Updated version released 18th May 2010, Griff has fixed a problem with the shaders.

''[[Flying Dutchman OXP]]'' (31.0Kb). 
Featuring Griff's Wireframe Cobra. 
Adds the small chance to meet a Ghost Ship in the Ooniverse. What is it? Some claim that it's the ghost of Commander Peter Jameson, reported lost at the end of the last Thargoid War, others that it is simply a manifestation of all those lost souls who were trapped in the trackless depths of interstellar space. One common story is the trail of bad luck and hideous deaths that follow in the wake of the ship's sightings...

[[Griff ArcElite|''Griff's ArcElite'']] (201.2 Kb). 
Adds all the ships from the Acorn Archimedes version of Elite, textured & shaded to resemble how they originally appeared in that version of the game.
Version 2.0 adds extra ships from Elite 'A', Elite 2 and the Amiga version of Elite

[[Griff Boa|''Griff's Boa OXP'']] (2.7Mb). 
Wiki link containing the famous Griff Boa, as featured in the ''"Oolite - It's not just for triangles anymore"'' images. Note: the Boa is not included in the ''Normalmapped Ships OXP'' as above. Note also that this OXP only works on Oolite 1.74 and higher.

[https://www.box.com/s/162d02b7e79b1202689c ''Griff's Alloys & Wreckage OXP''] (1.5mb). 
Box.com link to an OXP for Oolite v1.75 and higher that adds a new models & texture for the 'Alloys'. The OXP also generates extra clouds of burning wreckage whenever ships explode. This OXP was updated on 24th March 2013 for more compatibility with the Griff Normalmapped Ships, Replacement version, and should be used in preference to the old ''Griff's Explosion Debris OXP''.

[[Griff Krait|''Griff's Krait OXP'']] (2.5Mb). 
A heavily modified Krait, similar in design to the Griff Boa. Note: ''this'' Krait is not included in the ''Normalmapped Ships OXP'' as above.

== Related OXPs by Other Authors ==

[http://www.box.com/shared/t3n98yhk6n ''Illicit Unlock - Griff Version''] by ADCK (3.5Kb). 
Based on the original Illicit Unlock, Allows the player to fly Griffs pirate/viper Ships. (Requires ''Griff's Normalmapped Ships'' )

Bugfixed and updated files for the oxp by Dertien (requires overwriting files in ADCK's original oxp) - [http://www.box.com/shared/jq8biuf21o ''Download'']

''[[Random Hits OXP]]''. 
Featuring many Ships/Stations made by Griff.

[[Your_Ad_Here!|''Your Ad Here! OXP'']]. 
Featuring Griff's Tradestations.

[[Staer9%27s_Shipset|''Staer9's Shipset'']]. 
Adds more ships based on Griffs models.

[https://bb.oolite.space/viewtopic.php?f=4&t=9306 ''ZGrOovy Griff System Stations OXP''] by Dertien (on the Oolite BB). 
Using Griff's station textures, adds five new model stations, from the small Tetrahedron and Octahedrons, through the standard sized Coriolis, to the large Dodecahedron and Icosahedron stations. 

[[Black_Monk_Monastery|''Bank of the Black Monks'']] by LittleBear. Version 2.0 maintained by spara [https://bb.oolite.space/viewtopic.php?p=238880#p238880 ''See here for details''].

== Lore ==
Added by [[The Assassins Guild OXP]]

The [[Sector7/Ateslete|Ateslete]] system in galaxy 7 is reasonably noted for the ice-world, Stymphal. The well known robotics company, '''Griff Research Ltd''', operates factories over most of the planet and maintains an orbital research station near Stymphal.

The company was originally founded to produce droids and other artificial life forms, enjoying much success winning the coveted “Which Droid?” award for a decade. Perhaps their most famous design was the [[Griff Robotic Cargo Loader|Robotic Cargo Loader]] which is still in service in all sectors. In recent years the company has diversified into building high specification ships and stations to order. Examples of their known designs include providing the Bank of the Black Monks of St Herod with a fearsome [[Black Monk Monastery|armed orbital platform]] and the [[Black Monk Gunship|Holy Avenger Mark II Tri-Laser Gunship]].

The company's main ship design work is however highly classified, their most regular client being the [[Galactic Navy]]. Griff Research Ltd has constructed several Frigate Class vessels for the Navy, in addition to new types of weapons. No further details are available, although it is rumored that the Company is returning to its roots as a robotics company, in a current design brief.

== Complete Catalogue of Griff's oeuvre (2006 - date) ==
See here: [[User:Griff/OXP Catalogue‎]] for an attempt at this (not fully formatted yet)

{{Retextures-OXP}}
{{Ship-OXP}}

[[Category:Griff Industries| ]]

Interstellar Tweaks

2026-08-02T08:57:30Z

Cholmondely: /* Relation to other expansion packs */ Updated further

[[File:Light Destroyer (Galactic Navy AddOns).png|thumb|300px|right|Interstellar Tweaks interacts intelligently with many other OXPs, adding depth to Oolite. Such as this [[Navy Light Destroyer]] from [[Galactic Navy Additions]] (''Not'' on the in-game Expansions Manager)]]
[[File:Genship.png|thumb|300px|right|Interstellar Tweaks adds rather more to interactions with the massive [[Generation Ships]]. The little blob on the upper right is an enormous Galactic Navy [[Behemoth]]! ]]
Rather more excitement in interstellar space!

==Overview==

This OXP makes misjumps a little more likely and, fairly often, generates one of various (mostly) exciting witchspace scenarios.

==Requirements==
* The expansion pack requires Oolite version ''1.82'' or above.
* The pack draws upon various other expansion packs, if they are installed. (See below.)

==General notes==

The scenarios at issue include, but are not limited to, the following things happening within interstellar space.

* Encountering the navy battling thargoids (though some other OXPs provide something on those lines).
* Having your escape pod rescued. (Hooray! And your chances of rescue are increased by having - merely possessing - the 'electronic thumb'; a different OXP makes that equipment available.)
* Encountering bounty hunters. (Hooray?)
* Encountering pirates. (Boo?)
* Developing 'witchspace sickness'. (Definitely boo.)
* Ending up in a high radiation area, which can kill you whilst you are there but has no long-lasting effects. (So, mostly: boo.)
* Meeting rebel thargoids. (Hooray!)
* Finding derelicts within interstellar space.

Also, though this is something that happens when one leaves witchspace: this OXP gives you a chance of ending up near - or, er, very near - the system's sun. (Er . . handy?)

==Relation to other expansion packs==

'''OXPs which Interstellar Tweaks enhances/uses'''

Interstellar Tweaks can draw upon all of the following (and indeed, but in a fairly trivial way, a few that I do not list here) - but it ''requires'' none of them. Most but not all of the packs are available via the in-game Expansions Manager. (The remainder will have to be downloaded and installed manually. The in-game expansions manager will suggest - as accompaniments to Interstellar Tweaks - only those packs that are available via that manager.)

:* [[Armoury]]
:* [[Behemoth]]
:* [[Breakable 'Standard' Equipment OXPs|Breakable WitchDrive]]
:* [[BGS]]
:* [[Escape Pod Locator OXP]]
:* [[Extra Thargoids]]
:* [[Fer-de-Lance 3G OXP]]
:* [[Fuel Collector OXP]]
:* [[Galactic Navy]] - not on Expansions Manager - see [[Galactic Navy OXP]] for download details - there are several variants and GN addons to choose from
:* [[Generation Ships OXP]]
:* [[User:Griff|Griff's]] shipset expansion packs (for, especially, nice looking thargoids!)
:* [[Interstellar help OXP]] - with its 'Electronic Thumb'
:* [[Military Fiasco]]
:* [[Misjump Analyser]]
:* [[Missionaries OXP]]
:* mPakRedux (a.k.a. 'Rusties') - not on Expansions Manager - see [[Second-hand ships]] for download details
:* [[Staer9 Spectre]] - not on Expansions Manager
:* [[TCAT OXP|To Catch a Thargoid]]
:* [[Thargoid Carrier]] - not on Expansions Manager (this will considerably increase the thargoid threat - though the Fer-de-Lance 3G OXP will somewhat offset that);
:* [[Thargorn Threat]]
:* [[Tionisla Orbital Graveyard]] together with its 'TOGY_Shipwreck pack'

'''Compatibility'''

Interstellar tweaks tries to be compatible with the following expansion packs.

* [[Thargoid Witchspace Drive]] - not on Expansions Manager
* [https://bb.oolite.space/viewtopic.php?f=4&t=9242 Wormhole drones] - not on Expansions Manager
* [[Galactic Misjump OXP]] - not on Expansions Manager
* [[Her Imperial Majesty's Space Navy]] (at least up to a point)

==Other points==
* The load that Interstellar Tweaks will place on your computer will be, for the most part, light to moderate (and, mostly, via CPU much more than RAM and graphics card). That is so especially for Interstellar Tweaks version ≥ 7.5. Yet, if you install many expansion packs with which Interstellar Tweaks can interact, then that will increase the load.

* The difficulty of this expansion pack varies automatically, in various ways, with the player's [[Elite Rating]].

==License==
This expansion pack is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

You are free:
* to copy, distribute, display, and perform the work;
* to make derivative works.

But only under the following conditions.
* Attribution: you must give the original author credit.
* Non-commercial use: you may not use this work for commercial purposes.
* Share Alike: if you alter, transform, or build upon this work, you may distribute the resulting work only under a license materially identical to this one.

Your fair use right and other rights are in no way affected by the above.

==Acknowledgements==

My thanks to the following (from some of whom I have adapted code):

*Another Commander
*Arexack Heretic
*Capt. Murphy
*cim
*Commander McLane
*Draco Caeles
*Duggan
*Dr Nil and other contributors to the 'Your Ad Here' expansion pack
*Eric Walch
*Gimi
*Norby
*phkb
*SirAdrian
*Thargoid
*Solonar
*Switeck

Thanks also to Cholmondely, our indefatigable archivist.

==Download==
*Downloadable through the in-game [[Expansions Manager]]

*Or here: [[File:Oolite.oxp.UK_Eliter.InterstellarTweaks.oxz]]
*Rather older downloads are here: [[File:InterstellarTweaks.oxz]]

{{Infobox OXPb| title = Interstellar Tweaks
|version = 1.82
|release = 6.67
|license = CC BY-NC-SA 3.0
|features = surprises!
|category = Mechanics OXPs
|author = [[User:Uk Eliter|Uk Eliter]]
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=11864 BB Thread]
}}

Interstellar Tweaks

2026-08-02T08:07:06Z

Cholmondely: Added some pretty pictures - and some tweaks

[[File:Light Destroyer (Galactic Navy AddOns).png|thumb|300px|right|Interstellar Tweaks interacts intelligently with many other OXPs, adding depth to Oolite. Such as this [[Navy Light Destroyer]] from [[Galactic Navy Additions]] (''Not'' on the in-game Expansions Manager)]]
[[File:Genship.png|thumb|300px|right|Interstellar Tweaks adds rather more to interactions with the massive [[Generation Ships]]. The little blob on the upper right is an enormous Galactic Navy [[Behemoth]]! ]]
Rather more excitement in interstellar space!

==Overview==

This OXP makes misjumps a little more likely and, fairly often, generates one of various (mostly) exciting witchspace scenarios.

==Requirements==
* The expansion pack requires Oolite version ''1.82'' or above.
* The pack draws upon various other expansion packs, if they are installed. (See below.)

==General notes==

The scenarios at issue include, but are not limited to, the following things happening within interstellar space.

* Encountering the navy battling thargoids (though some other OXPs provide something on those lines).
* Having your escape pod rescued. (Hooray! And your chances of rescue are increased by having - merely possessing - the 'electronic thumb'; a different OXP makes that equipment available.)
* Encountering bounty hunters. (Hooray?)
* Encountering pirates. (Boo?)
* Developing 'witchspace sickness'. (Definitely boo.)
* Ending up in a high radiation area, which can kill you whilst you are there but has no long-lasting effects. (So, mostly: boo.)
* Meeting rebel thargoids. (Hooray!)
* Finding derelicts within interstellar space.

Also, though this is something that happens when one leaves witchspace: this OXP gives you a chance of ending up near - or, er, very near - the system's sun. (Er . . handy?)

==Relation to other expansion packs==

'''OXPs which Interstellar Tweaks enhances'''

Interstellar Tweaks can draw upon all of the following (and indeed, but in a fairly trivial way, a few that I do not list here) - but it ''requires'' none of them. Most but not all of the packs are available via the in-game Expansions Manager. (The remainder will have to be downloaded and installed manually. The in-game expansions manager will suggest - as accompaniments to Interstellar Tweaks - only those packs that are available via that manager.)

:* [[Armoury]]
:* [[Behemoth]]
:* [[Breakable 'Standard' Equipment OXPs|Breakable WitchDrive]]
:* [[BGS]]
:* [[Escape Pod Locator OXP]]
:* [[Extra Thargoids]]
:* [[Fer-de-Lance 3G OXP]]
:* [[Fuel Collector OXP]]
:* [[Galactic Navy]] - not on Expansions Manager - see [[Galactic Navy OXP]] for download details - there are several variants and GN addons to choose from
:* [[Generation Ships OXP]];
:* [[User:Griff|Griff's]] shipset expansion packs (for, especially, nice looking thargoids!) - for those using older versions of Oolite
:* [[Interstellar help OXP]] - with its 'Electronic Thumb'
:* [[Military Fiasco]]
:* [[Misjump Analyser]]
:* [[Missionaries OXP]]
:* mPakRedux (a.k.a. 'Rusties') - not on Expansions Manager - see [[Second-hand ships]] for download details
:* [[Staer9 Spectre]]
:* [[TCAT OXP|To Catch a Thargoid]]
:* [[Thargoid Carrier]] (this will considerably increase the thargoid threat - though my Fer-de-Lance 3G expansion pack will offset that increase somewhat);
:* [[Thargorn Threat]]
:* [[Tionisla Orbital Graveyard]] together with its 'TOGY_Shipwreck pack'

'''Compatibility'''

Interstellar tweaks tries to be compatible with the following expansion packs.

* [[Thargoid_Witchspace_Drive]]
* [https://bb.oolite.space/viewtopic.php?f=4&t=9242 Wormhole drones] - not on Expansions Manager
* [[Galactic Misjump OXP]] - not on Expansions Manager
* [[Her Imperial Majesty's Space Navy]] (at least up to a point)

==Other points==
* The load that Interstellar Tweaks will place on your computer will be, for the most part, light to moderate (and, mostly, via CPU much more than RAM and graphics card). That is so especially for Interstellar Tweaks version ≥ 7.5. Yet, if you install many expansion packs with which Interstellar Tweaks can interact, then that will increase the load.

* The difficulty of this expansion pack varies automatically, in various ways, with the player's [[Elite Rating]].

==License==
This expansion pack is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

You are free:
* to copy, distribute, display, and perform the work;
* to make derivative works.

But only under the following conditions.
* Attribution: you must give the original author credit.
* Non-commercial use: you may not use this work for commercial purposes.
* Share Alike: if you alter, transform, or build upon this work, you may distribute the resulting work only under a license materially identical to this one.

Your fair use right and other rights are in no way affected by the above.

==Acknowledgements==

My thanks to the following (from some of whom I have adapted code):

*Another Commander
*Arexack Heretic
*Capt. Murphy
*cim
*Commander McLane
*Draco Caeles
*Duggan
*Dr Nil and other contributors to the 'Your Ad Here' expansion pack
*Eric Walch
*Gimi
*Norby
*phkb
*SirAdrian
*Thargoid
*Solonar
*Switeck

Thanks also to Cholmondely, our indefatigable archivist.

==Download==
*Downloadable through the in-game [[Expansions Manager]]

*Or here: [[File:Oolite.oxp.UK_Eliter.InterstellarTweaks.oxz]]
*Rather older downloads are here: [[File:InterstellarTweaks.oxz]]

{{Infobox OXPb| title = Interstellar Tweaks
|version = 1.82
|release = 6.67
|license = CC BY-NC-SA 3.0
|features = surprises!
|category = Mechanics OXPs
|author = [[User:Uk Eliter|Uk Eliter]]
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=11864 BB Thread]
}}

Risky Business

2026-08-02T07:13:31Z

Cholmondely: Added a little more

[[File:IconLib.png|right]]
Improves profits in pirate-ridden systems

== Overview ==
Risky Business aims to make Multi-Gov, Feudal and Anarchy systems more rewarding for traders, by tweaking prices on a few goods. Goods that are already over the average could be increased. Goods that are below the average could be reduced. Not all goods will be impacted at all locations.

== Detail ==
RB doesn't look at the local systems so much as just assuming a dangerous system (ie. Anarchy, Feudal, Multi-Gov) will have some high-demand commodities. It will randomly pick a couple of commodities that are already above or below average and basically make them more so. So you might occasionally find computers for sale at well over the galactic average, or furs for well under. So computers in [[Sector1/Ararus|Ararus]] might sell for 120₢/TC.

This contrasts with Cim's [[Risk Based Economy OXP]] which also tweaks the markets, but instead "adjusts prices according to trade volume - so safer systems have more 'centred' prices, and hub systems have more 'centred' prices." It looks at how safe/dangerous a system is, based on the type of local systems surround it, and moves prices accordingly. R-BE's focus is on the market as a whole, rather than extreme pricing for just one or two commodities.

This also contrasts, more markedly, with [[Real-Life Economics]] which is based on the assumption that traders would ignore the piracy and restore pricing equilibrium where extreme economic systems were close (eliminating the better [[Milkrun|milk-runs]]).

== Two oxp's for the price of one! ==
=== Risk-based economy: choose with Library Config ===
The current version also incorporates Cim's [[Risk Based Economy OXP]].

"Risk-based economy" not only considers the politics of the system but also the hub-ishness of it (how many other trading systems are in the region), ''and'' affects prices in a more global fashion.

You can choose to implement the one, the other or both through selecting Library oxp's ''Config for AddOns'' on the [[F4 screen (ship and system interfaces)]].

[[File:Supply & demand.png|right|320px]]
== License ==
*Author: Phkb
*License: CC-BY-SA-NC 4.0
*Version: 0.2
*Requires: Oolite v.1.81 or newer, [[Library OXP|Library]], [[Market Script Interface]]

== Download ==
*Downloadable through the in-game [[Expansions Manager]]
:or manually:
*[[Media:RiskyBusiness.oxz|RiskyBusiness.oxz]]
:Download, unzip and pop into your AddOns folder (see [[OXP]] if you need more detail).

== Links ==
Discussion can be found here: [https://bb.oolite.space/viewtopic.php?f=4&p=271089 BB Link].
*Author: [[User:Phkb|Phkb]]
*[[Economics]]
*[[Oolite Trading]]

== Gameplay and Balance Indicator ==
[[File:Tag-colour-blue.png|right]]
Better rewards for dangerous trading.

{{mechanics-OXP}}

Quarantine

2026-07-30T23:40:36Z

Cholmondely: /* Note */ Update

[[File:GalCop Missions GNN Quarantine.png|right|600px]]
[[File:GalCop Missions Docked Quarantine.png|right|600px]]
Some OXPs can put systems into quarantine.

== Overview ==
Outbreaks of plague can cause GalCop or the system itself to place the system into Quarantine.

The OXPs known to describe/enable this are [[GNN]], [[GalCop Missions]] and [[Rescue Stations|Rescue Stations/RSS]].

The information can also be independently broadcast by the GalCop Missions and RSS through [[GNN]] - and also be placed on the [[F7 screen (data on "system")]].

There can also be viewscreen messages with this information. Eg.: Warning. Isanlequian disease infection rates are high. Please remain within designated visitor areas.

Entry to such a system can result in [[Law|criminalisation]].

=== Terminology ===
*The '''Galactic Centre for Disease Control''' is created by GalCop Missions
*'''GalMed''' is created by Rescue Stations

=== Note ===
[[User:Phkb|Phkb's]] April 2026 version of GalCop Missions enhances all the various OXPs which impact on "Quarantine" and creates a logical relationship between them all.

[[Category:Concepts]]

Misjump

2026-07-30T10:38:02Z

Cholmondely: Added "Drive malfunctions"

[[File:Misjump (BGS new).png|thumb|right|300px|Sequence for misjump: [[BGS]] (new version)]]
== Misjumps ==
These usually happen as a result of poor maintenance. One is marooned in interstellar space or witchspace, often surrounded by Thargoids! This can prove to be lethal.

There ''might'' be enough fuel left in the tank to escape to the nearest system, but that is not a given. Sometimes it might be possible to use another's witchspace tunnel to escape.

There are a large number of oxp's which modify all this.

=== Links ===
*WitchSpace/[[Hyperspace]]
*[[Thargoids]]
*[[Dealing with Thargoids]]
*[https://bb.oolite.space/viewtopic.php?f=11&t=9649 Derelict] by Ganelon - fiction
*[https://bb.oolite.space/viewtopic.php?f=11&t=13049 An Ideal Victim!] by Cody - fiction

 '''OXP's'''
[[File:Wide-screen-hud-3.png|right|thumb|480px|Wide-Screen HUD's "Jump Stability Meter" on the far left]]
*[[Enhanced Misjump OXP]] enhances the tunnel for the witchspace misjump (2011 - before BGS below) - this one is ''very'' clever
*[[BGS]] oxp gives an enhanced tunnel for the witchspace jump - which alters when you misjump (see above for the newest BGS version - the older version is different)
*[[Galactic Misjump OXP]] - this OXP is a mere "proof of concept"
*[[Interstellar Tweaks]] - a much wider range of encounters/adventures (needs supplementary OXP's too)
*[[Wide-Screen HUD]] includes a "Jump Stability Meter" which appears during countdown.

 '''OXP's which help!'''
*[[Fuel Collector OXP]] - collect fuel (very slowly!)
*[[Fuel Tank]] - with links to 3 alternative OXP's
*[[Galactic Navy OXP]] - allies against the Thargoids (and can maybe hitch a lift or buy fuel).
*[[Interstellar help OXP]] - buy an electronic thumb!
*[[Misjump Analyser]] OXP
*[[Wormhole restoration OXP]] - defeat the Thargoids to reopen your wormhole

== Force Misjump ==
'''Don't''' do this unless you are either experienced or feeling suicidal!

The way to force mis-jump may follow thus:

1. Pick target system
2. Exit station
3. Get far enough away to jump
4. Initiate hyper-space countdown
5. Hold down the ''up arrow'' or the ''down arrow'' key (this may vary depending on your computer! - and you need ''maximum'' pitch when the count reaches 0 - and a joystick might not manage perfect maximum)
6. Finish countdown
7. Blast those bugs!

If this does not work, you may either need to update [[Oolite]] or simply play normally.

== Drive malfunctions ==
"Drive malfunction - missed witchpoint!" - this is caused by [[Interstellar Tweaks]]

=== Links ===
*[[Misjump Inducer]] OXP
*[[User:Switeck|Variable Jump Drive OXP]] - "misjump" 11% of the way to the next system - or 73% of the way...

*[https://bb.oolite.space/viewtopic.php?f=6&t=7917 Debate on use of fuel and time] (2010)
*[https://bb.oolite.space/viewtopic.php?t=13729 Thread with useful advice] (2013)
*[https://bb.oolite.space/viewtopic.php?f=2&t=17152 Misjumpier] (2015) What else might happen?
*[https://bb.oolite.space/viewtopic.php?t=18365 Thargoids in interstellar space and deliberate misjumps] (2016) Why are they ''always'' there - and how many of them are there?
*[https://bb.oolite.space/viewtopic.php?p=261936#p261936 a_c on perfecting your misjumps!] (2018)
*[https://bb.oolite.space/viewtopic.php?f=2&t=21345 How to cross VOIDS in Oolite!] (2022)

[[Category:Oolite]]
[[Category:Concepts]]

Black Market

2026-07-28T23:45:49Z

Cholmondely: Added pretty picture

[[File:Rock Hermit Locations.png|right|600px]]
Adds black markets to most Rock Hermits and some other stations.

==Overview==
When docked at most non-GalCop stations (Rock Hermits, predominantly), and even GalCop stations in some systems, you will find a new interface screen called "Black Market". This interface provides access to a number of options: 
a. Noticeboard: View some of the messages from the black market news boards. Some are good, some aren't. You might even learn about some tasty abandoned cargo! 
b. Smuggling contracts: These contracts will be smaller cargo quantities (less than 20t), and they will all be illegal at the destination system, so there will be a high degree of risk with each one. However, the rewards will be substantial, more than double what the cargo would be worth at the destination. ([[Smugglers - The Galactic Underworld|Smugglers OXP]] required) 
c. Purchase fake import permits: You can purchase fake import permits that may or may not work at the destination system. The chance is only a slightly better than 50%. ([[Smugglers - The Galactic Underworld|Smugglers OXP]] required) 
d. Purchase Rock Hermit waypoints: Finding Rock Hermits is important, as they are the primary location to access the Black Market. Waypoints can help you find a Rock Hermit in a given system. 
e. Purchase phase scan settings: Not always available but occasionally a trader will offer their settings for a price. ([[Smugglers - The Galactic Underworld|Smugglers OXP]] required) 
f. Sell phase scan settings: If you have discovered a phase scan setting, you can sell it for some real coin! This will only be available once you have purchased a phase scanner. ([[Smugglers - The Galactic Underworld|Smugglers OXP]] required) 
g. Sell restricted equipment: If you've come into possession of some military grade equipment, you can potentially find a buyer on the black market. 

Please be aware that GalCop have been known to run sting operations at some Black Markets. If you are caught buying illegal information or goods through a Black Market while a sting operation is in place, you will be penalised.

==3rd Party Access To Black Market==
===Selling Custom Items===
It's possible for other OXP's to add items to be sold on the Black Market. You can add your item using the following method:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$addSaleItem({
key:"my_key_value", // reference to be passed back to your worldscript when the item is sold, so you can know which item it was
text:"A very exclusive item", // text to display on the sale screen
cost:1000, // the base cost of the item. a system factor will be applied to this value, either increasing or decreasing it
worldScript:"my_worldscript_name", // the name of your worldscript
sellCallback:"$my_functionname", // the name of the function to be called in the item is sold
});
}

this.$my_functionname = function(key, price) {
// this is the function that will be called. the key name and the price are two parameters of the function
// you can now do any additional functions that need to be done (eg removing special equipment or cargo)
}

Items added to the Black Market will stay there until the next witchspace jump. If you want to remove the item manually, you can use this function:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$removeSaleItem(key);
}

You can also remove all sale items for your worldScript with this function:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$removeWorldScriptItems(ws);
}

===Purchase Custom Items===
It's possible for other OXP's to add items to be purchased on the Black Market. You can add your item using the following method:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$addPurchaseItem({
key:"my_key_value", // reference to be passed back to your worldscript when the item is bough, so you can know which item it was
text:"A very exclusive item", // text to display on the sale screen
cost:1000, // the base cost of the item. a system factor will be applied to this value, either increasing or decreasing it
worldScript:"my_worldscript_name", // the name of your worldscript
purchaseCallback:"$my_functionname",// the name of the function to be called in the item is bought
});
}

this.$my_functionname = function(key, price) {
// this is the function that will be called. the key name and the price are two parameters of the function
// you can now do any additional functions that need to be done (eg adding special equipment or cargo)
}

Items added to the Black Market will stay there until the next witchspace jump. If you want to remove the item manually, you can use this function:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$removePurchaseItem(key);
}

You can also remove all purchase items for your worldScript with this function:

var sbm = worldScripts.Smugglers_BlackMarket;
if (sbm) {
sbm.$removePurchaseWorldScriptItems(ws);
}

==Developer Note==
This OXP used to reside inside the [[Smugglers - The Galactic Underworld|Smugglers OXP]], and so a lot of the code and descriptions are related to that OXP. However, I had the need of a Black Market for another project, and rather than force players to install Smugglers (which has a big impact on gameplay), I split out the functionality into a separate pack.

==Download==
Download [[Media:BlackMarket_1.7.oxz|BlackMarket_1.7.oxz]] 

==License==
This OXP is released under the Creative Commons Attribution - Non-Commercial - Share Alike 3.0 license. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/3.0/

Skull and crossbones image from http://simpleicon.com/dangerous_sign.html.

==Version History==
1.7
* Added Pirate Coves to list of RH's that will have a Black Market.
* Black Market Info Booklet now only purchasable through the Black Market.
* Added new section on Black Market: "Buy Other Items", with associated API calls.
* Added the buy/sell sound effects when buying/selling items.
* Switched to using logcontrol for debug messages.

1.6
* Added Black Market Info Booklet to Ship's Library (if installed).

1.5
* Darkened overlay images for better compatibility with Oolite 1.92.

1.4
* Moved all text into descriptions.plist for easier localisation.

1.3
* Added sound when a fuel leak occurs.

1.2
* Added missing noticeboard items to descriptions.plist.
* Small code improvements.

1.1
* Fixed issue that was displaying "You have a waypoint to a Rock Hermit in this system" on th F7 page for every system.

1.0
* Initial release

==Quick Facts==
{{OXPLevel|0}}{{IconOXP|ooVersion="1.80"|oxpCPU="Low"|oxpMEM="Low"|oxpGPU="Low"|oxpIsAPI=true|oxpIsDocumented=true}}
{{Infobox OXPb| title = BlackMarket.oxz
|version = 1.7
|release = 2026-05-10
|license = CC BY-NC-SA 4.0
|features = Rock Hermits
|category = Mechanics OXPs‏‎
|author = [[User:phkb|phkb]]
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=17723 Oolite BB]
}}

File:Rock Hermit Locations.png

2026-07-28T23:44:03Z

Cholmondely: Another crummy Cholmondeley Screen Shot From Black Market OXP

== Summary ==
Another crummy Cholmondeley Screen Shot

From Black Market OXP

OXP howto

2026-07-28T13:49:10Z

Cholmondely: Added links specifically for OXP categories (Ships, HUDs, Missions, etc).

:''Shortcut: EW:OXP and EW:HOWDS redirect here''
[[Image:oolite-oxp-icon.png|100px|thumb|right|OXP icon]]
[[File:Oolite-debug-menu.png|thumb|right|Debug Menu (From the AppleMac variety of the "Oolite TR" version)]]
==Overview==
An '''Oolite Expansion Pack''' can cause many big changes or additions to Oolite's gameplay, or it may represent just a small, subtle alteration. By first appearances, there is no way to tell what is inside, as it's merely a ''folder'' with the added extension '''.oxp'''.
Oolite Version 1.79 onwards supports also compressed files in ZIP format with extension '''.oxz'''.

To learn starting with a non-compressed version have a look at [[OXP_tutorial]].

{{QuoteText|Text=It's worth saying I think that compared with a lot of game addon architectures, the OXP architecture as designed by Giles is already very good at avoiding conflicts compared with a lot of other games
- you can save your game, add, remove and upgrade lots of OXPs, load your game, and have it work
- you can do this repeatedly, while incrementally upgrading the core game, for years
- as a player you basically never have to care about load order; as an OXP developer, rarely

It's also worth noting that a lot of types of OXP conflicts are inevitable due to resource conflicts - a planet can only have one diffuse map, a ship can only have one AI - or due to conceptual conflicts - OXP A removes all stations from a system; OXP B expects the player to dock there.|Source=([https://bb.oolite.space/viewtopic.php?p=241733#p241733 Cim (3rd Lead Developer)])}}

=== Oolite TR version ===
The Oolite Developer Release/Test Release version is specially developed for testing out OXPs. It comes with a [[Debug OXP]]/Debug Console allowing one to spawn ships/station on demand, award oneself a test ship, detect the mass of another ship ''etc''.

It is downloaded from the main Oolite website - currently http://www.oolite.space/download/

== OXZ ==
The new OXZ distribution format is strongly recommended. It makes version control and distribution just so much easier.

To make an OXZ file, use a ZIP program to compress the contents of the OXP folder, so that the [[manifest.plist]] file is in the root of the ZIP file, and the folders (AI, Config, etc) are folders in the ZIP file. Then, rename the ZIP file so that its extension is '''.oxz'''. To inspect an OXZ file, open it with your ZIP program.

Here is a sample: [[Media:X.0.1.oxz]] - just rename all "X" within to the title of your idea and put your name into the author fields.

You can use [http://www.ghisler.com/download.htm Total Commander] or [http://en.wikipedia.org/wiki/Krusader Krusader] to edit files within '''.oxz''' directly, without unpacking.

For more details read [https://bb.oolite.space/viewtopic.php?f=4&t=16688 The All-in-One Guide to OXZ Packaging and Distribution].

=== Creating an .oxz on an AppleMac ===
When you compress the files/folders on the AppleMac to create the .oxz ''do not'' select them with your mouse! This way lies misery!

Rather, ensure the relevant files/folders are inside one overall folder. Then, use '''command-a''' to select all the ''contents'' of this overall folder and then select '''compress''' from the file menu on the finder's menu bar. Finally, rename your newly-created .zip file as an .oxz

==Structure==
Inside the '''.oxp''' folder, or the '''.oxz''' file, it will at least contain a folder (Config, AIs, Models, Textures, etc...) that holds scripts, plists or other things like textures or models. It is down to the goal of the [[OXP]], which ways to combine elements to the OXP's contents. To get a feeling for it, simply take a look in other oxps. (If they are in .oxz format, any normal unzip program can inspect their contents - many will even let you edit the contents without having to unzip and rezip the file)

The structure for OXPs:
AddOns (folder)
~.oxp (really just another folder!) - Holds manifest.plist and the other folders:

--> AIs (folder) - Holds AI plists
--> Config (folder) - Holds all other plists (and possibly an anonymous "Script.js")
--> Images (folder) - Holds background images
--> Models (folder) - Holds the .dat files (special Oolite format)
--> Music (folder) - Surprise - holds .ogg music files
--> Scenarios (folder) - Holds new game scenarios (v1.79)
--> Scripts (folder) - Holds scripts (worldScripts and shipScripts)
--> Shaders (folder) - Holds Vertex and Fragment shaders (v1.69)
--> Sounds (folder) - Holds sound files
--> Textures (folder) - Holds models textures (can be planets, too!)
--> [[manifest.plist]] (file)
''the following might also be found in here:''
--> [[Misc plists|info.plist]] (file, seems to be a poor duplicate of the Manifest.plist)
--> [[Requires.plist]] (file: deprecated - replaced by Manifest.plist)

*If the OXP is in the uncompressed OXP folder format, the .oxp folder must contain a [[requires.plist]] file. If it is in the compressed OXZ single-file format, it must contain a [[manifest.plist]] file.

*[https://bb.oolite.space/viewtopic.php?f=4&t=13134 Nested OXPs in AddOns folder] (2012) - some OXZ's do this (Station spotter oxp inside [[Stations for Extra Planets]])

===AIs folder===
The folder named AIs contains any AI.plist additions the OXP might use.

* [[OXP howto AI|Making Oolite AI]]

In Oolite 1.79 AIs may be written in Javascript using .js files in this folder. A helper library is provided to make writing complex JS AIs simpler.

* [[Oolite PriorityAI Documentation]]
* [[Oolite PriorityAI Tutorial]]

===Config folder===
All plist files except for those introducing new AIs, ''[[requires.plist]]'', ''[[manifest.plist]]'' or ''[[Misc plists|info.plist]]'', belong in Config.

In its simplest form, an OXP could contain only a Config with an altering ''script.plist'' or ''planetinfo.plist''. An OXP that adds a new ship needs a ''shipdata.plist'' entry, and unless it is based entirely on existing Oolite data, would include a model and texture.

* [[OXP howto plist|Making Oolite plists]]
* Usually irrelevant: The Config folder isn't cached in the same way as the rest of an oxp because usually its contents merge rather than overwriting (See [https://bb.oolite.space/viewtopic.php?f=3&t=16927 here])
 
This folder contains [[Property lists]] such as:

* ''[[characters.plist]]'' that adds non-player characters to Oolite.
* ''[[crosshairs.plist]]'' that contains the look for your weapons (v1.73).
* ''[[customsounds.plist]]'' that contains references to ingame used sounds.
* ''[[descriptions.plist]]'' that adds vocabulary to Oolite texts.
* ''[[effectdata.plist]]'' defines custom visual effects (v1.77).
* ''[[equipment.plist]]'' lists upgrades available from the Shipyard.
* ''[[explosions.plist]]'' customises things blowing up (v1.81)
* ''[[global-settings.plist]]'' sets a few miscellaneous universal settings (v1.81)
* ''[[gui-settings.plist]]'' settings for reformatting the GUI screens (v1.81)
* ''[[hud.plist]]'' and ''[[hud.plist|hud-small.plist]]'' that allows for changes or a radically new ''Head-Up Display''.
* ''[[Oolite_Keyboard_Controls|keyconfig2.plist]]'' that allows for changes of the keymapping.
* ''[[missiontext.plist]]'' contains texts for the mission screens.
* ''[[OXPMessages.plist]]'' adds warnings to testversions of an oxp.
* ''[[planetinfo.plist]]'' that plots system specific changes from the default. May also contain ''script actions''.
* ''[[role-categories.plist]]'' for specifying groups of roles (''eg''.: trader, Miner, pirate ''etc''.) with similar properties (v1.79)
* ''[[scenarios.plist]]'' lists the starting scenarios in the Scenarios folder (v1.79).
* ''[[screenbackgrounds.plist]]'' that contains references to background images (v1.74).
* ''[[Scripting Oolite with JavaScript|script.js]]'' is the successor of [[script.plist]] in JavaScript.It will be loaded in preference to script.plist if both exist.
* ''[[shipdata.plist]]'' that introduces any new entity (ships, stations, objects etc.) to Oolite.
* ''[[shipdata-overrides.plist]]'' that selectively can replace shipentries in other shipdata.plists
* ''[[shiplibrary.plist]]'' that gives information for the ship description library viewable from the startup screen (v1.79)
* ''[[shipyard.plist]]'' that introduces new ships available for player purchase.
* ''[[shipyard-overrides.plist]]'' that selectively can replace shipentries in other shipyard.plists
* ''[[speech_pronunciation_guide.plist]]'' is another of the other custom methods.
* ''[[trade-goods.plist]]'' defines trade goods in 1.81 and later
* ''[[world-scripts.plist]]'' that contains a list of scripts (if more than one worldScript should be used).

Deprecated:
* ''[[commodities.plist]]'' that contains information for each commodity in a market in 1.80 or earlier
* ''[[demoships.plist]]'' that selects demoships to show on startup (replaced - approximately - by shiplibrary.plist in 1.79 and later)
* ''[[illegal_goods.plist]]'' that contains a list of banned/forbidden items in 1.80 or earlier. GalCop has an eye on that.
* ''[[Oolite_Keyboard_Controls|keyconfig.plist]]'' that allows for changes of the keymapping. (deprecated in v1.92)
* ''[[pirate-victim-roles.plist]]'' that defines which roles should act as traders. (deprecated in v1.79)
* ''[[script.plist]]'' to handle conditional ''script actions''. (deprecated)
* ''[[script.oos]]'' was briefly introduced during 1.70 development but is now deprecated in favour of JS.)

=== Models folder===
Oolite models need to be in an Oolite specific format using the the '''.dat''' file extension. There are utilities available that convert models made in Wings 3D (.obj) and Meshwork (.mesh) into this. A .dat file can be opened in a plain text editor to view the object's assigned texture names and see that they correspond with the actual file names in the Textures folder. The .dat file must be named exactly as it is referenced in the shipdata ''model'' entry - case sensitive!!!

* [[OXP howto model|Making Oolite models]] - tutorials for Wings3D & Blender, notes on sub-entities, links ''etc''.
* [https://bb.oolite.space/viewtopic.php?f=4&t=12165 Model Converter utilities] (2012-17)
* Video: [https://bb.oolite.space/viewtopic.php?f=4&t=16123 From scratch to Mamba in under an hour] ([[Dertien]], 2013)

===Scripts folder===
Scripts are in text format. In this folder you can put both JavaScript scripts as well as legacy scripts. New OXPs should only use JavaScript here.
* [[Scripting_Oolite_with_JavaScript|Scripting Oolite with Javascript]]
* [[Oolite_JavaScript_object_model|Scripting reference]]

===Textures folder===

Oolite's textures are in the '''.png''' format, usually at a standard 512x512 size, and must be named exactly as they are named in the .dat file.

* [[OXP howto texture|Making Oolite textures]]

* [[Smivs'_texture_tutorial|Smivs' guide to making Oolite textures]]

* [[Texturing tips and tricks by Theta Seven]]

Viewing a specific texture and / or model in Oolite.
"I made one. How do I proof it?"

* [[Viewing a Texture or Model]]

==Tool: OXP Verifier==

Oolite has what amounts to a spell checker for shipdata.plist and some other plists, called the OXP verifier.

*It does not work with OXZ's (so convert your OXP's to OXZ's later!).
*Nor does it work on the standard game release version of Oolite (v.1.90, v.1.92 ''etc''). Only on the Test Release/Developer's Release version ''and'' on the Nightlies/Pre-Releases (v.1.91, v.1.93 ''etc''.)

The verifier detects unknown keys or wrong use of keys ''etc''. It can currently only be invoked from the command line.

On Windows or Linux:
Code:
'''oolite.app/oolite --verify-oxp <path to OXP> '''

On Mac OS X:
Code:
'''Oolite.app/Contents/MacOS/Oolite --verify-oxp <path to OXP>'''

Most Mac users will not be familiar with using the command line. Look inside your application folder for a '''utilities folder'''. Inside that you will find a program called [https://en.wikipedia.org/wiki/Terminal_(macOS) Terminal]. 
Run it to open a terminal window. Now drop the oolite application on that window. That will generate the path to oolite on the command line. Delete the trailing space and paste the following text - including the trailing space- behind it: "/Contents/MacOS/Oolite --verify-oxp ". Now drop the oxp you want to verify on the window. That will again create the path to the oxp behind the last entry. 
When you select the window and hit the <return> key, the verification will start. It should now open the Console program, showing the results. 
'''Console''' is a log viewer developed by Apple Inc. and included with macOS, also in the utilities folder. It allows users to search through all of the system's logged messages, and can alert the user when certain types of messages are logged. The Console is generally used for troubleshooting when there is a problem with the computer. MacOS itself, as well as any applications that are used, send a constant stream of messages to the system in the form of log files. The console allows you to read the system logs, help find certain ones, monitor them, and filter their contents. See [[Debug OXP]] for more information.

There is a lengthy file - '''OXP verifier design.txt''' tucked inside your Oolite installation with more information about it

Note that it is possible to [https://bb.oolite.space/viewtopic.php?f=2&t=21443 obtain graphical output] from Graphviz for OXP Verifier.

=== Verifier BB threads ===
*[https://bb.oolite.space/viewtopic.php?f=8&t=13400 plist Editor Pro for Windows] (2013 - full of relevant Red Herrings)
*[https://bb.oolite.space/viewtopic.php?f=3&t=16865 lite --verify-oxp fails when path has spaces in it] (2014)
*[https://bb.oolite.space/viewtopic.php?f=4&t=21359 OXP Develoopment and Plist files] (2023 - quick introduction)

=== Correcting with plutil (Apple Macintosh Terminal utility) ===
Since a very small mistake is enough to stop a .plist from being accepted, it's important to be exact about every letter and sign. The Mac Terminal utility has a very practical tool for catching parser errors. After opening Terminal, simply type plutil, add one space, and drag and drop the plist in question onto the Terminal window. This will cause the 'address' of the plist to be shown. Hit return, and Terminal will reveal whether or not the plist is OK. If it's not, you might be given a clue to what is wrong, and the line number of the error - or just a general note that "Unexpected character { at line 1"!

==Need for unique names==
On loading the oxps, Oolite will add all files in the AIs, Models, Sound and Scripts folders in one big folder for its own use. That means that all files need unique names or one file will overwrite another with the same name. Files in Textures are not pre-loaded, but when looking for a specific texture Oolite looks in all Texture folders until it finds a texture file with a matching name. If another oxp contains a texture with identical name, Oolite could use that texture.

For the Config folder something similar happens. Here the plists all have the same name, but the content of all oxp plists is loaded per type in one big plist. e.g. all individual shipData.plist go in one big shipData.plist file. And within a single plist, all keys must be unique. When two plists use the same key, the later loading key will overwrite the former.

Generally it is a good habit to precede your chosen filenames and keys with the name of the oxp, or another unique prefix, to make sure the names stay unique and no other oxp will use the same names.

==Scripting with JavaScript==
Older OXPs (from [[User:Aegidian|Aegidian]]'s day were written in Legacy Script: see [[Methods]]. Modern OXPs are written in JavaScript. Specifically oolite.jsVersion 185, an Oolite specific variant of '''ECMAv5'''. It is the same Spidermonkey version that Firefox 4 shipped with many years ago, but it is a special build for Oolite. This is the version that we have almost always had and it has not changed between versions of the game. [https://bb.oolite.space/viewtopic.php?p=256623#p256623 It is unlikely to change] in the future.

JavaScript is the preferred scripting interface for worldScripts and shipScripts. The legacy scripting interface (see [[script.plist]]) still works, but is not supported. See [[Scripting Oolite with JavaScript]] for more information.

Note that most of the [[Legacy Scripting]] still works perfectly well (XML & OpenStep)!

==Hidden settings==
There are several [[Hidden_Settings_in_Oolite]] that make life for an oxp creator easier. One of them is the setting '''always-flush-cache'''. It makes every startup a bit slower, but it prevents Oolite working with cached data instead of your newly changed file. For someone that only does occasional oxp changes it will be enough to flush the cache by holding the shift key when starting Oolite but if you are writing oxps, this is the way to prevent frustrations.

==Cookbook==
* How to add dials to a HUD: https://bb.oolite.space/viewtopic.php?p=290352#p290352
* How to limit a station's shipyard to only offer a defined set of ships: https://bb.oolite.space/viewtopic.php?p=293174#p293174
* Ship/Station design with external docking ports: https://bb.oolite.space/viewtopic.php?f=4&t=21574&p=293777

== See Also ==
*'''Context''': [https://bb.oolite.space/viewtopic.php?p=275434#p275434 What can OXP's ''not'' change?] (2021)
*It is often helpful to dip one's toes (claws?) in the water by experimenting with tweaking oxp's first: see [[How to tweak OXZ's]]
*[[:Category:Oolite scripting]]
*[[Javascript Operators]]
*[[:Category:Oolite JavaScript Reference‎]]
*[[:Category:Oolite Development]]
*[[User:Montana05|Montana05]] recommends https://www.w3schools.com/js/js_array_sort.asp for better knowledge of the js on Oolite.
*[https://bb.oolite.space/viewtopic.php?f=4&t=12149 OXP Development Best Practices] (2012-7)
*Some older oxp's are written in [[Legacy Scripting]]
*[https://github.com/OoliteProject/oolite/find/master Github] vanilla game code repository - the resources section at the bottom of the page contains possibly useful parts of vanilla game coding, with occasional annotations.
=== Tools ===
*[[List of software]] that is helpful for creating OXPs (eg. editorial packages for javascript or 3D model creators)
*[[List of Planets used in OXPs]] for planets already used by other OXPs. Helps authors avoid overlapping with or breaking other OXPs.
*[[OXP_howto_Game_Balance|OXP howto Game Balance]] to avoid conflicts from accidental gameplay changes.
*[[Long Range Scanner]] is an OXP which allows you to jump around the star system to objects you have placed there - or to jump around within the galaxy. A "cheat" for players, but a useful tool for some OXP designers.

*[https://bb.oolite.space/viewtopic.php?f=4&t=13422 What Tools Are Good For Windows OXP Programming?] (2013)

==== Tutorials for Tools ====
*[https://web.archive.org/web/20050317033938/http://oolite.aegidian.org/cyoship/ Oolite Tutorial - Meshwork Shipbuilding (OSX only)] via WayBack Machine
*[https://web.archive.org/web/20060621211940/http://oolite.aegidian.org/cyoship2/ Oolite Tutorial - Wings 3D Shipbuilding (Cross-platform)] via WayBack Machine

=== OXP tutorials ===
Oolite changes affecting different varieties of OXPs happened with v.1.76 (2011), v.1.80 (2014) & v1.82 (2015).
*[https://bb.oolite.space/viewtopic.php?f=4&t=20937 MasterClass: How to OXP (updating SoThisTC)] by [[User:Spara|Spara]] who teaches computing in Helsinki! (2021)
*[https://archive.org/details/GettingStartedWithOoliteOXZDevelopment Getting started with OXZ Development] ''An .odt for Open Office'': By Bugbear (2012). 2 example OXPs: a pirate-ridden solar systems warning tool & Witchspace Blockades [https://bb.oolite.space/viewtopic.php?f=4&t=17731 BB Thread (2015)]

*[https://bb.oolite.space/viewtopic.php?f=4&t=18837 OXP Performance] BB thread (mostly 2017-8): improving your OXP (speed, ''etc'')
==== Tutorials: Ships, Retextures & Dockables OXPs ====
*[[OXP howto model]]
*[[OXP howto texture]] - also covers planet textures
*[https://bb.oolite.space/viewtopic.php?f=4&t=18284 The bare minimum for a game-recognizable ship OXP] (thread: 2016)
*[[OXP_tutorial|OXP Tutorial]] creating a new spaceship - and then tweaking it in different ways (2007-13)
*[[OXP howto dockable stations]] (2009-10)
*[[User:Shipbuilder|Shipbuilder]] wrote a Shaders tutorial with resource packs (2013)
==== Tutorials: HUD OXPs ====
*[[OXP howto HUD]]
*[[Guide to HUDs]] - table comparing features
*[[HUD Customisation Guide‎‎]]
*[[Fully Annotated HUD Configuration (hud.plist) File‎]]
==== Tutorials: Missions OXPs ====
*[[OXP mission offering]]
*[[GalCop Missions]] has a wide variety of over 80 javascripted mini-missions - see the list behind the "Spoilers" button
==== Tutorials: Other ====
*[https://bb.oolite.space/viewtopic.php?f=4&t=14135 How to make a simple OXP?] (thread: 2013) 3 OXPs - pop-up message at docking, set only Pythons for sale at Lave shipyard, create a new ship.
*[[Escape Pod Locator OXP]] has notes on programming on the bottom of the page regarding beacon transmission & location

=== Helpful OXPs for your OXP===
There are a number of OXPs which have been specifically written to allow your OXP to use them:
*[[Library OXP|Library]]: a collection of useful snippets and helpers. Its main purpose is to simplify or unify some common tasks used by OXPers.
:*It can add dynamic maps, music & animation.
:*It adds a Personal Assistant Device for the player with details of people met, medals awarded, Guild rankings, ''etc''.
:*It allows in-game configuration of an oxp by the player.
:*Add-on modules allows inspection of models and materials for creation of ship & station oxps.
*[[GalCop Missions]] introduces many new pieces of equipment with wide varieties of use (Cargo Stoppers, Ejection Dampers, Range Finders, Solar Radiation Disrupter Missiles, Seismic Resonance Scanners, Patient Transport Modules ''etc''). It can also help with creating missions (it contains over 80 varieties - see the spoiler button on that wiki page).
*[[Diplomancy]] can be used to make states of war impact personally on the player
*[[System Data Config]] helps re-organise the F7 screen to squeeze more information onto it

==== While docked/stations ====
*[[HD Backgrounds]] can provide a High Definition screenshot of a station lobby or other such for interaction with the player
*[[BGS]] can help organise a customised docking or launching sequence (see the [[Riredi OXP]] or the [[Kiota Stations]]).
*[[GNN]] can broadcast your news alerts (see how [[Diplomancy]] uses it for war & peace declarations). GNN also contains '''PhraseGen''' which can be used for randomizing text descriptions.
*[[Station Validator]] will remember that a station has been destroyed and stop Oolite automatically replacing it on the next visit to the system
*[[Station Dock Control]] can help interraction with other ships docked at the station
*[[Bulletin Board System]] can help manage interractions at the station
*[[Email System OXP]] can also help manage interractions at the station
*[[Ship Storage Helper]] allows storage of the player's ship whilst doing other things (such as flying another ship!)
*[[Equipment Storage OXP]] allows storage of equipment/goods whilst doing other things
*[[Ship's Library]] allows reading documents with illustrations while docked (see the included Ship's Manual)
*[[Station Options]] allows complex configurations of equipment, but could potentially also be used for managing dialogue with NPCs
*[[Life in the Frontier]] was being expanded to cover more stations (Dodo/Ico/Rock Hermits and potentially OXP stations), but is currently mothballed.

==== In-flight ====
*[[MFD - Broadcast Comms]] can be used for in-flight interaction with NPC's
*[[Bigships]] can be used to help with the AI for massive space ships which cannot dock at orbital stations
*[[Montanas Resource Pack 01]] contains a number of resources for use (treasures, containers, escape/survival equipment)
*[[Star System Lane Indicator]] - the older version contains a very graphical dynamic display (does not function properly, but boy! does it look good!)
*[[SOTL Exploration]] contains exploration equipment and a non-automatic hyperspace jump
*[[SOTL Altmap]] contains different politics, markets and NPCs with Torus Drives.
*[[Resistance Commander]] & [[EscortDeck]] contain mechanisms for "managing" allied ships.

==== Planet Surfaces ====
*[[Planetfall OXP]] allows landing on the planet (used by [[Feudal States]] for access to the Royal Court, and by [[Astronaut]] for space-jumping)
*[[Lave is Earth 8k]] contains night-time city lighting

=== Packaging and distribution ===
*[https://bb.oolite.space/viewtopic.php?f=4&t=16688 The All-in-One Guide to OXZ Packaging and Distribution].
::And see [https://bb.oolite.space/viewtopic.php?p=279034#p279034 this post] for AppleMac issues with the above.
* Cim created [https://github.com/cim--/oxp-build-scripts some scripts to ease packaging] a project.
*[[OXP Distribution]] The All-in-One Guide to OXP Packaging and Distribution (and [[OXP_standards]] for advice on which ways of doing things are supported and which are not).
* Since the domain change to [https://oolite.space] the distribution of expansions has changed slightly. The new version is still subject to discussions and might change again. Here is a [[Publishing Procedure Comparison]].
*[[Gameplay_and_Balance_Indicator|Gameplay Balance Indicator]] and [[OXP_Levelindicators|Difficulty Indicator]]. Add these to your wiki page to show effects on Game Balance and the Difficulty Level of your OXP/OXZ. The '''first''' indicates the impact on play (equipment making the game easier/more difficult), the '''second''' indicates the suggested [[Elite Rating]] needed to attempt the mission/defeat the ship ''etc''.

[[Category:Oolite]]
[[Category:Oolite scripting]]

Diplomancy OXP

2026-07-28T13:26:23Z

Cholmondely: /* War Zones OXP */ Updated for 1.10

[[Image:IconGNN.png|100px|right]]
[[File:Diplomancy 1 new F4 Screen.png|thumb|right|The additions to the F4 ship-station interface screen (with ANA installed)]]
== Overview ==
[[File:Diplomancy 2 Embassy District.png|thumb|right|The new Embassy District on the Orbital Station]]
[[File:Diplomancy Warring Systems Map.png|thumb|right|The Star Wars screens (need [[ANA]] installed) Toggles between Wars Map/Diplomancy Map/Warring Systems Map. This one is the Warring Systems Map: ''red cross'' means that the system is at war with somebody, no idea who!]]
[[File:Diplomancy 4 Star Wars legend.png|thumb|right|legend for Star Wars screen]]
[[File:Diplomancy Wars Map.png|thumb|right|The Wars Map ''Red line = war, Green line = alliance'' Qubeen is at war with Soorbi, Onlema & Xexeti. She is allied with Arraesso. To the West, Usanat is at peace with both Geerra and Soladies - no wars with them and no alliances either]]
[[File:Diplomancy Diplomacy Map.png|thumb|right|The Diplomacy Map ''Red = hate, Green = love, Yellow = love/hate, Orange = dislike, Blue = like, Grey = neutral'' Feudal Qubeen and anarchic Xexeti have a love/hate relationship. Commie Usanat hates Democratic Geerra despite being at peace with it]]
[[File:Diplomancy System History.png|thumb|right|System History screen Note the yellow "Love+Hate" line between Qubeen and Xexeti on the "Diplomacy Map" above]]
This OXP effects three major changes in the game:
*It creates an inter-galactic politics with systems declaring war on each other, forming alliances and signing peace deals.
*It allows purchase of citizenship of a system (with resulting tax liabilities & refugee status in systems at war with one's own)
*It requires visas for travel to some government types. Not all surrounding systems will sell them (depending on wars or on being anarchies)!

Not to be confused with [[Home System]] OXP which allows investment in systems.

=== Citizenships ===
The player may acquire, or renounce, a system citizenship when visiting this system, for the right price. They may choose which one of their citizenships is announced as the flag of their ship.
*The player is considered '''fugitive''' when in systems warring with their flag.
*'''Anarchies''' provide no citizenship. They also have no embassy district (for buying visas for neighbouring systems).
*The player may buy '''several days of visa''' in the '''Embassy district''' in a neighbouring state, which is not an enemy to the destination system.
:'''Corporate systems''', '''dictatorships''' and '''communists''' refuse docking to players when stateless and visaless.
*Citizenship leads to Income Tax!

=== Systems' alliances, wars ===
*[[GNN]] news: GNN news is now displayed when an alliance is formed or broken between two systems, or when a war starts or ends between two systems, and the player is in one of those systems.
*'''Strategic maps''' showing the warring systems, and the diplomatic relationships!
::These need the [[ANA]] to be installed to show on the F4 station-interface screen.
*Two systems within 7ly of each other may now form an alliance, if they like each other enough.
*They may break their alliance, too!
*They may wage war to each other, and make peace too!
*New F4 Interface screens: the '''Embassy District''' & the '''System's History'''!

=== Systems' treasury ===
*Wars require money, and countries are defeated either by battles or by bankruptcy, sometimes the latter producing the former.
*The Treasury and Tax levels are displayed in the F7 system information.
*Each system treasury is increased through taxation each player jump, depending on the time past since the last jump.

----
== What's currently implemented technically? ==

The oxp contains Engines which may be use by developers to implement interesting galaxy-spanning events:
* (main) [[Diplomacy Engine API|Engine]]
* War - see WarZones OXP below
* History
* Systems
* Economy
* Citizenships - see Rexebe Citizen OXP & Digebiti Subject OXP below

----

== Effects on game ==

=== Effects on game difficulty ===
* The player is considered fugitive when in systems warring with their flag.
* The player is refused docking in some stations when they have not the requisite visa or passport.
* Some new ways to spend money: becoming a citizen, visas.

=== Effects on game performance ===
*This .oxp works only when the player is docked, so there is no impact during the flight time. During the docking, it works once every ten frames, the effect on player experience should be negligible.

''If it isn't negligible, tell me and I'll put in the ability to choose the number of frames.''
:Even if the effect is negligible on the player, it uses lots of CPU, so it might not be negligible on the battery.

== Tips ==
*One now needs to keep abreast of developments in the systems one is about to visit. This ''can'' be done using the new F4 choices while docked. And it can ''also'' be done using the F7 screen - and if one's route has been plotted using the [[ANA]], one can view the different systems along the route in F7 using the left/right arrow keys.

*If one is approaching a set of systems needing a visa from an anarchy, if a rock hermit can be found in the first system needing a visa, once can dock there and then a visa for the second system can be purchased there.
----

== Instructions ==
*For OXZ's, the Expansions Manager download is fine.
*For OXPs, do not unzip the .oxz file, just move into the AddOns folder of your Oolite installation.

== Dependencies ==
*[[GNN]] OXP
*[[Anarchies]] OXP

== Known bugs ==
None.

== License ==
*Diplomancy was created by Commander [[User:Day‎|Day‎]], from the home of diplomancy (think of Talleyrand & Richelieu!).
*This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike License version 4.0.
*If you are re-using any piece of this OXP, please let him know by sending an e-mail to david ''at'' pradier ''dot'' info

----
== Versions history ==
*'''v.0.21'''
:Improvement, can now purchase visa at systems beyond 7LY range.
*'''v.0.20'''
:Improvement, added map name to the title of the Star Wars map, making it clearer which map is being viewed.
:Improvement, moved all text to missiontext.plist and descriptions.plist for easier localisation.
:Improvement, added helper text to System History page if no data to display.
:Improvement, the Advanced Navigational Array is no longer a requirement for the map screens to see system connections.
:Improvement, can now extend visa for the current system at the main station.
:Improvement, flavor: alternative allegiance, broken allegiance, war, and peace GNN news items.
:Improvement, dev func: added WarEngine.$isActorWarring (passing an actor ID, returns a boolean)
:Improvement, dev func: added WarEngine.$isSystemWarring (passing a system ID, returns a boolean)
:Improvement, dev func: added WarEngine.$areSystemsWarring (passing two system IDs, returns a boolean)
:Bugfix: Fixed potential null reference check in War script when checking observersId.
<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
*'''v.0.19'''
:Bugfix: breaking alliances and making peace now works again.

*'''v.0.18'''
:Improvement, user-friendliness: the visa system in-game explanation is clearerer.

*'''v.0.17'''
Improvement, user-friendliness: the visa system in-game explanation is clearer.

*'''v.0.16'''
:Improvement, flavor: the player is considered fugitive when in systems warring with their flag.
:Improvement, flavor: no "Embassy district" in anarchies, no citizenship in an Anarchy
:Improvement, flavor: the player may buy days of visa (cost: productivity / population / 365 per day) in the embassy district in a neighbouring, non-enemy from the destination system.
:Improvement, flavor: the first time the Diplomacy OXP is used, if a visa is needed in the current system, we give the player a 1-day visa.
:Improvement, flavor: a GNN news introduces the Visa Law.
:Improvement, flavor: when stateless, docking is refused in corporates, dictatorships and communists without having a visa.
:Improvement, flavor: maps are centered and zoomed. Possibility to center on the target system, or on the whole trajectory. Possibility to display the short/quick trajectory, or no trajectory at all.
:Improvement, performance: the API are removed in favor of JsDoc.
:Improvement, code quality: the Snoopers dependency, which is deprecated, is replaced by the GNN dependency. Oolite minimal required version is now 1.88, because of this.
:Improvement, code quality: moved the GNN connection to external script.
:Improvement, code quality: tax level and treasury are now displayed through mission.addMessageText rather than through a modification of the system description.
:Improvement, tweaking: the alliance threshold between systems is lowered.
:Bugfix: the initActions wasn't set as it should be. In particular, initActionsByType wasn't set when adding an initAction, and initActions was set with an ActorType as key instead of an ActionId.

*'''v.0.15'''
:Improvement, flavor: the player may acquire or renounce the citizenship of the system they are in.
:Improvement, flavor: the player may display one of their citizenships as the flag of their ship.
:Improvement, dev func: other scripts may subscribe to be informed of a citizenship change of the player.
:Improvement, dev func: citizenships prices are dynamic and available to other scripts.
:Improvement, dev func: other scripts may inquire if the player has a particular citizenship.
:Improvement, code quality: introduced JsDoc comments, including some allowing to document the Oolite javascript hooks!

*'''v.0.14'''
:Improvement, flavor: War declaration! Peace! Snooper news about them!
:Improvement, flavor: Wars map!
:Improvement, dev func: the war threshold and the alliance threshold are scriptable through the WarEngineAPI.
:Improvement, dev func: new F4 interface making History happen for debug purposes.
:Improvement, code consistency: Alliances scripts become War scripts.

*'''v.0.13'''
:Bugfix: manifest.plist for the oxz manager.

*'''v.0.12'''
:Bugfix: manifest.plist for the oxz manager.

*'''v.0.11'''
:Improvement, flavor: added a F4 Alliances Map, showing alliances between systems.
:Improvement, flavor: having only Snooper news for the player current system.
:Improvement, flavor: fixed Diziet Sma citation
:Improvement, code consistency: the tax script becomes the economy script.
:Improvement, code consistency: removed the TechnicalPrinciples.txt file, as its content is now mainly in the new OXP Performance thread.
:Improvement, dev func: added a beginning of Economy Engine API.
:Improvement, dev func: added a _debug flag in the Engine to start as if you just spent a turn and entered the station; ie, events are processing.

*'''v.0.10'''
:Improvement, flavor: added a F4 System history, showing the F7-selected system events history. The displayed text depends on a formatting function definable through API per event.
:Improvement, flavor: the alliance and alliance break events are now displayed in the history.
:Improvement, dev func: the EngineAPI provides the events, and the events by actor.
:Improvement, dev func: the EngineAPI allows now to store a variable in the saved state with the other saved variables of the oxp.
:Improvement, dev func: introduced a Systems API and a History API. The systems API provides the system actors indexed by galaxyID and systemID.

*'''v.0.9'''
:Improvement, flavor: the score given to a system by another depend on who they are allied to.
:Improvement, flavor: systems may now break their alliances.
:Bugfix: systems within 7 ly of any of both systems in the alliance are now informed of the alliance.
:Improvement, dev func: introduced an Alliance API.

*'''v.0.8'''
:Improvement, flavor: Two systems within 7ly of each other may now form an alliance, depending on their relation quality. Currently, each must have a score for the other of at least +0.5.
:Improvement, flavor: some Snooper news are now displayed when an alliance is formed between two systems, and the player is within 7ly of one of the allied systems.
:New, oxp dev func: introduced a functional Event system.

*'''v.0.7'''
:Improvement, flavor: added a F4 Strategic Map, showing links between systems nearer than 7. The relation between systems is currently based on their government.

*'''v.0.6'''
:Improvement, flavor: tax amount depends on the time spent since the last taxation.
:Improvement, speed: major refactor to remove closures, dereferences, JSON (de)serialization special functions.

*'''v.0.5'''
:Bugfix manifest.plist for the oxz manager.

*'''v.0.41'''
:Put into the oxz manager.

*'''v.0.3'''
:New, oxp dev func: delivered DiplomacyEngineAPI for oxp developers, provided a dedicated readme file.
:New, doc: provided a dedicated file DiplomacyRoadmap.txt
:Improvement, code consistency: the Systems and Tax js script now use the API rather than the native engine calls.
:Improvement, speed: optimized the loops in the engine
:Improvement, logic: when starting, the player is docked, so we should process the saved actions.
:Bugfix: solved a bug in the Tax script recurrent tax task after a savefile load.
:Bugfix: the init action using the api wasn't working after a restore from the savefile.
:Cleaning: log cleaning, file cleaning.

*'''v.0.2''' The actions are made progressively, one every 10 frames when docked, so as not to need more execution time than allowed at the same time, and to avoid slowdowns during the game.

*'''v.0.1''' First version of the Diplomacy engine. Systems are introduced as a type of "Actor". "SELFTAX" is introduced as an event for systems. Tax level and treasury are displayed on the F7 screen.
</div>
----
== Associated OXPs ==
=== Rexebe Citizen OXP ===
*[https://app.box.com/s/stnhgdubo7ogn0ug3e7zqfhyksw182wz Rexebe Citizen.oxz] grants citizenship of Rexebe for users of Diplomancy who want ''eg''. to try out [[Hermitage]] (Phkb, 2021)
=== Digebiti Subject OXP ===
*[https://wiki.alioth.net/index.php/File:DigebitiSubject.0.92.oxp.zip Digebiti Subject.oxp] grants subjecthood of Digebiti for users of Diplomancy
=== Quick Visa OXP ===
*[[Quick-Visa]] provides horrendously expensive "Visa purchasing options" on arrival at the Witchpoint Beacon (for those forgetting to get a visa at the previous system)
=== War Zones OXP ===
*[https://app.box.com/s/6gdpycwo639vhry03h13h0c3m6e2hsbx WarZones_1.10.oxz] creates wars between warring systems.

*Warning: ''You'' are now automatically conscripted into an active battle if you are a citizen of either side and flying their flag!

* Where two systems are at war, this OXP will often add a battle between ships from those systems. It is purely up to the player whether they want to get involved or not. When no active battle is added, there is a chance there will be the aftermath of a battle.

* Market prices in any warring systems are elevated, while quantities available will be reduced.

* Finally, some missions will be added to the [[GalCop Missions]] Bulletin Board as a result of two warring systems.

==== Requirements ====
:Diplomacy v.0.20 or later
:[[GalCop Missions]] v.0.13 or later
:[[Market Script Interface]].

==== License ====
*License: CC-BY-SA-NC 3.0

==== Version History ====
This OXP is borrowed heavily from the [[Factions OXP]] by m4r35n357.

1.10
:Fixed crash-inducing bug

1.9.1
:Fixed error when attempting to create pilots for faction escorts.

1.9
:Fixed invalid property name for descriptions lookup.
:Fixed some other incomplete references that caused JS errors.

1.8
:Trimmed helper text in Library Config so it will be fully visible.
:Fixed issue with Library Config not showing the flags page due to an error.

1.7
:Fixed issue with aftermath generation where errors could occur while spawning escape capsules.
:When battles are completed, any foreign ships will now wait a suitable amount of time before performing the jump, rather than the instant the battle is won.
:Removed debug code that would make battles happen 100% of the time between warring systems.
:Added unique fleet names based on government type (with thanks to Cholmondely for the suggestions/examples).
:A light destroyer can now sometimes be involved in the skirmishes.
:Added compatibility with Factions.
<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
v.1.6
:Player is now automatically conscripted into an active battle if they are a citizen of either side and flying their flag.
:When battles are completed, remaining ships will return home.
:When no active battle is taking place in a warring system, there is now a 50% chance of there being the aftermath of a battle.
:Reworked shipdata roles to be less confusing.
:Switched to using logcontrol.plist for controlling log file output.
:Changed name to "Diplomacy: War Zones".
:Code refactoring.

v.1.5
:Fixed manifest.plist requirements issue.

v.1.4
:Moved restoration of market impact values to startUp, so values are restored before prices potentially set.
:Fixed incorrectly named file.

v.1.3
:Cleaned up warring parties scanner colours, and made sure different colours will be applied to different systems of the same type.
:Made sure the "war" happens within visible distance of the witchpoint.
:Updated Wireframe Ship Images with correct Sidewinder link.
:Added market changes if a system is at war.
:Added two BB missions for at war systems.

v.1.2
:Added "use strict" to ship script file.
:Suppressed "The 'conditions' key is deprecated in shipdata entry" messages in log file.

v.1.1
:Fixed incorrect condition script filename in shipdata.

v.1.0
:Initial release
</div>
----

== Musings ==
[[File:Sv pad08.jpg|thumb|right|Library's PAD (Personal Assistance Device) showing player's origin]]
This section contains musings by Cholmondely and Cdr Day's 2021 roadmap for his OXP. Expand it to read!

<div class="mw-collapsible mw-collapsed" data-expandtext="Expand" data-collapsetext="Hide" style="overflow:auto;">

[[User:Cholmondely|Cholmondely]] writes: this is one of my favourite OXPs adding a good dash of realism to my game. And it makes visiting other places difficult just as real, life does! If anybody ever manages to introduce real wars into Oolite, this will help provide a realistic background to them ([[User:Montana05|Montana05]] has created an "invasion oxp" which is currently in alpha stage).

''There are a number of things which still need doing/thinking about.''
*One should be able to choose one's first citizenship without paying - ideally it should be linked to the self-chosen system of "origin" on [[Library OXP|Library's PAD]].
*It seems unlikely that there would be Embassy Districts on Rock Hermits! But it might well be possible to buy over-priced visas through the Black Market there (as ''eg'' installed by Smugglers oxp) - and especially for the same system that the RH is in!
*The decision not to install Embassy Districts on the local orbital station in an anarchy needs thinking through. The Lore is that the anarchy does not provide any finance for the orbital, meaning that GalCop has to pay for all of the costs. Hence [[GalCop]] runs the orbital, not the anarchy. And thus the lack of an "Embassy" with (inexistent) anarchic "governments" would seem to be irrelevant to the presence of some sort of visa-issuing body on the station. Even if the second system were at war with the anarchy. This can of course all be [[Handwavium|handwaved]] away by referring to GalCop regulations, but still, it should be thought through!

=== Day's "Diplomacy roadmap" (2021) ===

Next versions might include:

0.19 - more expensive visa to go planetSide, costs slashed planetSide (90% custom rebate ?...)
:- citizenships may be acquired planetSide only

0.20 player taxation depending on the number of citizenships (CreditDiff / timeInDaysSinceLastSystemVisit * n * (n - 1))

0.21 War declaration generates an immediate gdp growth increase!

----

Conditions for version 1.0 to be declared:
:- filesave format stabilized,
:- performance considered to be ok,
:- all core engine functionalities implemented, remaining ones:
::- actor/event/response/function/initAction/recurrentAction disabling/removal,
::- 'act next turn' functionality.
:- APIs stabilized
:- I18n ok
:- L10n ok for english
:- Documentation in .md format
:- all major events implemented, remaining ones:
::- DEFENSE_PREPARATION
::- ATTACK_PREPARATION
::- ATTACK
::- LOSS
::- VICTORY
::- BANKRUPTCY
::- BREAK (Alliance)
::- ALLY (Alliance)
::- SPLIT
::- COMBINE
::- TAX (Alliance)
::- SUBSIDIZE

Conditions for 2.0 to be declared:
:- Wiki pages, including APIs
:- perfectperf FIXMEs,
:- perfectfunc FIXMEs,
:- perfectstyle FIXMEs

----

:FIXME 0.f explain that the total number of credits in the Ooniverse is always the same through a Raxxla adventure
:FIXME 0.f make the tax level evolve ?
:FIXME 0.f How do we know the real productivity? Is there an OMC? Black work wouldn't be reported, nor taxed. Yet another time Raxxla?
:FIXME 0.f productivity could slowly converge towards a value depending on space scarcity
:FIXME 0.f use Fuel tweaks oxp depending on state of war, recently attacked system, and player home system :p
:FIXME 0.f tweakability / configurability / by player / by other oxps
:FIXME 0.f equipment/commodities prices vary depending on war/system richness
:FIXME 0.f identifying player as citizen from some system (Citizenship), consequences
:FIXME 0.f player taxation
:FIXME 0.f the strategic map should be available through an equipment, or a role (commander ;) ); through the oxp :GalacticRegistry (Galcop maps)?
:FIXME 0.f provide Diplomacy lore (the deep comments in the code) to the player through other oxps. GNN army? Spacebars? The oxp from which you're the hero?

:FIXME 0.n manage versioning of savefiles (last step before 1.0)

:FIXME 0.perfectperf use tco to avoid recursion: http://www.integralist.co.uk/posts/js-recursion.html
:FIXME 0.perfectperf minify, https://jscompress.com/, https://github.com/mishoo/UglifyJS2
:FIXME 0.perfectperf benchmark with lazy regexps

:FIXME 0.z make a story/scenario generator?

:FIXME 0.z passengers are taxed too; maybe player may pay less depending on passenger home system? why would passenger allow that?
:FIXME 0.z some systems could have their citizens not taxed? free passage? by some chosen systems? vassal systems?
:FIXME 0.z "Troll wars" (noble Troll specie against human cultural trolls)
:FIXME 0.z "Trumble wars" (trumbles are used as weapons to disrupt blockades)
:FIXME 0.z "Day of the Tentacle"
:FIXME 0.z the events history could be visualized through GNN
:FIXME 0.z the events history could be visualized through a map

:FIXME 0.z: implement scoring of relations between systems
::*goodwill low depending on history:
::if they have attacked that turn,
::polarization? if the system has several neighbours, it dislikes better one of them
::if they have attacked that turn a member of the alliance,
::if they prepare for attack (even an enemy?),
::if they're from an opposite economy,
::if they're from a different alliance (enemy alliance?)
::if they currently got a bad economy?
::if the other currently has a bad economy?
::if they're from a disliked race
::polarization? if the system has several neighbours, it dislikes better one of them
::if they harbor an enemy faction
::polarization: if they have enough money to attack and the other not enough to defend
::*goodwill high:
::if they have helped in the past,
::if they are member of the alliance,
::if they prepare for defense,
::if they're from a comparable economy
::if they're next to a common enemy
::if they're on a commercial road?
::if they're from a liked race
::polarization? if the system has several neighbours, it likes better one of them
::if they harbor an ally faction
::polarization: if they have enough money to defend and the other not enough to attack
::*What's an enemy?
::initial scoring + eventsScoring losing 10% each turn (year?) + current turn eventStoring
::initialScore = economy comparison + ideology comparison + commercial road
::who should we score? a system scores those systems it is observing?
::staticScore[observerId][observedId] = {
::: economyComparison:,
::: ideologyComparison:,
::: sameCommercialRoad:,
::}
::dynamicScore[observerId][observedId] = {
::: nextToCommonEnemy:,
::: preparingForDefense:,
::: harboursEnemyFaction:,
::}
::ally to alliance if avg(systemsScores) > threshold
::attack if systemMoney > targetProductivity * targetPopulation, divided by constant

'''WAR'''

:prepare_fight if:
:- treasury > fightPreparationThreshold => war_treasury
:Is this really needed?
:Fight may be prepared at all times

:- attacked => lowers drastically score
:- ally attacked => lowers (less) drastically score

:attack or finance_ally if:
:- score < attackThreshold ?

:- war_declared
:- roi > roi_threshold && war_treasury > attack_budget (depending on attacker culture? [0,30% of war_treasury?])

:An attack may remove from the attacked:
: pib -= [5%,,5%]*pib
: treasury -= attack_budget * 100 * [100%,1%]
: war_treasury -= attack_budget * 10 * [100%,1%]
:An attack may from the attacker:
: war_treasury += attack_budget * [-100%,100%]

: depending on the success [100%,0%]

: success repartition must be a gauss curve

: what of ROI? hmm, economy size might change depending on battles?
: So an increase in economy size is a one-year increase to be compared to the cost of the attack
: what about using a zero-sum game principle? like economy size decrease goes to neigbors?
: or declaring war weakens some economic relations between systems and strengthens others?

: or wars are decided by hidden interests, not by global economy? per good type? per 2 types only agro and industrial?
: I like the idea that the exchange depends on prices differences * size of economy
: but should the exchange be imbalanced? how is that impacting the economy growth?
: what are the coefficient on each good? what of forbidden goods?

: the number of tons entering a system is equal to the number of tons exiting. Nope. the max number only, but it's theoretical.
: the max number 128 is administrative? why is it everywhere, then?
: not to be considered, as it would imply a very small spatial exchange between systems, very inferior to systems economy size

: We need spatial ascensors, so as to have a low cost from planet to station,
: which is needed not to have prohibitively expensive food and other things.
: Or cheap anti-gravity =o
: => big exchanges between systems

: Let's say that we think in terms of %age of total GDP, and not in GDP
: Let's say that the evolution of total GDP due to productivity increase is small in Ooniverse, compared to the variation due to the wars.
: In that case, we can think we are in a zero-sum game, in terms of %age of total GDP.
: Each loss of GDP %age is gained by the others.
: We can (it is a game shortcut) reattribute the lost gdp to some others
:: => normal way is to add depending on their own current gdp, in the galaxy.
:: => another way is to consider it goes to near systems (neighors?).
:: => another way is to consider it goes to systems depending on their distance (squared)
:: => this way is nice but expensive to calculate
:: (needs the distance between each systems, and the sum of these distances)
:: => another way is to consider that neighbors in fact taxes the money,
:: and that systems other than neighbors earn a negligible increase
:: => money goes to neighbors, coefficiented on inverse distance squared

:: => attack ROI depends on the attacked distance
:: => financed attack ROI depends on the attacked distance
:: => finance ROI should always be better than attack ROI?
:: then finance is preferable to attack when it is possible
:: => how to ensure that 2 allies in war with a third system won't only finance each other instead of attacking?

:: there must be an incentive to finish the other
:: => spoils of war: combat_budget+, war_treasury+, treasury+, total gdp appropriation this turn (no neighbours),
:: greater portion of gdp (40% of attacked gdp * coeff depending on attacker gdp
:: (representing the ability to process the attacked gdp)), attacked forced peace

:: What if 2 allies finish a system at the same time? It isn't possible to have a "at the same time" event.
:: Well maybe, events concurrency.

:: FIXME 0.f use station in fire when a system has been beaten http://aegidian.org/bb/viewtopic.php?t=3460&start=154

'''FIXME 0.f PEACE'''

:FIXME 0.z have an indicator "Ongoing war" per system
:FIXME 0.z have a notion of "war zone"
:FIXME 0.z have a notion of galaxy, station, traveller as actors
:FIXME 0.z tax evasion
:FIXME 0.z factions?
:FIXME 0.z news, depending on player current system, player citizenship system, propaganda?
::maybe the right way is to generate LOTS of news and let the player register to those they want?
::GNN, citizenship news company
:FIXME 0.z blockades
:FIXME 0.z each turn, a system has an event card: a sun explodes, or a native singer becomes famous, which changes taxes, or alliances, or fights, or... Use some mega bomb for a supernova style event
:FIXME 0.z what about the story of a war writing itself?
:FIXME 0.z war cargoes
:FIXME 0.z player's greed is the key
:FIXME 0.z "OXP that adds another eight galaxies" !!
:FIXME 0.z what happens if the player lands on an enemy planet?
:FIXME 0.z ideology and richness change in a system after a victory/defeat

:FIXME extract the main engine into its own OXP

'''Day's Musings'''
:Space is big. But the space we are interested in is the space around planetary systems :)
:What about ships localization detection and declaration?

:On our old earth, we have transponders onto every (naval) ship and plane. We even have control towers.
:We have radars too, and the chinese have recently made a quantum radar (so no evasion through deflecting the wave like the B-2 stealth bomber do).

:We could have mandatory transponders in corporate systems, optional transponders in, say, feudal systems, useless transponders in anarchy systems.
:That way, ships are declared, and space content is better known.

:We could have (gravitic?) radars which results are shared ad-hoc (like wifi) by law-abiding pilots ^^
:That way, ships are detected, and space content is better known.

:Using these, from the point of view of the ship commander, space isn't empty or big anymore; it's crowded and interaction are possibly frequent.

----
:FIXME 0.z citizenship could be linked to a corporation instead of to a system (Cyberpunk meme)
:FIXME 0.z obligations may weight on the player depending on their citizenship (missions, battles...)
:FIXME 0.z the player may acquire a citizenship through missions, falsified papers, stolen papers from a captured pilot, marriage with a crew member, another pilot or an inhabitant
:FIXME 0.z the player may lose their citizenship through lack of system visit per year, treason, attack on the local army, simultaneous citizenship with an enemy system
:FIXME 0.z the player, citizen of a warring system, may be taxed, enroled into battles, or be given missions

:FIXME show enemy planets on the main map, allied planets, needs a visa planet ; new script enemies: war+citizenship

:FIXME 0.z manage supernovas

:FIXME convoys oxp to have convoys + military oxp to have military ships, to create battles...

'''Asked by Cholmondeley'''
:If you added: "Extend the Zaonce visa at a cost of 2.1cr/day"...
and if you could show the total of bought days on the screen...
:The slightly different cost of the extension helps add emphasis.
:I notice that the F8 page totals change as one buys and sells...

:Also, one can often extend the visa within the country itself.
:(One might have to go down to the planet surface on a shuttle...
:But another visa to use the shuttle... etc. ad nauseum...
:Or join a lo-o-o-ong queue on the orbital station (or pay someone else to do it)...

:I've only just dipped my toes into your modification, but the only thing I'd like to see added so far (other than the change of text above) would be some graphics for the Embassy district and the System History Section. Easier said than done, alas!
:If there was a GalCop logo, maybe that on a flag for the Embassy district (I've only seen ones so far are for the Galactic Police & Army).
:Or how about a pair of white gloves, a pith helmet and a glass of bubbly? Or a visa stamp in a passport...
:Or some of Phantorgorth's species icons? Or some of the F6 system government icons (anarchy etc)?...
:We could do with a decent GalCop logo anyway for the GalCop wiki page
:How about a picture of the planet (it need not revolve) for the System History F4 page?

:To what extent does buying citizenship of a system link in with Home System.oxp's inner workings?
:There you buy Home System Privileges for 15,000cr a pop, which leads to what seems to be a sort of super-citizenship.
:Should it automatically grant Diplomancy.oxp style citizenship as well?

</div>

==Links==
*[https://bb.oolite.space/viewtopic.php?f=4&t=18645|BB Discussion]
*[https://bb.oolite.space/viewtopic.php?f=6&t=11904 Tax OXP?] thread (2012)
*[https://bb.oolite.space/viewtopic.php?p=278364#p278364 Wars discussion] (2021)
*[https://bb.oolite.space/viewtopic.php?f=6&t=19471 Is Political Change Possible?] (2018)
*[https://bb.oolite.space/viewtopic.php?p=286468#p286468 Problems with combining the buggy Diplomancy with Bounty System OXP] (2022)

=== Downloads ===
*Version 0.21 (2026) [https://app.box.com/s/5xbksy48qr9cp31z2wpef6wjla05s3ih Phkb's Oolite Box] look in his "Mechanics" folder

*Version 0.19 (2023) is downloadable through the in-game [[Expansions Manager]]

== Gameplay and Balance Indicator ==
[[File:Tag-colour-orange.png|right]]{{OXPLevel|1}}
Diplomancy makes things a bit more difficult - you need to pay for a visa to visit some of the systems - or get fined! And you can't buy the visas just anywhere either - sometimes you can't even buy them at all!
{{ambience-OXP}}

OXP howto

2026-07-28T11:30:17Z

Cholmondely: /* Helpful OXPs for your OXP */ Added in to GalCop Missions note

:''Shortcut: EW:OXP and EW:HOWDS redirect here''
[[Image:oolite-oxp-icon.png|100px|thumb|right|OXP icon]]
[[File:Oolite-debug-menu.png|thumb|right|Debug Menu (From the AppleMac variety of the "Oolite TR" version)]]
==Overview==
An '''Oolite Expansion Pack''' can cause many big changes or additions to Oolite's gameplay, or it may represent just a small, subtle alteration. By first appearances, there is no way to tell what is inside, as it's merely a ''folder'' with the added extension '''.oxp'''.
Oolite Version 1.79 onwards supports also compressed files in ZIP format with extension '''.oxz'''.

To learn starting with a non-compressed version have a look at [[OXP_tutorial]].

{{QuoteText|Text=It's worth saying I think that compared with a lot of game addon architectures, the OXP architecture as designed by Giles is already very good at avoiding conflicts compared with a lot of other games
- you can save your game, add, remove and upgrade lots of OXPs, load your game, and have it work
- you can do this repeatedly, while incrementally upgrading the core game, for years
- as a player you basically never have to care about load order; as an OXP developer, rarely

It's also worth noting that a lot of types of OXP conflicts are inevitable due to resource conflicts - a planet can only have one diffuse map, a ship can only have one AI - or due to conceptual conflicts - OXP A removes all stations from a system; OXP B expects the player to dock there.|Source=([https://bb.oolite.space/viewtopic.php?p=241733#p241733 Cim (3rd Lead Developer)])}}

=== Oolite TR version ===
The Oolite Developer Release/Test Release version is specially developed for testing out OXPs. It comes with a [[Debug OXP]]/Debug Console allowing one to spawn ships/station on demand, award oneself a test ship, detect the mass of another ship ''etc''.

It is downloaded from the main Oolite website - currently http://www.oolite.space/download/

== OXZ ==
The new OXZ distribution format is strongly recommended. It makes version control and distribution just so much easier.

To make an OXZ file, use a ZIP program to compress the contents of the OXP folder, so that the [[manifest.plist]] file is in the root of the ZIP file, and the folders (AI, Config, etc) are folders in the ZIP file. Then, rename the ZIP file so that its extension is '''.oxz'''. To inspect an OXZ file, open it with your ZIP program.

Here is a sample: [[Media:X.0.1.oxz]] - just rename all "X" within to the title of your idea and put your name into the author fields.

You can use [http://www.ghisler.com/download.htm Total Commander] or [http://en.wikipedia.org/wiki/Krusader Krusader] to edit files within '''.oxz''' directly, without unpacking.

For more details read [https://bb.oolite.space/viewtopic.php?f=4&t=16688 The All-in-One Guide to OXZ Packaging and Distribution].

=== Creating an .oxz on an AppleMac ===
When you compress the files/folders on the AppleMac to create the .oxz ''do not'' select them with your mouse! This way lies misery!

Rather, ensure the relevant files/folders are inside one overall folder. Then, use '''command-a''' to select all the ''contents'' of this overall folder and then select '''compress''' from the file menu on the finder's menu bar. Finally, rename your newly-created .zip file as an .oxz

==Structure==
Inside the '''.oxp''' folder, or the '''.oxz''' file, it will at least contain a folder (Config, AIs, Models, Textures, etc...) that holds scripts, plists or other things like textures or models. It is down to the goal of the [[OXP]], which ways to combine elements to the OXP's contents. To get a feeling for it, simply take a look in other oxps. (If they are in .oxz format, any normal unzip program can inspect their contents - many will even let you edit the contents without having to unzip and rezip the file)

The structure for OXPs:
AddOns (folder)
~.oxp (really just another folder!) - Holds manifest.plist and the other folders:

--> AIs (folder) - Holds AI plists
--> Config (folder) - Holds all other plists (and possibly an anonymous "Script.js")
--> Images (folder) - Holds background images
--> Models (folder) - Holds the .dat files (special Oolite format)
--> Music (folder) - Surprise - holds .ogg music files
--> Scenarios (folder) - Holds new game scenarios (v1.79)
--> Scripts (folder) - Holds scripts (worldScripts and shipScripts)
--> Shaders (folder) - Holds Vertex and Fragment shaders (v1.69)
--> Sounds (folder) - Holds sound files
--> Textures (folder) - Holds models textures (can be planets, too!)
--> [[manifest.plist]] (file)
''the following might also be found in here:''
--> [[Misc plists|info.plist]] (file, seems to be a poor duplicate of the Manifest.plist)
--> [[Requires.plist]] (file: deprecated - replaced by Manifest.plist)

*If the OXP is in the uncompressed OXP folder format, the .oxp folder must contain a [[requires.plist]] file. If it is in the compressed OXZ single-file format, it must contain a [[manifest.plist]] file.

*[https://bb.oolite.space/viewtopic.php?f=4&t=13134 Nested OXPs in AddOns folder] (2012) - some OXZ's do this (Station spotter oxp inside [[Stations for Extra Planets]])

===AIs folder===
The folder named AIs contains any AI.plist additions the OXP might use.

* [[OXP howto AI|Making Oolite AI]]

In Oolite 1.79 AIs may be written in Javascript using .js files in this folder. A helper library is provided to make writing complex JS AIs simpler.

* [[Oolite PriorityAI Documentation]]
* [[Oolite PriorityAI Tutorial]]

===Config folder===
All plist files except for those introducing new AIs, ''[[requires.plist]]'', ''[[manifest.plist]]'' or ''[[Misc plists|info.plist]]'', belong in Config.

In its simplest form, an OXP could contain only a Config with an altering ''script.plist'' or ''planetinfo.plist''. An OXP that adds a new ship needs a ''shipdata.plist'' entry, and unless it is based entirely on existing Oolite data, would include a model and texture.

* [[OXP howto plist|Making Oolite plists]]
* Usually irrelevant: The Config folder isn't cached in the same way as the rest of an oxp because usually its contents merge rather than overwriting (See [https://bb.oolite.space/viewtopic.php?f=3&t=16927 here])
 
This folder contains [[Property lists]] such as:

* ''[[characters.plist]]'' that adds non-player characters to Oolite.
* ''[[crosshairs.plist]]'' that contains the look for your weapons (v1.73).
* ''[[customsounds.plist]]'' that contains references to ingame used sounds.
* ''[[descriptions.plist]]'' that adds vocabulary to Oolite texts.
* ''[[effectdata.plist]]'' defines custom visual effects (v1.77).
* ''[[equipment.plist]]'' lists upgrades available from the Shipyard.
* ''[[explosions.plist]]'' customises things blowing up (v1.81)
* ''[[global-settings.plist]]'' sets a few miscellaneous universal settings (v1.81)
* ''[[gui-settings.plist]]'' settings for reformatting the GUI screens (v1.81)
* ''[[hud.plist]]'' and ''[[hud.plist|hud-small.plist]]'' that allows for changes or a radically new ''Head-Up Display''.
* ''[[Oolite_Keyboard_Controls|keyconfig2.plist]]'' that allows for changes of the keymapping.
* ''[[missiontext.plist]]'' contains texts for the mission screens.
* ''[[OXPMessages.plist]]'' adds warnings to testversions of an oxp.
* ''[[planetinfo.plist]]'' that plots system specific changes from the default. May also contain ''script actions''.
* ''[[role-categories.plist]]'' for specifying groups of roles (''eg''.: trader, Miner, pirate ''etc''.) with similar properties (v1.79)
* ''[[scenarios.plist]]'' lists the starting scenarios in the Scenarios folder (v1.79).
* ''[[screenbackgrounds.plist]]'' that contains references to background images (v1.74).
* ''[[Scripting Oolite with JavaScript|script.js]]'' is the successor of [[script.plist]] in JavaScript.It will be loaded in preference to script.plist if both exist.
* ''[[shipdata.plist]]'' that introduces any new entity (ships, stations, objects etc.) to Oolite.
* ''[[shipdata-overrides.plist]]'' that selectively can replace shipentries in other shipdata.plists
* ''[[shiplibrary.plist]]'' that gives information for the ship description library viewable from the startup screen (v1.79)
* ''[[shipyard.plist]]'' that introduces new ships available for player purchase.
* ''[[shipyard-overrides.plist]]'' that selectively can replace shipentries in other shipyard.plists
* ''[[speech_pronunciation_guide.plist]]'' is another of the other custom methods.
* ''[[trade-goods.plist]]'' defines trade goods in 1.81 and later
* ''[[world-scripts.plist]]'' that contains a list of scripts (if more than one worldScript should be used).

Deprecated:
* ''[[commodities.plist]]'' that contains information for each commodity in a market in 1.80 or earlier
* ''[[demoships.plist]]'' that selects demoships to show on startup (replaced - approximately - by shiplibrary.plist in 1.79 and later)
* ''[[illegal_goods.plist]]'' that contains a list of banned/forbidden items in 1.80 or earlier. GalCop has an eye on that.
* ''[[Oolite_Keyboard_Controls|keyconfig.plist]]'' that allows for changes of the keymapping. (deprecated in v1.92)
* ''[[pirate-victim-roles.plist]]'' that defines which roles should act as traders. (deprecated in v1.79)
* ''[[script.plist]]'' to handle conditional ''script actions''. (deprecated)
* ''[[script.oos]]'' was briefly introduced during 1.70 development but is now deprecated in favour of JS.)

=== Models folder===
Oolite models need to be in an Oolite specific format using the the '''.dat''' file extension. There are utilities available that convert models made in Wings 3D (.obj) and Meshwork (.mesh) into this. A .dat file can be opened in a plain text editor to view the object's assigned texture names and see that they correspond with the actual file names in the Textures folder. The .dat file must be named exactly as it is referenced in the shipdata ''model'' entry - case sensitive!!!

* [[OXP howto model|Making Oolite models]] - tutorials for Wings3D & Blender, notes on sub-entities, links ''etc''.
* [https://bb.oolite.space/viewtopic.php?f=4&t=12165 Model Converter utilities] (2012-17)
* Video: [https://bb.oolite.space/viewtopic.php?f=4&t=16123 From scratch to Mamba in under an hour] ([[Dertien]], 2013)

===Scripts folder===
Scripts are in text format. In this folder you can put both JavaScript scripts as well as legacy scripts. New OXPs should only use JavaScript here.
* [[Scripting_Oolite_with_JavaScript|Scripting Oolite with Javascript]]
* [[Oolite_JavaScript_object_model|Scripting reference]]

===Textures folder===

Oolite's textures are in the '''.png''' format, usually at a standard 512x512 size, and must be named exactly as they are named in the .dat file.

* [[OXP howto texture|Making Oolite textures]]

* [[Smivs'_texture_tutorial|Smivs' guide to making Oolite textures]]

* [[Texturing tips and tricks by Theta Seven]]

Viewing a specific texture and / or model in Oolite.
"I made one. How do I proof it?"

* [[Viewing a Texture or Model]]

==Tool: OXP Verifier==

Oolite has what amounts to a spell checker for shipdata.plist and some other plists, called the OXP verifier.

*It does not work with OXZ's (so convert your OXP's to OXZ's later!).
*Nor does it work on the standard game release version of Oolite (v.1.90, v.1.92 ''etc''). Only on the Test Release/Developer's Release version ''and'' on the Nightlies/Pre-Releases (v.1.91, v.1.93 ''etc''.)

The verifier detects unknown keys or wrong use of keys ''etc''. It can currently only be invoked from the command line.

On Windows or Linux:
Code:
'''oolite.app/oolite --verify-oxp <path to OXP> '''

On Mac OS X:
Code:
'''Oolite.app/Contents/MacOS/Oolite --verify-oxp <path to OXP>'''

Most Mac users will not be familiar with using the command line. Look inside your application folder for a '''utilities folder'''. Inside that you will find a program called [https://en.wikipedia.org/wiki/Terminal_(macOS) Terminal]. 
Run it to open a terminal window. Now drop the oolite application on that window. That will generate the path to oolite on the command line. Delete the trailing space and paste the following text - including the trailing space- behind it: "/Contents/MacOS/Oolite --verify-oxp ". Now drop the oxp you want to verify on the window. That will again create the path to the oxp behind the last entry. 
When you select the window and hit the <return> key, the verification will start. It should now open the Console program, showing the results. 
'''Console''' is a log viewer developed by Apple Inc. and included with macOS, also in the utilities folder. It allows users to search through all of the system's logged messages, and can alert the user when certain types of messages are logged. The Console is generally used for troubleshooting when there is a problem with the computer. MacOS itself, as well as any applications that are used, send a constant stream of messages to the system in the form of log files. The console allows you to read the system logs, help find certain ones, monitor them, and filter their contents. See [[Debug OXP]] for more information.

There is a lengthy file - '''OXP verifier design.txt''' tucked inside your Oolite installation with more information about it

Note that it is possible to [https://bb.oolite.space/viewtopic.php?f=2&t=21443 obtain graphical output] from Graphviz for OXP Verifier.

=== Verifier BB threads ===
*[https://bb.oolite.space/viewtopic.php?f=8&t=13400 plist Editor Pro for Windows] (2013 - full of relevant Red Herrings)
*[https://bb.oolite.space/viewtopic.php?f=3&t=16865 lite --verify-oxp fails when path has spaces in it] (2014)
*[https://bb.oolite.space/viewtopic.php?f=4&t=21359 OXP Develoopment and Plist files] (2023 - quick introduction)

=== Correcting with plutil (Apple Macintosh Terminal utility) ===
Since a very small mistake is enough to stop a .plist from being accepted, it's important to be exact about every letter and sign. The Mac Terminal utility has a very practical tool for catching parser errors. After opening Terminal, simply type plutil, add one space, and drag and drop the plist in question onto the Terminal window. This will cause the 'address' of the plist to be shown. Hit return, and Terminal will reveal whether or not the plist is OK. If it's not, you might be given a clue to what is wrong, and the line number of the error - or just a general note that "Unexpected character { at line 1"!

==Need for unique names==
On loading the oxps, Oolite will add all files in the AIs, Models, Sound and Scripts folders in one big folder for its own use. That means that all files need unique names or one file will overwrite another with the same name. Files in Textures are not pre-loaded, but when looking for a specific texture Oolite looks in all Texture folders until it finds a texture file with a matching name. If another oxp contains a texture with identical name, Oolite could use that texture.

For the Config folder something similar happens. Here the plists all have the same name, but the content of all oxp plists is loaded per type in one big plist. e.g. all individual shipData.plist go in one big shipData.plist file. And within a single plist, all keys must be unique. When two plists use the same key, the later loading key will overwrite the former.

Generally it is a good habit to precede your chosen filenames and keys with the name of the oxp, or another unique prefix, to make sure the names stay unique and no other oxp will use the same names.

==Scripting with JavaScript==
Older OXPs (from [[User:Aegidian|Aegidian]]'s day were written in Legacy Script: see [[Methods]]. Modern OXPs are written in JavaScript. Specifically oolite.jsVersion 185, an Oolite specific variant of '''ECMAv5'''. It is the same Spidermonkey version that Firefox 4 shipped with many years ago, but it is a special build for Oolite. This is the version that we have almost always had and it has not changed between versions of the game. [https://bb.oolite.space/viewtopic.php?p=256623#p256623 It is unlikely to change] in the future.

JavaScript is the preferred scripting interface for worldScripts and shipScripts. The legacy scripting interface (see [[script.plist]]) still works, but is not supported. See [[Scripting Oolite with JavaScript]] for more information.

Note that most of the [[Legacy Scripting]] still works perfectly well (XML & OpenStep)!

==Hidden settings==
There are several [[Hidden_Settings_in_Oolite]] that make life for an oxp creator easier. One of them is the setting '''always-flush-cache'''. It makes every startup a bit slower, but it prevents Oolite working with cached data instead of your newly changed file. For someone that only does occasional oxp changes it will be enough to flush the cache by holding the shift key when starting Oolite but if you are writing oxps, this is the way to prevent frustrations.

==Cookbook==
* How to add dials to a HUD: https://bb.oolite.space/viewtopic.php?p=290352#p290352
* How to limit a station's shipyard to only offer a defined set of ships: https://bb.oolite.space/viewtopic.php?p=293174#p293174
* Ship/Station design with external docking ports: https://bb.oolite.space/viewtopic.php?f=4&t=21574&p=293777

== See Also ==
*'''Context''': [https://bb.oolite.space/viewtopic.php?p=275434#p275434 What can OXP's ''not'' change?] (2021)
*It is often helpful to dip one's toes (claws?) in the water by experimenting with tweaking oxp's first: see [[How to tweak OXZ's]]
*[[:Category:Oolite scripting]]
*[[Javascript Operators]]
*[[:Category:Oolite JavaScript Reference‎]]
*[[:Category:Oolite Development]]
*[[User:Montana05|Montana05]] recommends https://www.w3schools.com/js/js_array_sort.asp for better knowledge of the js on Oolite.
*[https://bb.oolite.space/viewtopic.php?f=4&t=12149 OXP Development Best Practices] (2012-7)
*Some older oxp's are written in [[Legacy Scripting]]
*[https://github.com/OoliteProject/oolite/find/master Github] vanilla game code repository - the resources section at the bottom of the page contains possibly useful parts of vanilla game coding, with occasional annotations.
=== Tools ===
*[[List of software]] that is helpful for creating OXPs (eg. editorial packages for javascript or 3D model creators)
*[[List of Planets used in OXPs]] for planets already used by other OXPs. Helps authors avoid overlapping with or breaking other OXPs.
*[[OXP_howto_Game_Balance|OXP howto Game Balance]] to avoid conflicts from accidental gameplay changes.
*[[Long Range Scanner]] is an OXP which allows you to jump around the star system to objects you have placed there - or to jump around within the galaxy. A "cheat" for players, but a useful tool for some OXP designers.

*[https://bb.oolite.space/viewtopic.php?f=4&t=13422 What Tools Are Good For Windows OXP Programming?] (2013)

==== Tutorials for Tools ====
*[https://web.archive.org/web/20050317033938/http://oolite.aegidian.org/cyoship/ Oolite Tutorial - Meshwork Shipbuilding (OSX only)] via WayBack Machine
*[https://web.archive.org/web/20060621211940/http://oolite.aegidian.org/cyoship2/ Oolite Tutorial - Wings 3D Shipbuilding (Cross-platform)] via WayBack Machine

=== OXP tutorials ===
Oolite changes affecting different varieties of OXPs happened with v.1.76 (2011), v.1.80 (2014) & v1.82 (2015).
*[https://bb.oolite.space/viewtopic.php?f=4&t=20937 MasterClass: How to OXP (updating SoThisTC)] by [[User:Spara|Spara]] who teaches computing in Helsinki! (2021)
*[https://archive.org/details/GettingStartedWithOoliteOXZDevelopment Getting started with OXZ Development] ''An .odt for Open Office'': By Bugbear (2012). 2 example OXPs: a pirate-ridden solar systems warning tool & Witchspace Blockades [https://bb.oolite.space/viewtopic.php?f=4&t=17731 BB Thread (2015)]
*[[OXP_tutorial|OXP Tutorial]] creating a new spaceship - and then tweaking it in different ways (2007-13)
*[[OXP howto dockable stations|Creating a dockable station]] (2009-10)
*[[User:Shipbuilder|Shipbuilder]] wrote a Shaders tutorial with resource packs (2013)

*[https://bb.oolite.space/viewtopic.php?f=4&t=18837 OXP Performance] BB thread (mostly 2017-8): improving your OXP (speed, ''etc'')

*[https://bb.oolite.space/viewtopic.php?f=4&t=18284 The bare minimum for a game-recognizable ship OXP] (thread: 2016)
*[https://bb.oolite.space/viewtopic.php?f=4&t=14135 How to make a simple OXP?] (thread: 2013) 3 OXPs - pop-up message at docking, set only Pythons for sale at Lave shipyard, create a new ship.

*[[Escape Pod Locator OXP]] has notes on programming on the bottom of the page regarding beacon transmission & location

=== Helpful OXPs for your OXP===
There are a number of OXPs which have been specifically written to allow your OXP to use them:
*[[Library OXP|Library]]: a collection of useful snippets and helpers. Its main purpose is to simplify or unify some common tasks used by OXPers.
:*It can add dynamic maps, music & animation.
:*It adds a Personal Assistant Device for the player with details of people met, medals awarded, Guild rankings, ''etc''.
:*It allows in-game configuration of an oxp by the player.
:*Add-on modules allows inspection of models and materials for creation of ship & station oxps.
*[[GalCop Missions]] introduces many new pieces of equipment with wide varieties of use (Cargo Stoppers, Ejection Dampers, Range Finders, Solar Radiation Disrupter Missiles, Seismic Resonance Scanners, Patient Transport Modules ''etc''). It can also help with creating missions (it contains over 80 varieties - see the spoiler button on that wiki page).
*[[Diplomancy]] can be used to make states of war impact personally on the player
*[[System Data Config]] helps re-organise the F7 screen to squeeze more information onto it

==== While docked/stations ====
*[[HD Backgrounds]] can provide a High Definition screenshot of a station lobby or other such for interaction with the player
*[[BGS]] can help organise a customised docking or launching sequence (see the [[Riredi OXP]] or the [[Kiota Stations]]).
*[[GNN]] can broadcast your news alerts (see how [[Diplomancy]] uses it for war & peace declarations). GNN also contains '''PhraseGen''' which can be used for randomizing text descriptions.
*[[Station Validator]] will remember that a station has been destroyed and stop Oolite automatically replacing it on the next visit to the system
*[[Station Dock Control]] can help interraction with other ships docked at the station
*[[Bulletin Board System]] can help manage interractions at the station
*[[Email System OXP]] can also help manage interractions at the station
*[[Ship Storage Helper]] allows storage of the player's ship whilst doing other things (such as flying another ship!)
*[[Equipment Storage OXP]] allows storage of equipment/goods whilst doing other things
*[[Ship's Library]] allows reading documents with illustrations while docked (see the included Ship's Manual)
*[[Station Options]] allows complex configurations of equipment, but could potentially also be used for managing dialogue with NPCs
*[[Life in the Frontier]] was being expanded to cover more stations (Dodo/Ico/Rock Hermits and potentially OXP stations), but is currently mothballed.

==== In-flight ====
*[[MFD - Broadcast Comms]] can be used for in-flight interaction with NPC's
*[[Bigships]] can be used to help with the AI for massive space ships which cannot dock at orbital stations
*[[Montanas Resource Pack 01]] contains a number of resources for use (treasures, containers, escape/survival equipment)
*[[Star System Lane Indicator]] - the older version contains a very graphical dynamic display (does not function properly, but boy! does it look good!)
*[[SOTL Exploration]] contains exploration equipment and a non-automatic hyperspace jump
*[[SOTL Altmap]] contains different politics, markets and NPCs with Torus Drives.
*[[Resistance Commander]] & [[EscortDeck]] contain mechanisms for "managing" allied ships.

==== Planet Surfaces ====
*[[Planetfall OXP]] allows landing on the planet (used by [[Feudal States]] for access to the Royal Court, and by [[Astronaut]] for space-jumping)
*[[Lave is Earth 8k]] contains night-time city lighting

=== Packaging and distribution ===
*[https://bb.oolite.space/viewtopic.php?f=4&t=16688 The All-in-One Guide to OXZ Packaging and Distribution].
::And see [https://bb.oolite.space/viewtopic.php?p=279034#p279034 this post] for AppleMac issues with the above.
* Cim created [https://github.com/cim--/oxp-build-scripts some scripts to ease packaging] a project.
*[[OXP Distribution]] The All-in-One Guide to OXP Packaging and Distribution (and [[OXP_standards]] for advice on which ways of doing things are supported and which are not).
* Since the domain change to [https://oolite.space] the distribution of expansions has changed slightly. The new version is still subject to discussions and might change again. Here is a [[Publishing Procedure Comparison]].
*[[Gameplay_and_Balance_Indicator|Gameplay Balance Indicator]] and [[OXP_Levelindicators|Difficulty Indicator]]. Add these to your wiki page to show effects on Game Balance and the Difficulty Level of your OXP/OXZ. The '''first''' indicates the impact on play (equipment making the game easier/more difficult), the '''second''' indicates the suggested [[Elite Rating]] needed to attempt the mission/defeat the ship ''etc''.

[[Category:Oolite]]
[[Category:Oolite scripting]]

Oolite Missions

2026-07-28T11:25:59Z

Cholmondely: /* Musings */ Updated GalCop Missions description

'''Important note''': for many of these missions, important information/reminders are displayed on the [[F5 screen (commander "jameson": details)|F5F5 screen]].

The Constrictor Hunt mission crucially uses the [[F7 screen (data on "system")|F7 screen]] for gossip.

Missions are from OXPs unless indicated otherwise.

== Musings ==
Note that some of the missions OXPs are rather more than "just" missions. The Assassins Guild rebuilds the 7th Galaxy, Iron Raven does the same for G8. Ionics provides a unifying theme for the north-east corner of G2, with Resistance Commander doing the same for the south of G6.

And various of the Thargoid-related missions (Cataclysm, TCAT, Thargoid Wars ''etc'') create a veritable armageddon against the Thargoids.

{| class="wikitable sortable" width="100%" style="border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #ffffff; table-layout: fixed; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;"
|-
! scope="col" width="165px" style="margin: 0px; padding: 0px; border-width: 1px; border-style: solid; border-color: #ffffff; background-color: #e7e7ff; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;" |Mission
! scope="col" width="50px" style="margin: 0px; padding: 0px; border-width: 1px; border-style: solid; border-color: #ffffff; background-color: #e7e7ff; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;" |Start
! scope="col" width="45px" style="margin: 0px; padding: 0px; border-width: 1px; border-style: solid; border-color: #ffffff; background-color: #e7e7ff; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;" |Kills
! scope="col" width="200px" class="unsortable" style="margin: 0px; padding: 0px; border-width: 1px; border-style: solid; border-color: #ffffff; background-color: #e7e7ff; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;" |Other Requirements
! scope="col" width="1500px" class="unsortable" style="margin: 0px; padding: 0px; border-width: 1px; border-style: solid; border-color: #ffffff; background-color: #e7e7ff; vertical-align: top; text-align: left; overflow: hidden; white-space: nowrap;" |Notes/Description
{{OoliteMissionTableRow
|name=Constrictor Hunt (Native)
|start=G1, G2
|kills=256
|desc=Native There is a [[Mission One - FAQ|FAQ]] available.}}
{{OoliteMissionTableRow
|name=Thargoid Plans (Native)
|start=G3
|kills=1281
|req= Finished Constrictor Hunt
|desc=Native See [https://bb.oolite.space/viewtopic.php?p=252452#p252452 here] for tips if needed!}}
{{OoliteMissionTableRow
|name=Nova (Native)
|start=G4
|req=Galactic Hyperdrive
|desc=Native}} See [https://bb.oolite.space/viewtopic.php?p=177657#p177657 here] and following for some Dark Side details of this mission
{{OoliteMissionTableRow
|name=Cloaking Device (Native)
|start=G5
|desc=Native}}
{{OoliteMissionTableRow
|name=Trumbles (Native)
|start=any
|req=Balance of 6553.5₢ or more
|desc=Native}}
{{OoliteMissionTableRow
|name=[[The Assassins Guild OXP|Assassins Guild]]
|start=G7
|kills=200
|desc=By [[User:LittleBear|LittleBear]]: 21 missions involving murder to order. Progress depends on your Elite and Guild Ratings. Also see [[Victim 11]]}}
{{OoliteMissionTableRow
|name=[[Aquatics OXP|Aquatics - The Kraken IV]]
|start=G3
|req=Good standing with the Corporation
|desc=By [[User:Thargoid|Thargoid]]: A mission based out of the [[Aquarian Shipbuilding Corp. HQ]] in the Aqualina system.}}
{{OoliteMissionTableRow
|name=[[Asteroid Storm]]
|start=G1
|kills=64
|desc=By [[User:LittleBear|LittleBear]]: A station comes under threat from a large asteroid strike. Begins when docked in Leesti.}}
{{OoliteMissionTableRow
|name=[[Black Monk Monastery|Bank of the Black Monks]]
|start=any
|desc=By [[User:LittleBear|LittleBear]]: Mini-mission. Deal with the loan sharks (if you take out a loan). Begins when docked at any Black Monk Monastery.}}
{{OoliteMissionTableRow
|name=[[BlackjacksBullion OXP|Blackjack's Bullion]]
|start=G2
|desc=By Rustybolts: Starts at Telace as Commander Blackjack arrives via escape pod.}}
{{OoliteMissionTableRow
|name=[[Cataclysm OXP|Cataclysm]]
|start=G1
|kills=5200
|req=Finished Thargoid Plans
|desc=By [[User:Commander McLane|Commander McLane]], updated by [[User:Phkb|Phkb]]: Sends you on a mission far bigger than anything you have done for the Navy so far.}}
{{OoliteMissionTableRow
|name=[[Coyote's_Run|Coyote's Run]]
|start=G5
|kills=
|req=Cloaking Device
|desc=By [[User:Cody|Cody]] & [[Okti]]: The mission will commence when the player jumps into Laquused in G5, with a Cloaking Device.}}
{{OoliteMissionTableRow
|name=[[Curse_of_the_Black_Sunspot|Curse of the Black Sunspot]]
|start=G3
|kills=512
|req=
|desc=By [[User:Cim|Cim]]: Sometimes pirates are more than they seem}}
{{OoliteMissionTableRow
|name=[[Deposed OXP|Deposed]]
|start=G4
|kills=1700
|desc=By Cmdr. Wombat: A series of missions connected by a plot. Triggers the Nova mission if you haven't finished it yet.}}
{{OoliteMissionTableRow
|name=[[Escort Contracts OXP|Escort Contracts OXP]]
|start=any
|kills=any
|req=Clean legal status
|desc=By [[User:Capt. Murphy|Capt. Murphy]]: Allow players to enter into short-term escort contracts with NPC lone wolf traders.}}
{{OoliteMissionTableRow
|name=[[Feudal States]]
|start=any
|kills=
|desc=By [[User:Ramirez|Ramirez]]: Mini-missions on behalf of various Royal Courts.}}
{{OoliteMissionTableRow
|name=[[The Galactic Almanac OXZ|The Galactic Almanac]]
|start=G1
|kills=any
|req= Must also have GNN News Installed
|desc=By [[User:LittleBear|LittleBear]]: A scavenger hunt through Galaxy 1. Keep an eye on the News and wait to be contacted.}}
{{OoliteMissionTableRow
|name=[[Galactic Navy OXP|Galactic Navy]]
|start=any
|kills=128
|desc=By Matt634: The Galactic Navy needs you. Begins when docked at any SecCom Station.}}
{{OoliteMissionTableRow
|name=[[Galactic Navy OXP|Galactic Navy Spec Ops]]
|start=G6
|kills=128
|req=Finished 10 Reserve Sorties
|desc=By Matt634: Begins when docked at any SecCom Station. There is a [[Galactic Navy Spec Ops Walkthrough|walkthrough]] available if you need hints.}}
{{OoliteMissionTableRow
|name=[[GalCop Missions]]
|start=any
|kills=
|req=Occasional equipment needs
|desc=By [[User:Phkb|Phkb]]: Adds over 80 different local mini-missions to the [[Bulletin Board System]]}}
{{OoliteMissionTableRow
|name=[[GalCop's Most Wanted]]
|start=any
|kills=
|req=Various equipment needs
|desc=By [[User:Phkb|Phkb]]: Adds mini-missions for Bounty Hunters}}
{{OoliteMissionTableRow
|name=[[Illegal Goods Tweak OXP|Illegal Goods Tweak OXP]]
|start=any
|kills=any
|req=Released slaves to customs.
|desc=By [[User:Capt. Murphy|Capt. Murphy]]: Short reward mini-missions offered by rescued ex-slaves.}}
{{OoliteMissionTableRow
|name=[[Ionics OXP|Ionics]]
|start=G2
|desc=By [[User:Galileo|Galileo]]: A series of missions featuring the Ionics Company of Zaria. Begins at Zaria.}}
{{OoliteMissionTableRow
|name=[[Iron Raven|Iron Raven]]
|start=G8
|desc=By [[User:Ramirez|Ramirez]]: Multi-stage mission to investigate a dangerous conspiracy on behalf of GalCop High Command.}}
{{OoliteMissionTableRow
|name=[[Lave Academy OXP|Lave Academy]]
|start=G1
|desc=By [[User:Thargoid|Thargoid]]: Training mini-missions.}}
{{OoliteMissionTableRow
|name=[https://bb.oolite.space/viewtopic.php?f=4&t=9135&hilit=linkg7 LinkG7]
|start=G7
|desc=By [[Okti]]: Find a way across the great rift.}}
{{OoliteMissionTableRow
|name=[[Localhero OXP|Localhero]]
|start=G1-G5
|kills=50
|req=Must be lawful
|desc=By [[User:Svengali|Svengali]]: Support the local police to find, destroy and capture ex-general Harkov and his group.}}
{{OoliteMissionTableRow
|name=[[LongWay_OXP|Long Way Around]]
|start=G1
|desc=By [[User:Aegidian|Aegidian]]: A transport mission well suited to the novice in Galaxy 1. Begins at Biarge.}}
{{OoliteMissionTableRow
|name=[[GalDrivePod#Lost_Worlds_Grand_Tour|Lost Worlds Grand Tour]]
|start=G6
|kills=N/A
|req=[[GalDrivePod]]
|desc=By [[User:Smivs|Smivs]]: A tour of the Lost Worlds in Galaxy 7, and then to Oresrati in G8. Tour ends back in G1.}}
{{OoliteMissionTableRow
|name=[[Lovecats.oxp|Love Cats]]
|start=G4
|req=Finished Constrictor Hunt
|desc=By [[JohnSmith]]: Begins when docked.}}
{{OoliteMissionTableRow
|name=[[Military Fiasco]]
|start=any
|kills=1000
|req=Must be lawful
|desc=By [[User:Murgh|Murgh]]: A mission for the Navy available to a Commander with more than 1,000 kills.}}
{{OoliteMissionTableRow
|name=[[MincePie]]
|start=any
|kills=
|req=Mince Pies
|desc=By Araser: Even dafter than the [[Santa]] oxp, which this is a development for.}}
{{OoliteMissionTableRow
|name=[[Oo-Haul|Oo-haul Escort Missions]]
|start=any
|kills=32
|req=Good standing with Oo-Haul corp.
|desc=By [[User:Dr. Nil|Dr. Nil]]: Escort a hauler safely to its destination. Must be docked at a Constore. [[Your Ad Here!]] required.}}
{{OoliteMissionTableRow
|name=[[Random Hits OXP|Random Hits]]
|start=any
|kills=32
|desc=By [[User:LittleBear|LittleBear]]: Get contracts for bounty hunting at any Seedy Space Bar. Special Missions for successful hunters.}}
{{OoliteMissionTableRow
|name=[[RRS_Group|Rescue Stations]]
|start=any
|kills=
|desc=By [[User:Cim|Cim]]: Rescue and recovery missions for contract pilots.}}
{{OoliteMissionTableRow
|name=[[Resistance Commander]]
|start=G5
|kills=1000
|req=Ship with at least 6 missile pylons
|desc=By [[User:Ramirez|Ramirez]]: Engage in a long campaign against the Biesmaan Dictatorship and command a small squadron.}}
{{OoliteMissionTableRow
|name=[[Runner G5 Challenge]]
|start=G5
|kills=
|req=
|desc=By galpet: Complete a non-stop 50LY journey from Rianin to Ceered in Galaxy 5. En route collect 750TC cargo and 100 kills.}}
{{OoliteMissionTableRow
|name=[[Scourge of the Black Baron]]
|start=G1
|kills=151
|desc=By [[User:Rxke|Rxke]]: A sequel to the [[LongWay_OXP|Long Way Around]], featuring combat and transport missions. Begins at Teesdi.}}
{{OoliteMissionTableRow
|name=[[Shrews Rights]]
|start=G2
|kills=512
|desc=By [[User:Zafrusteria|Zafrusteria]]: Save the Shrews! Begins at Arries.}}
{{OoliteMissionTableRow
|name=[[Spy Hunter OXP|Spy Hunter]]
|start=G1
|kills=512
|desc=By [[User:Selezen|Selezen]]: A mission for the Galactic Navy. Starts at Inines.}}
{{OoliteMissionTableRow
|name=[[Stealth OXP|Stealth]]
|start=G3
|desc=By [[User:Thargoid|Thargoid]]: Small mission to showcase the new scanner capabilities of 1.74 and to introduce stealth ships.}}
{{OoliteMissionTableRow
|name=[[Stellar Serpents OXP]]
|start=Any
|desc=By [[User:Thargoid|Thargoid]]: Hunt the stellar serpents.}}
{{OoliteMissionTableRow
|name=[[Taranis OXP|Taranis]]
|start=G1
|kills=128
|req=Must be clean
|desc=By Roberto: Begins at Taranis Corporation HQ, Lerelace.}}
{{OoliteMissionTableRow
|name=[[Taxi Galactica]]
|start=Any
|desc=By [[User:Pleb87|Pleb87]]: Mini-mission taxi tasks. Begins at any Corporate state taxi station.}}
{{OoliteMissionTableRow
|name=[[TheCollector|The Collector]]
|start=G1
|desc=By Mossfoot & [[User:Norby|Norby]]: Find the rich man and do the jobs he offer.}}
{{OoliteMissionTableRow
|name=[[Thargoid Wars|Thargoid Wars]]
|start=G2-G8
|desc=By Cmdr. Wombat: War with the Thargoids intensifies featuring new attack and defense missions.}}
{{OoliteMissionTableRow
|name=[[Tionisla Reporter]]
|start=G1
|desc=By [[User:Eric Walch|Eric Walch]]: A small mission for the Tionisla Chronicle.}}
{{OoliteMissionTableRow
|name=[[TCAT OXP|To Catch A Thargoid (TCAT)]]
|start=G3
|kills=1500
|req=Finished Thargoid Plans
|desc=By [[User:Thargoid|Thargoid]]: The Bugs are back - follow-up mission to Thargoid Plans. May be offered while docking.}}
{{OoliteMissionTableRow
|name=[[Trident Down]]
|start=G4
|kills=512
|desc=By [[User:Ramirez|Ramirez]]: Investigate a vicious attack on an Trident Shuttle operated by [[Executive SpaceWays]].}}
{{OoliteMissionTableRow
|name=[[UPS Courier|UPS Courier Company]]
|start=any
|desc=By [[User:Eric Walch|Eric Walch]]: Take goods or documents from system to system and be awarded with combat mini-missions.}}
{{OoliteMissionTableRow
|name=[[Vector OXP|Vector]]
|start=any
|kills=150
|req=300 kills for the background story
|desc=By [[User:Svengali|Svengali]]: Special feature - 'Richmans World' - a unusual mission type. [[Snoopers|Snoopers]] required.}}
{{OoliteMissionTableRow
|name=[[Victim 11]]
|start=G7
|req=Finished Assassins Guild
|desc=By [[User:Fatleaf|Fatleaf]]: A follow-up mission to [[The Assassins Guild OXP|Assassins Guild]] that picks up some loose ends.}}
{{OoliteMissionTableRow
|name=[[Xeptatl's_Sword|Xeptatl's Sword]]
|start=G5
|req=None
|desc=By [[User:Smivs|Smivs]]: A mission taking you around the 'Eight' twice in a bid to thwart the Thargoids evil plans.}}
|}

Note that a number of missions are marked as Deprecated.
:In some cases, this is due to changes in Oolite. Try an older version from the links [[Oolite|here]].
:*[[Localhero OXP]] will not work on 1.72 or newer.
:*[[Vector OXP]] will not work on 1.77 or newer.
:*[[Xeptatl's Sword]] will not work with 1.82 or newer
:In other cases, the original plan of the author was banjaxed by the growing plethora of oxp's which defeated the mechanics of the mission (such oxp's as [[Telescope]], fuel tanks, or the various [[Ubership]]s, ''etc''), and in one case it was marked as deprecated. In such cases it will still work (and you can remove some of these oxp's to get the original feel intended for the mission).
:*[[Cataclysm OXP]] was for many years an example of this with [[User:Commander McLane|Commander McLane]] refusing to update it because he considered it broken as a result.

== Links ==
*[[OXP List]]
*[http://www.oolite.org/oxps/ OXZ list] - downloadable through the in-game [[Expansions Manager]]
*[[Guide to Unlisted OXPs]]

=== The Dark Side ===
*[[OXP howto]] introduction to writing OXPs
*[[List of Planets used in OXPs]] for reference for OXP writers to avoid clashes!
*[https://bb.oolite.space/viewtopic.php?f=4&t=18240 Mission packs and the grind] (2016) - discussion of abstract missions

[[Category:Oolite]]
[[Category:OXP Lists]]
[[Category:Missions OXPs| ]]

GalCop Missions

2026-07-28T11:23:57Z

Cholmondely: Added strapline at top

[[image:gcm_mission_example.png|right|500px|Sample mission]]
Adds over 80 different types of missions.

==Overview==
This OXP adds some local missions to the [[Bulletin Board System]], to hopefully add more things to do in and around each system. Very little by way of new ships, stations, equipment or AI's has been added to the game. The idea was to simply make use of the existing assets in new and (hopefully) interesting ways.

There are a number of different missions available, and the availability of these missions depends on a number of factors (score, system tech level, government type, installed equipment etc). Missions can be offered in a number of ways: via the Bulletin Board, from scooped escape pods, from passing ships, or from emails.

This OXP also includes the concept of "mission chains", in that completing one mission may trigger a second mission, which could then trigger a third mission, and so on. Sometimes the player is given an option as to whether they want to perform the secondary mission, and sometimes they won't be.

Generally, all the missions are optional. If you don't visit the Bulletin board, you won't see what's on offer, and very little in the game will change if you don't do the missions (although see the two sections below: Gameplay Impacts and Disease Outbreaks). You may occasionally be offered a mission when scooping escape capsules, and sometimes passing ships will pass on requests.

===Gameplay impacts===
Some of the missions in this pack can impact on other areas of the game. For instance, one type of mission, if completed successfully, will result in a higher frequency of mis-jumps to a particular system. Some missions can effect the commodities of a station, or the availability of equipment at a station. It will hopefully be obvious when these changes take place (ie as a result of completing a mission).

===Disease Outbreaks===
Another potential impact is on systems that are reported to have disease outbreaks. If a major outbreak occurs, GalCop might choose to lock down the system, preventing the disease from spreading off-world. When this happens, you might find you can’t jump to a particular system without a permit. Some pilots have reported there are ways around GalCop’s restrictions, but even if you do, you might find that GalCop stations in that system will physically prevent you from docking, and inattentive pilots might find their ship taking damage rather than entering the docking slot.

When a disease outbreak restriction is in effect, there might be missions you can undertake that will grant you the required permissions and passcodes to successfully enter the system and dock at the main station. These missions will likely be in systems close to where the outbreak is occurring.

==Mission Categories==
This mission pack contains over 80 different missions and variations, but most of the missions fall into one of these general categories.
* '''Hunter''' - Hunt down and destroy certain ships (asteroids, pirates, traders, Thargoids, police, etc).
* '''Recovery''' - Find and collect certain items (cargo, derelicts, black boxes, data packets, etc).
* '''Rescue''' - Locate and collect escape pods, deliver critical equipment to stricken ships, deliver medical supplies.
* '''Delivery''' - Take cargo between one point and another, but outside the normal cargo mission system.
* '''Covert''' - Install spying software, disrupt station economies, hack witchpoint beacons.
* '''Donation''' - Donate money or cargo to charities to gain economic or legal advantages.

==Required Equipment==
[[Fuel_Scoops|Fuel/Cargo scoops]] and the [[Advanced_Space_Compass|Advanced Space Compass]] are required for many of the missions. If your ship lacks these items, certain missions will be unavailable.

[[BroadcastComms_MFD|Broadcast Comms MFD]] is a requirement for many of the missions, as it provides an interface for ship-to-ship communications. If you have not purchased this item, some of the missions will be unavailable.

==New Equipment==
Some new equipment has been added with this OXP.
[[File:Range Finder (1).png|right|320px]]
[[File:Range Finder (2).png|right|320px]]
===Range Finder MFD===
When this item is purchased, installed and primed, you can press the "b" key (Mode) to switch the mode between escape capsules, black boxes, asteroids, ships, communication relays and cargo pods. Pressing the "n" (Activate) key will initiate a scan of the local area, up to a distance of 200km. The scan will take approximately 2 seconds to run, but will be run continuously until deactivated with the "n" key again. Any objects of the selected type within range will be displayed, along with the distance to the object. A "+" or "-" indicator will be displayed next to each item, showing whether you are moving away from (+), or towards (-), the target. When the target is less than 50km away, a simplified directional indicator will be shown instead, but outside this distance, the range finder does not provide directional information. The information returned by the scan is displayed in an MFD, so you will need to select an MFD slot (using the ":" key) and then select the Range Finder MFD (using the ";" key).

Direction indicators when distance < 50km:
O - Target is generally ahead of you
o - Target is ahead of you.
X - Target is directly ahead of you.
< - Target is to the left
> - Target is to the right
^ - Target is above you
v - Target is below you
A - Target is behind you (ie Aft)

Range Finder MFD
Techlevel: 5
Price: 250 cr

Note: When the Range Finder is activated, there will be a drain on your ships energy. If the [[Ship Configuration OXP|Ship Configuration OXP]] is installed, engaging the Range Finder will also generate cabin heat.

===Range Finder Extender===
An additional device, a Range Finder Extender, which increases the range of the scanner to 500km, as well as boosting the range for the simplified directional indicator to 75km.

Range Finder Extender
Techlevel: 9
Price: 2650 cr

===Comms Relay Beacon Switch===
This device will be issued to the player when attempting particular missions, although it can also be purchased independently from TL3 systems for 60cr. It is a primable piece of equipment that will communicate with any communication relays in the system and request the beacon to be switched on for a short period of time. The device can be used 3 times before needing to be recharged. Using the device will incur a 5% penalty on whatever mission the communication relay relates to.

Comms Relay Beacon Switch
Techlevel: 3
Price: 60 cr

===Comms Relay Beacon Switch Recharge===
This item will replace all the degraded parts of the switch, allowing it to be used 3 more times. The cost will vary, based on how degraded the current parts are. It is available in all systems.

===Cargo Stopper===
This device makes use of the [[Tractor Beam|tractor beam]] which forms part of the cargo scoops. When your ship is aimed at cargo cannisters that are floating away, it will automatically use the tractor beam to bring the cargo to a stop. Cargo must be within 2km of your ship, and in the centre area of your front viewscreen, otherwise the tractor beam can't reach it.

Cargo Stopper
Techlevel: 6
Price: 30 cr

===Ejection Damper===
This device attaches to the end of the cargo scoop, and when engaged, will apply some force to any ejected item so that it will slow to a stop within a short period of time, rather than floating away at a constant rate.

Once purchased, the unit must be turned on before any cargo will be impacted. Prime the "Ejection Damper" equipment, and press either the "Mode" (b) or "Activate" (n) key to turn the unit on. Pressing those keys a second time will turn the unit off. The unit is automatically turned off whenever your ship docks.

When the unit is on, all cargo ejected will be slowed to a stop. The device can be used on 50 ejected items before it needs to be replaced.

Ejection Damper
Techlevel: 7
Price: 100cr

==Required OXP's==
The following OXP's are listed as required:
* [[Bulletin Board System]] - Required as all missions are accessed through this interface.
* [[BroadcastComms_MFD|BroadcastComms MFD]] - Required for missions that need ship-to-ship communications to take place. Also used for accepting or declining secondary missions.
* [[Email_System_OXP|Email System]] - Provides another interface for missions to be offered.
* [[GNN]] - Provides text randomisation system used for mission descriptions. Plus, some news items will be published periodically, which can add some flavour to game events.

==Recommended OXP's==
The following OXP's are listed as recommended, in that additional text and/or gameplay options will become available if they are installed.
* [https://bb.oolite.space/viewtopic.php?f=4&t=17846 Manifest Scanner] - Can aid with finding cargo in other ships, which can be very important if you are on a mission to steal certain cargo.
* [[Cargo_Scanner_OXP|Cargo Scanner]] - Can help with some missions to identify the contents of cargo containers.
* [[Black Market]] - Some additional opportunities are available through the Black Market interface in this OXP.
* [[Satellites]] - Some missions are available related to the various satellites created by this OXP.

[[File:F4 Reputation.png|thumb|right|300px|After blasting some local pirates on a number of visits (no missions involved), this Jameson became a "Casual Acquaintance" of Ararus]]
==What else is in the box?==
'''Reputations:''' The missions available to the player originate from a number of different entities - governments, corporations, factions of every stripe. As missions are performed for these entities your reputation will increase. However, given the number of entities involved, a new F4 interface screen has been created that combines all reputation information into an easy to read display. Also, any awards received can be displayed as well.

If you have the [[Library OXP]] installed, you additionally have the option of importing a variety of internal and OXP reputations into the screen, rather than having those reputations displayed on the F5F5 Manifest screen.

<div class="mw-collapsible mw-collapsed" data-expandtext="Spoiler: show mission list" data-collapsetext="Hide list" style="overflow:auto;">
This is Phkb's working list, taken from his GalCopBB_Missions.js (April 2026 version) with inclusions from the other scripts.

There seem to be 81 fully functional missions (presumably those with the blue blobs!), with much code already written for the others (I have assumed that the satellite missions are all fully functional). (''Cholmondeley 12:19, 28 July 2026 (BST)'')

''Mission types''
:*1 - "Cleanup the spaceways": destroy x number of asteroids in the current system
:::any system, max of 1 mission of this type
:*2 - "Making the system safer": destroy x number of pirates in system y.
:::any safe system within 7 LY of a feudal or anarchy
:::record when mission is accepted and only offer another one to the same system after 10 days
:*3 - "Disrupting trade (System authority)": destroy x number of traders in system y.
:::any multi-gov or worse, near a safe system
:::record when mission is accepted and only offer another one to the same system after 10 days
:*4 - "Disrupting trade (Pirate authority)": destroy x number of traders in system y.
:::record when mission is accepted and only offer another one to the same system after 10 days
:*5 - "Thargoid hunt" - intentionally misjump between system X and Y and destroy N number of thargoid motherships (not tharglets)
:*6 - "Collect the deposit" (System authority): find dumped cargo in system X, deliver to system Y.
:::- cargo will be guarded by x number of high quality ships
:*7 - "Collect the deposit" (Pirate authority)
:*8 - "Pirates for hire (System authority)": attack trader ships in system X to get their cargo (n tons required),
:::return to system Y
:*9 - "Pirates for hire (Pirate authority)": attack trader ships in system X to get their cargo (n tons required), return to system Y
:*10 - "Pirate specific commodity (System authority)": find an amount of a particular commodity but only when in a particular system and only from piracy (not purchased from stations)
:*11 - "Pirate specific commodity (Pirate authority)": find an amount of a particular commodity but only when in a particular system and only from piracy (not purchased from stations)
:*12 - "Free slaves": (if IGT is installed) target all ships entering Communist or higher system, and if carrying slaves, demand cargo.
:::(Recommend the "Manifest Scanner" be installed)
:::Use BroadcastCommsMFD to "Demand slaves"
:::Ship will then have the ability to respond: either "OK" (and slaves are dumped), or "I'm not carrying slaves", or "Get lost"
:*13 - "Collect Thargoid wreckage" destroy thargoids and collect wreckage in interstellar space
:::add scenario where alloys are destroyed during flight
:::>> prevent thargoid alloys from being relabelled by Smugglers
:::>> prevent thargoid alloys from being put into storage by SC
:*14 - Gun runner: attack ships in target looking for firearms
:*15 - Drug dealer: attack ships in target looking for narcotics
:*16 - Civil unrest (pirate authority): destroy as many police ships in current system as you can
:*17 - Garbage scow: dump radioactive waste containers near sun so they are destroyed by heat
:*18 - Rival gang war (ie pirate hunt) (pirate authority)

''Escape Pods, Black Boxes & Derelicts''
:*20 - Find escape pod in particular system and rescue occupant
:::- when in range, send out a distress signal to the player
:*21 - interstellar escape pod rescue
:*22 - Find black box in particular system and collect it
:::- make this different from Rescue Stations by making the black box be inside the hulk of a destroyed ship
:::- need some way of locating ship hulk - maybe an intermittent comms signal?
::::- have console message appear saying "Weak navigation beacon signal ("U") being picked up."
::::- player switches ASC to find "U", gets a heading, then signal disappears. The further away the player is, the more inaccurate the ASC heading is.
::::- repeat until the player finds the hulk (ie is comes within scanner range)
::::- give player the option of selling black box on the black market
:*23 - interstellar black box recovery
:*24 - Destroy derelict ship, scoop data cache (special cargo pod) and return it to station
:*25 - catch runaway escape pod - escape pod ended up with a massive ejection speed and is on it's way to interstellar space.
:::a regular waypoint will be set showing the pods last position

''Ship-to-ship''
:*30 - Find and meet a particular ship in a particular system, will lead to secondary mission
:::- via BB as a mission
:::- via email when created as a primary mission
:::- via a random trader along space lane or at witchpoint
:*31 - go to waypoint in system y, receive message from comms relay
:*32 - Meet ship in system X, give them info package
:*33 - intercept ship carrying stolen data cache, (use Broadcast comms to demand data pack), which must then be scooped
:34 - track ship from witchpoint to station, then return
:::- if player gets with 25 km of target and appears to be following them (eg heading is roughly the same and the player is behind them) they will detect player and flee (mission failed)
:::- player can get closer if they are cloaked
:::this needs to be more interesting that just following them to the station.
:36 - Find ship in system X by sending a pass phrase to any/all ships - one of which will reply with a message with details of where to find special cargo to be returned to system Y
:37 - Find ship in system X by sending a pass phrase to any/all ships - one of which will reply with a message with details of where to find data point to be returned to system Y

''Delivery-type missions''
:*40 - Special delivery - player given unique cargo (poss using Smugglers illegal goods) or equipment, must deliver to remote point in destination, paid in precious metals/gems given to the player at the drop point
:*41 - Special delivery - player given cargo or equipment, must go to system X to find a data point, to get location of drop point in system Y, paid in previous metals/gems given to the player at the drop point
:*42 - special delivery: transport special computer equipment to ship, without docking at a station (docking will render the mission void)
:*43 - transport vital equipment to stricken ship to enable it to continue flying
:::- have option of giving player secondary mission here
:*44 - transport vital equipment to stricken ship in interstellar space to enable it to continue flying and escape
:45 - Special delivery (only used for a secondary mission. similar to 40 but without giving cargo) - player told to get Xt of commodity, then deliver to a remote point in destination, paid is precious metals/gems
:46 - pickup cargo from waypoint, delivery to another waypoint
:::will need a cargo shepherd, cargo stopper for ejection damper
:::arrival at one or other of waypoints could result in an ambush
:47 - (only used for a secondary mission. similar to 41 but without giving cargo) - player told to get Xt of commodity, go to X to find data point to get location of drop point in Y, paid in precious metals/gems

''Medical missions''
:*50 - deliver critical medical supplies to systems with "disease" as part of their description
:::- each day do a check for
:::(a) is a disease outbreak starting on a system?
::::only have, at most 2-3 outbreaks at any one time
::::when starting the outbreak, send a news item to snoopers, and define the end point for the outbreak (2-3 months ahead), define propagation chance
::::if a player transports medical supplies, take a day off the end point, reduce the propagation chance
:::(b) is a disease outbreak stopping on a system?
::::send an item to snoopers
:::(c) is disease spreading to a neighbouring system
::::there is a chance disease will spread to a neighbouring system - add it to the outbreak list, with a news item and end point
::::- medical supply missions offered only from hi-tech worlds (TL 12 and above)
::::expiry time is based on the volatility of the antibiotics being carried.
:*51 - Transport critically ill patients from disease system to high tech level destination
:*52 - Transport virus specimens
:*53 - collect 3 components for an experimental antidote from different parts of the galaxy

''Software hacking: Witchpoint beacons/stations''
:*60 - Hacking witchpoints
:::System authorities in system X are concerned about the flow of pirate traffic through their system. They want to hack into the witchpoint beacons of all systems within a 7LY range, that will enable them to monitor traffic flows into their system, outside of GalCop's purview.
:::- will require getting within 200m of witchpoint marker, targeting the marker and initiating the special equipment (prime, activate)
:*61 - Restoring witchpoints
:::GalCop has become aware of an illegal data stream emanating from witchpoint markers around system X. You need to go to each of the systems listed, and clean the illegal code from the units.
:::- will require getting within 200m of witchpoint marker, targeting the marker and initiating the special equipment (prime, activate)
:::- will only be available once mission 60 has been performed at a system
:*62 - deliver security software payload to pirate rock hermit that track all ships coming and going from the station
:::- need to use cloaking device to dock with hermit. going red alert within 50k of station will result in mission failure.
:::>> TEST
:*63 - (from non galcop stations) deliver software payload to main station that will disrupt the trade computers (allowing all commodities to be purchased for 1 cr). (possible) for a period of 2 weeks
:::- when installing the software you will be asked what amount to set commodity prices to. You must enter the number specified in the mission description (either 1 or 99).
:::- you have to launch within 2 minutes of installing the software (and not redock again for 24 hours) otherwise GalCop will be able to trace the upload and you'll get hit with a massive fine (10000cr, 200 bounty)
:*64 - (from non galcop stations) deliver software payload to main station that will disrupt the equipment page, preventing any access for a period of 2 weeks.
:::- you have to launch within 2 minutes of installing the software (and not redock again for 24 hours) otherwise GalCop will be able to trace the upload and you'll get hit with a massive fine (10000cr, 200 bounty)
:*65 - get galcop system software
:::Player needs to do a multi-step process in order to get the software:
:::1. go to destination (a multi-gov of lower system with TL > 7) and pick up customised escape pod from any non-GalCop station (mission screen will inform player of installation)
:::2. return to system and use customised escape pod at more than 100000k from main station
:::3. after redocking, launch and wait for the next police ship to launch
:::4. follow police ship - it will self-destruct after 5-10 minutes, spewing an escape pod and a cargo item.
:::5. Scoop the cargo item and return it to the source station.
:66 - Perform scan of rock hermits, possibly while cloaked, return collected data
:::- need to create scanning equipment item
:::- harvest phase scanner code from Smugglers for general operating params
:67 - Perform scan of main station, possibly while cloaked, return collected data

''Solar activity system missions''
:*70 - Use scan equipment to take close up measurements of sun
:::get to fuel scoop dist = ((system.sun.collisionRadius * system.sun.collisionRadius) / system.sun.position.squaredDistanceTo(player.ship.position)) > 0.75;
:::prime scanning device, activate
:::await completion
:::If player retreats before scan is complete, scan will stop, but will restart automatically when in range again (ie it won't start from the beginning)
:*71 - Recover data cache in low orbit over sun
:::find data cache
:::transmit security code
:::await data package
:72 - Launch monitoring devices (special cargo or missiles)
:::must deploy 2 special cargo items from within fuel scoop range, one on the planet side, the other on the far side of the sun.
:*73 - Variation on 70: Go to another system to pick up new equipment, then bring it back and scan the sun
:*74 - Take solar data to hi-tech system for analysis
:75 - return analysed solar data to original system?
:76 - Recover derelict ship near the sun (derelict will be given a high heat shield rating to prevent destruction)
:::- Use DeepSpaceDredger for equipment/process of ship recovery?

''Charity missions''
:*80/81/82/83 - Give credits to entity
:*84/85/86/87 - purchase and give commodity to entity (slaves for AI, any for the others)
:88 - purchase any commodity (not slaves, firearms or narcs) and give to AI
:89 - donation to nationalist entity of system
:::- reward of better commodity prices?
:::maybe just better prices on illegals?
:::- reward of better equipment prices?
:::- reward of better ship prices?
:? - donation to religious entity

''War zone missions''
:*90 - evacuate refugees
:*91 - transfer injured
:92 - import weapons

''Earthquake system missions''
:*100 - Use scan equipment (seismic resonance scanner) to scan planet in 3-4 locations
:::player must get in low enough orbit to perform scan successfully
:::have some way of informing the player where the scan points are - waypoints, must be within 2km of waypoints
:*101 - transport injured people to hi-techlevel system for treatment
:*102 - destroy a number of asteroids around the planet. The gravitational effect of the asteroids means instability on the surface
:103 - collect and deliver special equipment
:*104 - take seismic data to hi-techlevel system for data analysis

''Satellite missions (when Satellites OXP is installed)''
:*110 - Extract data
:*111 - Install new firmware
:*112 - Destroy satellite
:*113 - Hack satellite
:*114 - insert data

''Investigations''
:*130 - a stash of cargo pods with precious metals/gems
:*131 - a ship graveyard
:*132 - a damaged escape pod
:*133 - a pirate base
:*134 - a thargoid trap
:*135 - a proximity mine that causes a fuel leak
:*136 - a spooky noise/comms
:*137 - a pirate trap
:*138 - an asteroid field with blackbox
:139 - (currently unused)
:*140 - destroy pirate base
:*141 - deliver goodbye messages

''Defence/escort missions''
:*150 - defend anaconda from pirates
:151 - defend liner from pirates (need liners OXP installed)
:*152 - defend main station from pirates
:153 - defend other galcop station from pirates (OXP required)
:*154 - defend main station from thargoids
:155 - defend other station from thargoids (OXP's required)
:*156 - defend witchpoint beacon from thargoids

:160 Scan planet from low orbit
:::requires to maintain a low orbit for a certain amount of time, with some possibility of attack

</div>

==Download==
Download [[Media:GalCopMissions_0.14.oxz|GalCopMissions_0.14.oxz]] (downloaded {{#downloads:GalCopMissions_0.14.oxz}} times). 
Download [https://app.box.com/s/wo2nfn3j1xkkjinfu3ytgn810r7gkr2v GalCopMissions.zip] v0.14 (extract OXP folder to AddOns)

==License==
This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 4.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/

Thanks to Svengali and Disembodied for their PhraseGen tool. 
Thanks to Ramirez for his remote mine model (from the "Missiles and Bombs" OXP). 
Thanks to these forum members who have submitted bug reports or suggestions that have helped make the OXP better: Nite Owl, herodotus, Astrobe, Damocles Edge, Cody, Bogatyr, pagroove, gsagostinho, Cmd. Northgate, Balisongdalo, javirodriguez, and lohcek.gsagostinho, Cmd. Northgate, Balisongdalo, javirodriguez, and lohcek. 
Special thanks to cim who has very kindly given permission to include his "Black Box" model from [[RRS_Group|Rescue Stations]] in this OXP. 

No entry sign image from http://simpleicon.com/no_entry_sign_1.html 
Warning sign image from http://simpleicon.com/warning-2.html 
Tick image from http://simpleicon.com/ok_1.html 
Pill image from http://simpleicon.com/pill_3.html 
Star badge from https://www.iconfinder.com/icons/1031361/award_badge_best_prize_reward_icon#size=512 (Free for commercial use) 
Round badge from https://www.iconfinder.com/icons/465072/achievement_award_label_medal_politic_win_winner_icon#size=512 (Free for commercial use) 
Star medal from https://www.iconfinder.com/icons/111092/medal_icon#size=512 (CC BY-SA 3.0) 
Star medal on ribbon from https://www.iconfinder.com/icons/316245/medal_icon#size=512 (Free for commercial use) 
Trophy image from http://simpleicon.com/trophy_1.html 
Cup image from http://simpleicon.com/cup.html 
Candle image from http://simpleicon.com/candle-2.html 
Family image from http://simpleicon.com/chat_10.html 
Education image from http://simpleicon.com/wp-content/uploads/knowledge.png 
Head image from https://www.shareicon.net/download/2016/04/17/751132_people_512x512.png 
Raining image from http://simpleicon.com/wp-content/uploads/lightning__raining_2.png 
Biohazard image from https://www.freepik.com/free-vector/biohazard-yellow-circle-sign-graphic-illustration_2631298.htm#fromView=search&page=1&position=0&uuid=040f7aab-af6b-4231-9d3d-7f20cc869cd0" Image by rawpixel.com on Freepik 
Tractor beam sound effect by Finnolia Productions Inc from http://www.soundeffectsplus.com (see licence here: https://www.soundeffectsplus.com/content/license/) 
Sound effect from https://freesound.org/people/jmorrisoncafe330/sounds/110097/ (license https://creativecommons.org/licenses/sampling+/1.0/) 
Sound effect from https://freesound.org/people/klankbeeld/sounds/169334/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/klankbeeld/sounds/239633/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/flint10/sounds/197547/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/Robinhood76/sounds/219853/ (license https://creativecommons.org/licenses/by-nc/3.0/) 
Sound effect from https://freesound.org/people/Robinhood76/sounds/333230/ (license https://creativecommons.org/licenses/by-nc/3.0/) 
Sound effect from https://freesound.org/people/staticpony1/sounds/249597/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/TheBillinator3000/sounds/333845/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/InSintesi/sounds/346295/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/lennyboy/sounds/275186/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/AlienXXX/sounds/168511/ (license https://creativecommons.org/licenses/by/3.0/)

==Discussion==
This OXP is discussed at this forum link: https://bb.oolite.space/viewtopic.php?f=4&t=18745

==Version History==
0.14
* Market prices on disease outbreak systems now boosted, and quantities reduced. If you can get there, it's probably worth it.
* Added a hint for the player if they attempt to jump into a quarantined system and are blocked by GalCop.
* Suppressed Rescue Stations ambience for disease systems, to prevent confusion over lockdowns.

0.13
* Added ability to call functions when testing conditions.

0.12
* Added Galactic Navy as a reputation entity, and added it to some missions.

0.11
* Fixed issue with "Recover stolen items" mission, when recovering the stolen documents, where the mission could not be completed.
* Darkened overlay images for better compatibility with Oolite 1.92.

0.10
* Fixed more issues with the Satellite missions.

0.9
* Really corrected issue preventing some satellite missions from being completable if the Galactic Almanac OXP is installed.
* Sound now plays when a fuel leak occurs.
* Tweaks to the reputation system to allow for complete localisation through descriptions.plist.
* Made some reputations visible on the reputations screen, even if the actual reputation value is zero.
* Fixed issue where some missions with a minimum player score were being offered to players under that value.
* Moved as much text as possible into descriptions.plist for slightly easier localisation.
* Added prebuilt descriptions for each mission that uses PhraseGen, so PhraseGen can be avoided when translating text. See notes in descriptions.plist or galcopbb_missiondetails.js for details.
* Bug fixes.

0.8.2
* Fixed referencing errors in spawning scripts for "Recover special cargo" (type 24) and "Black Box recovery" (type 22) missions.
* Fixed issue with mission state not being correctly recorded when the derelict is destroyed in black box recovery missions (types 22/23).
* Fixed issue with invalid functions calls for meet ship missions (type 30).
* Fixed issue with the meet ship mission, delivered by email (type 30), that wouldn't generate a second mission when you meet the target.
* Added clarity to "Computer Delivery" mission (type 42), so when the target ship is destroyed, the mission is failed.
* Removed "Computer Delivery" from being a follow-up mission.
* Fixed reference error bugs with investigation missions (types 130-138).
* Fixed issue with email missions causing a JS exception.
* Fixed invalid descriptions lookup key.
* Grammar corrections.

0.8.1
* Fixed referencing error in data cache missions (type 41) that was preventing the mission from being completable.

0.8
* Added a 10% penalty to cargo recovery missions (type 6) for each cargo pod the player destroys.
* Destroying a cargo pod in a "Cargo Recovery" mission will now trigger a mission status update.
* Fixed multiple issues with the descriptive text for "Cargo Recovery" missions (type 6).
* For type 6/7 missions, changed reward calculation to be based on the value of the commodity being collected.
* Excluded escape pods from being considered in the "Pirates for Hire" mission (type 8) when slaves are being sought.
* Adjusted spawning rules for ship with stolen items (type 33), to ensure they always spawn in scanner range of the player.
* Fixed bug in special delivery mission (type 40) that was preventing key information from being updated.
* Tweaked special delivery mission (type 40) so mission complete percentage doesn't go above 100%.
* Added missing position to a "Computer delivery" mission (type 42) description.
* Bug fixes in disease outbreak script (types 50-52).
* Fixed issue with disease outbreak systems, where system traffic wasn't being reduced, and GalCop station docking wasn't being prevented, in the case where the player doesn't have a valid permit.
* Added a screen displayed when docking at a station to inform player of disease lockdown systems with 7LY.
* Fixed grammar in descriptive text for "Hacking the witchpoint" mission (type 60).
* Fixed issues with mission details and grammar for station disrupt missions (type 63).
* Fixed issues preventing the disrupt station missions (type 63/64) from being completable.
* Reduced eject distance for the "Acquire GalCop Software" mission (type 65).
* Fixed issues preventing the "Acquire GalCop Software" mission (type 65) from being completable.
* Beacon labels are now turned off after collecting data from Solar Monitors (type 71).
* Updated manifest and BB status entries for donation missions (types 80-87) so that after a partial donation the status shows how much is remaining to donate.
* Removed waypoints from terminated or failed Seismic Scan missions (type 100).
* Fixed issue with manifest entry for "Asteroids in low orbit" mission (type 102), where it did not show progress towards completion.
* Fixed issue with completing the "Deliver Seismic Scan Data" mission (type 104), where the equipment item wasn't being removed.
* Destroying a satellite will now update the mission objectives (types 110-124).
* Corrected issue preventing some satellite missions from being completable if the Galactic Almanac OXP is installed.
* Fixed bug when spawning satellite defenders that was preventing the AI from being switched.
* Tweaked how far you have to go past the reference point before the unidentified signal is started in an Investigation mission (type 130-138).
* Tweaked descriptions for investigation missions to include a "reference point" past which a fair distance must be travelled in order to find the signal.
* Tweaked the location of unidentified signals in Investigation missions (type 130-138).
* Fixed spelling in "Defend station from attack" mission (type 152) description.
* Added some lurking pirates outside pirate bases.
* Added some extra details to manifest entry for missions that send to you a specific location in a system.
* Ejection damper now includes "uses left" in a console message when turned on and again when used.
* Switched a few mission types to stop the clock when complete.
* Switched a lot of mission types to be completable at any main station.
* Fixed issue that was preventing the Range Finder equipment from detecting mission-based escape pods.
* Fixed issue that was preventing the Range Finder equipment from detecting derelict ships.
* Added a simplified directional indicator to the Range Finder for when scanned items are less then 50km distant.
* Fixed issue where cargo collected for missions wasn't being handed over correctly and removed from the player's hold.
* Fixed issue where scooping more cargo than the mission requirement would cause some display and calculation irregularities.
* Fixed issue where the F5F5 manifest page wasn't getting updated correctly for missions that have multiple items to collect if items had been destroyed.
* Fixed various other grammar issues in mission text.
* Fixed grammar in readme.txt.
* Set global debug flag to false.
* Code refactoring.

<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
0.7.0
* Fixed bug in "Extract telescope data" mission, where the wrong satellite types were being used in the calculations.

0.6.9
* Fixed issue where scooped Thargoid metal fragments were not being counted towards mission objective (type 13).
* Code refactoring.

0.6.8
* Fixed referencing errors with hit team docking notifications.
* Fixed JS error when in interstellar space while a slave rescue mission is active.
* Fixed JS error for disease outbreak systems.
* Fixed description for blackbox secondary mission that wasn't putting location into the details.
* Will now try up to 10 times to create a secondary mission after meeting a ship.
* When no secondary mission can be created after meeting a ship, a message providing some explanation is now given.
* Improved process for detecting and flagging alloys as having come from Thargoid vessels (type 13).
* Hit teams bug fixes.
* Bug fixes.

0.6.7
* Added mission type 18 to available missions.
* Fixed spelling error in function names for Collect ingredients mission (type 53).
* Fixed issue with possibly changing the status of the "defend the anaconda" mission (type 150) after completing it successfully.

0.6.6
* Turned off debug flag on investigation missions.

0.6.5
* Completing some missions will now reduce the players bounty.

0.6.4
* Fixed issue with the Reputations screen not showing some items.

0.6.3
* Removed customised PhraseGen code, made GNN a requirement for the OXP.

0.6.2
* Fixed a bug with donation missions and integration with Market Observer.

0.6.1
* Fixed error when repairing the Range Finder.
* Tweak to cargo stopper process for mild performance improvements when selecting targets.
* Fixes to the descriptions for slave repatriation missions (type 84).
* Fixes to the description for the Destroy Satellites mission (type 122).
* Donating cargo or slaves to charities will now update Market Observer (if installed).
* Adjusted time limit for satellite download missions.
* Tweaked manifest descriptions on satellite missions to better communicate distinct requirements for missions.
* Range Finder now compatible with GalTech Escape Pods.

0.6.0
* Cargo stopper is now activated automatically when cargo is targeted, in front of the player ship and in range, negating the need for priming and activating the equipment.
* Fixed stealing cargo missions, where it was possible to hand in cargo at stations other than the originating station.
* Improved mission status messages for stealing cargo missions to show how much has been collected.
* Bug fixes.

0.5.9
* Fixed some instances of timers being recycled while running.

0.5.8
* Fixed issue with delivery missions, where comms relay was not being spawned due to a Javascript error.

0.5.7
* Fixed some issues with retrieving data from stored settings used when the system populator runs.
* Cleaned up the process of setting ship scripts in all script files to prevent scripts not being present when required.

0.5.6
* Bug fix in spawning routine for derelict ships for black box missions (type 22).
* Fix to (hopefully) prevent scenario where mission ships were not being spawned.

0.5.5
* Small text adjustments for game consistency.
* Fix JS error in satellite missions.

0.5.4
* Improved logic for adding ships to a system.
* Fixed invalid reference error when generating missions.
* Better use of new functions available in later versions of Oolite.
* Corrected use of samplePrice method.

0.5.3
* The number of asteroids required to complete the Asteroid Removal missions (type 1) is now restricted to be less than the number of asteroids currently in the system.
* Fixed bug in the Hit Teams script where the definition of the "$initiateInvestigation" routine was inaccurately declared.

0.5.2
* Fixed invalid variable reference error.

0.5.1
* An email will now be sent to the player when they accept their first mission to Interstellar space, offering tips on how to enter interstellar space, and what to expect when they get there.

0.5.0
* Added some civil warzone missions (types 90, 91).
* Added defence missions (types 150, 152, 154, 156).
* Added a new delivery mission (type 46), which involves collecting cargo from a waypoint, and dropping it at another waypoint.
* Added a new investigation mission (136). Be afraid...
* Added secondary mission (type 74) to solar activity missions (70, 71, 73).
* Fixed error in description for solar activity mission (74).
* Fixed issue preventing the "gather ingredients" mission (53) from being created.
* Fixed issue with the "Remove Ejection Damper" equipment item, which wasn't removing the ejection damper equipment.
* Fixed issue with cargo recovery missions (6, 7), where ejecting and re-scooping cargo pods would throw the mission status out of kilter.
* Fixed manifest entry for the upload surveillance data mission (118) which was showing the wrong destination.
* Fixed some missions that were not including a player-rated bonus in their payment amounts.
* Defend satellite missions (124) were not being created for players with more than 64 kills.
* Upgrade satellite firmware missions (115) now have proper pass codes to transmit to the satellites.
* Tweaked the payment amount, and completion time requirement for satellite firmware update missions (115).
* Completing the delivery of personal messages for a dead pilot (141, secondary mission after investigation mission 132) now done manually.
* Limited some Thargoid missions to only be available in frontier systems.
* Updated description of Range Finder MFD equipment on F3 screen to include mention of cargo pods mode.
* Tweaks to the custom assassin AI routines to eliminate null target conditions.
* Various adjustments to the manifest entry for many missions.
* Spelling corrections.
* Bug fixes and code refactoring.
* Added a method to main script to allow for any mission to be easily tested during runtime ($testMissionType).

0.4.0
* Added "Cargo pod" mode to Range Finder.
* Fixed error with Range Finder when scanning for Black Boxes. If non-ship entities were in range (eg planet, sun), a Javascript error would occur.
* Changing the Range Finder mode will now clear the MFD of previous scan results.

0.3.7
* Fixed bug with missing variable declaration in failed mission function call.

0.3.6
* Removed debug flag that would cause a particular mission to always be generated.

0.3.5
* Fixed issue with secondary mission after investigation mission (132) not having correct destination on manifest.
* Code refactoring.

0.3.4
* Fixed title in manifest.plist file.
* Fixed missing reference error when completing data cache missions.
* Fixed missing reference error when completing black box missions.
* Fixed missing reference error when completing meet ship missions.
* Fixed missing reference error when completing hacking/restoring witchpoint beacon missions.
* Fixed missing reference error when completing some solar activity missions.
* Fixed missing reference error when completing some disease outbreak missions.

0.3.3
* Added some fallback code in case cargo pods are not spawned with our preferred barrel type.

0.3.2
* Fixed incorrect worldScript name references in Pirate Bases script.
* Added extra qualification to mission destination texts that refer to main planet, to help distinguish the main planet from any additional planets.
* Tweaked one investigation mission to limit its availability to more experienced players with an upgraded ship.
* Fixed issue with the Thargoid wreckage mission (13) which wasn't recognising wreckage collected in interstellar space.
* Removed debug log messages.

0.3.1
* Fixed spawning issues for investigation missions (types 130-139).
* Tweaked the power of the proximity mine.

0.3.0
* Added investigation missions (types 130-139).
* Switched from using a dummy alloy ship entity as a navigational beacon to using a visual effect.
* Code refactoring, improving code reuse.
* Split more mission specific functions out of general script file to associated script file.
* Fixed issue with some missions having a decimal amount as part of the payment.
* Performance improvements when generating new missions for a system.
* Fixed status message with drug dealer mission (15).
* Bug fixes.

0.2.4
* Linked the MFD to Broadcast Comms MFD in the Auto-Prime Equipment OXP.
* Makes use of GNN OXP if installed.
* Improved handling of player ship death scenarios.
* Fixed linkage to [[Home System]].

0.2.3
* Added the Ejection Damper equipment.
* Reduced the effective range of the Cargo Stopper to approximately 2km to make it slightly less OP.
* Added a sound effect for the tractor beam when activated.

0.2.2
* Tweaks to the positioning of ships for "Special Delivery" missions (40/41).
* Fixed issue with "Special Delivery" mission (40), where the target ship was not responding to the "I don't have any more" comms message.
* Tweaks to the scavenger AI, so the target ship doesn't jump out of the system prematurely.
* Added Advanced Space Compass as a requirement for "Special Delivery" missions (40).
* Removed some debug messages.

0.2.1
* Fixed issue with escape pod rescue missions (21, 22, 25) not being completable.
* Moved more interstellar populator routines into the correct methods.
* Removed some hard-coded scanner range values.
* Spelling corrections.

0.2.0
* Fixed issues with the "Collect cargo" (6/7) missions, where scooped cargo was being counted as destroyed instead of collected.
* Fixed issue with "Special Delivery" (40) missions where, if cargo was dumped and then re-scooped because it was drifting out of range, when the cargo was re-dumped the target ship was ignoring it.
* Fixed issues with missions that have multiple stages (types 41, 63, 64, 65, and 73) that weren't being initialised correctly and so would never start.
* Fixed issues with escape pod rescue missions (20) and runaway escape pod missions (25) that was preventing the escape pods from being spawned.
* Added a new device, a Comms Relay Beacon Switch, that is issued to the player for any "Collect data cache" (31) or "Special delivery" (41) mission. This device will turn on the comms relay beacon again after the initial transmission period has expired, although using it will incur a 5% payment reduction.
* Added a new device, the "Cargo Stopper", primable equipment available from TL6 systems, which, when pointed at moving cargo and then activated, will bring the cargo to a stop.
* Fixed issue where I.T.H.A. reputation was not being removed from the F5 page correctly when reputations were set to be moved to the "Reputations and Awards" page.
* Forced bonus payment calculations to return an integer, rather than a decimal.
* Some mission text tweaks.

0.1.5
* Adjustments to the population routines for interstellar space.
* Fixed bug where reputation was not being applied correctly for missions where multiple reputation entities were defined.
* Fixed bug with distance calculation in the Disease Outbreak script.
* Adjusted time calculation for travel between threatened satellites during a satellite defend mission.
* Added reputation links to [[Home System]] OXP.
* Better handling of Combat Simulator.

0.1.4
* Adjusted calculation of the number of deaths from a disease outbreak.
* Fixes to secondary missions sourced from black boxes or escape pods or passing ships having a termination penalty.

0.1.3
* Reworked all the cargo collection mission types (8,9,10,11,13,14,15) so that mission updates happen when cargo is handed in, not when it is scooped (although a notification will still be given to the player that the cargo was suitable for the mission). Expiry time has also been removed, and maximum quantity can now be greater than the player's available cargo hold.
* Fixed issues with Thargoid wreckage collection missions, so alloys can now be successfully handed in, and (hopefully) alloys from any Thargoid warship (including OXP Thargoids) should now be acceptable.
* Applied some fixes for the "Stranded ship" mission to stop the ship from moving before receiving help.
* Code refactoring.
* Bug fixes.

0.1.2
* Tweaked the energy drain of the Range Finder.
* Added sound for when the Range Finder scan is stopped.
* Removed debug flag from "Thargoid wreckage" missions, so they shouldn't appear as frequently.
* Fixed cargo dontation charity missions that were only being made available if the local market had slaves.
* Code refactoring and (hopefully) performance improvements.

0.1.1
* Fixed bug with Thargoid wreckage mission that was preventing the wreckage from being recognised.
* Made the "Collect Thargoid wreckage" mission have no expiry, and provided a means by which you can hand over incomplete amounts and continue.
* Removed debug flag from "Interstellar escape pod rescue" missions, so they shouldn't appear as frequently.

0.1.0
* Added some missions using Satellites OXP (types 110, 111, 113, 115, 122, 124).
* Fixed issue where emailed missions, or missions delivered via another ship, were not checking all the conditions, giving the player a mission they couldn't complete.
* Fixed issue with "Request for meeting" missions, where the target would not respond when the passcode was transmitted.
* Added additional text to mission briefing for missions that require an interstellar space destination to make it clearer this is required.
* Added additional text to mission briefing to make it clearer when a mission requires the player to return to the source system in order to complete it.
* Applied distance and player score bonuses to Special delivery missions (type 40).
* Fixed issue with the WBSA device not being startable when the beacon is targeted.
* Fixed issue with the Range Finder not creating an energy drain.
* Mission text tweaks.

0.0.9
* Added "Gather ingredients" mission (type 53).
* Fixed issue where missions with a deposit could have a negative net payment if the player's reputation is low.
* Fixed issue with manifest entries not reflecting the state of progress correctly.
* Reworked how textures are specified in mission definitions.
* Added overlay images to charity missions.
* Added routines to control the creation of asteroid fields, so they will be created in the same place in each system, and reused for future missions.
* Fixed issues with mission descriptions missing some text elements.
* Fixed issue with cargo recovery mission text containing ">undefined".
* Fixed issue with RRS reputations causing a JavaScript error when opening the "Reputation and Awards" F4 screen.
* Headings on the reputations page will now be suppressed if there are no related items to display.
* Converted text for mission types 74, 100, 101 and 102 to use the PhraseGen tool.
* Some tweaks/fixes to mission text.
* Code refactoring.

0.0.8
* Better logic for determining what is a witchpoint buoy.
* Better client name generation using PhraseGen tool.
* Fixed minor text issue with the "decline mission" for escape pod messages.
* No mission accept/complete confirmation emails will be sent for secondary missions when the source of the mission is an NPC from an escape pod or a ship.
* If player ejects escape pod while in pod occupant is communicating, conversation will stop and mission offering will be correctly terminated.
* Fixed error when scooping escape pod with no "crew" set (ie equivalent to scooping 1t slaves)
* Improved robustness of "Rescue Stricken Ship" missions.
* Fixed issue where stricken ships were not communicating with player correctly.
* Fixed error when firing on the stricken ship after it was repaired.

0.0.7
* Better logic for determining if a pirate ship has just been destroyed.
* Added a "+/-" indicator on the Range Finder MFD, to make it clearer in which direction the player is moving in relation to the target.

0.0.6
* Prevented Cargo Shepherd magnets from being targeted by delivery ships.
* Corrected issues with intergrating to the Smugglers Black Market script.

0.0.5
* Fixed mess left after code refactoring. :(

0.0.4
* Fixed issue with escape pod missions not being complete-able.
* Turned off lights on derelict ships.
* Code refactoring to reduce the chance of scripts for various mission types conflicting with another.
* More robust logic for connecting with Smugglers Black Market.
* Bug fixes.

0.0.3
* Made compatible with Oolite v1.84.

0.0.2
* Initial public release.
</div>

== Quick Facts ==
{{OXPLevel|1|4}}{{IconOXP|ooVersion="1.84"|oxpCPU="Average"|oxpMEM="Average"|oxpGPU="Low"|oxpIsConfigurable=true}}
{|class="floatright" style="alignment:right;margin: 0 auto;"
|[[Image:IconLib.png|48px|right|link=Library OXP|alt=Config options available through 'Library']]
|[[Image:IconBB.png|48px|right|link=Bulletin Board System|alt=Missions offered through the 'Bulletin Board System']]
|[[Image:IconGNN.png|48px|right|link=GNN|alt=News items displayed through GNN]]
|}
{{Infobox OXPb| title = GalCopMissions.oxz
|version = 0.14
|release = 2026-04-20
|license = CC BY-NC-SA 4.0
|features = Missions
|category = Missions OXPs
|author = [[User:phkb|phkb]]
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=18745 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-green.png]]

GalCop Missions

2026-07-28T11:19:07Z

Cholmondely: /* What else is in the box? */ Added concealed "spoiler" list of all missions

[[image:gcm_mission_example.png|right|500px|Sample mission]]

==Overview==
This OXP adds some local missions to the [[Bulletin Board System]], to hopefully add more things to do in and around each system. Very little by way of new ships, stations, equipment or AI's has been added to the game. The idea was to simply make use of the existing assets in new and (hopefully) interesting ways.

There are a number of different missions available, and the availability of these missions depends on a number of factors (score, system tech level, government type, installed equipment etc). Missions can be offered in a number of ways: via the Bulletin Board, from scooped escape pods, from passing ships, or from emails.

This OXP also includes the concept of "mission chains", in that completing one mission may trigger a second mission, which could then trigger a third mission, and so on. Sometimes the player is given an option as to whether they want to perform the secondary mission, and sometimes they won't be.

Generally, all the missions are optional. If you don't visit the Bulletin board, you won't see what's on offer, and very little in the game will change if you don't do the missions (although see the two sections below: Gameplay Impacts and Disease Outbreaks). You may occasionally be offered a mission when scooping escape capsules, and sometimes passing ships will pass on requests.

===Gameplay impacts===
Some of the missions in this pack can impact on other areas of the game. For instance, one type of mission, if completed successfully, will result in a higher frequency of mis-jumps to a particular system. Some missions can effect the commodities of a station, or the availability of equipment at a station. It will hopefully be obvious when these changes take place (ie as a result of completing a mission).

===Disease Outbreaks===
Another potential impact is on systems that are reported to have disease outbreaks. If a major outbreak occurs, GalCop might choose to lock down the system, preventing the disease from spreading off-world. When this happens, you might find you can’t jump to a particular system without a permit. Some pilots have reported there are ways around GalCop’s restrictions, but even if you do, you might find that GalCop stations in that system will physically prevent you from docking, and inattentive pilots might find their ship taking damage rather than entering the docking slot.

When a disease outbreak restriction is in effect, there might be missions you can undertake that will grant you the required permissions and passcodes to successfully enter the system and dock at the main station. These missions will likely be in systems close to where the outbreak is occurring.

==Mission Categories==
This mission pack contains over 80 different missions and variations, but most of the missions fall into one of these general categories.
* '''Hunter''' - Hunt down and destroy certain ships (asteroids, pirates, traders, Thargoids, police, etc).
* '''Recovery''' - Find and collect certain items (cargo, derelicts, black boxes, data packets, etc).
* '''Rescue''' - Locate and collect escape pods, deliver critical equipment to stricken ships, deliver medical supplies.
* '''Delivery''' - Take cargo between one point and another, but outside the normal cargo mission system.
* '''Covert''' - Install spying software, disrupt station economies, hack witchpoint beacons.
* '''Donation''' - Donate money or cargo to charities to gain economic or legal advantages.

==Required Equipment==
[[Fuel_Scoops|Fuel/Cargo scoops]] and the [[Advanced_Space_Compass|Advanced Space Compass]] are required for many of the missions. If your ship lacks these items, certain missions will be unavailable.

[[BroadcastComms_MFD|Broadcast Comms MFD]] is a requirement for many of the missions, as it provides an interface for ship-to-ship communications. If you have not purchased this item, some of the missions will be unavailable.

==New Equipment==
Some new equipment has been added with this OXP.
[[File:Range Finder (1).png|right|320px]]
[[File:Range Finder (2).png|right|320px]]
===Range Finder MFD===
When this item is purchased, installed and primed, you can press the "b" key (Mode) to switch the mode between escape capsules, black boxes, asteroids, ships, communication relays and cargo pods. Pressing the "n" (Activate) key will initiate a scan of the local area, up to a distance of 200km. The scan will take approximately 2 seconds to run, but will be run continuously until deactivated with the "n" key again. Any objects of the selected type within range will be displayed, along with the distance to the object. A "+" or "-" indicator will be displayed next to each item, showing whether you are moving away from (+), or towards (-), the target. When the target is less than 50km away, a simplified directional indicator will be shown instead, but outside this distance, the range finder does not provide directional information. The information returned by the scan is displayed in an MFD, so you will need to select an MFD slot (using the ":" key) and then select the Range Finder MFD (using the ";" key).

Direction indicators when distance < 50km:
O - Target is generally ahead of you
o - Target is ahead of you.
X - Target is directly ahead of you.
< - Target is to the left
> - Target is to the right
^ - Target is above you
v - Target is below you
A - Target is behind you (ie Aft)

Range Finder MFD
Techlevel: 5
Price: 250 cr

Note: When the Range Finder is activated, there will be a drain on your ships energy. If the [[Ship Configuration OXP|Ship Configuration OXP]] is installed, engaging the Range Finder will also generate cabin heat.

===Range Finder Extender===
An additional device, a Range Finder Extender, which increases the range of the scanner to 500km, as well as boosting the range for the simplified directional indicator to 75km.

Range Finder Extender
Techlevel: 9
Price: 2650 cr

===Comms Relay Beacon Switch===
This device will be issued to the player when attempting particular missions, although it can also be purchased independently from TL3 systems for 60cr. It is a primable piece of equipment that will communicate with any communication relays in the system and request the beacon to be switched on for a short period of time. The device can be used 3 times before needing to be recharged. Using the device will incur a 5% penalty on whatever mission the communication relay relates to.

Comms Relay Beacon Switch
Techlevel: 3
Price: 60 cr

===Comms Relay Beacon Switch Recharge===
This item will replace all the degraded parts of the switch, allowing it to be used 3 more times. The cost will vary, based on how degraded the current parts are. It is available in all systems.

===Cargo Stopper===
This device makes use of the [[Tractor Beam|tractor beam]] which forms part of the cargo scoops. When your ship is aimed at cargo cannisters that are floating away, it will automatically use the tractor beam to bring the cargo to a stop. Cargo must be within 2km of your ship, and in the centre area of your front viewscreen, otherwise the tractor beam can't reach it.

Cargo Stopper
Techlevel: 6
Price: 30 cr

===Ejection Damper===
This device attaches to the end of the cargo scoop, and when engaged, will apply some force to any ejected item so that it will slow to a stop within a short period of time, rather than floating away at a constant rate.

Once purchased, the unit must be turned on before any cargo will be impacted. Prime the "Ejection Damper" equipment, and press either the "Mode" (b) or "Activate" (n) key to turn the unit on. Pressing those keys a second time will turn the unit off. The unit is automatically turned off whenever your ship docks.

When the unit is on, all cargo ejected will be slowed to a stop. The device can be used on 50 ejected items before it needs to be replaced.

Ejection Damper
Techlevel: 7
Price: 100cr

==Required OXP's==
The following OXP's are listed as required:
* [[Bulletin Board System]] - Required as all missions are accessed through this interface.
* [[BroadcastComms_MFD|BroadcastComms MFD]] - Required for missions that need ship-to-ship communications to take place. Also used for accepting or declining secondary missions.
* [[Email_System_OXP|Email System]] - Provides another interface for missions to be offered.
* [[GNN]] - Provides text randomisation system used for mission descriptions. Plus, some news items will be published periodically, which can add some flavour to game events.

==Recommended OXP's==
The following OXP's are listed as recommended, in that additional text and/or gameplay options will become available if they are installed.
* [https://bb.oolite.space/viewtopic.php?f=4&t=17846 Manifest Scanner] - Can aid with finding cargo in other ships, which can be very important if you are on a mission to steal certain cargo.
* [[Cargo_Scanner_OXP|Cargo Scanner]] - Can help with some missions to identify the contents of cargo containers.
* [[Black Market]] - Some additional opportunities are available through the Black Market interface in this OXP.
* [[Satellites]] - Some missions are available related to the various satellites created by this OXP.

[[File:F4 Reputation.png|thumb|right|300px|After blasting some local pirates on a number of visits (no missions involved), this Jameson became a "Casual Acquaintance" of Ararus]]
==What else is in the box?==
'''Reputations:''' The missions available to the player originate from a number of different entities - governments, corporations, factions of every stripe. As missions are performed for these entities your reputation will increase. However, given the number of entities involved, a new F4 interface screen has been created that combines all reputation information into an easy to read display. Also, any awards received can be displayed as well.

If you have the [[Library OXP]] installed, you additionally have the option of importing a variety of internal and OXP reputations into the screen, rather than having those reputations displayed on the F5F5 Manifest screen.

<div class="mw-collapsible mw-collapsed" data-expandtext="Spoiler: show mission list" data-collapsetext="Hide list" style="overflow:auto;">
This is Phkb's working list, taken from his GalCopBB_Missions.js (April 2026 version) with inclusions from the other scripts.

There seem to be 81 fully functional missions (presumably those with the blue blobs!), with much code already written for the others (I have assumed that the satellite missions are all fully functional). (''Cholmondeley 12:19, 28 July 2026 (BST)'')

''Mission types''
:*1 - "Cleanup the spaceways": destroy x number of asteroids in the current system
:::any system, max of 1 mission of this type
:*2 - "Making the system safer": destroy x number of pirates in system y.
:::any safe system within 7 LY of a feudal or anarchy
:::record when mission is accepted and only offer another one to the same system after 10 days
:*3 - "Disrupting trade (System authority)": destroy x number of traders in system y.
:::any multi-gov or worse, near a safe system
:::record when mission is accepted and only offer another one to the same system after 10 days
:*4 - "Disrupting trade (Pirate authority)": destroy x number of traders in system y.
:::record when mission is accepted and only offer another one to the same system after 10 days
:*5 - "Thargoid hunt" - intentionally misjump between system X and Y and destroy N number of thargoid motherships (not tharglets)
:*6 - "Collect the deposit" (System authority): find dumped cargo in system X, deliver to system Y.
:::- cargo will be guarded by x number of high quality ships
:*7 - "Collect the deposit" (Pirate authority)
:*8 - "Pirates for hire (System authority)": attack trader ships in system X to get their cargo (n tons required),
:::return to system Y
:*9 - "Pirates for hire (Pirate authority)": attack trader ships in system X to get their cargo (n tons required), return to system Y
:*10 - "Pirate specific commodity (System authority)": find an amount of a particular commodity but only when in a particular system and only from piracy (not purchased from stations)
:*11 - "Pirate specific commodity (Pirate authority)": find an amount of a particular commodity but only when in a particular system and only from piracy (not purchased from stations)
:*12 - "Free slaves": (if IGT is installed) target all ships entering Communist or higher system, and if carrying slaves, demand cargo.
:::(Recommend the "Manifest Scanner" be installed)
:::Use BroadcastCommsMFD to "Demand slaves"
:::Ship will then have the ability to respond: either "OK" (and slaves are dumped), or "I'm not carrying slaves", or "Get lost"
:*13 - "Collect Thargoid wreckage" destroy thargoids and collect wreckage in interstellar space
:::add scenario where alloys are destroyed during flight
:::>> prevent thargoid alloys from being relabelled by Smugglers
:::>> prevent thargoid alloys from being put into storage by SC
:*14 - Gun runner: attack ships in target looking for firearms
:*15 - Drug dealer: attack ships in target looking for narcotics
:*16 - Civil unrest (pirate authority): destroy as many police ships in current system as you can
:*17 - Garbage scow: dump radioactive waste containers near sun so they are destroyed by heat
:*18 - Rival gang war (ie pirate hunt) (pirate authority)

''Escape Pods, Black Boxes & Derelicts''
:*20 - Find escape pod in particular system and rescue occupant
:::- when in range, send out a distress signal to the player
:*21 - interstellar escape pod rescue
:*22 - Find black box in particular system and collect it
:::- make this different from Rescue Stations by making the black box be inside the hulk of a destroyed ship
:::- need some way of locating ship hulk - maybe an intermittent comms signal?
::::- have console message appear saying "Weak navigation beacon signal ("U") being picked up."
::::- player switches ASC to find "U", gets a heading, then signal disappears. The further away the player is, the more inaccurate the ASC heading is.
::::- repeat until the player finds the hulk (ie is comes within scanner range)
::::- give player the option of selling black box on the black market
:*23 - interstellar black box recovery
:*24 - Destroy derelict ship, scoop data cache (special cargo pod) and return it to station
:*25 - catch runaway escape pod - escape pod ended up with a massive ejection speed and is on it's way to interstellar space.
:::a regular waypoint will be set showing the pods last position

''Ship-to-ship''
:*30 - Find and meet a particular ship in a particular system, will lead to secondary mission
:::- via BB as a mission
:::- via email when created as a primary mission
:::- via a random trader along space lane or at witchpoint
:*31 - go to waypoint in system y, receive message from comms relay
:*32 - Meet ship in system X, give them info package
:*33 - intercept ship carrying stolen data cache, (use Broadcast comms to demand data pack), which must then be scooped
:34 - track ship from witchpoint to station, then return
:::- if player gets with 25 km of target and appears to be following them (eg heading is roughly the same and the player is behind them) they will detect player and flee (mission failed)
:::- player can get closer if they are cloaked
:::this needs to be more interesting that just following them to the station.
:36 - Find ship in system X by sending a pass phrase to any/all ships - one of which will reply with a message with details of where to find special cargo to be returned to system Y
:37 - Find ship in system X by sending a pass phrase to any/all ships - one of which will reply with a message with details of where to find data point to be returned to system Y

''Delivery-type missions''
:*40 - Special delivery - player given unique cargo (poss using Smugglers illegal goods) or equipment, must deliver to remote point in destination, paid in precious metals/gems given to the player at the drop point
:*41 - Special delivery - player given cargo or equipment, must go to system X to find a data point, to get location of drop point in system Y, paid in previous metals/gems given to the player at the drop point
:*42 - special delivery: transport special computer equipment to ship, without docking at a station (docking will render the mission void)
:*43 - transport vital equipment to stricken ship to enable it to continue flying
:::- have option of giving player secondary mission here
:*44 - transport vital equipment to stricken ship in interstellar space to enable it to continue flying and escape
:45 - Special delivery (only used for a secondary mission. similar to 40 but without giving cargo) - player told to get Xt of commodity, then deliver to a remote point in destination, paid is precious metals/gems
:46 - pickup cargo from waypoint, delivery to another waypoint
:::will need a cargo shepherd, cargo stopper for ejection damper
:::arrival at one or other of waypoints could result in an ambush
:47 - (only used for a secondary mission. similar to 41 but without giving cargo) - player told to get Xt of commodity, go to X to find data point to get location of drop point in Y, paid in precious metals/gems

''Medical missions''
:*50 - deliver critical medical supplies to systems with "disease" as part of their description
:::- each day do a check for
:::(a) is a disease outbreak starting on a system?
::::only have, at most 2-3 outbreaks at any one time
::::when starting the outbreak, send a news item to snoopers, and define the end point for the outbreak (2-3 months ahead), define propagation chance
::::if a player transports medical supplies, take a day off the end point, reduce the propagation chance
:::(b) is a disease outbreak stopping on a system?
::::send an item to snoopers
:::(c) is disease spreading to a neighbouring system
::::there is a chance disease will spread to a neighbouring system - add it to the outbreak list, with a news item and end point
::::- medical supply missions offered only from hi-tech worlds (TL 12 and above)
::::expiry time is based on the volatility of the antibiotics being carried.
:*51 - Transport critically ill patients from disease system to high tech level destination
:*52 - Transport virus specimens
:*53 - collect 3 components for an experimental antidote from different parts of the galaxy

''Software hacking: Witchpoint beacons/stations''
:*60 - Hacking witchpoints
:::System authorities in system X are concerned about the flow of pirate traffic through their system. They want to hack into the witchpoint beacons of all systems within a 7LY range, that will enable them to monitor traffic flows into their system, outside of GalCop's purview.
:::- will require getting within 200m of witchpoint marker, targeting the marker and initiating the special equipment (prime, activate)
:*61 - Restoring witchpoints
:::GalCop has become aware of an illegal data stream emanating from witchpoint markers around system X. You need to go to each of the systems listed, and clean the illegal code from the units.
:::- will require getting within 200m of witchpoint marker, targeting the marker and initiating the special equipment (prime, activate)
:::- will only be available once mission 60 has been performed at a system
:*62 - deliver security software payload to pirate rock hermit that track all ships coming and going from the station
:::- need to use cloaking device to dock with hermit. going red alert within 50k of station will result in mission failure.
:::>> TEST
:*63 - (from non galcop stations) deliver software payload to main station that will disrupt the trade computers (allowing all commodities to be purchased for 1 cr). (possible) for a period of 2 weeks
:::- when installing the software you will be asked what amount to set commodity prices to. You must enter the number specified in the mission description (either 1 or 99).
:::- you have to launch within 2 minutes of installing the software (and not redock again for 24 hours) otherwise GalCop will be able to trace the upload and you'll get hit with a massive fine (10000cr, 200 bounty)
:*64 - (from non galcop stations) deliver software payload to main station that will disrupt the equipment page, preventing any access for a period of 2 weeks.
:::- you have to launch within 2 minutes of installing the software (and not redock again for 24 hours) otherwise GalCop will be able to trace the upload and you'll get hit with a massive fine (10000cr, 200 bounty)
:*65 - get galcop system software
:::Player needs to do a multi-step process in order to get the software:
:::1. go to destination (a multi-gov of lower system with TL > 7) and pick up customised escape pod from any non-GalCop station (mission screen will inform player of installation)
:::2. return to system and use customised escape pod at more than 100000k from main station
:::3. after redocking, launch and wait for the next police ship to launch
:::4. follow police ship - it will self-destruct after 5-10 minutes, spewing an escape pod and a cargo item.
:::5. Scoop the cargo item and return it to the source station.
:66 - Perform scan of rock hermits, possibly while cloaked, return collected data
:::- need to create scanning equipment item
:::- harvest phase scanner code from Smugglers for general operating params
:67 - Perform scan of main station, possibly while cloaked, return collected data

''Solar activity system missions''
:*70 - Use scan equipment to take close up measurements of sun
:::get to fuel scoop dist = ((system.sun.collisionRadius * system.sun.collisionRadius) / system.sun.position.squaredDistanceTo(player.ship.position)) > 0.75;
:::prime scanning device, activate
:::await completion
:::If player retreats before scan is complete, scan will stop, but will restart automatically when in range again (ie it won't start from the beginning)
:*71 - Recover data cache in low orbit over sun
:::find data cache
:::transmit security code
:::await data package
:72 - Launch monitoring devices (special cargo or missiles)
:::must deploy 2 special cargo items from within fuel scoop range, one on the planet side, the other on the far side of the sun.
:*73 - Variation on 70: Go to another system to pick up new equipment, then bring it back and scan the sun
:*74 - Take solar data to hi-tech system for analysis
:75 - return analysed solar data to original system?
:76 - Recover derelict ship near the sun (derelict will be given a high heat shield rating to prevent destruction)
:::- Use DeepSpaceDredger for equipment/process of ship recovery?

''Charity missions''
:*80/81/82/83 - Give credits to entity
:*84/85/86/87 - purchase and give commodity to entity (slaves for AI, any for the others)
:88 - purchase any commodity (not slaves, firearms or narcs) and give to AI
:89 - donation to nationalist entity of system
:::- reward of better commodity prices?
:::maybe just better prices on illegals?
:::- reward of better equipment prices?
:::- reward of better ship prices?
:? - donation to religious entity

''War zone missions''
:*90 - evacuate refugees
:*91 - transfer injured
:92 - import weapons

''Earthquake system missions''
:*100 - Use scan equipment (seismic resonance scanner) to scan planet in 3-4 locations
:::player must get in low enough orbit to perform scan successfully
:::have some way of informing the player where the scan points are - waypoints, must be within 2km of waypoints
:*101 - transport injured people to hi-techlevel system for treatment
:*102 - destroy a number of asteroids around the planet. The gravitational effect of the asteroids means instability on the surface
:103 - collect and deliver special equipment
:*104 - take seismic data to hi-techlevel system for data analysis

''Satellite missions (when Satellites OXP is installed)''
:*110 - Extract data
:*111 - Install new firmware
:*112 - Destroy satellite
:*113 - Hack satellite
:*114 - insert data

''Investigations''
:*130 - a stash of cargo pods with precious metals/gems
:*131 - a ship graveyard
:*132 - a damaged escape pod
:*133 - a pirate base
:*134 - a thargoid trap
:*135 - a proximity mine that causes a fuel leak
:*136 - a spooky noise/comms
:*137 - a pirate trap
:*138 - an asteroid field with blackbox
:139 - (currently unused)
:*140 - destroy pirate base
:*141 - deliver goodbye messages

''Defence/escort missions''
:*150 - defend anaconda from pirates
:151 - defend liner from pirates (need liners OXP installed)
:*152 - defend main station from pirates
:153 - defend other galcop station from pirates (OXP required)
:*154 - defend main station from thargoids
:155 - defend other station from thargoids (OXP's required)
:*156 - defend witchpoint beacon from thargoids

:160 Scan planet from low orbit
:::requires to maintain a low orbit for a certain amount of time, with some possibility of attack

</div>

==Download==
Download [[Media:GalCopMissions_0.14.oxz|GalCopMissions_0.14.oxz]] (downloaded {{#downloads:GalCopMissions_0.14.oxz}} times). 
Download [https://app.box.com/s/wo2nfn3j1xkkjinfu3ytgn810r7gkr2v GalCopMissions.zip] v0.14 (extract OXP folder to AddOns)

==License==
This work is licensed under the Creative Commons Attribution-Noncommercial-Share Alike 4.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/

Thanks to Svengali and Disembodied for their PhraseGen tool. 
Thanks to Ramirez for his remote mine model (from the "Missiles and Bombs" OXP). 
Thanks to these forum members who have submitted bug reports or suggestions that have helped make the OXP better: Nite Owl, herodotus, Astrobe, Damocles Edge, Cody, Bogatyr, pagroove, gsagostinho, Cmd. Northgate, Balisongdalo, javirodriguez, and lohcek.gsagostinho, Cmd. Northgate, Balisongdalo, javirodriguez, and lohcek. 
Special thanks to cim who has very kindly given permission to include his "Black Box" model from [[RRS_Group|Rescue Stations]] in this OXP. 

No entry sign image from http://simpleicon.com/no_entry_sign_1.html 
Warning sign image from http://simpleicon.com/warning-2.html 
Tick image from http://simpleicon.com/ok_1.html 
Pill image from http://simpleicon.com/pill_3.html 
Star badge from https://www.iconfinder.com/icons/1031361/award_badge_best_prize_reward_icon#size=512 (Free for commercial use) 
Round badge from https://www.iconfinder.com/icons/465072/achievement_award_label_medal_politic_win_winner_icon#size=512 (Free for commercial use) 
Star medal from https://www.iconfinder.com/icons/111092/medal_icon#size=512 (CC BY-SA 3.0) 
Star medal on ribbon from https://www.iconfinder.com/icons/316245/medal_icon#size=512 (Free for commercial use) 
Trophy image from http://simpleicon.com/trophy_1.html 
Cup image from http://simpleicon.com/cup.html 
Candle image from http://simpleicon.com/candle-2.html 
Family image from http://simpleicon.com/chat_10.html 
Education image from http://simpleicon.com/wp-content/uploads/knowledge.png 
Head image from https://www.shareicon.net/download/2016/04/17/751132_people_512x512.png 
Raining image from http://simpleicon.com/wp-content/uploads/lightning__raining_2.png 
Biohazard image from https://www.freepik.com/free-vector/biohazard-yellow-circle-sign-graphic-illustration_2631298.htm#fromView=search&page=1&position=0&uuid=040f7aab-af6b-4231-9d3d-7f20cc869cd0" Image by rawpixel.com on Freepik 
Tractor beam sound effect by Finnolia Productions Inc from http://www.soundeffectsplus.com (see licence here: https://www.soundeffectsplus.com/content/license/) 
Sound effect from https://freesound.org/people/jmorrisoncafe330/sounds/110097/ (license https://creativecommons.org/licenses/sampling+/1.0/) 
Sound effect from https://freesound.org/people/klankbeeld/sounds/169334/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/klankbeeld/sounds/239633/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/flint10/sounds/197547/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/Robinhood76/sounds/219853/ (license https://creativecommons.org/licenses/by-nc/3.0/) 
Sound effect from https://freesound.org/people/Robinhood76/sounds/333230/ (license https://creativecommons.org/licenses/by-nc/3.0/) 
Sound effect from https://freesound.org/people/staticpony1/sounds/249597/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/TheBillinator3000/sounds/333845/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/InSintesi/sounds/346295/ (license https://creativecommons.org/licenses/by/3.0/) 
Sound effect from https://freesound.org/people/lennyboy/sounds/275186/ (license https://creativecommons.org/publicdomain/zero/1.0/) 
Sound effect from https://freesound.org/people/AlienXXX/sounds/168511/ (license https://creativecommons.org/licenses/by/3.0/)

==Discussion==
This OXP is discussed at this forum link: https://bb.oolite.space/viewtopic.php?f=4&t=18745

==Version History==
0.14
* Market prices on disease outbreak systems now boosted, and quantities reduced. If you can get there, it's probably worth it.
* Added a hint for the player if they attempt to jump into a quarantined system and are blocked by GalCop.
* Suppressed Rescue Stations ambience for disease systems, to prevent confusion over lockdowns.

0.13
* Added ability to call functions when testing conditions.

0.12
* Added Galactic Navy as a reputation entity, and added it to some missions.

0.11
* Fixed issue with "Recover stolen items" mission, when recovering the stolen documents, where the mission could not be completed.
* Darkened overlay images for better compatibility with Oolite 1.92.

0.10
* Fixed more issues with the Satellite missions.

0.9
* Really corrected issue preventing some satellite missions from being completable if the Galactic Almanac OXP is installed.
* Sound now plays when a fuel leak occurs.
* Tweaks to the reputation system to allow for complete localisation through descriptions.plist.
* Made some reputations visible on the reputations screen, even if the actual reputation value is zero.
* Fixed issue where some missions with a minimum player score were being offered to players under that value.
* Moved as much text as possible into descriptions.plist for slightly easier localisation.
* Added prebuilt descriptions for each mission that uses PhraseGen, so PhraseGen can be avoided when translating text. See notes in descriptions.plist or galcopbb_missiondetails.js for details.
* Bug fixes.

0.8.2
* Fixed referencing errors in spawning scripts for "Recover special cargo" (type 24) and "Black Box recovery" (type 22) missions.
* Fixed issue with mission state not being correctly recorded when the derelict is destroyed in black box recovery missions (types 22/23).
* Fixed issue with invalid functions calls for meet ship missions (type 30).
* Fixed issue with the meet ship mission, delivered by email (type 30), that wouldn't generate a second mission when you meet the target.
* Added clarity to "Computer Delivery" mission (type 42), so when the target ship is destroyed, the mission is failed.
* Removed "Computer Delivery" from being a follow-up mission.
* Fixed reference error bugs with investigation missions (types 130-138).
* Fixed issue with email missions causing a JS exception.
* Fixed invalid descriptions lookup key.
* Grammar corrections.

0.8.1
* Fixed referencing error in data cache missions (type 41) that was preventing the mission from being completable.

0.8
* Added a 10% penalty to cargo recovery missions (type 6) for each cargo pod the player destroys.
* Destroying a cargo pod in a "Cargo Recovery" mission will now trigger a mission status update.
* Fixed multiple issues with the descriptive text for "Cargo Recovery" missions (type 6).
* For type 6/7 missions, changed reward calculation to be based on the value of the commodity being collected.
* Excluded escape pods from being considered in the "Pirates for Hire" mission (type 8) when slaves are being sought.
* Adjusted spawning rules for ship with stolen items (type 33), to ensure they always spawn in scanner range of the player.
* Fixed bug in special delivery mission (type 40) that was preventing key information from being updated.
* Tweaked special delivery mission (type 40) so mission complete percentage doesn't go above 100%.
* Added missing position to a "Computer delivery" mission (type 42) description.
* Bug fixes in disease outbreak script (types 50-52).
* Fixed issue with disease outbreak systems, where system traffic wasn't being reduced, and GalCop station docking wasn't being prevented, in the case where the player doesn't have a valid permit.
* Added a screen displayed when docking at a station to inform player of disease lockdown systems with 7LY.
* Fixed grammar in descriptive text for "Hacking the witchpoint" mission (type 60).
* Fixed issues with mission details and grammar for station disrupt missions (type 63).
* Fixed issues preventing the disrupt station missions (type 63/64) from being completable.
* Reduced eject distance for the "Acquire GalCop Software" mission (type 65).
* Fixed issues preventing the "Acquire GalCop Software" mission (type 65) from being completable.
* Beacon labels are now turned off after collecting data from Solar Monitors (type 71).
* Updated manifest and BB status entries for donation missions (types 80-87) so that after a partial donation the status shows how much is remaining to donate.
* Removed waypoints from terminated or failed Seismic Scan missions (type 100).
* Fixed issue with manifest entry for "Asteroids in low orbit" mission (type 102), where it did not show progress towards completion.
* Fixed issue with completing the "Deliver Seismic Scan Data" mission (type 104), where the equipment item wasn't being removed.
* Destroying a satellite will now update the mission objectives (types 110-124).
* Corrected issue preventing some satellite missions from being completable if the Galactic Almanac OXP is installed.
* Fixed bug when spawning satellite defenders that was preventing the AI from being switched.
* Tweaked how far you have to go past the reference point before the unidentified signal is started in an Investigation mission (type 130-138).
* Tweaked descriptions for investigation missions to include a "reference point" past which a fair distance must be travelled in order to find the signal.
* Tweaked the location of unidentified signals in Investigation missions (type 130-138).
* Fixed spelling in "Defend station from attack" mission (type 152) description.
* Added some lurking pirates outside pirate bases.
* Added some extra details to manifest entry for missions that send to you a specific location in a system.
* Ejection damper now includes "uses left" in a console message when turned on and again when used.
* Switched a few mission types to stop the clock when complete.
* Switched a lot of mission types to be completable at any main station.
* Fixed issue that was preventing the Range Finder equipment from detecting mission-based escape pods.
* Fixed issue that was preventing the Range Finder equipment from detecting derelict ships.
* Added a simplified directional indicator to the Range Finder for when scanned items are less then 50km distant.
* Fixed issue where cargo collected for missions wasn't being handed over correctly and removed from the player's hold.
* Fixed issue where scooping more cargo than the mission requirement would cause some display and calculation irregularities.
* Fixed issue where the F5F5 manifest page wasn't getting updated correctly for missions that have multiple items to collect if items had been destroyed.
* Fixed various other grammar issues in mission text.
* Fixed grammar in readme.txt.
* Set global debug flag to false.
* Code refactoring.

<div class="mw-collapsible mw-collapsed" data-expandtext="Show older" data-collapsetext="Hide older" style="overflow:auto;">
0.7.0
* Fixed bug in "Extract telescope data" mission, where the wrong satellite types were being used in the calculations.

0.6.9
* Fixed issue where scooped Thargoid metal fragments were not being counted towards mission objective (type 13).
* Code refactoring.

0.6.8
* Fixed referencing errors with hit team docking notifications.
* Fixed JS error when in interstellar space while a slave rescue mission is active.
* Fixed JS error for disease outbreak systems.
* Fixed description for blackbox secondary mission that wasn't putting location into the details.
* Will now try up to 10 times to create a secondary mission after meeting a ship.
* When no secondary mission can be created after meeting a ship, a message providing some explanation is now given.
* Improved process for detecting and flagging alloys as having come from Thargoid vessels (type 13).
* Hit teams bug fixes.
* Bug fixes.

0.6.7
* Added mission type 18 to available missions.
* Fixed spelling error in function names for Collect ingredients mission (type 53).
* Fixed issue with possibly changing the status of the "defend the anaconda" mission (type 150) after completing it successfully.

0.6.6
* Turned off debug flag on investigation missions.

0.6.5
* Completing some missions will now reduce the players bounty.

0.6.4
* Fixed issue with the Reputations screen not showing some items.

0.6.3
* Removed customised PhraseGen code, made GNN a requirement for the OXP.

0.6.2
* Fixed a bug with donation missions and integration with Market Observer.

0.6.1
* Fixed error when repairing the Range Finder.
* Tweak to cargo stopper process for mild performance improvements when selecting targets.
* Fixes to the descriptions for slave repatriation missions (type 84).
* Fixes to the description for the Destroy Satellites mission (type 122).
* Donating cargo or slaves to charities will now update Market Observer (if installed).
* Adjusted time limit for satellite download missions.
* Tweaked manifest descriptions on satellite missions to better communicate distinct requirements for missions.
* Range Finder now compatible with GalTech Escape Pods.

0.6.0
* Cargo stopper is now activated automatically when cargo is targeted, in front of the player ship and in range, negating the need for priming and activating the equipment.
* Fixed stealing cargo missions, where it was possible to hand in cargo at stations other than the originating station.
* Improved mission status messages for stealing cargo missions to show how much has been collected.
* Bug fixes.

0.5.9
* Fixed some instances of timers being recycled while running.

0.5.8
* Fixed issue with delivery missions, where comms relay was not being spawned due to a Javascript error.

0.5.7
* Fixed some issues with retrieving data from stored settings used when the system populator runs.
* Cleaned up the process of setting ship scripts in all script files to prevent scripts not being present when required.

0.5.6
* Bug fix in spawning routine for derelict ships for black box missions (type 22).
* Fix to (hopefully) prevent scenario where mission ships were not being spawned.

0.5.5
* Small text adjustments for game consistency.
* Fix JS error in satellite missions.

0.5.4
* Improved logic for adding ships to a system.
* Fixed invalid reference error when generating missions.
* Better use of new functions available in later versions of Oolite.
* Corrected use of samplePrice method.

0.5.3
* The number of asteroids required to complete the Asteroid Removal missions (type 1) is now restricted to be less than the number of asteroids currently in the system.
* Fixed bug in the Hit Teams script where the definition of the "$initiateInvestigation" routine was inaccurately declared.

0.5.2
* Fixed invalid variable reference error.

0.5.1
* An email will now be sent to the player when they accept their first mission to Interstellar space, offering tips on how to enter interstellar space, and what to expect when they get there.

0.5.0
* Added some civil warzone missions (types 90, 91).
* Added defence missions (types 150, 152, 154, 156).
* Added a new delivery mission (type 46), which involves collecting cargo from a waypoint, and dropping it at another waypoint.
* Added a new investigation mission (136). Be afraid...
* Added secondary mission (type 74) to solar activity missions (70, 71, 73).
* Fixed error in description for solar activity mission (74).
* Fixed issue preventing the "gather ingredients" mission (53) from being created.
* Fixed issue with the "Remove Ejection Damper" equipment item, which wasn't removing the ejection damper equipment.
* Fixed issue with cargo recovery missions (6, 7), where ejecting and re-scooping cargo pods would throw the mission status out of kilter.
* Fixed manifest entry for the upload surveillance data mission (118) which was showing the wrong destination.
* Fixed some missions that were not including a player-rated bonus in their payment amounts.
* Defend satellite missions (124) were not being created for players with more than 64 kills.
* Upgrade satellite firmware missions (115) now have proper pass codes to transmit to the satellites.
* Tweaked the payment amount, and completion time requirement for satellite firmware update missions (115).
* Completing the delivery of personal messages for a dead pilot (141, secondary mission after investigation mission 132) now done manually.
* Limited some Thargoid missions to only be available in frontier systems.
* Updated description of Range Finder MFD equipment on F3 screen to include mention of cargo pods mode.
* Tweaks to the custom assassin AI routines to eliminate null target conditions.
* Various adjustments to the manifest entry for many missions.
* Spelling corrections.
* Bug fixes and code refactoring.
* Added a method to main script to allow for any mission to be easily tested during runtime ($testMissionType).

0.4.0
* Added "Cargo pod" mode to Range Finder.
* Fixed error with Range Finder when scanning for Black Boxes. If non-ship entities were in range (eg planet, sun), a Javascript error would occur.
* Changing the Range Finder mode will now clear the MFD of previous scan results.

0.3.7
* Fixed bug with missing variable declaration in failed mission function call.

0.3.6
* Removed debug flag that would cause a particular mission to always be generated.

0.3.5
* Fixed issue with secondary mission after investigation mission (132) not having correct destination on manifest.
* Code refactoring.

0.3.4
* Fixed title in manifest.plist file.
* Fixed missing reference error when completing data cache missions.
* Fixed missing reference error when completing black box missions.
* Fixed missing reference error when completing meet ship missions.
* Fixed missing reference error when completing hacking/restoring witchpoint beacon missions.
* Fixed missing reference error when completing some solar activity missions.
* Fixed missing reference error when completing some disease outbreak missions.

0.3.3
* Added some fallback code in case cargo pods are not spawned with our preferred barrel type.

0.3.2
* Fixed incorrect worldScript name references in Pirate Bases script.
* Added extra qualification to mission destination texts that refer to main planet, to help distinguish the main planet from any additional planets.
* Tweaked one investigation mission to limit its availability to more experienced players with an upgraded ship.
* Fixed issue with the Thargoid wreckage mission (13) which wasn't recognising wreckage collected in interstellar space.
* Removed debug log messages.

0.3.1
* Fixed spawning issues for investigation missions (types 130-139).
* Tweaked the power of the proximity mine.

0.3.0
* Added investigation missions (types 130-139).
* Switched from using a dummy alloy ship entity as a navigational beacon to using a visual effect.
* Code refactoring, improving code reuse.
* Split more mission specific functions out of general script file to associated script file.
* Fixed issue with some missions having a decimal amount as part of the payment.
* Performance improvements when generating new missions for a system.
* Fixed status message with drug dealer mission (15).
* Bug fixes.

0.2.4
* Linked the MFD to Broadcast Comms MFD in the Auto-Prime Equipment OXP.
* Makes use of GNN OXP if installed.
* Improved handling of player ship death scenarios.
* Fixed linkage to [[Home System]].

0.2.3
* Added the Ejection Damper equipment.
* Reduced the effective range of the Cargo Stopper to approximately 2km to make it slightly less OP.
* Added a sound effect for the tractor beam when activated.

0.2.2
* Tweaks to the positioning of ships for "Special Delivery" missions (40/41).
* Fixed issue with "Special Delivery" mission (40), where the target ship was not responding to the "I don't have any more" comms message.
* Tweaks to the scavenger AI, so the target ship doesn't jump out of the system prematurely.
* Added Advanced Space Compass as a requirement for "Special Delivery" missions (40).
* Removed some debug messages.

0.2.1
* Fixed issue with escape pod rescue missions (21, 22, 25) not being completable.
* Moved more interstellar populator routines into the correct methods.
* Removed some hard-coded scanner range values.
* Spelling corrections.

0.2.0
* Fixed issues with the "Collect cargo" (6/7) missions, where scooped cargo was being counted as destroyed instead of collected.
* Fixed issue with "Special Delivery" (40) missions where, if cargo was dumped and then re-scooped because it was drifting out of range, when the cargo was re-dumped the target ship was ignoring it.
* Fixed issues with missions that have multiple stages (types 41, 63, 64, 65, and 73) that weren't being initialised correctly and so would never start.
* Fixed issues with escape pod rescue missions (20) and runaway escape pod missions (25) that was preventing the escape pods from being spawned.
* Added a new device, a Comms Relay Beacon Switch, that is issued to the player for any "Collect data cache" (31) or "Special delivery" (41) mission. This device will turn on the comms relay beacon again after the initial transmission period has expired, although using it will incur a 5% payment reduction.
* Added a new device, the "Cargo Stopper", primable equipment available from TL6 systems, which, when pointed at moving cargo and then activated, will bring the cargo to a stop.
* Fixed issue where I.T.H.A. reputation was not being removed from the F5 page correctly when reputations were set to be moved to the "Reputations and Awards" page.
* Forced bonus payment calculations to return an integer, rather than a decimal.
* Some mission text tweaks.

0.1.5
* Adjustments to the population routines for interstellar space.
* Fixed bug where reputation was not being applied correctly for missions where multiple reputation entities were defined.
* Fixed bug with distance calculation in the Disease Outbreak script.
* Adjusted time calculation for travel between threatened satellites during a satellite defend mission.
* Added reputation links to [[Home System]] OXP.
* Better handling of Combat Simulator.

0.1.4
* Adjusted calculation of the number of deaths from a disease outbreak.
* Fixes to secondary missions sourced from black boxes or escape pods or passing ships having a termination penalty.

0.1.3
* Reworked all the cargo collection mission types (8,9,10,11,13,14,15) so that mission updates happen when cargo is handed in, not when it is scooped (although a notification will still be given to the player that the cargo was suitable for the mission). Expiry time has also been removed, and maximum quantity can now be greater than the player's available cargo hold.
* Fixed issues with Thargoid wreckage collection missions, so alloys can now be successfully handed in, and (hopefully) alloys from any Thargoid warship (including OXP Thargoids) should now be acceptable.
* Applied some fixes for the "Stranded ship" mission to stop the ship from moving before receiving help.
* Code refactoring.
* Bug fixes.

0.1.2
* Tweaked the energy drain of the Range Finder.
* Added sound for when the Range Finder scan is stopped.
* Removed debug flag from "Thargoid wreckage" missions, so they shouldn't appear as frequently.
* Fixed cargo dontation charity missions that were only being made available if the local market had slaves.
* Code refactoring and (hopefully) performance improvements.

0.1.1
* Fixed bug with Thargoid wreckage mission that was preventing the wreckage from being recognised.
* Made the "Collect Thargoid wreckage" mission have no expiry, and provided a means by which you can hand over incomplete amounts and continue.
* Removed debug flag from "Interstellar escape pod rescue" missions, so they shouldn't appear as frequently.

0.1.0
* Added some missions using Satellites OXP (types 110, 111, 113, 115, 122, 124).
* Fixed issue where emailed missions, or missions delivered via another ship, were not checking all the conditions, giving the player a mission they couldn't complete.
* Fixed issue with "Request for meeting" missions, where the target would not respond when the passcode was transmitted.
* Added additional text to mission briefing for missions that require an interstellar space destination to make it clearer this is required.
* Added additional text to mission briefing to make it clearer when a mission requires the player to return to the source system in order to complete it.
* Applied distance and player score bonuses to Special delivery missions (type 40).
* Fixed issue with the WBSA device not being startable when the beacon is targeted.
* Fixed issue with the Range Finder not creating an energy drain.
* Mission text tweaks.

0.0.9
* Added "Gather ingredients" mission (type 53).
* Fixed issue where missions with a deposit could have a negative net payment if the player's reputation is low.
* Fixed issue with manifest entries not reflecting the state of progress correctly.
* Reworked how textures are specified in mission definitions.
* Added overlay images to charity missions.
* Added routines to control the creation of asteroid fields, so they will be created in the same place in each system, and reused for future missions.
* Fixed issues with mission descriptions missing some text elements.
* Fixed issue with cargo recovery mission text containing ">undefined".
* Fixed issue with RRS reputations causing a JavaScript error when opening the "Reputation and Awards" F4 screen.
* Headings on the reputations page will now be suppressed if there are no related items to display.
* Converted text for mission types 74, 100, 101 and 102 to use the PhraseGen tool.
* Some tweaks/fixes to mission text.
* Code refactoring.

0.0.8
* Better logic for determining what is a witchpoint buoy.
* Better client name generation using PhraseGen tool.
* Fixed minor text issue with the "decline mission" for escape pod messages.
* No mission accept/complete confirmation emails will be sent for secondary missions when the source of the mission is an NPC from an escape pod or a ship.
* If player ejects escape pod while in pod occupant is communicating, conversation will stop and mission offering will be correctly terminated.
* Fixed error when scooping escape pod with no "crew" set (ie equivalent to scooping 1t slaves)
* Improved robustness of "Rescue Stricken Ship" missions.
* Fixed issue where stricken ships were not communicating with player correctly.
* Fixed error when firing on the stricken ship after it was repaired.

0.0.7
* Better logic for determining if a pirate ship has just been destroyed.
* Added a "+/-" indicator on the Range Finder MFD, to make it clearer in which direction the player is moving in relation to the target.

0.0.6
* Prevented Cargo Shepherd magnets from being targeted by delivery ships.
* Corrected issues with intergrating to the Smugglers Black Market script.

0.0.5
* Fixed mess left after code refactoring. :(

0.0.4
* Fixed issue with escape pod missions not being complete-able.
* Turned off lights on derelict ships.
* Code refactoring to reduce the chance of scripts for various mission types conflicting with another.
* More robust logic for connecting with Smugglers Black Market.
* Bug fixes.

0.0.3
* Made compatible with Oolite v1.84.

0.0.2
* Initial public release.
</div>

== Quick Facts ==
{{OXPLevel|1|4}}{{IconOXP|ooVersion="1.84"|oxpCPU="Average"|oxpMEM="Average"|oxpGPU="Low"|oxpIsConfigurable=true}}
{|class="floatright" style="alignment:right;margin: 0 auto;"
|[[Image:IconLib.png|48px|right|link=Library OXP|alt=Config options available through 'Library']]
|[[Image:IconBB.png|48px|right|link=Bulletin Board System|alt=Missions offered through the 'Bulletin Board System']]
|[[Image:IconGNN.png|48px|right|link=GNN|alt=News items displayed through GNN]]
|}
{{Infobox OXPb| title = GalCopMissions.oxz
|version = 0.14
|release = 2026-04-20
|license = CC BY-NC-SA 4.0
|features = Missions
|category = Missions OXPs
|author = [[User:phkb|phkb]]
|feedback = [https://bb.oolite.space/viewtopic.php?f=4&t=18745 Oolite BB]
}}

== Gameplay and Balance indicator ==
[[File:Tag-colour-green.png]]

Ethics

2026-07-28T09:57:35Z

Cholmondely: /* OXPs adding ethical choices */ Added a note

{{OXPNote|This Page is under construction!}}
 
[[File:Prohip xpat1.jpg|thumb|500px|right|The Refugee Adder - do you try and protect it, or do you sell off the refugees as slaves?]]
== Overview ==
Since the nature of Classic Elite/Oolite is a sandbox game where you make your own decisions about what the goals of your game actually should be, you decide your own ethics - and can add in OXPs which reflect this.

There are several sets of choices which you must make as a player.
:1) Do you deal in illegal goods - and specifically, how do you deal with slaves?
:2) Do you attack innocents and act piratically, or do you only attack when you yourself are attacked (or do you do something in between?).

These choices can be added to by adding such OXPs as Refugee Adder, Illegal Goods Tweak OXP and GalCop Missions.

== Links ==
*[[Cheating]] - analysis of how one can cheat in Oolite (and relevant OXP's)
*[[Slaves]] - list of OXPs which affect this aspect of the game
*[[Piracy]] - list of OXPs which either allow a life of piracy - or which allow you to join groups fighting the pirates

*[https://bb.oolite.space/viewtopic.php?f=2&t=10857 House Rools] (2011) - listings of different approaches to Oolite: the Smuggler, the Regulator, the Gentleman, ''etc''.
*[https://bb.oolite.space/viewtopic.php?f=2&t=21218 Do any of you play by an "honor code"?] (2022-23)
*[https://bb.oolite.space/viewtopic.php?t=21391 An Ethics OXP?] (2023)
*[https://bb.oolite.space/viewtopic.php?t=21394 Escaping Prisoners (in Mining Pods from Commies OXP)] (2023)
*[https://bb.oolite.space/viewtopic.php?t=21890 NPC Detection Range] (2023)

=== The Dark Side ===
*[https://bb.oolite.space/viewtopic.php?p=250371#p250371 Bug: Player can Lead a Group, but AIs Don't Like It] 2016 (re: leading a victim to safety)

== OXP's ==
=== OXPs adding ethical choices ===
*[[Refugee Adder]] - do you help? Or threaten/attack?
*[[Commies]] - this adds in the occasional escapee from the Astrogulags. Again, do you help - or attack?
*[[Illegal Goods Tweak OXP]] - do you try and bribe the customs to look the other way?
*[[GalCop Missions]] - do you accept slave-freeing missions? And also enables charitable work/donations.
*[[Random Hits]] - do you accept any old contract as long as it pays - or are you more selective?
*[[Hermitage]] - do you steal somebody else's Rock Hermit? Do you deal in illegal goods - or do you shut down the black market?
*[[Life in the Frontier]] allows donations to charity and a fresh selection of vices!
*Some of the missions also add in ethical choices - such as deciding whether to accept the [[Taranis]] mission, or the choices in [[Vector]] (you need to load up an older version of Oolite for this broken oxp).

=== OXP's which affect cheating ===
*See [[Cheating]] for a list and discussion of these.

[[Category:Factual]] [[Category:Concepts]]

Oolite System Populator

2026-07-26T07:08:19Z

Cholmondely: Added summary

This page dates from 2013: it covers the present-day populatory protocols. For ''previous'' populatory protocols (2004-13) see [[System Populator]].

== Overview ==
The Oolite System Populator has three parts:
# Via [[planetinfo.plist]] populator and repopulator functions are defined. Different functions may be defined for different systems.
# The populator function is called whenever a new system (or region of interstellar space) needs populating: immediately after the [[Oolite JavaScript Reference: World script event handlers#startUp|startUp]] world event, and immediately before the [[Oolite JavaScript Reference: World script event handlers#shipWillExitWitchspace|shipWillExitWitchspace]] world event. It acts like a world event itself, but does not have a fixed name. This function should use [[Oolite JavaScript Reference: System#setPopulator|system.setPopulator()]] to set up system population.
# The repopulator function is called every twenty seconds of [[Time scales in Oolite#Game real time|game real time]]. This function should use functions like [[Oolite JavaScript Reference: System#addGroup|system.addGroup()]] and [[Oolite JavaScript Reference: Station#launchShipWithRole|station.launchShipWithRole()]] to add new ships to the system as required to replace those which have been destroyed, or for other new arrivals.

== Defining populator functions ==
There are three "default" populator and repopulator functions.
* '''For normal systems''': <code>systemWillPopulate</code> and <code>systemWillRepopulate</code>
* '''For interstellar space''': <code>interstellarSpaceWillPopulate</code> and <code>interstellarSpaceWillRepopulate</code>
* '''For nova systems''': <code>novaSystemWillPopulate</code> and <code>novaSystemWillRepopulate</code>

OXPs which intend to add additional content to "normal" systems should define these functions in a worldscript, and use them to add to or amend the default population.

OXPs which wish to "take over" a system or systems should use [[planetinfo.plist]] to set a different populator function which is unique to their worldscript(s). This then prevents normal system population, including modifications from other more generic OXPs (provided those OXPs have been written to use this new population method, of course)

== The system setPopulator function ==
The system populator is a dictionary of populator definitions set by using the [[Oolite_JavaScript_Reference:_System#setPopulator|system.setPopulator()]] function. Existing definitions may be overwritten by specifying a new definition for that key, and the definitions set up so far may be read in [[Oolite_JavaScript_Reference:_System#populatorSettings|system.populatorSettings]]

Each definition has the following required parameters:
* '''callback''' : a function which takes a single parameter, a Vector. This function when called should then add entities to the system at or near the Vector passed to it using the standard <code>system.addShips</code> or <code>system.addGroup</code> functions.

...and the following optional parameters:
* '''priority''' : a number. The default is 100. Populator definitions will be run in priority order, with ties broken randomly. Values below 100 should be considered reserved for Oolite if you are using the default populator functions, and only used with an understanding of the implications.
* '''location''' : a string which must either be "COORDINATES" (the default) or a region name. Region names are listed below.
* '''locationSeed''' : a number. The default is zero. If this is zero, the location is picked entirely randomly within the named region. Otherwise, it is picked using a seeded random number generator, guaranteed to give the same answer every time it is used in this system (but not the same answer as in other systems). If the <code>groupCount</code> is greater than zero and a <code>locationSeed</code> is set, an appropriate number of deterministic locations within the region will be picked, always in the same order.
* '''coordinates''' : this must be a valid Vector expression if <code>location</code> is "COORDINATES". It is ignored otherwise.
* '''groupCount''' : a number, default 1. This is the number of times the callback function will be called. It is only really useful with <code>location</code>s other than "COORDINATES".
* '''deterministic''' : a boolean, default false. If this is true (only possible when using "COORDINATES" or a non-zero <code>locationSeed</code>, and not in nova systems or interstellar space) this is a promise to Oolite that this populator function will always be called with these parameters if the player revisits this system, provided the OXP has the power to do so, and will always have the same effect when it is called. (i.e. it has not been uninstalled, had the system populator function changed under it, has its populator entries removed by another OXP, etc.). Currently secondary stations added by deterministic populators may allow the player to save and load the game. If the player saves the game at such a station, which is then not there when they reload the game, they will be returned to the main station as a safety measure.

=== Named regions ===
The following named regions exist in Oolite v.1.79 and later.
* '''WITCHPOINT''' : A position within scanner range of the witchpoint. In interstellar space and nova systems, all named regions are equivalent to this. Unrecognised region names will also be treated as "WITCHPOINT"
* '''LANE_PS''', '''LANE_WP''', '''LANE_WS''' : A position on the space lane between the planet, sun and witchpoint, within two scanner ranges of the centre of the lane, and not within three radii of the planet or sun, or scanner range of the witchpoint.
* '''LANE_WPS''' : Picks one of the lane parameters, weighted to the lengths of the three lanes.
* '''STATION_AEGIS''' : A position within two scanner ranges of the main station, but not too close to the planet.
* '''PLANET_ORBIT''', '''PLANET_ORBIT_HIGH''', '''PLANET_ORBIT_LOW''' : A position less than 1 radii from the main planet's surface (low orbit), between 1 and 3 radii (orbit), or between 3 and 7 radii (high orbit)
* '''STAR_ORBIT''', '''STAR_ORBIT_HIGH''', '''STAR_ORBIT_LOW''' : As the planet orbits, but relative to the system's star's position and radius.
* '''TRIANGLE''' : A position in the the triangle described by the sun, main planet, and witchpoint, at least three radii from the sun and planet and three scanner ranges from the witchpoint.
* '''INNER_SYSTEM''', '''INNER_SYSTEM_OFFPLANE''' : A position at least as close to the sun as the planet is, but no closer than three radii. If "OFFPLANE" is not specified, the position will be close to the plane described by the sun, main planet and witchpoint.
* '''OUTER_SYSTEM''', '''OUTER_SYSTEM_OFFPLANE''' : A position at least as far from the sun as the planet is, but no further than 10,000km from it. Note that coordinates in this area may take the player 15 minutes or more to reach at full torus speeds, and ships travelling at conventional speeds may take several hours or even days to reach these locations from the inner system.

== The system repopulator function ==

The system repopulator function will be called approximately every twenty seconds, and can be used to replace ships that have been destroyed. Generally such replacements should enter the system in a believable way - exiting witchspace near the witchpoint, by being launched from an appropriate station or the planet, or by some similar method. It is important for smooth gameplay that this function runs very quickly. If calculations are needed, run as many as possible in the populator function to save the result.

== Location of stations ==
"One of the reasons for the changes to the populator back in Oolite v.1.80 was to make it easier for stations to be placed individually at consistent per-system positions without them being also always being placed at the same consistent per-system positions as each other or even the same position in every system they're in. I'm not sure any of those OXPs have been updated enough since then to take advantage of that, however." [https://bb.oolite.space/viewtopic.php?p=254182#p254182 Cim 2017]

=== Stranger's World ===
Note that the orbital movement of planets and moons around the sun (based on "0,0,0" being at the witchpoint beacon) means that many of the stations in Stranger's World cannot be used for saving games.

== Links ==
*[[System Populator]] - more on this
*[[Configurable Populator]] - OXP for adjusting some populations in-game
*[[Custom Populator OXP]] - utility for adjusting populations

*[https://bb.oolite.space/viewtopic.php?f=3&t=8117 System.addShips] (2010 BB discussion)
*[https://bb.oolite.space/viewtopic.php?t=8104 Placing objects in Oolite space - understanding the co-ords] (2010 BB discussion)
*[https://bb.oolite.space/viewtopic.php?t=8188 ship populator code] (2010 BB analysis)
*[https://bb.oolite.space/viewtopic.php?p=304792#p304792 start] of lengthy BB discussion on how to override populators from ''other'' OXPs within specific systems (2026). This runs for two pages:
:The "Police role" will spawn Vipers in the strict game (Viper Interceptors are added to this once OXPs are allowed: ''ie'' in a "non-strict" game).
:Suppose that ''eg''. Commies OXP added in "Thought Police" with such weighting that the spawning ratio becomes "1/102 Viper <> 1/102 Viper Interceptor <> 100/102 Thought Police" in a Commie system. That would then lead to "1/102 Viper <> 1/102 Viper Interceptor <> 100/102 ''nothing'' spawned" in a non-Commie system.
:LittleBear overrides all this (in his Assassins Guild OXP) using the "shipSpawned" world event - rather than faffing about with the gory entrails of the populator mechanism.
:This is only in the specific case where you want to ''replace'' ships rather than adding them - and you don't want your ships to replace ships in the game generally, but only at particular places under particular circumstances.

[[Category:Oolite]]

Oolite System Populator

2026-07-24T10:26:11Z

Cholmondely: Added note, tweaks

This page dates from 2013: it covers the present-day populatory protocols. For ''previous'' populatory protocols (2004-13) see [[System Populator]].

== Overview ==
The Oolite System Populator has three parts:
# Via [[planetinfo.plist]] populator and repopulator functions are defined. Different functions may be defined for different systems.
# The populator function is called whenever a new system (or region of interstellar space) needs populating: immediately after the [[Oolite JavaScript Reference: World script event handlers#startUp|startUp]] world event, and immediately before the [[Oolite JavaScript Reference: World script event handlers#shipWillExitWitchspace|shipWillExitWitchspace]] world event. It acts like a world event itself, but does not have a fixed name. This function should use [[Oolite JavaScript Reference: System#setPopulator|system.setPopulator()]] to set up system population.
# The repopulator function is called every twenty seconds of [[Time scales in Oolite#Game real time|game real time]]. This function should use functions like [[Oolite JavaScript Reference: System#addGroup|system.addGroup()]] and [[Oolite JavaScript Reference: Station#launchShipWithRole|station.launchShipWithRole()]] to add new ships to the system as required to replace those which have been destroyed, or for other new arrivals.

== Defining populator functions ==
There are three "default" populator and repopulator functions.
* '''For normal systems''': <code>systemWillPopulate</code> and <code>systemWillRepopulate</code>
* '''For interstellar space''': <code>interstellarSpaceWillPopulate</code> and <code>interstellarSpaceWillRepopulate</code>
* '''For nova systems''': <code>novaSystemWillPopulate</code> and <code>novaSystemWillRepopulate</code>

OXPs which intend to add additional content to "normal" systems should define these functions in a worldscript, and use them to add to or amend the default population.

OXPs which wish to "take over" a system or systems should use [[planetinfo.plist]] to set a different populator function which is unique to their worldscript(s). This then prevents normal system population, including modifications from other more generic OXPs (provided those OXPs have been written to use this new population method, of course)

== The system setPopulator function ==
The system populator is a dictionary of populator definitions set by using the [[Oolite_JavaScript_Reference:_System#setPopulator|system.setPopulator()]] function. Existing definitions may be overwritten by specifying a new definition for that key, and the definitions set up so far may be read in [[Oolite_JavaScript_Reference:_System#populatorSettings|system.populatorSettings]]

Each definition has the following required parameters:
* '''callback''' : a function which takes a single parameter, a Vector. This function when called should then add entities to the system at or near the Vector passed to it using the standard <code>system.addShips</code> or <code>system.addGroup</code> functions.

...and the following optional parameters:
* '''priority''' : a number. The default is 100. Populator definitions will be run in priority order, with ties broken randomly. Values below 100 should be considered reserved for Oolite if you are using the default populator functions, and only used with an understanding of the implications.
* '''location''' : a string which must either be "COORDINATES" (the default) or a region name. Region names are listed below.
* '''locationSeed''' : a number. The default is zero. If this is zero, the location is picked entirely randomly within the named region. Otherwise, it is picked using a seeded random number generator, guaranteed to give the same answer every time it is used in this system (but not the same answer as in other systems). If the <code>groupCount</code> is greater than zero and a <code>locationSeed</code> is set, an appropriate number of deterministic locations within the region will be picked, always in the same order.
* '''coordinates''' : this must be a valid Vector expression if <code>location</code> is "COORDINATES". It is ignored otherwise.
* '''groupCount''' : a number, default 1. This is the number of times the callback function will be called. It is only really useful with <code>location</code>s other than "COORDINATES".
* '''deterministic''' : a boolean, default false. If this is true (only possible when using "COORDINATES" or a non-zero <code>locationSeed</code>, and not in nova systems or interstellar space) this is a promise to Oolite that this populator function will always be called with these parameters if the player revisits this system, provided the OXP has the power to do so, and will always have the same effect when it is called. (i.e. it has not been uninstalled, had the system populator function changed under it, has its populator entries removed by another OXP, etc.). Currently secondary stations added by deterministic populators may allow the player to save and load the game. If the player saves the game at such a station, which is then not there when they reload the game, they will be returned to the main station as a safety measure.

=== Named regions ===
The following named regions exist in Oolite v.1.79 and later.
* '''WITCHPOINT''' : A position within scanner range of the witchpoint. In interstellar space and nova systems, all named regions are equivalent to this. Unrecognised region names will also be treated as "WITCHPOINT"
* '''LANE_PS''', '''LANE_WP''', '''LANE_WS''' : A position on the space lane between the planet, sun and witchpoint, within two scanner ranges of the centre of the lane, and not within three radii of the planet or sun, or scanner range of the witchpoint.
* '''LANE_WPS''' : Picks one of the lane parameters, weighted to the lengths of the three lanes.
* '''STATION_AEGIS''' : A position within two scanner ranges of the main station, but not too close to the planet.
* '''PLANET_ORBIT''', '''PLANET_ORBIT_HIGH''', '''PLANET_ORBIT_LOW''' : A position less than 1 radii from the main planet's surface (low orbit), between 1 and 3 radii (orbit), or between 3 and 7 radii (high orbit)
* '''STAR_ORBIT''', '''STAR_ORBIT_HIGH''', '''STAR_ORBIT_LOW''' : As the planet orbits, but relative to the system's star's position and radius.
* '''TRIANGLE''' : A position in the the triangle described by the sun, main planet, and witchpoint, at least three radii from the sun and planet and three scanner ranges from the witchpoint.
* '''INNER_SYSTEM''', '''INNER_SYSTEM_OFFPLANE''' : A position at least as close to the sun as the planet is, but no closer than three radii. If "OFFPLANE" is not specified, the position will be close to the plane described by the sun, main planet and witchpoint.
* '''OUTER_SYSTEM''', '''OUTER_SYSTEM_OFFPLANE''' : A position at least as far from the sun as the planet is, but no further than 10,000km from it. Note that coordinates in this area may take the player 15 minutes or more to reach at full torus speeds, and ships travelling at conventional speeds may take several hours or even days to reach these locations from the inner system.

== The system repopulator function ==

The system repopulator function will be called approximately every twenty seconds, and can be used to replace ships that have been destroyed. Generally such replacements should enter the system in a believable way - exiting witchspace near the witchpoint, by being launched from an appropriate station or the planet, or by some similar method. It is important for smooth gameplay that this function runs very quickly. If calculations are needed, run as many as possible in the populator function to save the result.

== Location of stations ==
"One of the reasons for the changes to the populator back in Oolite v.1.80 was to make it easier for stations to be placed individually at consistent per-system positions without them being also always being placed at the same consistent per-system positions as each other or even the same position in every system they're in. I'm not sure any of those OXPs have been updated enough since then to take advantage of that, however." [https://bb.oolite.space/viewtopic.php?p=254182#p254182 Cim 2017]

=== Stranger's World ===
Note that the orbital movement of planets and moons around the sun (based on "0,0,0" being at the witchpoint beacon) means that many of the stations in Stranger's World cannot be used for saving games.

== Links ==
*[[System Populator]] - more on this
*[[Configurable Populator]] - OXP for adjusting some populations in-game
*[[Custom Populator OXP]] - utility for adjusting populations

*[https://bb.oolite.space/viewtopic.php?f=3&t=8117 System.addShips] (2010 BB discussion)
*[https://bb.oolite.space/viewtopic.php?t=8104 Placing objects in Oolite space - understanding the co-ords] (2010 BB discussion)
*[https://bb.oolite.space/viewtopic.php?t=8188 ship populator code] (2010 BB analysis)
*[https://bb.oolite.space/viewtopic.php?p=304792#p304792 start] of lengthy discussion on how to override populators from ''other'' OXPs within specific systems (2026 BB discussion)

[[Category:Oolite]]

File:Xs-lib pad xepatl1.png

2026-07-23T17:37:08Z

Cholmondely:

Oolite coordinate systems

2026-07-19T15:34:50Z

Cholmondely: Added note

[[File:FPS report.png|600px|thumb|[[Frame rate]] and object counter from the "Developer's Test Release" versions of Oolite]]
== Oolite Coordinate system ==

By definition the witchpoint is the origin of the system with coordinate [0,0,0], and the buoy is placed at the origin. The main planet is placed on the Z-axis at a distance of about 10 to 14 times the main planet radius from the origin. (This is roughly at 300 000 to 900 000 meters from the origin). The sun is placed at a random direction from the planet, around 20 planetary radii from the planet, but never too close to the witchpoint-planet line.

== legacy_addShipAt systems ==

In most situations the scripter is not interested in the exact coordinates of a point but just the position relative to other system objects. For this reason offers Oolite a whole series of different coordinate systems for the scripter. These are all characterised with a 3-character code to be used in the various legacy_addShip functions.

=== first letter ===
The first letter indicates the feature that is the origin of the coordinate system.
w => witchpoint
s => sun
p => planet

=== second letter ===
The next letter indicates the feature on the 'z' axis of the coordinate system.
w => witchpoint
s => sun
p => planet

Then the 'y' axis of the system is normal to the plane formed by the planet, sun and witchpoint.
And the 'x' axis of the system is normal to the y and z axes.
So:
ps: z axis = (planet -> sun) y axis = normal to (planet - sun - witchpoint) x axis = normal to y and z axes
pw: z axis = (planet -> witchpoint) y axis = normal to (planet - witchpoint - sun) x axis = normal to y and z axes
sp: z axis = (sun -> planet) y axis = normal to (sun - planet - witchpoint) x axis = normal to y and z axes
sw: z axis = (sun -> witchpoint) y axis = normal to (sun - witchpoint - planet) x axis = normal to y and z axes
wp: z axis = (witchpoint -> planet) y axis = normal to (witchpoint - planet - sun) x axis = normal to y and z axes
ws: z axis = (witchpoint -> sun) y axis = normal to (witchpoint - sun - planet) x axis = normal to y and z axes

=== third letter ===
The third letter denotes the units used:
m: meters
p: planetary radii
s: solar radii
u: distance between first two features indicated from 0 to 1. Negative values or values greater that 1 are allowed.
(eg. spu means that u = distance from sun to the planet)

in interstellar space (== no sun) coordinates are absolute irrespective of the system used

== absolute coordinates ==
When you use the code "abs" as coordinate system, than there is no transformation and you can use coordinates in Oolite's internal coordinate system. For more in depth position calculations this native system will be the most important system.

With the '''Vector3D.interpolate''' method you can create your own coordinate system. When you add a custom station in a system and you want to populate the spacelane between this station and the main station you can use:
coordinate = Vector3D.interpolate(system.mainStation.position, cutomStation.position, fraction)
This results in an absolute '''coordinate''' between the two positions. Fraction runs from 0 to 1, representing the lane and values outside this range are also allowed. By using:
system.legacy_addShipsAt("role", number, "abs", coordinate)
you add the ship at exactly that calculated spot.

=== Cim's comment ===
Note to OXPers: best practice is to never add anything using hard-coded absolute coordinates... Always calculate the coordinates relative to existing objects. In 1.79, you'll be able to get Oolite to give you "safe" coordinates in particular regions of space relative to the major objects. ([https://bb.oolite.space/viewtopic.php?p=205451#p205451 Cim, 2013])

== legacy_addSystemShips ==
For this one you don't need to specify a coordinate system. It uses the line witchpoint to main station as its baseline. Just be aware that this line is not the same as witchpoint<-->planet. The more close to the planet the more they start to deviate from each other. Players flying straight from witchpoint to the station will find ships sooner on this route while players that first fly to the planet will find ships sooner when added on the "wpu" route. Take note that the populator adds the ships on the "wpu" route.

----
== Links ==
*[[Oolite System Populator]]
*[https://bb.oolite.space/viewtopic.php?t=8104 Placing objects in oolite space - understanding the co-ordinates (2010)]

[[Oolite_JavaScript_Reference:_System|return]]

[[Category:Oolite_scripting]]