Differences

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

--- modding:xml:adventuredesc [2012/09/23 21:29] – rpc
+++ modding:xml:adventuredesc [2013/01/09 00:29] – gpm
@@ Line 2: / Line 2: @@
 <AdventureDesc> defines the properties and behavior of an adventure. \\
 \\
-[[http://neurohack.com/transcendence/forums/viewtopic.php?f=5&t=5400#p49424|include10StartingShips tag]]
+=====Starting Ship Classes=====
+An adventure has some control over the set of starting ship classes to offer the player and the location (the star system) where the player will start the game. The following properties are available:
+**startingShipCriteria=** This property is a [[type criteria]] that selects the set of ship classes to offer the player at the beginning of the game. If omitted, all ship classes are available.
+**include10StartingShips=** This property is used for backwards compatibility with version 1.0 of the game. If set to **true** the adventure will offer player ship classes that //do not// match the **startingShipCriteria** property if and only if the player ship class is defined in an extension of apiVersion < 12.
+See: [[http://neurohack.com/transcendence/forums/viewtopic.php?f=5&t=5400#p49424|include10StartingShips tag]]
+**startingMap=** **[Version 1.2+]** If defined, this property specifies the UNID of the default [[<SystemMap>]] to use for the player. This property is used in conjunction with the **startingMap=** property on a SystemMap.
+Normally, all SystemMaps are automatically loaded at the beginning of the game. If, however, you wish to change the topology based on which player ship class is chosen, you may use the following technique:
+If a player ship class defines a **startingMap=** property, then the given map is loaded; otherwise, if the AdventureDesc defines a **startingMap=** property, then that map is loaded. No other SystemMap with the **startingMap="true"** property is loaded, however.
+**startingSystem=** If defined, this property specifies the nodeID of the system where the player should start.
+**startingPos=** If defined, this property specified a named object where the player should start.
 =====Constants=====