Changes between Version 74 and Version 75 of content/LevelHowTo

Timestamp:

Dec 2, 2015, 8:43:05 PM (9 years ago)

Author:

fvultier

Comment:

—

content/LevelHowTo

@@ -260 +260 @@
 }}}
 In this example the static entity has five collision shapes. Flying into any of these will cause a collision detected by the physics engine.
+
+== Collision types ==
+In Orxonox there are four collision types: static, kinematic, dynamic, none
+
+Depending on the collision type of a WorldEntity it will in a different way to a collision with an other WorldEntity.
+
+In the next example there is a StaticEntity with a model and a collision shape. If you try to push away the box with a spaceship you will fail. This is because a WorldEntity with collision type "static" will never react to collisions with other WorldEntities. It will stay at the same position forever.
+{{{
+#!xml
+<Model position="0,0,0" mesh="cube.mesh" scale3D="10000,1,1" />
+
+<StaticEntity position="0,0,0" collisionType=static mass=10000>
+  <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>
+</StaticEntity>
+}}}
+
+In the following example we changed the collision type to "kinematic" and replaced the StaticEntity by a MovableEntity. It is still impossible to push away the box with the spaceship, but the moving box is able to push the spaceship.
+
+{{{
+#!xml
+<Model position="0,0,0" mesh="cube.mesh" scale3D="10000,1,1" />
+
+<MovableEntity position="0,0,0" velocity="20,0,0" collisionType=kinematic mass=10000>
+  <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>
+</MovableEntity>
+}}}
+
+To make it possible that the box may be pushed by the spaceship and the spaceship may be pushed by the box we need to change the collision type to "dynamic":
+
+{{{
+#!xml
+<Model position="0,0,0" mesh="cube.mesh" scale3D="10000,1,1" />
+
+<MovableEntity position="0,0,0" velocity="20,0,0" collisionType=dynamic mass=10000>
+  <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>
+</MovableEntity>
+}}}
+
+To completely deactivate the physics of a WorldEntity set the collision type to "none".
+
+A WorldEntity with the collision type "dynamic" may have damping parameters:
+{{{
+#!xml
+<MovableEntity position="0,-100,0" velocity="0,50,0" rotationaxis="0,1,0" rotationrate=1000 collisionType=dynamic lineardamping=0.1 angularDamping=0.01 mass=10000>
+  <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>
+</MovableEntity>
+}}}
+Since the linear damping is large the box will stop the linear movement after a few seconds. The low angular damping decreases the angluar velocity only slowly.
+
+Not every collision type is legal for every WorldEntity. The following table gives an overview over the legal collision types of common WorldEntities:
+|| || '''StaticEntity''' || '''MovableEntity, ControllableEntity, Pawn''' || '''Spaceship'''||
+||'''dynamic'''|| ||X||X||
+||'''kinematic'''|| ||X|| ||
+||'''static'''||X|| || ||
+||'''none'''||X||X|| ||
+
 == Spawnpoints ==
 A Spawnpoint is the '''entrance point''' for controllable entities (spaceships). Without a spawnpoint no level can work!
@@ -269 +345 @@
 || '''pawndesign''' || '''include()''' || '''additional information'''||
 ||spaceshipassff||"templates/spaceshipAssff.oxt"||default spaceship - equipped with rockets||
+||spaceshipescort||"templates/spaceshipEscort.oxt"||small spaceship with only weak laser weapons||
 ||spaceshippirate||"templates/spaceshipPirate.oxt"||Spaceship used by pirates||
 ||spaceshipswallow||"templates/spaceshipSwallow.oxt"||fast, nice design||