@hytopia.com/examples 1.0.8 → 1.0.9

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

@@ -0,0 +1,155 @@
+import { Collider, ColliderShape, RigidBodyType } from 'hytopia';
+import BaseCombatEntity, { BaseCombatEntityOptions } from '../BaseCombatEntity';
+import GamePlayerEntity from '../../GamePlayerEntity';
+import type BaseEntity from '../BaseEntity';
+
+import WeaverBroodlingEntity from './WeaverBroodlingEntity';
+
+// Drops
+import GoldItem from "../../items/general/GoldItem";
+import RareSeedsItem from '../../items/seeds/RareSeedsItem';
+import UnusualSeedsItem from '../../items/seeds/UnusualSeedsItem';
+
+export type QueenWeaverEntityOptions = {
+  
+} & Partial<BaseCombatEntityOptions>;
+
+export default class QueenWeaverEntity extends BaseCombatEntity {
+  constructor(options?: QueenWeaverEntityOptions) {
+    super({
+      aggroRadius: 20,
+      attacks: [
+        {
+          animations: [ 'bite' ],
+          cooldownMs: 1500,
+          range: 2,
+          simpleAttackDamage: 50,
+          simpleAttackDamageVariance: 0.2,
+          simpleAttackDamageDelayMs: 400,
+          simpleAttackReach: 3,
+          weight: 10,
+        },
+        {
+          animations: [ 'cocoon' ],
+          complexAttack: (params) => this._pounce(params.target),
+          complexAttackDelayMs: 300,
+          cooldownMs: 2500,
+          range: 10,
+          weight: 10,
+        },
+        {
+          animations: [ 'web' ],
+          complexAttack: () => this._slam(),
+          complexAttackDelayMs: 600,
+          cooldownMs: 2500,
+          range: 5,
+          weight: 10,
+        },
+        {
+          animations: [ 'gas' ],
+          complexAttack: () => this._spawnBroodling(),
+          complexAttackDelayMs: 5000,
+          cooldownMs: 6500,
+          range: 8,
+          stopMovingDuringDelay: true,
+          weight: 4,
+        }
+      ],
+      combatExperienceReward: 650,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1500,
+      deathItemDrops: [
+        { itemClass: GoldItem, minQuantity: 93, maxQuantity: 186, weight: 40 },
+        { itemClass: UnusualSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 20 },
+        { itemClass: RareSeedsItem, minQuantity: 1, maxQuantity: 3, weight: 1 },
+      ],
+      deathItemMaxDrops: 5,
+      faceSpeed: 4,
+      health: 1000,
+      idleAnimations: [ 'waiting' ],
+      modelUri: 'models/enemies/weaver.gltf',
+      modelScale: 1.3,
+      moveAnimations: [ 'walking' ],
+      moveSpeed: 5,
+      name: 'Queen Weaver',
+      pathfindingOptions: {
+        maxJump: 3,
+        maxFall: 4,
+        maxOpenSetIterations: 50,
+      },
+      pushable: false,
+      rigidBodyOptions: {
+        type: RigidBodyType.DYNAMIC,
+        ccdEnabled: true,
+      },
+      ...options,
+    })
+  }
+
+  private _pounce(target: BaseEntity | GamePlayerEntity) {
+    if (!this.world) return;
+
+    const position = target.position;
+    const direction = this.calculateDirectionToTargetPosition(position);
+
+    this.applyImpulse({
+      x: direction.x * 10 * this.mass,
+      y: 5 * this.mass,
+      z: direction.z * 10 * this.mass,
+    });
+
+    this.faceTowards(position, 10);
+
+    setTimeout(() => {
+      if (!target.isSpawned || target.isDead) return;
+
+      if (this.calculateDistanceSquaredToTarget(target) < this.diameterSquared + 1) {
+        target.takeDamage(this.calculateDamageWithVariance(65, 0.4));
+      }
+    }, 1100);
+  }
+
+  private _slam() {
+    if (!this.world) return;
+
+    const aoeCollider = new Collider({
+      shape: ColliderShape.CYLINDER,
+      halfHeight: this.height / 2,
+      radius: Math.sqrt(this.diameterSquared) / 2 + 2,
+    })
+
+    const targets = this.getTargetsByRawShapeIntersection(
+      aoeCollider.rawShape,
+      this.position,
+      this.rotation,
+    );
+
+    for (const target of targets) {
+      if (!target.isSpawned || !(target instanceof GamePlayerEntity)) continue;
+
+      target.takeDamage(this.calculateDamageWithVariance(70, 0.2));
+      
+      if (!target.isDodging) { // we check here to allow damage to resolve for dodged exp
+        const direction = this.calculateDirectionToTargetPosition(target.position);
+        target.applyImpulse({
+          x: direction.x * 13 * target.mass,
+          y: 5 * target.mass,
+          z: direction.z * 13 * target.mass,
+        });
+      }
+    }
+  }
+
+  private _spawnBroodling() {
+    if (!this.world) return;
+
+    const weaverBroodling = new WeaverBroodlingEntity();
+    const facingDirection = this.directionFromRotation;
+
+    weaverBroodling.spawn(this.world, {
+      x: this.position.x + (-facingDirection.x * 3),
+      y: this.position.y + 1,
+      z: this.position.z + (-facingDirection.z * 3),
+    });
+  }
+}

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

@@ -11,7 +11,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type RatkinBruteEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class RatkinBruteEntity extends BaseCombatEntity {
   constructor(options?: RatkinBruteEntityOptions) {

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

@@ -13,7 +13,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type RatkinRangerEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class RatkinRangerEntity extends BaseCombatEntity {
   constructor(options?: RatkinRangerEntityOptions) {

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

@@ -13,7 +13,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type RatkinSpellcasterEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class RatkinSpellcasterEntity extends BaseCombatEntity {
   constructor(options?: RatkinSpellcasterEntityOptions) {

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

@@ -11,7 +11,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type RatkinWarriorEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class RatkinWarriorEntity extends BaseCombatEntity {
   constructor(options?: RatkinWarriorEntityOptions) {

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

@@ -11,7 +11,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type TaintedRatkinBruteEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class TaintedRatkinBruteEntity extends BaseCombatEntity {
   constructor(options?: TaintedRatkinBruteEntityOptions) {

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

@@ -14,7 +14,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type TaintedRatkinRangerEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class TaintedRatkinRangerEntity extends BaseCombatEntity {
   constructor(options?: TaintedRatkinRangerEntityOptions) {

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

@@ -13,7 +13,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type TaintedRatkinSpellcasterEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class TaintedRatkinSpellcasterEntity extends BaseCombatEntity {
   constructor(options?: TaintedRatkinSpellcasterEntityOptions) {

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

@@ -11,7 +11,7 @@ import RatkinToothItem from "../../items/materials/RatkinToothItem.ts";
 
 export type TaintedRatkinWarriorEntityOptions = {
 
-} & BaseCombatEntityOptions;
+} & Partial<BaseCombatEntityOptions>;
 
 export default class TaintedRatkinWarriorEntity extends BaseCombatEntity {
   constructor(options?: TaintedRatkinWarriorEntityOptions) {

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

@@ -0,0 +1,47 @@
+import BaseCombatEntity, { BaseCombatEntityOptions } from "../BaseCombatEntity";
+
+// Drops
+import GoldItem from "../../items/general/GoldItem";
+
+export type WeaverBroodlingEntityOptions = {
+
+} & Partial<BaseCombatEntityOptions>;
+
+export default class WeaverBroodlingEntity extends BaseCombatEntity {
+  constructor(options?: WeaverBroodlingEntityOptions) {
+    super({
+      aggroRadius: 12,
+      aggroSensorForwardOffset: 0,
+      attacks: [
+        { // Bite attack
+          animations: [ 'fang_attack' ],
+          cooldownMs: 2000,
+          range: 2,
+          simpleAttackDamage: 17,
+          simpleAttackDamageVariance: 0.1,
+          simpleAttackDamageDelayMs: 600,
+          weight: 1,
+        }
+      ],
+      combatExperienceReward: 30,
+      deathAnimations: [ 'death' ],
+      deathDespawnDelayMs: 1000,
+      deathItemDrops: [
+        { itemClass: GoldItem, minQuantity: 16, maxQuantity: 24, weight: 2 },
+      ],
+      health: 140,
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/enemies/weaver-broodling.gltf',
+      modelScale: 0.8,
+      moveAnimations: [ 'walk' ],
+      moveSpeed: 3,
+      name: 'Weaver Broodling',
+      pathfindingOptions: {
+        maxJump: 3,
+        maxFall: 3,
+      },
+      tintColor: { r: 64, g: 255, b: 64 },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/entities/environmental/SpiderWebEntity.ts

@@ -1,20 +1,50 @@
-import { Collider, Entity, EntityOptions, RigidBodyType } from 'hytopia';
+import { Collider, CollisionGroup, Entity, ModelEntityOptions, RigidBodyType } from 'hytopia';
+import GamePlayerEntity from '../../GamePlayerEntity';
 
 export type SpiderWebEntityOptions = {
 
-} & EntityOptions;
+} & ModelEntityOptions;
 
 export default class SpiderWebEntity extends Entity {
   public constructor(options?: SpiderWebEntityOptions) {
+    const modelScale = options?.modelScale ?? Math.random() * 1.5 + 0.5; // 0.5 to 2 scale
+    const colliderOptions = Collider.optionsFromModelUri('models/vfx/spider-web.gltf', modelScale);
+    
     super({
       ...options,
       modelUri: 'models/vfx/spider-web.gltf',
+      modelScale,
       rigidBodyOptions: {
         type: RigidBodyType.DYNAMIC,
         colliders: [
-          {
-            ...Collider.optionsFromModelUri('models/vfx/spider-web.gltf'),
+          { // Collider for ground contact
+            ...colliderOptions,
+            bounciness: 0,
+            collisionGroups: {
+              belongsTo: [ CollisionGroup.ENTITY ],
+              collidesWith: [ CollisionGroup.BLOCK ],
+            }
+          },
+          { // Collider for slow effect on relevant entities
+            ...colliderOptions,
+            collisionGroups: {
+              belongsTo: [ CollisionGroup.ENTITY ],
+              collidesWith: [ CollisionGroup.ENTITY ],
+            },
             isSensor: true,
+            onCollision: (entity, started) => {
+              if (!(entity instanceof GamePlayerEntity)) return;
+
+              if (started) {
+                entity.setGravityScale(2);
+                entity.playerController.walkVelocity = entity.playerController.walkVelocity * 0.5;
+                entity.playerController.runVelocity = entity.playerController.runVelocity * 0.5;
+              } else {
+                entity.setGravityScale(1);
+                entity.playerController.walkVelocity = entity.playerController.walkVelocity * 2;
+                entity.playerController.runVelocity = entity.playerController.runVelocity * 2;
+              }
+            }
           }
         ]
       }

package/frontiers-rpg-game/src/items/BaseWeaponItem.ts

@@ -146,7 +146,7 @@ export default abstract class BaseWeaponItem extends BaseItem {
     }
   }
 
-  protected getTargetsByRawShapeIntersection(rawShape: RawShape, position: Vector3Like, rotation: QuaternionLike, reach: number): Entity[] {
+  protected getTargetsByRawShapeIntersection(rawShape: RawShape, position: Vector3Like, rotation: QuaternionLike): Entity[] {
     if (!this.entity?.parent || !this.entity.parent.world) {
       return [];
     }

package/frontiers-rpg-game/src/items/weapons/DullSwordItem.ts

@@ -49,7 +49,6 @@ export default class DullSwordItem extends BaseWeaponItem {
         spinCollider.rawShape,
         this.entity.parent.position,
         this.entity.parent.rotation,
-        attack.reach,
       );
 
       for (const target of targets) {

package/frontiers-rpg-game/src/items/weapons/IronLongSwordItem.ts

@@ -49,7 +49,6 @@ export default class IronLongSwordItem extends BaseWeaponItem {
         spinCollider.rawShape,
         this.entity.parent.position,
         this.entity.parent.rotation,
-        attack.reach,
       );
 
       for (const target of targets) {

package/frontiers-rpg-game/src/items/weapons/TrainingSwordItem.ts

@@ -49,7 +49,6 @@ export default class TrainingSwordItem extends BaseWeaponItem {
         spinCollider.rawShape,
         this.entity.parent.position,
         this.entity.parent.rotation,
-        attack.reach,
       );
 
       for (const target of targets) {

package/frontiers-rpg-game/src/quests/main/WelcomeToStalkhavenQuest.ts

@@ -81,7 +81,8 @@ export default class WelcomeToStalkhavenQuest extends BaseQuest {
         },
       },
       enabledForInteractor: (interactor: GamePlayerEntity) => {
-        return interactor.gamePlayer.questLog.isQuestActive(this.id);
+        // This || may be unecessary but a bug was found in testing with persistence that broke quest state..
+        return interactor.gamePlayer.questLog.isQuestActive(this.id) || !interactor.gamePlayer.questLog.hasQuest(ExploringStalkhavenQuest.id);
       }
     }
   ];

package/frontiers-rpg-game/src/regions/ratkin-nest/RatkinNestRegion.ts

@@ -1,3 +1,4 @@
+import { Quaternion } from 'hytopia';
 import GameRegion from '../../GameRegion';
 import Spawner from '../../systems/Spawner';
 import PortalEntity from '../../entities/PortalEntity';
@@ -19,6 +20,8 @@ import TaintedRatkinWarriorEntity from '../../entities/enemies/TaintedRatkinWarr
 
 import LesserBlightBloomEntity from '../../entities/enemies/LesserBlightBloomEntity';
 
+import WeaverBroodlingEntity from '../../entities/enemies/WeaverBroodlingEntity';
+
 // Spawner Forageables
 import DecayingPileEntity from '../../entities/forageables/DecayingPileEntity';
 
@@ -48,6 +51,7 @@ export default class RatkinNestRegion extends GameRegion {
     this._setupNPCs();
     this._setupPortals();
   }
+  
   private _setupEnemySpawners(): void {
     const wanderOptions: WanderOptions = {
       idleMinMs: 8000,
@@ -124,11 +128,29 @@ export default class RatkinNestRegion extends GameRegion {
       ],
       spawnIntervalMs: 60000,
       world: this.world,
+    });
+
+    const weaverBroodlingSpawner = new Spawner({
+      groundCheckDistance: 4,
+      maxSpawns: 6,
+      spawnables: [
+        { entityConstructor: WeaverBroodlingEntity, weight: 1 },
+      ],
+      spawnRegions: [
+        {
+          min: { x: -4, y: 2, z: -112 },
+          max: { x: 45, y: 5, z: -64 },
+          weight: 1,
+        }
+      ],
+      spawnIntervalMs: 15000,
+      world: this.world,
     })
 
     upperNestSpawner.start(true);
     lowerNestSpawner.start(true);
     lowerNestLesserBlightBloomSpawner.start(true);
+    weaverBroodlingSpawner.start(true);
   }
 
   private _setupForageableSpawners(): void {
@@ -176,5 +198,14 @@ export default class RatkinNestRegion extends GameRegion {
     });
 
     chitterForestPortal.spawn(this.world, { x: -31, y: 23.5, z: -71 }); 
+
+    const weaversHollowPortal = new PortalEntity({
+      destinationRegionId: 'weavers-hollow',
+      destinationRegionPosition: { x: 10, y: 2, z: 13 },
+      destinationRegionFacingAngle: 45,
+      type: 'boss',
+    });
+
+    weaversHollowPortal.spawn(this.world, { x: 31, y: 3.5, z: -123 }, Quaternion.fromEuler(0, 45, 0));
   }
 }

package/frontiers-rpg-game/src/regions/stalkhaven-port/StalkhavenPortRegion.ts

@@ -37,6 +37,7 @@ export default class StalkhavenRegion extends GameRegion {
       destinationRegionFacingAngle: 90,
       modelScale: 2,
     });
+    
     stalkhavenPortal.spawn(this.world, { x: -6, y: 9.5, z: -31 });
   }
 }

package/frontiers-rpg-game/src/regions/weavers-hollow/WeaversHollowRegion.ts

@@ -1,11 +1,13 @@
+import { Quaternion } from 'hytopia';
 import GameRegion from '../../GameRegion';
 import Spawner from '../../systems/Spawner';
 import PortalEntity from '../../entities/PortalEntity';
-import type { WanderOptions } from '../../entities/BaseEntity';
 
 import weaversHollowMap from '../../../assets/maps/weavers-hollow.json';
 
 import SpiderWebEntity from '../../entities/environmental/SpiderWebEntity';
+import QueenWeaverEntity from '../../entities/enemies/QueenWeaverEntity';
+import WeaverBroodlingEntity from '../../entities/enemies/WeaverBroodlingEntity';
 
 export default class WeaversHollowRegion extends GameRegion {
   public constructor() {
@@ -14,9 +16,14 @@ export default class WeaversHollowRegion extends GameRegion {
       name: `Weaver's Hollow`,
       map: weaversHollowMap,
       maxAmbientLightIntensity: 0.075,
-      maxDirectionalLightIntensity: 0.4,
+      maxDirectionalLightIntensity: 0.8,
       minAmbientLightIntensity: 0.055,
-      minDirectionalLightIntensity: 0.2,
+      minDirectionalLightIntensity: 0.4,
+      respawnOverride: {
+        regionId: 'ratkin-nest',
+        facingAngle: 135,
+        spawnPoint: { x: -1, y: 10, z: -67 },
+      },
       skyboxUri: 'skyboxes/black',
       spawnPoint: { x: 10, y: 2, z: 13 },
       ambientAudioUri: 'audio/music/cave-theme-looping.mp3',
@@ -27,15 +34,69 @@ export default class WeaversHollowRegion extends GameRegion {
     super.setup();
 
     this._setupEnemySpawners();
+    this._setupEnvironmentSpawners();
     this._setupPortals();
   }
 
   private _setupEnemySpawners(): void {
-    const spiderWeb = new SpiderWebEntity();
-    spiderWeb.spawn(this.world, { x: 6, y: 5, z: 8 });
+    const queenWeaverSpawner = new Spawner({
+      maxSpawns: 1,
+      spawnables: [
+        { entityConstructor: QueenWeaverEntity, weight: 1 },
+      ],
+      spawnRegions: [
+        {
+          min: { x: -1, y: 16, z: 6 },
+          max: { x: 0, y: 16, z: 7 },
+          weight: 1,
+        }
+      ],
+      spawnIntervalMs: 120000,
+      world: this.world,
+    });
+
+    queenWeaverSpawner.start(true);
+
+    // Spawn lure broodlings
+    for (let i = 0; i < 3; i++) {
+      const weaverBroodling = new WeaverBroodlingEntity({ facingAngle: Math.random() * 360 });
+      weaverBroodling.spawn(this.world, {
+        x: Math.random() * 8 - 4,
+        y: 2,
+        z: Math.random() * 8 - 4,
+      });
+    }
+  }
+
+  private _setupEnvironmentSpawners(): void {
+    const spiderWebSpawner = new Spawner({
+      groundCheckDistance: 8,
+      maxSpawns: 20,
+      spawnables: [
+        { entityConstructor: SpiderWebEntity, weight: 1 },
+      ],
+      spawnRegions: [
+        {
+          min: { x: -13, y: 5, z: -9 },
+          max: { x: 13, y: 8, z: 11 },
+          weight: 1,
+        }
+      ],
+      spawnIntervalMs: 10000,
+      world: this.world,
+    });
+
+    spiderWebSpawner.start(true);
   }
 
   private _setupPortals(): void {
-    
+    const ratkinNestPortal = new PortalEntity({
+      delayS: 10,
+      destinationRegionId: 'ratkin-nest',
+      destinationRegionPosition: { x: 35, y: 2, z: -118 },
+      destinationRegionFacingAngle: 240,
+    });
+
+    ratkinNestPortal.spawn(this.world, { x: 13.5, y: 3.5, z: 18 }, Quaternion.fromEuler(0, 45, 0));
   }
 }

package/frontiers-rpg-game/src/systems/Spawner.ts

@@ -22,7 +22,7 @@ export type SpawnRegion = BoundingBox & {
 };
 
 export type EntitySpawnable = {
-  entityConstructor: new () => BaseEntity;
+  entityConstructor: new () => Entity;
   weight: number;
   wanders?: boolean;
   wanderOptions?: WanderOptions;
@@ -139,7 +139,7 @@ export default class Spawner {
       instance.spawn(this._world, spawnPoint, rotation);
 
       // Apply wandering behavior if configured
-      if (spawnable.wanders && spawnable.wanderOptions) {
+      if (spawnable.wanders && spawnable.wanderOptions && instance instanceof BaseEntity) {
         instance.wander(instance.moveSpeed, spawnable.wanderOptions);
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hytopia.com/examples",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "",
   "license": "ISC",
   "author": "",