Differences

This shows you the differences between two versions of the page.

--- modding:xml:systemtype [2013/01/14 18:12] – gpm
+++ modding:xml:systemtype [2017/08/30 23:16] – Add summary 0xabcdef
@@ Line 1: / Line 1: @@
+=====Summary=====
+  * SystemType
+    * backgroundID=
+    * noExtraEncounters=
+    * noRandomEncounters=
+    * spaceEnvironmentTileSize=
+    * spaceScale=
+    * timeScale=
+    * 1 SystemType
+      * 0|1+ AntiTrojan
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * offset= [dice_range]
+      * 0|1+ ArcDistribution
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * count= [dice_range]
+        * radialWidth= [whole]
+        * radialEdgeWidth= [whole]
+        * scale= [scale_distance]
+      * 0|1+ AddAttribute
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * attributes= [string]
+      * 0|1+ AddTerritory
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * id= [string]
+        * minRadius= [whole]
+        * maxRadius= [whole]
+        * criteria= [string]
+        * attributes= [string]
+      * 0|1+ Code
+        * debugOnly= [boolean]
+        * probability= [whole]
+      * 0|1+ FillLocations
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * percentFull= [whole]
+        * count= [whole]
+        * percentEnemies= [whole]
+        * stationCriteria= [string]
+      * 0|1+ Group
+        * debugOnly= [boolean]
+        * probability= [whole]
+      * 0|1+ Label
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * attributes= [string]
+      * 0|1+ LevelTable
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * All subelements have **levelFrequency**
+      * 0|1+ LocationCriteriaTable
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * All subelements have **criteria**
+      * 0|1+ Lookup
+        * table= [string]
+      * 0|1+ Marker
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * objName= [string]
+        * showOrbit= [boolean]
+      * 0|1+ Null
+      * 0|1+ Offset
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * count= [dice_range]
+        * scale= [scale_distance]
+        * radius= [dice_range]
+        * angle= [dice_range]
+        * x= [dice_range]
+        * y= [dice_range]
+      * 0|1+ Orbitals
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * count= [dice_range]
+        * distance= [dice_range]
+        * bodeDistanceStart= [dice_range]
+        * bodeDistanceEnd= [dice_range]
+        * angle= [dice_range]
+        * eccentricity= [dice_range]
+        * rotation= [dice_range]
+        * noOverlay= [boolean]
+        * exclusionRadius= [whole]
+        * scale= [scale_distance]
+      * 0|1+ Particles
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * name= [string]
+        * noWake= [boolean]
+        * radius= [whole]
+        * minRadius= [whole]
+        * dampening= [whole]
+        * damage= [string]
+        * count= [dice_range]
+        * 0|1 ImageDesc
+      * 0|1+ PlaceRandomStation
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * count= [dice_range]
+        * stationCriteria= [string]
+        * separateEnemies= [boolean]
+      * 0|1+ Primary
+        * debugOnly= [boolean]
+        * probability= [whole]
+      * 0|1+ RandomLocation
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * locationCriteria= [string]
+        * minDist= [whole]
+        * maxDist= [whole]
+        * percentFull= [whole]
+        * count= [dice_range]
+      * 0|1+ RandomStation
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * stationCriteria= [string]
+        * locationAttribs= [string]
+        * includeAll= [boolean]
+        * noSatellites= [boolean]
+        * showOrbit= [boolean]
+        * imageVariant= [whole]
+        * paintLayer= [paint_layer]
+        * objName= [string]
+        * noMapLabel= [boolean]
+        * noConstruction= [boolean]
+        * noReinforcements= [boolean]
+        * 0|1 Data
+        * 0|1 Satellites
+        * 0|1 Ships
+        * 0|1 OnCreate
+      * 0|1+ Ship
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * count= [dice_range]
+      * 0|1+ SpaceEnvironment
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * type= [type_space_environment]
+        * shape= [shape_space_environment]
+        * patches= [whole]
+        * patchFrequency= [whole]
+        * encountersCount= [dice_range]
+        * 1 Element from SystemGroup
+      * 0|1+ Stargate
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * objName= [string]
+      * 0|1+ Table
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * All subelements have **chance**
+      * 0|1+ Variant
+        * debugOnly= [boolean]
+        * probability= [whole]
+        * variant= [string]
+      * 0|1+ Variants
+        * debugOnly= [boolean]
+        * probability= [whole]
+      * 0|1+ VariantTable
+        * debugOnly= [boolean]
+        * probability= [whole]
 =====Overview=====
 <SystemType> defines a type of star system. The type describes the creation of a star system, including the random placement of planets and stations. In addition, a SystemType may have handle events while the player is in the system.
@@ Line 7: / Line 172: @@
 **UNID=** The [[UNID]] of the system type.
+**noExtraEncounters=** Some <StationType> encounters have a minimum number per game (by using the minAppearing= parameter). In those cases, we sometimes need to create stations in random systems, regardless of the <SystemType> directives. By setting noExtraEncounters="true" you are specifying that this system type should **not** get any of those stations. **[API Version 23+]**
+**noRandomEncounters=** If set to "true", this indicates that there should be no random patrols in the system.
+**spaceScale=** This sets the number of kilometers per pixel, or 1/24th the length of a light-second. By default, this is 12500. Setting this to other values will affect the way distances are shown in the game.
+**timeScale=** This sets the number of game seconds that pass each real-time second. By default, this is 60. Setting this to other values will speed up or slow down the in-game speed. However, certain stats such as weapon fire rates, projectile lifetimes, and ship rotations do not seem to be affected
 =====Creating a Star System=====
 To create a star system from a SystemType definition, the engine looks for the <SystemGroup> element in the SystemType.
@@ Line 78: / Line 250: @@
 ====<Offset>====
+Offset is a positional directive that alters a position either by Cartesian or polar coordinates. It defines a new circular orbit, centered on the original position and reaching out to the offset position.
+To specify a Cartesian offset, use the **xOffset** and **yOffset** parameters. The position will be adjusted by the given amount. The **scale** parameter is used to determine dimensions. For polar offsets, use the **angle** and **radius** parameters. [Note: You should not specify //both// sets of offset, but if you do, angle/radius will take precedence.]
+Any number of child directives may be inside an Offset directive; they will all be given the same orbit and position.
+The following parameters are supported:
+**angle=** The angle for the offset. This is valid only if a **radius** parameter is specified. The angle is specified in degrees.
+**count=** This is a [[dice range]] specifying the number of objects to create. If omitted we assume a count of 1. If there are multiple child directives, each is created in sequence until the count is reached.
+**radius=** The radius of the offset. You must specify an **angle** parameter.
+**scale=** This optional parameter specifies the scale to use for distance numbers. Defaults to "light-second".
+**xOffset=** This is a [[dice range]] specifying the offset distance along the x-axis.
+**yOffset=** This is a [[dice range]] specifying the offset distance along the y-axis.
 ====<Orbitals>====
@@ Line 130: / Line 321: @@
 ====<Variants>====
+There is more information for later versions in [[http://forums.kronosaur.com/viewtopic.php?f=5&t=6125#p55243|this post]].