Run.3DEngine

A Three.js-based game engine with ECS architecture, physics, navigation, and comprehensive game systems.

Features

• ECS Architecture: Component-based GameObject system
• Physics: Rapier3D integration with RigidBody components
• Navigation: Dynamic navigation system with A* pathfinding
• Animation: Advanced animation system with blending and retargeting
• Audio: 2D/3D audio system with music management
• UI: Comprehensive UI system with utilities
• Camera: Follow camera, free camera with smooth transitions
• Asset Loading: FBX, GLB, OBJ loaders with skeleton caching
• Particles: Flexible particle system
• Input: Cross-platform input management with mobile support

Installation

As npm workspace dependency

{
  "dependencies": {
    "@series-inc/rundot-3d-engine": "^0.2.0"
  }
}

As git submodule

git submodule add https://github.com/series-ai/Run.3DEngine.git rundot-3D-engine
git submodule update --init --recursive

Usage

import { VenusGame, GameObject, Component } from "@series-inc/rundot-3d-engine"
import { PhysicsSystem, UISystem } from "@series-inc/rundot-3d-engine/systems"

class MyGame extends VenusGame {
  async onCreate(): Promise<void> {
    // Initialize game
  }
  
  async onStart(): Promise<void> {
    // Start game logic
  }
}

Dependencies

• three ^0.180.0
• @dimforge/rapier3d ^0.11.2
• @series-inc/rundot-game-sdk 5.0.4
• @series-inc/stowkit-reader ^0.1.42
• @series-inc/stowkit-three-loader ^0.1.40

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Lint
npm run lint

License

See LICENSE file in root repository.