mattmone/aether-shards
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: Add initial game content including missions, narrative sequences, and NPC personality specifications.

Browse source
This commit is contained in:
Matthew Mone 2026-01-02 12:14:15 -08:00
parent 8ac9fa441d
commit 4d531c23de
1 changed files with 52 additions and 27 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

79
README.md
View file

@ -43,41 +43,55 @@ A tactical turn-based roguelike strategy game built with Three.js, featuring pro
## Project Structure ## Project Structure
``` ```
specs/ # Detailed feature specifications and design docs
src/ src/
├── assets/ ├── assets/
│ ├── data/ │ ├── data/
│ │ ├── classes/ # Character class definitions (JSON) │ │ ├── classes/ # Character class definitions (JSON)
│ │ ├── missions/ # Mission configurations │ │ ├── effects/ # Status effects and abilities
│ │ └── narrative/ # Dialogue sequences │ │ ├── missions/ # Mission configurations
│ └── images/ # Character portraits and assets │ │ ├── narrative/ # Dialogue sequences
│ │ ├── skill_trees/ # Class skill tree templates
│ │ └── skills/ # Individual skill definitions
│ └── images/ # Character portraits and assets
├── core/ ├── core/
│ ├── GameLoop.js # Main game loop and Three.js setup │ ├── GameLoop.js # Main game loop and Three.js setup
│ ├── GameStateManager.js # Application state management │ ├── GameStateManager.js # Application state management
│ ├── InputManager.js # Input handling (keyboard/gamepad) │ ├── InputManager.js # Input handling (keyboard/gamepad)
│ └── Persistence.js # Save/load system │ └── Persistence.js # Save/load system
├── factories/
│ └── SkillTreeFactory.js # Skill tree generation logic
├── generation/ ├── generation/
│ ├── BaseGenerator.js # Base class for world generators │ ├── BaseGenerator.js # Base class for world generators
│ ├── CaveGenerator.js # Cave biome generator │ ├── CaveGenerator.js # Cave biome generator
│ ├── RuinGenerator.js # Ruin biome generator │ ├── RuinGenerator.js # Ruin biome generator
│ └── textures/ # Procedural texture generators │ └── textures/ # Procedural texture generators
├── grid/ ├── grid/
│ ├── VoxelGrid.js # 3D voxel grid data structure │ ├── VoxelGrid.js # 3D voxel grid data structure
│ └── VoxelManager.js # Voxel rendering and mesh management │ └── VoxelManager.js # Voxel rendering and mesh management
├── managers/ ├── managers/
│ ├── MissionManager.js # Mission progression and objectives │ ├── InventoryManager.js # Equipment and inventory
│ ├── NarrativeManager.js # Dialogue and story sequences │ ├── ItemRegistry.js # Item definitions
│ ├── RosterManager.js # Character roster management │ ├── MarketManager.js # Shop and trading logic
│ └── UnitManager.js # Unit lifecycle and combat state │ ├── MissionManager.js # Mission progression and objectives
│ ├── NarrativeManager.js # Dialogue and story sequences
│ ├── ResearchManager.js # Tech tree and upgrades
│ ├── RosterManager.js # Character roster management
│ ├── SkillRegistry.js # Skill definitions map
│ └── UnitManager.js # Unit lifecycle and combat state
├── ui/ ├── ui/
│ ├── deployment-hud.js # Pre-battle deployment interface │ ├── deployment-hud.js # Pre-battle deployment interface
│ ├── team-builder.js # Squad composition screen │ ├── team-builder.js # Squad composition screen
│ ├── game-viewport.js # 3D game viewport component │ ├── game-viewport.js # 3D game viewport component
│ └── dialogue-overlay.js # Narrative dialogue display │ └── dialogue-overlay.js # Narrative dialogue display
├── units/ ├── units/
│ ├── Unit.js # Base unit class │ ├── Unit.js # Base unit class
│ ├── Explorer.js # Player-controlled units │ ├── Explorer.js # Player-controlled units
│ └── Enemy.js # Enemy AI units │ └── Enemy.js # Enemy AI units
└── index.js # Application entry point ├── utils/
│ ├── SeededRandom.js # Deterministic RNG
│ └── SimplexNoise.js # Noise generation
└── index.js # Application entry point
``` ```
## Getting Started ## Getting Started
@ -157,6 +171,15 @@ npm run test:watch
- **Narrative**: Intro and outro sequences that advance the story - **Narrative**: Intro and outro sequences that advance the story
- **Campaign Progression**: Unlock new missions as you complete objectives - **Campaign Progression**: Unlock new missions as you complete objectives
## Documentation
For detailed specifications of game systems, please see the `specs/` directory:
- [Character Sheet](specs/Character_Sheet.spec.md)
- [Combat System](specs/CombatState.spec.md)
- [Skill Trees](specs/Skill_Tree.spec.md)
- [Inventory](specs/Inventory.spec.md)
- [Procedural Missions](specs/Procedural_Missions.spec.md)
## Development Status ## Development Status
This is an active development project. Current features include: This is an active development project. Current features include:
@ -168,14 +191,16 @@ This is an active development project. Current features include:
- ✅ Mission system foundation - ✅ Mission system foundation
- ✅ Basic world generation - ✅ Basic world generation
- ✅ Save/load system - ✅ Save/load system
- ✅ Turn-based combat system
- ✅ AI behavior
- ✅ Skill tree implementation
- ✅ Equipment system
Planned features: Planned features / In Progress:
- 🔄 Turn-based combat system - 🔄 Additional biomes (Crystal Spires)
- 🔄 AI behavior - 🔄 Advanced AI behavior (Pack tactics, Retreat)
- 🔄 Skill tree implementation - 🔄 Endgame campaign content
- 🔄 Equipment system
- 🔄 Additional biomes and missions
## License ## License