@hytopia.com/examples 1.0.2 → 1.0.4

package/frontiers-rpg-game/src/entities/BaseProjectileEntity.ts

@@ -0,0 +1,73 @@
+import {
+  BlockType,
+  Collider,
+  Entity,
+  EntityOptions,
+  RigidBodyType,
+  Vector3Like,
+} from 'hytopia';
+import { isDamageable } from '../interfaces/IDamageable';
+
+export type BaseProjectileEntityOptions = {
+  damage: number;
+  despawnAfterMs: number;
+  direction: Vector3Like;
+  gravityScale?: number;
+  source: Entity;
+  speed: number;
+} & EntityOptions;
+
+export default class BaseProjectileEntity extends Entity {
+  public readonly damage: number;
+  public readonly direction: Vector3Like;
+  public readonly source: Entity;
+  public readonly speed: number;
+  private _despawnTimeout: NodeJS.Timeout | undefined;
+
+  constructor(options: BaseProjectileEntityOptions) {
+    const { damage, direction, source, speed, ...rest } = options;
+    
+    super({
+      ...rest,
+      rigidBodyOptions: {
+        type: RigidBodyType.DYNAMIC,
+        gravityScale: options.gravityScale ?? 1,
+        linearVelocity: {
+          x: direction.x * speed,
+          y: direction.y * speed,
+          z: direction.z * speed,
+        },
+        colliders: [
+          {
+            ...Collider.optionsFromModelUri('models/projectiles/arrow.gltf'),
+            isSensor: true,
+            onCollision: (other, started) => this.onCollision(other, started),
+          }
+        ],
+      }
+    });
+
+    this.damage = damage;
+    this.direction = direction;
+    this.source = source;
+    this.speed = speed;
+
+    this._despawnTimeout = setTimeout(this.safeDespawn, options.despawnAfterMs);
+  }
+
+  protected safeDespawn = (): void => {
+    if (!this.isSpawned) return;
+    this.despawn();
+  }
+
+  protected onCollision = (other: BlockType | Entity, started: boolean) => {
+    if (!started || other === this.source) return;
+    
+    if (isDamageable(other)) {
+      other.takeDamage(this.damage);
+    }
+
+    clearTimeout(this._despawnTimeout);
+    this.safeDespawn();
+  }
+}

package/frontiers-rpg-game/src/entities/PortalEntity.ts

@@ -0,0 +1,66 @@
+import {
+  BlockColliderOptions,
+  Collider,
+  ColliderShape,
+  Entity,
+  ErrorHandler,
+  ModelEntityOptions,
+  QuaternionLike,
+  RigidBodyType,
+  Vector3Like
+} from 'hytopia';
+
+import GameManager from '../GameManager';
+import GamePlayerEntity from '../GamePlayerEntity';
+
+export type PortalEntityOptions = {
+  destinationRegionId: string;
+  destinationRegionFacingAngle?: number;
+  destinationRegionPosition: Vector3Like;
+} & ModelEntityOptions;
+
+export default class PortalEntity extends Entity {
+  public readonly destinationRegionId: string;
+  public readonly destinationRegionFacingAngle: number;
+  public readonly destinationRegionPosition: Vector3Like;
+
+  public constructor(options: PortalEntityOptions) {
+    const colliderOptions = Collider.optionsFromModelUri('models/environment/portal.gltf', options.modelScale ?? 1, ColliderShape.BLOCK) as BlockColliderOptions;
+    colliderOptions.halfExtents!.x = Math.max(colliderOptions.halfExtents!.x, 0.5);
+
+    super({
+      modelScale: 2,
+      modelUri: 'models/environment/portal.gltf',
+      modelLoopedAnimations: [ 'idle' ],
+      rigidBodyOptions: {
+        type: RigidBodyType.FIXED,
+        colliders: [
+          {
+            ...colliderOptions,
+            relativePosition: { x: 0, y: 0, z: 0.5 }, // inset the sensor a bit
+            isSensor: true,
+            onCollision: (other, started) => {
+              if (!started || !(other instanceof GamePlayerEntity)) return;
+              
+              const destinationRegion = GameManager.instance.getRegion(this.destinationRegionId);
+              
+              if (!destinationRegion) {
+                ErrorHandler.warning(`PortalEntity: Destination region ${this.destinationRegionId} not found`);
+                return;
+              }
+              other.gamePlayer.setCurrentRegion(destinationRegion);
+              other.gamePlayer.setCurrentRegionSpawnFacingAngle(this.destinationRegionFacingAngle);
+              other.gamePlayer.setCurrentRegionSpawnPoint(this.destinationRegionPosition);              
+              other.player.joinWorld(destinationRegion.world);
+            },
+          },
+        ],
+      },
+      ...options,
+    });
+
+    this.destinationRegionId = options.destinationRegionId;
+    this.destinationRegionFacingAngle = options.destinationRegionFacingAngle ?? 0;
+    this.destinationRegionPosition = options.destinationRegionPosition;
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/LesserBlightBloomEntity.ts

@@ -0,0 +1,161 @@
+import { ColliderShape, Entity, RigidBodyType } from 'hytopia';
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+import BaseProjectileEntity from '../BaseProjectileEntity';
+import { isDamageable } from '../../interfaces/IDamageable';
+
+// Drops
+import BlightedRootItem from '../../items/materials/BlightedRootItem';
+import CommonMushroomItem from '../../items/consumables/CommonMushroomItem';
+import CommonSeedsItem from '../../items/seeds/CommonSeedsItem';
+import UnusualSeedsItem from '../../items/seeds/UnusualSeedsItem';
+import GoldItem from '../../items/general/GoldItem';
+
+export type LesserBlightBloomEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class LesserBlightBloomEntity extends BaseCombatEntity {
+  constructor(options?: LesserBlightBloomEntityOptions) {
+    super({
+      aggroRadius: 8,
+      aggroSensorForwardOffset: 0,
+      attacks: [
+        { // Eat
+          animations: [ 'eat' ],
+          complexAttack: () => this._eatTarget(),
+          complexAttackDelayMs: 750,
+          cooldownMs: 4000,
+          range: 4,
+          weight: 4,
+        },
+        { // AoEGas
+          animations: [ 'gas_explode' ],
+          complexAttack: () => this._emitGasAoE(25, 4),
+          complexAttackDelayMs: 2500,
+          cooldownMs: 4000,
+          range: 10,
+          weight: 2,
+        },
+        { // Spray 3 wide gas projectiles
+          animations: [ 'spore_splash' ],
+          complexAttack: () => this._sprayGas(18),
+          complexAttackDelayMs: 700,
+          cooldownMs: 4000,
+          range: 10,
+          weight: 2,
+        },
+      ],
+      combatExperienceReward: 60,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 5000,
+      deathItemDrops: [
+        { itemClass: BlightedRootItem, minQuantity: 1, maxQuantity: 3, weight: 30 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 15 },
+        { itemClass: GoldItem, minQuantity: 12, maxQuantity: 23, weight: 9 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 6 },
+        { itemClass: UnusualSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      deathItemMaxDrops: 3,
+      faceSpeed: 0.75,
+      health: 250,
+      idleAnimations: [ 'waiting' ],
+      modelUri: 'models/enemies/blight-bloom.gltf',
+      modelScale: 0.5,
+      moveAnimations: [ 'waiting' ],
+      moveSpeed: 0, // stationary, doesn't move.
+      name: 'Lesser Blight Bloom',
+      pathfindingOptions: {
+        maxJump: 2,
+        maxFall: 2,
+      },
+      pushable: false,
+      tintColor: { r: 128, g: 255, b: 128 },
+      ...options,
+    });
+  }
+
+  private _eatTarget() {
+    if (!this.world) return;
+
+    const currentDirection = this.directionFromRotation;
+    const raycastDirection = {
+      x: currentDirection.x,
+      y: currentDirection.y - 0.5, // aim down
+      z: currentDirection.z,
+    }
+
+    const raycastResult = this.world.simulation.raycast(this.position, raycastDirection, 4, {
+      filterExcludeRigidBody: this.rawRigidBody,
+      filterFlags: 8, // Rapier flag to exclude sensor colliders
+    });
+
+    if (isDamageable(raycastResult?.hitEntity)) {
+      raycastResult.hitEntity.takeDamage(this.calculateDamageWithVariance(80, 0.3));
+    }
+  }
+  
+  private _emitGasAoE(baseDamage: number, aoeRadius: number) {
+    if (!this.world) return;
+
+    const gas = new Entity({
+      modelUri: 'models/vfx/gas-explode.gltf',
+      modelLoopedAnimations: [ 'actived' ],
+      rigidBodyOptions: {
+        type: RigidBodyType.FIXED,
+        colliders: [
+          {
+            shape: ColliderShape.BALL,
+            radius: aoeRadius,
+            isSensor: true,
+            onCollision: (other, started) => {
+              if (started && other !== this && isDamageable(other)) {
+                other.takeDamage(this.calculateDamageWithVariance(baseDamage, 0.3));
+              }
+            }
+          }
+        ]
+      },
+      tintColor: { r: 0, g: 255, b: 0 },
+    });
+
+    gas.spawn(this.world, this.position);
+
+    setTimeout(() => {
+      gas.despawn();
+    }, 1800);
+  }
+
+  private _sprayGas(baseDamage: number) {
+    const spray = () => {
+      if (!this.world) return;
+
+      const direction = this.directionFromRotation;
+      const gasSpray = new BaseProjectileEntity({
+        damage: this.calculateDamageWithVariance(baseDamage, 0.3),
+        despawnAfterMs: 2000,
+        direction,
+        gravityScale: 0.15,
+        modelUri: 'models/projectiles/wide-spinning-fireball.gltf',
+        modelLoopedAnimations: [ 'idle' ],
+        modelScale: 0.75,
+        speed: 4, 
+        source: this,
+        tintColor: { r: 0, g: 255, b: 128 },
+      });
+
+      const sourcePosition = this.position;
+      const offsetSpawnPosition = {
+        x: sourcePosition.x + direction.x * 2,
+        y: sourcePosition.y + direction.y * 2,
+        z: sourcePosition.z + direction.z * 2,
+      }
+
+      gasSpray.spawn(this.world, offsetSpawnPosition, this.rotation);
+    }
+
+    // 3 sprays
+    spray();
+    setTimeout(spray, 600);
+    setTimeout(spray, 1200);
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/RatkinBruteEntity.ts

@@ -0,0 +1,79 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+
+// Drops
+import CommonMushroomItem from "../../items/consumables/CommonMushroomItem";
+import CommonSeedsItem from "../../items/seeds/CommonSeedsItem";
+import GoldItem from "../../items/general/GoldItem";
+import RatkinBonesItem from "../../items/materials/RatkinBonesItem";
+import RatkinEyesItem from "../../items/materials/RatkinEyesItem.ts";
+import RatkinTailItem from "../../items/materials/RatkinTailItem";
+import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
+
+export type RatkinBruteEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class RatkinBruteEntity extends BaseCombatEntity {
+  constructor(options?: RatkinBruteEntityOptions) {
+    super({
+      aggroRadius: 7.5,
+      aggroSensorForwardOffset: 3,
+      attacks: [
+        { // Heavy body slam attack
+          animations: [ 'atk1' ],
+          cooldownMs: 4000,
+          range: 2,
+          simpleAttackDamage: 20,
+          simpleAttackDamageVariance: 0.6, // ±60% damage (12-28)
+          simpleAttackDamageDelayMs: 1000, // Deal damage 1000ms into animation
+          simpleAttackReach: 3,
+          weight: 1,
+        },
+        { // Light hammer swing attack
+          animations: [ 'atk2' ],
+          cooldownMs: 1500,
+          range: 2,
+          simpleAttackDamage: 16,
+          simpleAttackDamageVariance: 0.15, // ±15% damage (7-11)
+          simpleAttackDamageDelayMs: 500, // Deal damage 500ms into animation
+          simpleAttackReach: 3,
+          weight: 2,
+        },
+        { // Light hammer swing 2 attack
+          animations: [ 'atk3' ],
+          cooldownMs: 1500,
+          range: 2,
+          simpleAttackDamage: 13,
+          simpleAttackDamageVariance: 0.15, // ±15% damage (5-9)
+          simpleAttackDamageDelayMs: 350, // Deal damage 350ms into animation
+          simpleAttackReach: 3,
+          weight: 2,
+        },
+      ],
+      combatExperienceReward: 30,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: RatkinBonesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinEyesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinToothItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinTailItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: GoldItem, minQuantity: 6, maxQuantity: 15, weight: 2 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      health: 140,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/ratkin-brute.gltf',
+      modelScale: 0.6,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 2.5,
+      name: 'Ratkin Brute',
+      pathfindingOptions: {
+        maxJump: 2,
+        maxFall: 2,
+      },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/RatkinRangerEntity.ts

@@ -0,0 +1,88 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+import BaseProjectileEntity from "../BaseProjectileEntity";
+import type { Vector3Like } from 'hytopia';
+
+// Drops
+import CommonMushroomItem from "../../items/consumables/CommonMushroomItem";
+import CommonSeedsItem from "../../items/seeds/CommonSeedsItem";
+import GoldItem from "../../items/general/GoldItem";
+import RatkinBonesItem from "../../items/materials/RatkinBonesItem";
+import RatkinEyesItem from "../../items/materials/RatkinEyesItem.ts";
+import RatkinTailItem from "../../items/materials/RatkinTailItem";
+import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
+
+export type RatkinRangerEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class RatkinRangerEntity extends BaseCombatEntity {
+  constructor(options?: RatkinRangerEntityOptions) {
+    super({
+      aggroRadius: 11,
+      aggroSensorForwardOffset: 3,
+      attacks: [
+        { // Fast bow attack
+          animations: [ 'atk1' ],
+          complexAttack: (params) => {
+            this._shootArrow(params.target.position, this.calculateDamageWithVariance(11, 0.5));
+          },
+          complexAttackDelayMs: 700,
+          cooldownMs: 2000,
+          range: 10,
+          weight: 2,
+        },
+        { // Slow heavy bow attack
+          animations: [ 'atk2' ],
+          complexAttack: (params) => {
+            this._shootArrow(params.target.position, this.calculateDamageWithVariance(16, 0.5));
+          },
+          complexAttackDelayMs: 1600,
+          cooldownMs: 3000,
+          range: 10,
+          weight: 3,
+        },
+      ],
+      combatExperienceReward: 20,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: RatkinBonesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinEyesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinToothItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinTailItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: GoldItem, minQuantity: 6, maxQuantity: 15, weight: 2 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      health: 100,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/ratkin-ranger.gltf',
+      modelScale: 0.8,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 3,
+      name: 'Ratkin Ranger',
+      pathfindingOptions: {
+        maxJump: 2,
+        maxFall: 2,
+      },
+      ...options,
+    });
+  }
+
+  private _shootArrow(targetPosition: Vector3Like, damage: number) {
+    if (!this.world) return;
+    
+    const arrow = new BaseProjectileEntity({
+      damage,
+      despawnAfterMs: 1000,
+      direction: this.calculateDirectionToTargetPosition(targetPosition),
+      gravityScale: 0.1,
+      modelUri: 'models/projectiles/arrow.glb',
+      modelScale: 0.75,
+      speed: 30,
+      source: this,
+    });
+    
+    arrow.spawn(this.world, this.position, this.rotation);
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/RatkinSpellcasterEntity.ts

@@ -0,0 +1,77 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+import BaseProjectileEntity from "../BaseProjectileEntity";
+import type { Vector3Like } from 'hytopia';
+
+// Drops
+import CommonMushroomItem from "../../items/consumables/CommonMushroomItem";
+import CommonSeedsItem from "../../items/seeds/CommonSeedsItem";
+import GoldItem from "../../items/general/GoldItem";
+import RatkinBonesItem from "../../items/materials/RatkinBonesItem";
+import RatkinEyesItem from "../../items/materials/RatkinEyesItem.ts";
+import RatkinTailItem from "../../items/materials/RatkinTailItem";
+import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
+
+export type RatkinSpellcasterEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class RatkinSpellcasterEntity extends BaseCombatEntity {
+  constructor(options?: RatkinSpellcasterEntityOptions) {
+    super({
+      aggroRadius: 12,
+      aggroSensorForwardOffset: 3,
+      attacks: [
+        { // Fireball attack
+          animations: [ 'atk1' ],
+          complexAttack: (params) => {
+            this._shootFireball(params.target.position, this.calculateDamageWithVariance(22, 0.5));
+          },
+          complexAttackDelayMs: 1000,
+          cooldownMs: 5000,
+          range: 10,
+          weight: 2,
+        },
+      ],
+      combatExperienceReward: 20,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: RatkinBonesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinEyesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinToothItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinTailItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: GoldItem, minQuantity: 6, maxQuantity: 15, weight: 2 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      health: 100,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/ratkin-spellcaster.gltf',
+      modelScale: 0.8,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 3,
+      name: 'Ratkin Spellcaster',
+      pathfindingOptions: {
+        maxJump: 2,
+        maxFall: 2,
+      },
+      ...options,
+    });
+  }
+
+  private _shootFireball(targetPosition: Vector3Like, damage: number) {
+    if (!this.world) return;
+
+    const fireball = new BaseProjectileEntity({
+      damage,
+      despawnAfterMs: 2000,
+      direction: this.calculateDirectionToTargetPosition(targetPosition),
+      gravityScale: 0,
+      modelUri: 'models/projectiles/fireball.glb',
+      speed: 15,
+      source: this,
+    });
+    
+    fireball.spawn(this.world, this.position, this.rotation);
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/RatkinWarriorEntity.ts

@@ -0,0 +1,69 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+
+// Drops
+import CommonMushroomItem from "../../items/consumables/CommonMushroomItem";
+import CommonSeedsItem from "../../items/seeds/CommonSeedsItem";
+import GoldItem from "../../items/general/GoldItem";
+import RatkinBonesItem from "../../items/materials/RatkinBonesItem";
+import RatkinEyesItem from "../../items/materials/RatkinEyesItem.ts";
+import RatkinTailItem from "../../items/materials/RatkinTailItem";
+import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
+
+export type RatkinWarriorEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class RatkinWarriorEntity extends BaseCombatEntity {
+  constructor(options?: RatkinWarriorEntityOptions) {
+    super({
+      aggroRadius: 7.5,
+      aggroSensorForwardOffset: 3,
+      attacks: [
+        { // Heavy attack
+          animations: [ 'atk1' ],
+          cooldownMs: 4000,
+          range: 2,
+          simpleAttackDamage: 16,
+          simpleAttackDamageVariance: 0.4, // ±40% damage (12-20)
+          simpleAttackDamageDelayMs: 1000, // Deal damage 1000ms into animation
+          simpleAttackReach: 3,
+          weight: 1,
+        },
+        { // Light attack
+          animations: [ 'atk2' ],
+          cooldownMs: 2000,
+          range: 2,
+          simpleAttackDamage: 9,
+          simpleAttackDamageVariance: 0.1, // ±10% damage (6-8) 
+          simpleAttackDamageDelayMs: 400, // Deal damage 400ms into animation
+          simpleAttackReach: 3,
+          weight: 2,
+        },
+      ],
+      combatExperienceReward: 15,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: RatkinBonesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinEyesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinToothItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinTailItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: GoldItem, minQuantity: 6, maxQuantity: 15, weight: 2 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      health: 100,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/ratkin-warrior.gltf',
+      modelScale: 0.8,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 3,
+      name: 'Ratkin Warrior',
+      pathfindingOptions: {
+        maxJump: 2,
+        maxFall: 2,
+      },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/enemies/TaintedRatkinBruteEntity.ts

@@ -0,0 +1,80 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+
+// Drops
+import CommonMushroomItem from "../../items/consumables/CommonMushroomItem";
+import CommonSeedsItem from "../../items/seeds/CommonSeedsItem";
+import GoldItem from "../../items/general/GoldItem";
+import RatkinBonesItem from "../../items/materials/RatkinBonesItem";
+import RatkinEyesItem from "../../items/materials/RatkinEyesItem.ts";
+import RatkinTailItem from "../../items/materials/RatkinTailItem";
+import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
+
+export type TaintedRatkinBruteEntityOptions = {
+
+} & BaseCombatEntityOptions;
+
+export default class TaintedRatkinBruteEntity extends BaseCombatEntity {
+  constructor(options?: TaintedRatkinBruteEntityOptions) {
+    super({
+      aggroRadius: 7.5,
+      aggroSensorForwardOffset: 3,
+      attacks: [
+        { // Heavy body slam attack
+          animations: [ 'atk1' ],
+          cooldownMs: 3500,
+          range: 2,
+          simpleAttackDamage: 30,
+          simpleAttackDamageVariance: 0.6, // ±60% damage
+          simpleAttackDamageDelayMs: 1000, // Deal damage 1000ms into animation
+          simpleAttackReach: 3,
+          weight: 1,
+        },
+        { // Light hammer swing attack
+          animations: [ 'atk2' ],
+          cooldownMs: 1000,
+          range: 2,
+          simpleAttackDamage: 18,
+          simpleAttackDamageVariance: 0.15, // ±15% damage
+          simpleAttackDamageDelayMs: 500, // Deal damage 500ms into animation
+          simpleAttackReach: 3,
+          weight: 2,
+        },
+        { // Light hammer swing 2 attack
+          animations: [ 'atk3' ],
+          cooldownMs: 1000,
+          range: 2,
+          simpleAttackDamage: 13,
+          simpleAttackDamageVariance: 0.15, // ±15% damage
+          simpleAttackDamageDelayMs: 350, // Deal damage 350ms into animation
+          simpleAttackReach: 3,
+          weight: 2,
+        },
+      ],
+      combatExperienceReward: 45,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: RatkinBonesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinEyesItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinToothItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: RatkinTailItem, minQuantity: 1, maxQuantity: 3, weight: 4 },
+        { itemClass: GoldItem, minQuantity: 11, maxQuantity: 20, weight: 2 },
+        { itemClass: CommonMushroomItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+        { itemClass: CommonSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      health: 210,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/ratkin-brute.gltf',
+      modelScale: 0.675,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 3.325,
+      name: 'Tainted Ratkin Brute',
+      pathfindingOptions: {
+        maxJump: 3,
+        maxFall: 3,
+      },
+      tintColor: { r: 128, g: 255, b: 128 },
+      ...options,
+    });
+  }
+}