Starting a new web-based threejs game and working on the requirements doc. What do you think? Want to work with me on this fun project? I loved Myth: The Fallen Lords as a kid.
# Eternal Eclipse - Game Project Specification
## Game Overview
A multiplayer survival game inspired by Myth: The Fallen Lords, featuring procedurally generated terrain and an eternal eclipse theme.
### Myth: The Fallen Lords Inspiration
Myth: The Fallen Lords is a tactical real-time strategy game where players control small groups of units in intense battles. The game features a unique physics-based combat system where units can be dismembered, thrown, and affected by terrain. Units have distinct abilities and roles - for example, dwarves throw explosive molotov cocktails that can damage both enemies and terrain, while warriors excel in close combat. The game emphasizes tactical positioning, unit management, and environmental awareness. Players must carefully consider terrain advantages, unit formations, and timing of special abilities. The multiplayer mode focuses on competitive battles where players must outmaneuver and outthink their opponents while managing their limited resources and units effectively.
### Core Gameplay
- Player selects troops before match start
- Battle Royale-style gameplay where players fight to be the last survivor
- Support for both multiplayer and single-player (AI) modes
- Fast-paced action with high FPS requirements
### Units
1. Dwarf
- Special ability: Throws molotov cocktails
2. Warrior
- Standard combat unit
3. Ghoul
- Fast-moving creature
4. Archer
- Ranged combat with arrows
## Technical Requirements
### Frontend Stack
- Three.js for 3D rendering
- Voxel/pixel art style (Minecraft-like) for simplified asset creation
- CSS3 for UI and styling
- Hammer.js for touch controls
- GSAP for animations
- RxJS for reactive programming
- Zustand for state management
- TypeScript for type safety
- WebGL 2.0 with fallback support
### Backend Stack
- PHP backend
- https://colyseus.io/ WebSocket server for real-time multiplayer
- WebRTC for peer-to-peer communication
- Build tools:
- Bun for development server, bundling, and minification
- ESLint and Prettier for code quality
- Husky for git hooks
- Vitest for unit testing
### Physics
- Use Rapier.js for physics
- Web Workers for physics calculations
- WebAssembly for performance-critical calculations
- Support for terrain collision and unit interactions, arrows, molotov cocktails shot/thrown, etc
### Visual Theme
- Eternal eclipse in the sky
- Magical atmosphere
- Procedurally generated terrain including:
- Hills
- Water bodies
- Sand areas
- Grass fields
- Walking trails
- Trees
## Project Structure
```
eternaleclipse/
├── public_html/
│ ├── index.php
│ ├── js/
│ │ ├── core/ # Core game engine
│ │ ├── entities/ # Game entities (units, terrain)
│ │ ├── physics/ # Physics calculations
│ │ ├── networking/ # WebSocket and multiplayer
│ │ └── ui/ # UI components
│ ├── css/
│ └── assets/
├── tests/ # Test files
├── scripts/ # Build and utility scripts
└── build/ # Build output directory
```
## Build & Development
- `bun dev`: Launches Bun dev server and PHP server
- `bun test`: Runs unit tests
- `bun run build`:
- Bundles and minifies JS
- Copies files to build/public_html
- Optimizes assets
- Generates service worker for PWA support
## Technical Considerations
- Mobile-first responsive design
- High-performance rendering with WebGL 2.0
- Efficient physics calculations using Web Workers
- Smooth multiplayer synchronization with WebRTC
- AI bot implementation for single-player mode
- Procedural terrain generation
- Asset optimization and streaming for fast loading
- Error boundaries for graceful failure handling
- Progressive Web App (PWA) support
- Type safety with TypeScript
- Code quality enforcement with ESLint and Prettier
- Automated testing with Vitest
## Development Workflow
- Pre-commit hooks with Husky
- Automated code formatting
- Unit test coverage requirements
- TypeScript strict mode
- Asset optimization pipeline
- Development environment parity
## Future Considerations
- Additional unit types
- More terrain variations
- Enhanced AI behavior
- Additional game modes
- Custom map creation 
