Difference between revisions of "The Galactic Almanac User Manual"

From Elite Wiki
(Script Info Keys Read by the Galactic Almanac F4 Screen)
(Script Info Keys Read by the Galactic Almanac Automatic Naming System)
Line 41: Line 41:
 
===Script Info Keys Read by the Galactic Almanac Automatic Naming System===
 
===Script Info Keys Read by the Galactic Almanac Automatic Naming System===
  
The Galactic Almanac was designed to be backwards compatible and thus all stations from OXZs released up to April 2022 are automatically named by the Galactic Almanac OXZ (unless OXZ Station Naming is turned off in the Galactic Almanac Settings Menu). These stations and examples of the naming style used for each type of station are listed in the table on [The Galactic Almanac OXZ|the Galactic Almanac OXZ main page]]. Starting with version Beta 1.6, the Galactic Almanac OXZ will automatically assign a unique and persistent name to any OXZ station released after the Galactic Almanac OXZ using a pool of 8,192 names. The Galactic Almanac OXZ will automatically add a name of the entity has Station Scan Class or it has Rock Scan Class but the isStaation Flag is set to true. The Galactic Almanac OXZ will only automatically name stations. It will not automatically name dockable carriers or ships with Police or Military Scan Class as these ships are automatically named by the Random Ship Names OXZ.
+
The Galactic Almanac was designed to be backwards compatible and thus all stations added by OXZs released up to April 2022 are automatically named by the Galactic Almanac OXZ (unless OXZ Station Naming is turned off in the Galactic Almanac Settings Menu). These stations and examples of the naming style used for each type of station are listed in the table on [The Galactic Almanac OXZ|the Galactic Almanac OXZ main page]]. Starting with version Beta 1.6, the Galactic Almanac OXZ will automatically assign a unique and persistent name to any OXZ station released after the Galactic Almanac OXZ using a pool of 8,192 names. The Galactic Almanac OXZ will automatically add a name of the entity has Station Scan Class or it has Rock Scan Class but the isStaation Flag is set to true. The Galactic Almanac OXZ will only automatically name stations. It will not automatically name dockable carriers or ships with Police or Military Scan Class as these ships are automatically named by the Random Ship Names OXZ.
  
 
If you are adding a new station to the game and you want it to be named by the Galactic Almanac OXZ then you do not need to do anything as the Galactic Almanac will name it automatically. If however you do not wish the Galactic Almanac to name your station, either because it is a unique station or you are giving it your own custom name then you can turn off the automatic naming feature as shown below:-
 
If you are adding a new station to the game and you want it to be named by the Galactic Almanac OXZ then you do not need to do anything as the Galactic Almanac will name it automatically. If however you do not wish the Galactic Almanac to name your station, either because it is a unique station or you are giving it your own custom name then you can turn off the automatic naming feature as shown below:-
  
 
"script_info" = {"almanac_object_naming" = "Off";};
 
"script_info" = {"almanac_object_naming" = "Off";};

Revision as of 14:29, 17 April 2022

Script Info Keys Read by the Galactic Almanac MFD Unit

Starting with Beta 1.6 onwards, the Galactic Almanac OXZ supports Script Info Keys which can be used by other OXZs to customise the descriptions given to ships and stations by the Galactic Almanac MFD Unit and to turn off automatic naming of stations.

The MFD will automatically classify any object added by an OXZ as a ship, station, missile, mine, asteroid and so on as appropriate. Planets, Moons and Gas Giants will also be automatically classified. For natural objects (planets, moons, gas giants and asteroids) the MFD will provide information on the object’s composition. For ships, stations, missiles and mines the MFD will provide information on the company or manufacturer of the ship or weapons system.

The Galactic Almanac MFD Unit contains an in-built Data Base of all ships and stations released as of the release date of the last Version of the Galactic Almanac OXZ. New ships and stations written after the Galactic Almanac OXZ are supported by the ability to add Script Info Keys specifying the Designer of the new ship or station. These Keys can also be used in Ship Data Overwrites to change the classifications of existing ships and stations.

The Default format for Ships, Stations, Missiles and Mines is the Designer and name of the Designer.

The MFD Unit provides information in the format:

Information on Targeted [OBJECT TYPE]

[OBJECT DATA NAME] : [OBJECT DETAILS]

If no Script Key is specified, then the Object Type will be Ship or Station and the Object Data Name will be Designer. Planets, Moons, Gas Giants and Ice Giants will be automatically classified by the Galactic Almanac OXZ. If the Ship or Station is a new one, not included in the Data Base, the Designer will be listed as "No Data Available." If you would like your ship or station to be given a listed designer, you can specify the name of the designer by setting the Object Details with a Script Info Key in Ship Data by setting the script info command for object details as shown below:

"script_info" = { "almanac_mfd_object_details" = "My Custom Company"; };

The MFD will then list the Designer of your ship, station or weapon as "My Custom Company". All three words the MFD displays can be custom set in Ship Data if you wish. For example, if you wished to over-write the defaults, so that your ship appeared on the MFD as "Information on Targeted UFO. Caution: Alien Vessel", set the script info to:

"script_info" = { "almanac_mfd_object_type" = "UFO"; "almanac_mfd_object_data_name" = "Caution"; "almanac_mfd_object_details" = "Alien Vessel"; };

There is no requirement to set any script info commands when designing a new ship or station. The MFD Unit will automatically classify the object if no script info is present. If the object is a new type of ship or station released after the Galactic Almanac OXZ, the Designer will be shown as "No Data Available" if no Designer has been specified in script info using the almanac_mfd_object_details script command in the object's Ship Data entry.

Script Info Keys Read by the Galactic Almanac F4 Screen

Normally all objects with a beacon will be listed on the "Galactic Almanac of GAL-ID Registered Orbitals and Stations" page. The Galactic Almanac OXZ contains an exclude list which automatically excludes certain objects with beacons (mission ships and secret stations) added by other OXZs up to the latest release of the Galactic Almanac. If you are adding a beacon to a ship, station or other object but do not want it to appear on the list of Registered Orbitals, then you can add your object to the exclude list by setting the hidden option to On as shown below:-

"script_info" = {"almanac_object_hidden" = "On";};

Please note however, that if you have given an object a beacon in Ship Data then it will still be detectable with the native Advanced Space Compass.

Script Info Keys Read by the Galactic Almanac Automatic Naming System

The Galactic Almanac was designed to be backwards compatible and thus all stations added by OXZs released up to April 2022 are automatically named by the Galactic Almanac OXZ (unless OXZ Station Naming is turned off in the Galactic Almanac Settings Menu). These stations and examples of the naming style used for each type of station are listed in the table on [The Galactic Almanac OXZ|the Galactic Almanac OXZ main page]]. Starting with version Beta 1.6, the Galactic Almanac OXZ will automatically assign a unique and persistent name to any OXZ station released after the Galactic Almanac OXZ using a pool of 8,192 names. The Galactic Almanac OXZ will automatically add a name of the entity has Station Scan Class or it has Rock Scan Class but the isStaation Flag is set to true. The Galactic Almanac OXZ will only automatically name stations. It will not automatically name dockable carriers or ships with Police or Military Scan Class as these ships are automatically named by the Random Ship Names OXZ.

If you are adding a new station to the game and you want it to be named by the Galactic Almanac OXZ then you do not need to do anything as the Galactic Almanac will name it automatically. If however you do not wish the Galactic Almanac to name your station, either because it is a unique station or you are giving it your own custom name then you can turn off the automatic naming feature as shown below:-

"script_info" = {"almanac_object_naming" = "Off";};