Changes between Version 70 and Version 71 of content/LevelHowTo

Timestamp:

Nov 3, 2015, 11:46:16 PM (9 years ago)

Author:

fvultier

Comment:

—

content/LevelHowTo

@@ -357 +357 @@
 </SpaceShip>
 }}}
+
+== Pawn ==
+If an object in your level should have health and be killable you need the Pawn class. Pawns can have a weapon system, can have a shield and if you shoot at them they'll die if their health is reduced to zero.
+{{{
+#!xml
+<Pawn team=1 health=30 shieldhealth=130 initialshieldhealth=130 maxshieldhealth=150 shieldabsorption=0.95 position="0,300,0" direction="0,-1,0" collisionType=dynamic mass=100000 name=box>
+    <attached>
+        <Model position="0,0,0" mesh="crate.mesh" scale3D="3,3,3" />
+    </attached>
+    <collisionShapes>
+        <BoxCollisionShape position="0,0,0" halfExtents="15,15,15" />
+    </collisionShapes>
+</Pawn>
+}}}
+Pawn interits from ControllableEntity.
 
 == [http://www.orxonox.net/doxygen/classorxonox_1_1_pickup_spawner.html Pickups]  ==
@@ -635 +650 @@
 {{{
 #!xml
-<Backlight position="0,0,0" visible=true frequency=0.6 amplitude=3 material="Flares/lensflare" colour="1,1,0.05"/>
-<DistanceTrigger name="flying1" position="0,0,0" target="Pawn" distance=10 stayActive="true" delay=2/>
-
-<SimpleNotification message="Let's fly to the blinking light." broadcast="true">
+<Backlight position="0,0,0" visible=true frequency=0.6 amplitude=3 material="Flares/lensflare" colour="1,0,0"/>
+<SimpleNotification message="Red Backlight." broadcast="true">
+  <events>
+    <trigger>
+      <DistanceTrigger position="0,0,0" target="ControllableEntity" distance=25 stayActive="true"/>
+    </trigger>
+  </events>
+</SimpleNotification>
+}}}
+'''DistanceTriggers''' are activated, when the target (e.g. a pawn, a spaceship, ...) is close enough to the distance trigger (defined via "'''distance'''"). The '''stayActive''' attribute keeps the switch activated once triggered - the event can only be created once.
+In the next example the DistanceTrigger ist no more placed inside the SimpleNotification. Instead it ist placed outside and a EventListerner is placed inside.
+{{{
+#!xml
+<Backlight position="0,200,0" visible=true frequency=0.6 amplitude=3 material="Flares/lensflare" colour="0,0,1"/>
+<DistanceTrigger name="flying1" position="0,200,0" target="Pawn" distance=10 stayActive="true" delay=2/>
+<SimpleNotification message="Blue Backlight." broadcast="true">
     <events>
        <trigger>
@@ -646 +673 @@
 </SimpleNotification>
 }}}
-'''DistanceTriggers''' are activated, when the target (e.g. a pawn, a spaceship, ...) is close enough to the distance trigger (defined via "'''distance'''"). The '''stayActive''' attribute keeps the switch activated once triggered - the event can only be created once. The name '''flying1''' is needed in order to catch the event, when the trigger was activated. The '''SimpleNotification''' is sent to the player when the trigger is activated. Note that the trigger is activated with a delay of 2 seconds.
+The name '''flying1''' is needed in order to catch the event, when the trigger was activated. The '''SimpleNotification''' is sent to the player when the trigger is activated. Note that the trigger is activated with a delay of 2 seconds.
+The EventListener provides an 1:n mapping between one listener and multiple event-sources. In the next example any of the two event listeners will show the simple notification:
+{{{
+#!xml
+<Backlight position="0,400,100" visible=true frequency=0.6 amplitude=3 material="Flares/lensflare" colour="0,1,0"/>
+<Backlight position="0,400,-100" visible=true frequency=0.6 amplitude=3 material="Flares/lensflare" colour="0,1,0"/>
+<DistanceTrigger name="flying2" position="0,400,-100" distance=25 target="ControllableEntity" />
+<DistanceTrigger name="flying2" position="0,400,100" distance=25 target="ControllableEntity" />
+<SimpleNotification message="Green Backlight." broadcast="true">
+  <events>
+    <trigger>
+      <EventListener event="flying2" />
+    </trigger>
+  </events>
+</SimpleNotification>
+}}}
 The problem of distance triggers is that you have to rely on that the player is actually activating it as intended. Try to attract the player by using bliking billboards, pickups to reward the player, ... and make the radius large enough such that the player can hardly miss it.
 Another problem might be that the distance trigger is triggered by another Pawn/Spaceship/... (whatever is specified as target). To exclude certain objects to activate the trigger or to only allow a specific object to activate the trigger, the '''DistanceTriggerBeacon''' was created: