Maya - 3D Life Simulation Game

A comprehensive 3D life simulation game built with Three.js and TypeScript, featuring realistic 3D environments, character interactions, and complex life simulation systems similar to InZOI. Developed in Cursor with full TypeScript support.

Project Overview

This project creates a 3D life simulation game where players can observe and interact with realistic 3D characters, environments, and ecosystems. The game focuses on detailed character life cycles, social interactions, environmental factors, and emergent behaviors in a beautiful 3D web-based world.

Key Features

• 3D Character System: Realistic 3D characters with detailed animations and behaviors
• Life Cycle Simulation: Birth, growth, aging, reproduction, and death in 3D
• Social Interactions: Characters form relationships, families, and social groups
• Environmental Systems: Dynamic weather, seasons, day/night cycles
• Interactive World: Players can influence the environment and observe outcomes
• Realistic AI: Advanced AI behaviors for autonomous character actions
• Beautiful Graphics: High-quality 3D rendering with modern lighting
• Web-Based: Runs in browser with excellent performance
• Cursor Development: Full TypeScript support with IntelliSense

Technology Stack

• Three.js: 3D graphics library for web
• TypeScript: Type-safe JavaScript development
• Vite: Fast build tool and development server
• React: UI framework for game interface
• Zustand: State management
• Framer Motion: Smooth animations
• WebGL: Hardware-accelerated 3D graphics

Project Structure

maya/
├── src/                    # TypeScript source code
│   ├── core/              # Core game systems
│   ├── entities/          # Character and entity classes
│   ├── systems/           # Game systems (AI, physics, etc.)
│   ├── ui/                # React UI components
│   ├── utils/             # Utility functions
│   └── types/             # TypeScript type definitions
├── public/                 # Static assets
├── assets/                 # Game assets
│   ├── models/            # 3D models and meshes
│   ├── textures/          # Textures and materials
│   └── sounds/            # Audio files
├── docs/                   # Documentation
├── tests/                  # Test files
├── package.json            # Dependencies and scripts
├── vite.config.ts          # Vite configuration
├── tsconfig.json           # TypeScript configuration
└── README.md               # This file

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn
• Cursor IDE
• Git

Installation

1. Clone the repository:

git clone https://github.com/reshdesu/maya.git
cd maya

2. Install dependencies:

npm install

3. Start development server:

npm run dev

4. Open in browser: http://localhost:5173

Development

Core Systems

• Scene Manager: 3D scene management and rendering
• Character System: 3D character management, animations, and behaviors
• Life Cycle System: Manages character aging, reproduction, and death
• AI System: Advanced AI for autonomous character behaviors
• Social System: Handles relationships, families, and social interactions
• Environment System: Dynamic world with weather, seasons, and day/night
• Interaction System: Player interaction with characters and environment

Character Features

• Realistic Appearance: Detailed 3D character models with customizable features
• Personality System: Unique personalities affecting behavior and interactions
• Needs System: Hunger, thirst, sleep, social, and entertainment needs
• Skill System: Characters develop skills through activities
• Relationship System: Complex social relationships and family structures
• Career System: Characters can pursue different careers and hobbies

Environment Features

• Dynamic Weather: Realistic weather effects affecting character behavior
• Day/Night Cycle: Dynamic lighting and character sleep patterns
• Seasonal Changes: Environmental changes affecting character needs
• Interactive Objects: Characters can interact with various objects
• Buildable Structures: Players can build and modify the environment

AI Agent Integration

This project is managed by the AI Context Manager and integrates with:

• BlackBlaze AI Assistant for development tasks
• Knowledge propagation system for learning
• Constitutional framework for code quality and ethics
• Real-time collaboration between AI agents

Contributing

1. Follow the AI Constitutional Framework rules
2. Write clean, documented TypeScript code
3. Use proper project structure
4. Test all new features thoroughly
5. Update documentation as needed

License

This project is licensed under the MIT License - see the LICENSE file for details.

Inspiration

This project is inspired by games like:

• InZOI (Krafton's life simulation game)
• The Sims series
• Animal Crossing
• Stardew Valley

Roadmap

• Basic 3D scene setup with Three.js
• Character system with 3D models
• Character AI and behaviors
• Life cycle simulation
• Social interaction system
• Environment and weather system
• Player interaction mechanics
• Advanced graphics and lighting
• Multiplayer support