| Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
| modding:xml:systemmap [2017/02/04 00:26] – [TopologyProcessor] 0xabcdef | modding:xml:systemmap [2017/02/04 00:35] – [TopologyProcessor] 0xabcdef |
|---|
| ===== TopologyProcessor ===== | ===== TopologyProcessor ===== |
| When the entire topology has been created, we iterate over all <TopologyProcessor> nodes in order and apply them to the topology. A TopologyProcessor is an element that can assign additional attributes to existing nodes and a SystemType to nodes that do not already have one. There can be multiple instances of a TopologyProcessor in a SystemMap. Additionally, TopologyProcessors are recursive in that the <Group> and <Processor> elements will act as TopologyProcessors of their own, using the nodes filtered by their parent. Any <System> element can have either an **attributes** attribute or a <Table> element containing multiple <System> subelements, each with their own **attributes** and **chance** attributes. | When the entire topology has been created, we iterate over all <TopologyProcessor> nodes in order and apply them to the topology. A TopologyProcessor is an element that can assign additional attributes to existing nodes and a SystemType to nodes that do not already have one. There can be multiple instances of a TopologyProcessor in a SystemMap. Additionally, TopologyProcessors are recursive in that the <Group> and <Processor> elements will act as TopologyProcessors of their own, using the nodes filtered by their parent. Any <System> element can have either an **attributes** attribute or a <Table> element containing multiple <System> subelements, each with their own **attributes** and **chance** attributes. |
| * One <Criteria> element to determine which nodes the processor applies to. The processor affects all nodes under its criteria. | * Zero or one <Criteria>. Determines which nodes the processor applies to. The processor affects all nodes under its criteria. If there is no <Criteria>, all nodes are affected. This applies to the <TopologyProcessor>, which will process every single node on the map. |
| * An <Attributes> element that filters nodes by their attributes | * An <Attributes> element that filters nodes by their attributes |
| * **criteria=** Contains the attributes to filter with. | * **criteria=** Contains the attributes to filter with. |
| * "+{attribute};" means that nodes must have {attribute}. "+systemType:0;" specifies nodes without a <SystemType> | * **"*"** specifies any node that already satisfies the parent criteria. |
| * "-{attribute};" means that nodes must not have {attribute} | * **"+{attribute};"** means that nodes must have {attribute}. "+systemType:0;" specifies nodes without a <SystemType> |
| * Zero or more <System> | * **"-{attribute};"** means that nodes must not have {attribute} |
| * **attributes=** | * Zero or one <System> |
| * Zero or more <Group>. They can process nodes that satisfy additional criteria | * **attributes=** The attributes to apply to the affected nodes. |
| * One <Criteria> | * Zero or more <Group>. Same as <TopologyProcessor>. |
| * **criteria=** | |
| * "+{attribute}" | |
| * "-{attribute}" | |
| * One <System> | |
| * One <Table> | |
| * One or more <System> | |
| * **chance=** | |
| * **unid=** | |
| * Zero or more <ConquerNodes>. In this processor category, "Conquerors" take turns attempting to "occupy" every eligible node. Each node can be taken by only one Conqueror. Every turn, a conqueror first attempts to create one new seed, then each of its seeds attempt to expand into adjacent nodes. | * Zero or more <ConquerNodes>. In this processor category, "Conquerors" take turns attempting to "occupy" every eligible node. Each node can be taken by only one Conqueror. Every turn, a conqueror first attempts to create one new seed, then each of its seeds attempt to expand into adjacent nodes. |
| * One or more <Conqueror> | * One or more <Conqueror> |
| * **weight=** The percent chance that a node will be conquered by the seed | * **weight=** The percent chance that a node will be conquered by the seed |
| * **successChance=** The percent chance that a conqueror will be successful in attempting to create a seed in a node. | * **successChance=** The percent chance that a conqueror will be successful in attempting to create a seed in a node. |
| * One <Processor>, which may act as a <TopologyProcessor> in its own((Please Verify)) | * One <Processor>. Same as <TopologyProcessor> |
| * One <System> | |
| * **attributes=** The attributes to add to the affected nodes | |
| * Zero or more <DistributeNodes> | * Zero or more <DistributeNodes> |
| * **nodeCount=** | * **nodeCount=** |
| * **nodeCount=** | * **nodeCount=** |
| * One <System> | * One <System> |
| * **attributes=** The attributes to add to the affected nodes | |
| * Zero or more <RandomPoints> | * Zero or more <RandomPoints> |
