Behavior element behavior adding force field support.

Behavior adds a ForceField resource to the the behavior element. Force fields apply physical forces to physical elements in the game world if their collision filter to match.

If the ECBehaviorCollider behavior is present in the behavior element before this behavior is added the force field is attached. The force field is attached to the named bone if defined otherwise it is attached statically.

This behavior can be used multiple times on an element to add multiple force fields to mainpulate. Use the behavior identifier to tell them apart.

Element class properties have the prefix forceField. or forceField({id}). if id is not empty.

Set influence area. Geometry touching this shape is affected by this force field.

• Full name: forceField.influenceArea or forceField({id}).influenceArea
• Type: string (shape format). See “Shape List Encoding” in CodecPropertyString.
• Default Value: empty string
• Example (*.deeclass)

  <string name='forceField.influenceArea'>box:position,0,0.5,0:extends,2,1,0.5</string>

Set falloff radius. Geometry inside this distance from the border is faded out gradually.

• Full name: forceField.radius or forceField({id}).radius
• Type: float
• Default Value: 1
• Restriction: At least 0
• Example (*.deeclass)

  <float name='forceField.radius'>2</float>

Set falloff exponent. Shape of the fading out applied due to radius. Value of 1 represents linear fading. Values less than 1 fade of stronger near the border. Values greater than 1 fade of stronger near the inner border.

• Full name: forceField.exponent or forceField({id}).exponent
• Type: float
• Default Value: 1
• Restriction: At least 0
• Example (*.deeclass)

  <float name='forceField.exponent'>0.5</float>

Set field type.

• Full name: forceField.fieldType or forceField({id}).fieldType
• Type: enumeration

• Allowed Values:

  Value	Description
  radial	Force is applied radial from the center.
  linear	Force is applied along the force direction.
  vortex	Force is applied vortex like swirling around.

• Default Value: radial
• Example (*.deeclass)

  <string name='forceField.fieldType'>linear</string>

Set force application type.

• Full name: forceField.applicationType or forceField({id}).applicationType
• Type: enumeration

• Allowed Values:

  Value	Description
  direct	Apply force equally to all elements independend of shape.
  surface	Apply force on exposed surface area.
  mass	Apply force on mass.
  speed	Apply force relative to speed of element.

• Default Value: direct
• Example (*.deeclass)

  <string name='forceField.applicationType'>mass</string>

Set force direction.

• Full name: forceField.direction or forceField({id}).direction
• Type: 3-component float vector
• Default Value: (0,0,0)
• Example (*.deeclass)

  <vector name='forceField.direction' x='0' y='1' z='0'/>

Set force in newton. Negative force reverse direction.

• Full name: forceField.force or forceField({id}).force
• Type: float
• Default Value: 1
• Example (*.deeclass)

  <float name='forceField.force'>50</float>

Set fluctuation of direction in degrees.

• Full name: forceField.fluctuationDirection or forceField({id}).fluctuationDirection
• Type: float
• Default Value: 0
• Example (*.deeclass)

  <float name='forceField.fluctuationDirection'>45</float>

Set force in newton. Negative force reverse direction.

• Full name: forceField.fluctuationForce or forceField({id}).fluctuationForce
• Type: float
• Default Value: 0
• Example (*.deeclass)

  <float name='forceField.fluctuationForce'>20</float>

Set force field enabled.

• Full name: forceField.enabled or forceField({id}).enabled
• Type: boolean
• Default Value: true
• Example (*.deeclass)

  <boolean name='forceField.enabled'>false</boolean>

Set shape from which the force originates. If not set force originates from origin position.

• Full name: forceField.shape or forceField({id}).shape
• Type: string (shape format). See “Shape List Encoding” in CodecPropertyString.
• Default Value: empty string
• Example (*.deeclass)

  <string name='forceField.shape'>box:position,0,0.5,0:extends,2,1,0.5</string>

Set position to attach resource to collider.

• Full name: forceField.position or forceField({id}).position
• Type: 3-component float vector
• Default Value: (0,0,0)
• Example (*.deeclass)

  <vector name='forceField.position' x='0' y='0' z='0.1'/>

Set orientation to attach resource to collider in degrees.

• Full name: forceField.orientation or forceField({id}).orientation
• Type: 3-component float vector
• Default Value: (0,0,0)
• Example (*.deeclass)

  <vector name='forceField.orientation' x='30' y='0' z='0'/>

Set bone to attach resource to. If empty string attach to collider.

• Full name: forceField.bone or forceField({id}).bone
• Type: string
• Default Value: empty string
• Example (*.deeclass)

  <string name='forceField.bone'>attach</string>

Set trigger enabling force field. If no trigger is set the state of enabled property is used.

• Full name: forceField.trigger or forceField({id}).trigger
• Type: string
• Default Value: state of enabled
• Example (*.deeclass)

  <string name='forceField.trigger'>@switchOnVent & @powerEnabled</string>

This behavior supports these events:

Force field has been enabled.

Force field has been disabled.

Force field parameters changed.

This behavior adds these behavior tree actions if behavior tree is present. If behavior has non-empty identifier replace forceField with forceField(id).

Set one or more force field parameters.

This is an example of using this action:

<action name='forceField.set'>
  <parameter name='enabled'>true</parameter>
</action>

Check one or more force field parameters. Action succeeds if all parameter value matches their respective force field parameter otherwise action fails. This action is typically used as first action in a sequence to run the sequence only if a force field parameter matches (or not).

This is an example of using this action:

<sequence>
  <action name='forceField.check'>
    <parameter name='enabled'>true</parameter>
  </action>
  <!-- actions here run only if force field is enabled -->
</sequence>

This behavior adds these behavior tree conditions if behavior tree is present. If behavior has non-empty identifier replace forceField with forceField(id).

Check one or more force field parameters. Conditions returns true if all parameter value match their respective force field parameter. This condition is typically used to run an action or sequence of actions as long as force field conditions are true.

This is an example of using this condition:

<action name='myAction' id='doing something'>
  <parameter name='forceField.enabled'>true</parameter>
  <condition>forceField.check</condition>
</action>

Same as Behavior Tree Actions.

Same as Behavior Tree Conditions.

This behavior sends these state machine events. If behavior has non-empty identifier replace forceField with forceField(id).

Force field has been enabled.

Force field has been disabled.

This behavior requires no other behaviors.

• ECBehaviorCollider: Attach force field to collider.
• ECBehaviorBehaviorTree: Add actions and conditions for behavior trees to use.
• ECBehaviorStateMachine: Add actions and conditions for state machine to use and events to send to the state machine.

This behavior does support element class to be persistable (setPersistable). Saves these states:

• enabled

ECBehaviorForceField.

Since DragonScript Module Version 1.0

• Allow element to apply physical forces to other elements using a force field.

This example defines an element which contains a force field.

class MyElement extends BehaviorElementClass
  public var ECBehaviorCollider collider
  public var ECBehaviorForceField forceField
  func new()
    collider = ECBehaviorCollider.new(this, null)
    forceField = ECBehaviorForceField.new(this, collider)
    forceField.getForceField().getForce().setValue(50)
    forceField.getAttach().getPosition().setVector(Vector.new(0, 0, 0.3))
  end
end

Using element class supporting adding behaviors the behavior can be added like this:

<?xml version='1.0' encoding='UTF-8'?>
<elementClass name='MyClass' class='GenericBehaviorElement'>
  <behavior type='ECBehaviorCollider'/>
 
  <behavior type='ECBehaviorForceField'>
    <!-- optional: set collision filter. default value '6:0 1 2 3 5' which means
                   category BaseGameApp.CollisionFilterBit.forceField
                   filter BaseGameApp.CollisionFilterBit.geometry,
                          BaseGameApp.CollisionFilterBit.dynamic,
                          BaseGameApp.CollisionFilterBit.actor,
                          BaseGameApp.CollisionFilterBit.actorAI,
                          BaseGameApp.CollisionFilterBit.particle.
                   format is '', 'category' or 'category:filter' where category and filter
                   are a list of bits to set. -->
    <string name='collisionFilter'>6:0 1 2 3 5</string>
 
    <!-- optional: use BaseGameApp trigger table. game can add more
                   supported values. default value is 'default' -->
    <string name='triggerTable'>default</string>
 
    <!-- optional: sync trigger with force field matching identifier -->
    <string name='syncTrigger'>second</string>
 
    <!-- optional: identifier of ECBehaviorTriggered to synchronize with or empty
                   string to not synchronize. default is empty string. -->
    <string name='trigger.synchronize'>other</string>
 
    <!-- optional: add behavior trees. default adds all behavior trees. -->
    <list name='behaviorTrees'>
      <string/> <!-- add behavior with empty identifier -->
      <string>default</string> <!-- add behavior with 'default' identifier -->
    </list>
 
    <!-- optional: add state machines. default adds all state machines. -->
    <list name='stateMachines'>
      <string/> <!-- add behavior with empty identifier -->
      <string>default</string> <!-- add behavior with 'default' identifier -->
    </list>
 
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <float name='.force'>50</float>
  </behavior>
 
  <!-- for adding multiple behaviors use unique identifiers -->
  <behavior type='ECBehaviorForceField' id='second'/>
</elementClass>

• DEExamples Repository