microverse

Microverse is a god-game sandbox developed with Godot 4, functioning as a multi-agent AI social simulation system. AI characters possess independent thoughts and memory, enabling autonomous social interactions, task completion, and the development of complex social relationships through ongoing communication. ## Project Features - **Sandbox AI Society**: Similar to Stanford AI Town, AI characters live and interact autonomously in an open world - **Multi-Agent Ecosystem**: Supports multiple AI characters engaging in complex social interactions simultaneously in scenes - **Intelligent Dialogue System**: Natural conversations based on large language models, supporting multiple API providers - **Persistent Memory System**: AI characters have long-term memory, remembering historical dialogues and events, forming continuous life experiences - **Autonomous Task Management**: AI characters can autonomously accept, execute, and manage various tasks, showcasing realistic work and life - **Environmental Awareness**: AI characters can perceive their surroundings and the states of other characters, reacting accordingly - **Multiple AI Service Integration**: Supports various AI services including OpenAI, Claude, Gemini, DeepSeek, Doubao, and Kimi ## Sandbox Game Features ### AI Character Ecosystem - 8 preset AI characters, each with unique personalities, backstories, and behavioral patterns - Characters can move, explore, and interact freely in the virtual world - Supports character state management, emotional changes, and autonomous behavior decisions - AI characters react realistically based on environment and social situations ### Natural Social System - Natural language dialogue based on large language models, supporting multi-turn deep conversations - Dynamic dialogue bubble UI displaying real-time communication between characters - Complete dialogue history recording and playback functionality - Supports group discussions, private conversations, and random social interactions ### Intelligent Memory and Learning - Persistent long-term memory storage system - AI characters can learn and adapt to environmental changes - Formatted memory storage and intelligent retrieval - Personalized behavior development based on memory ### Autonomous Task Ecosystem - Automatic task creation, intelligent assignment, and real-time tracking - Priority-based task management system - Dynamic monitoring of task completion status - Task collaboration and competition mechanisms among AI characters ## Technology Stack - **Game Engine**: Godot 4.3+ - **Programming Language**: GDScript - **AI Integration**: REST API calls - **Data Storage**: Local storage in JSON format - **UI Framework**: Godot built-in UI system ## System Requirements ### Development Environment - Godot 4.3 or higher ### Supported Platforms - **Windows**: Windows 10/11 (64-bit) - **macOS**: macOS 10.15+ (Intel/Apple Silicon) - **Linux**: Ubuntu 18.04+, Fedora 32+, Arch Linux, and other mainstream distributions - **Android**: Android 6.0+ (API Level 23+) ### Hardware Requirements - **Minimum Configuration**: 4GB RAM, 1GB available storage - **Recommended Configuration**: 8GB RAM, 2GB available storage - **Network**: Stable internet connection (for AI API calls) ### Notes - Android platform requires additional platform-specific configuration - All platforms require a valid AI service API key for dialogue functionality to work properly ## Quick Start 1. Clone the project: `git clone https://github.com/KsanaDock/Microverse.git` 2. Open the project: Launch the Godot editor and import the `project.godot` file 3. Configure API: Run the game, press ESC to open the settings interface, and configure the AI service provider and API key 4. Start the game: Select a map (currently supports the office scene), use WASD to move characters, press T to start dialogue, press L to end dialogue, and press the ` key to open the console ## Usage Instructions ### Basic Controls - **Move**: WASD keys or arrow keys - **Sit**: Spacebar - **Start Dialogue**: T key - **End Dialogue**: L key - **Open Settings**: ESC key - **Save/Load**: F1 key - **Console**: ` key (backtick) ### AI Character Introduction - **Alice**: Friendly project manager - **Grace**: Professional data analyst - **Jack**: Creative designer - **Joe**: Technical expert - **Lea**: Marketing specialist - **Monica**: HR specialist - **Stephen**: Financial analyst - **Tom**: Software development engineer ### Advanced Features - **Memory Viewing**: View AI character memories in the console - **Task Management**: Assign and manage tasks for AI characters - **Scene Switching**: Supports multiple scene maps - **Save System**: Save and load game states ## Development Guide ### Project Structure ``` office/ ├── asset/ # Game resource files ├── scene/ # Scene files ├── script/ # Script files │ ├── ai/ # AI-related scripts │ └── ui/ # UI-related scripts └── docs/ # Documentation files ``` ### Core Systems - **APIManager**: API call management - **DialogManager**: Dialogue system management - **MemoryManager**: Memory system management - **CharacterManager**: Character management - **TaskManager**: Task management ### Extension Development - Add new AI characters - Create new scene maps - Integrate new AI service providers - Extend dialogue functionality ## Steam Version Coming Soon "Microverse In Box" is coming to the Steam platform! This repository open-sources the initial Demo version of the game from June 2025, providing learning and reference material for developers and enthusiasts. The full version will be released on Steam, featuring more functionality, optimizations, and content. ## Contribution Guide Contributions are welcome! Please follow these steps: 1. Fork this project 2. Create a feature branch (`git checkout -b feature/AmazingFeature`) 3. Commit your changes (`git commit -m 'Add some AmazingFeature'`) 4. Push to the branch (`git push origin feature/AmazingFeature`) 5. Create a Pull Request ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## Acknowledgements - Godot game engine team - Various AI service providers - Contributors from the open-source community - Art assets source: [LimeZu](https://limezu.itch.io/) - Thanks to this excellent artist for providing beautiful game assets - Server gifted by dartnode ## Contact For questions or suggestions, please contact us through: - Submit an Issue: [GitHub Issues](https://github.com/KsanaDock/Microverse/issues) - Official Website: [KsanaDock](https://www.ksanadock.com) ## Follow Us Follow our latest updates on social media: - Xiaohongshu, Bilibili, GitHub, X (Twitter), Steam, YouTube ## Star History [](https://www.star-history.com/#KsanaDock/Microverse&type=date&legend=top-left) **Note**: Using this project requires a valid AI service API key. Please ensure compliance with the terms and conditions of each AI service provider.