@inglorious/engine 0.1.0

package/src/docs/ai/movement/dynamic/flee.js

@@ -0,0 +1,38 @@
+import flee from "@inglorious/engine/ai/movement/dynamic/flee.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+
+export default {
+  types: {
+    mouse: [enableMouse()],
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+
+          merge(instance, flee(instance, target, { dt }))
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+    },
+
+    character: {
+      type: "character",
+      maxAcceleration: 1000,
+      maxSpeed: 250,
+      position: [400, 0, 300],
+    },
+  },
+}

package/src/docs/ai/movement/dynamic/look-where-youre-going.js

@@ -0,0 +1,114 @@
+import {
+  DEFAULT_SLOW_RADIUS,
+  DEFAULT_TARGET_RADIUS,
+  DEFAULT_TIME_TO_TARGET,
+} from "@inglorious/engine/ai/movement/dynamic/align.js"
+import lookWhereYoureGoing from "@inglorious/engine/ai/movement/dynamic/look-where-youre-going.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import {
+  createControls,
+  enableControls,
+} from "@inglorious/game/decorators/input/controls.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+import { sum } from "@inglorious/utils/math/linear-algebra/vectors.js"
+import { pi } from "@inglorious/utils/math/trigonometry.js"
+
+export default {
+  types: {
+    ...enableControls(),
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const { fields } = instances.parameters.groups.lookWhereYoureGoing
+
+          const { input0 } = instances
+
+          const target = { velocity: [0, 0, 0] }
+          if (input0.left) {
+            target.velocity[0] = -1
+          }
+          if (input0.down) {
+            target.velocity[2] = -1
+          }
+          if (input0.right) {
+            target.velocity[0] = 1
+          }
+          if (input0.up) {
+            target.velocity[2] = 1
+          }
+
+          merge(instance, {
+            velocity: target.velocity,
+            position: sum(instance.position, target.velocity),
+          })
+
+          merge(
+            instance,
+            lookWhereYoureGoing(instance, {
+              dt,
+              targetRadius: fields.targetRadius.value,
+              slowRadius: fields.slowRadius.value,
+              timeToTarget: fields.timeToTarget.value,
+            }),
+          )
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.lookWhereYoureGoing.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    ...createControls("input0", {
+      ArrowLeft: "left",
+      ArrowRight: "right",
+      ArrowDown: "down",
+      ArrowUp: "up",
+    }),
+
+    character: {
+      type: "character",
+      maxAngularAcceleration: 1000,
+      maxAngularSpeed: pi() / 4,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 328, 0, 600],
+      groups: {
+        lookWhereYoureGoing: {
+          title: "Look Where You're Going",
+          fields: {
+            targetRadius: {
+              label: "Target Radius",
+              inputType: "number",
+              defaultValue: DEFAULT_TARGET_RADIUS,
+            },
+            slowRadius: {
+              label: "Slow Radius",
+              inputType: "number",
+              defaultValue: DEFAULT_SLOW_RADIUS,
+            },
+            timeToTarget: {
+              label: "Time To Target",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TIME_TO_TARGET,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/dynamic/match-velocity.js

@@ -0,0 +1,92 @@
+import matchVelocity, {
+  DEFAULT_TIME_TO_TARGET,
+} from "@inglorious/engine/ai/movement/dynamic/match-velocity.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import {
+  createControls,
+  enableControls,
+} from "@inglorious/game/decorators/input/controls.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+
+export default {
+  types: {
+    ...enableControls(),
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, options) {
+          const { parameters, input0, game } = options.instances
+          const { fields } = parameters.groups.matchVelocity
+          const SPEED = instance.maxSpeed
+
+          const target = { velocity: [0, 0, 0] }
+          if (input0.left) {
+            target.velocity[0] = -SPEED
+          }
+          if (input0.down) {
+            target.velocity[2] = -SPEED
+          }
+          if (input0.right) {
+            target.velocity[0] = SPEED
+          }
+          if (input0.up) {
+            target.velocity[2] = SPEED
+          }
+
+          merge(
+            instance,
+            matchVelocity(instance, target, {
+              dt: options.dt,
+              timeToTarget: fields.timeToTarget.value,
+            }),
+          )
+
+          clampToBounds(instance, game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.matchVelocity.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    ...createControls("input0", {
+      ArrowLeft: "left",
+      ArrowRight: "right",
+      ArrowDown: "down",
+      ArrowUp: "up",
+    }),
+
+    character: {
+      type: "character",
+      maxAcceleration: 1000,
+      maxSpeed: 250,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 328, 0, 600],
+      groups: {
+        matchVelocity: {
+          title: "Match Velocity",
+          fields: {
+            timeToTarget: {
+              label: "Time To Target",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TIME_TO_TARGET,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/dynamic/pursue.js

@@ -0,0 +1,72 @@
+import pursue, {
+  DEFAULT_MAX_PREDICTION,
+} from "@inglorious/engine/ai/movement/dynamic/pursue.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+
+export default {
+  types: {
+    mouse: [enableMouse()],
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+          const { fields } = instances.parameters.groups.pursue
+
+          merge(
+            instance,
+            pursue(instance, target, {
+              dt,
+              maxPrediction: fields.maxPrediction.value,
+            }),
+          )
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.pursue.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+      velocity: [0, 0, 0],
+    },
+
+    character: {
+      type: "character",
+      maxAcceleration: 1000,
+      maxSpeed: 250,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 343, 0, 600],
+      groups: {
+        pursue: {
+          title: "Pursue",
+          fields: {
+            maxPrediction: {
+              label: "Max Prediction",
+              inputType: "number",
+              defaultValue: DEFAULT_MAX_PREDICTION,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/dynamic/seek.js

@@ -0,0 +1,37 @@
+import seek from "@inglorious/engine/ai/movement/dynamic/seek.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+
+export default {
+  types: {
+    mouse: [enableMouse()],
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+
+          merge(instance, seek(instance, target, { dt }))
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+    },
+
+    character: {
+      type: "character",
+      maxAcceleration: 1000,
+      maxSpeed: 250,
+      position: [400, 0, 300],
+    },
+  },
+}

package/src/docs/ai/movement/dynamic/wander.js

@@ -0,0 +1,71 @@
+import wander, {
+  DEFAULT_WANDER_OFFSET,
+  DEFAULT_WANDER_RADIUS,
+} from "@inglorious/engine/ai/movement/dynamic/wander.js"
+import { flip } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+import { pi } from "@inglorious/utils/math/trigonometry.js"
+
+export default {
+  types: {
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const { fields } = instances.parameters.groups.wander
+
+          merge(
+            instance,
+            wander(instance, {
+              dt,
+              wanderOffset: fields.wanderOffset.value,
+              wanderRadius: fields.wanderRadius.value,
+            }),
+          )
+          flip(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.wander.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    character: {
+      type: "character",
+      maxAcceleration: 1000,
+      maxSpeed: 250,
+      maxAngularSpeed: pi() / 4,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 352, 0, 600],
+      groups: {
+        wander: {
+          title: "Dynamic Wander",
+          fields: {
+            wanderOffset: {
+              label: "Wander Offset",
+              inputType: "number",
+              defaultValue: DEFAULT_WANDER_OFFSET,
+            },
+            wanderRadius: {
+              label: "Wander Radius",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_WANDER_RADIUS,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/kinematic/align.js

@@ -0,0 +1,122 @@
+import align, {
+  DEFAULT_TARGET_RADIUS,
+  DEFAULT_TIME_TO_TARGET,
+} from "@inglorious/engine/ai/movement/kinematic/align.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import {
+  createControls,
+  enableControls,
+} from "@inglorious/game/decorators/input/controls.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+import { clamp } from "@inglorious/utils/math/numbers.js"
+import { pi } from "@inglorious/utils/math/trigonometry.js"
+
+export default {
+  types: {
+    mouse: [
+      enableMouse(),
+      {
+        "field:change"(instance, event) {
+          const { id, value } = event.payload
+          if (id === "targetOrientation") {
+            instance.orientation = -value * pi()
+          }
+        },
+
+        "game:update"(instance, event, options) {
+          const { input0 } = options.instances
+
+          if (input0.left || input0.up) {
+            instance.orientation += 0.1
+          } else if (input0.right || input0.down) {
+            instance.orientation -= 0.1
+          }
+          instance.orientation = clamp(instance.orientation, -pi(), pi())
+        },
+      },
+    ],
+
+    ...enableControls(),
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+          const { fields } = instances.parameters.groups.align
+
+          merge(
+            instance,
+            align(instance, target, {
+              dt,
+              targetRadius: fields.targetRadius.value,
+              timeToTarget: fields.timeToTarget.value,
+            }),
+          )
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.align.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+      orientation: 0,
+    },
+    ...createControls("input0", {
+      ArrowLeft: "left",
+      ArrowRight: "right",
+      ArrowDown: "down",
+      ArrowUp: "up",
+    }),
+
+    character: {
+      type: "character",
+      maxAngularSpeed: pi() / 4,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 328, 0, 600],
+      groups: {
+        align: {
+          title: "Kinematic Align",
+          fields: {
+            targetRadius: {
+              label: "Target Radius",
+              inputType: "number",
+              defaultValue: DEFAULT_TARGET_RADIUS,
+            },
+            timeToTarget: {
+              label: "Time To Target",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TIME_TO_TARGET,
+            },
+            targetOrientation: {
+              label: "Target Orientation",
+              inputType: "number",
+              step: 0.25,
+              min: -1,
+              max: 1,
+              defaultValue: 0,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/kinematic/arrive.js

@@ -0,0 +1,78 @@
+import arrive, {
+  DEFAULT_TARGET_RADIUS,
+  DEFAULT_TIME_TO_TARGET,
+} from "@inglorious/engine/ai/movement/kinematic/arrive.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+
+export default {
+  types: {
+    mouse: [enableMouse()],
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+          const { fields } = instances.parameters.groups.arrive
+
+          merge(
+            instance,
+            arrive(instance, target, {
+              dt,
+              targetRadius: fields.targetRadius.value,
+              timeToTarget: fields.timeToTarget.value,
+            }),
+          )
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.arrive.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+    },
+
+    character: {
+      type: "character",
+      maxSpeed: 250,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 328, 0, 600],
+      groups: {
+        arrive: {
+          title: "Kinematic Arrive",
+          fields: {
+            targetRadius: {
+              label: "Target Radius",
+              inputType: "number",
+              defaultValue: DEFAULT_TARGET_RADIUS,
+            },
+            timeToTarget: {
+              label: "Time To Target",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TIME_TO_TARGET,
+            },
+          },
+        },
+      },
+    },
+  },
+}

package/src/docs/ai/movement/kinematic/face.js

@@ -0,0 +1,82 @@
+import {
+  DEFAULT_TARGET_RADIUS,
+  DEFAULT_TIME_TO_TARGET,
+} from "@inglorious/engine/ai/movement/kinematic/align.js"
+import face from "@inglorious/engine/ai/movement/kinematic/face.js"
+import { clampToBounds } from "@inglorious/game/bounds.js"
+import { enableCharacter } from "@inglorious/game/decorators/character.js"
+import { enableMouse } from "@inglorious/game/decorators/input/mouse.js"
+import { merge } from "@inglorious/utils/data-structures/objects.js"
+import { pi } from "@inglorious/utils/math/trigonometry.js"
+
+export default {
+  types: {
+    mouse: [enableMouse()],
+
+    character: [
+      enableCharacter(),
+      {
+        "game:update"(instance, event, { dt, instances }) {
+          const target = instances.mouse
+          const { fields } = instances.parameters.groups.face
+
+          merge(
+            instance,
+            face(instance, target, {
+              dt,
+              targetRadius: fields.targetRadius.value,
+              timeToTarget: fields.timeToTarget.value,
+            }),
+          )
+
+          clampToBounds(instance, instances.game.bounds)
+        },
+      },
+    ],
+
+    form: {
+      "field:change"(instance, event) {
+        const { id, value } = event.payload
+        instance.groups.face.fields[id].value = value
+      },
+    },
+  },
+
+  instances: {
+    mouse: {
+      type: "mouse",
+      position: [400, 0, 300],
+    },
+
+    character: {
+      type: "character",
+      maxAngularSpeed: pi() / 4,
+      maxAngularAcceleration: 1000,
+      position: [400, 0, 300],
+    },
+
+    parameters: {
+      type: "form",
+      position: [800 - 328, 0, 600],
+      groups: {
+        face: {
+          title: "Face",
+          fields: {
+            targetRadius: {
+              label: "Target Radius",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TARGET_RADIUS,
+            },
+            timeToTarget: {
+              label: "Time To Target",
+              inputType: "number",
+              step: 0.1,
+              defaultValue: DEFAULT_TIME_TO_TARGET,
+            },
+          },
+        },
+      },
+    },
+  },
+}