Transcendence Community Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
=====Overview=====
A TemplateType is a DesignType that can be used to generate randomized, dynamic types. Unlike static types (which are defined in the same way in every single game), dynamic types can vary dramatically by game. For instance, the following template creates a weapon that shoots either positron, plasma or antimatter.
<code>
<TemplateType UNID="&itArchCannon;">
   <StaticData>
      <Template><![CDATA[
         <ItemType
			name=			"Arch's Cannon"
			level=			"12"
			value=			"700000"
			mass=			"12000"
			frequency=		"notRandom"
			attributes=		"MajorItem; Military; NotForSale"

		description=		"Many variations of the legendary Archenemy Blaster have existed over the years, but this is the only iteration that has not yet been lost to time."
            >
		<Weapon
				type=				"particles"
				damage=				"%damagetype%:350-500; WMD:4"
				
				fireRate=			"30"
				hitPoints=			"10"

				powerUse=			"4800"
				sound=				"&snRecoillessCannon;"
				>
			
			<ParticleSystem
					style=			"comet"
					emitLifetime=		"1"
					emitRate=		"100"
					emitSpeed=		"35-45"
					emitWidth=		"50"
					spreadAngle=		"3"
					
					particleLifetime=	"60"
					particleEffect=		"&efPlasmaParticleDefault;"
					>
			</ParticleSystem>
			
			<Effect>
				<ParticleSystem
						style=				"jet"
						fixedPos=			"true"
						emitRate=			"2-4"
						tangentSpeed=		"-8-8"
						particleLifetime=	"10"
						XformTime=			"30"
						>
					<ParticleEffect>
						<Orb
								instance=			"owner"
						
								style=				"smooth"
								animate=			"fade"
								radius=				"20"
								lifetime=			"10"
								intensity=			"20"
						
								blendMode=			"screen"
								primaryColor=		"#feff00"
								secondaryColor=		"#ff7f00"
								/>
					</ParticleEffect>
				</ParticleSystem>
			</Effect>
		</Weapon>
         </ItemType>
      ]]></Template>
   </StaticData>

   <Events>
      <GetTypeSource><![CDATA[
           (subst (typGetStaticData &itRandomWeapon; "Template")
              {
                 damagetype: (random (list "positron" "plasma" "antimatter"))
                 }
              )
      ]]></GetTypeSource>
   </Events>
</TemplateType>
</code>

TemplateType randomization can go further than that. For instance, the following code generates a laser weapon with three possible variations.
<code>
<TemplateType UNID="&itLaserRepeater;">
   <StaticData>
      <Template><![CDATA[
         <ItemType
		name=				"laser repeater"
		attributes=			"commonwealth, energyWeapon, majorItem"
			  
		level=				"1"
		frequency=			"common"

		value=				"380"
		mass=				"1000"

		description=			"The Moromisato Company often makes repeating versions of existing weapon designs. This weapon is based on the %name%."
            >
            %weapon%
         </ItemType>
      ]]></Template>
   </StaticData>

   <Events>
      <GetTypeSource><![CDATA[
     	 (block (
      			(weaponBase (random (list "Bolide laster blaster" "dual laser cannon" "fast-fire laser cannon")))
      			)
          	 (subst (typGetStaticData &itRandomWeapon; "Template") {
          	    	name: weaponBase
           		weapon: (@
              	  			(struct
              	  				"Bolide laser blaster"
                				"
						<Weapon
							type=				'beam'
							damage=				'laser:1d6'
							fireRate=			'10'
							lifetime=			'30'
							powerUse=			'20'

							repeating=			'3'		
	
							effect=				'&efLaserBeamDefault;'
							sound=				'&snLaserCannon;'
							>
						</Weapon>
						"
	
						"dual laser cannon"
						"
						<Weapon
							type=				'beam'		

							configuration=			'dual'
							damage=				'laser:1d4'
							fireRate=			'10'
							lifetime=			'30'
							powerUse=			'30'

							repeating=			'2'

							effect=				'&efLaserBeamDefault;'
							sound=				'&snLaserCannon;'
							>
						</Weapon>
						"

						"fast-fire laser cannon"
						"
						<Weapon
							type=				'beam'

							damage=				'laser:1d4'
							fireRate=			'6'
							lifetime=			'30'
							powerUse=			'30'
	
							repeating=			'4'

							effect=				'&efLaserBeamDefault;'
							sound=				'&snLaserCannon;'
							>
						</Weapon>
						"
                				)
                              		weaponBase
                 			)
                 	}
             	)
      ]]></GetTypeSource>
   </Events>
</TemplateType>
</code>

The CDATA block escapes the angle brackets and the elements use apostrophes rather than quotation marks to avoid string problems. The event <GetTypeSource> returns the entire XML that will be used to define the resulting type.

=====References=====
[[https://forums.kronosaur.com/viewtopic.php?p=44626#p44626|Forum post discussing implementation plan]]
  * [[http://forums.kronosaur.com/viewtopic.php?p=45046#p45046|<GetTypeSource> used to be called <OnEval>]]