{"id":49575898,"url":"https://github.com/donkey-projects/parsecnova","last_synced_at":"2026-05-10T23:16:22.674Z","repository":{"id":355059307,"uuid":"1226603751","full_name":"donkey-projects/ParSecNova","owner":"donkey-projects","description":"A modern, open-source reimagining of the classic space sim ParSec. Built with Godot 4, C#, and AI-assisted world generation.","archived":false,"fork":false,"pushed_at":"2026-05-01T19:50:28.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T20:10:23.061Z","etag":null,"topics":["csharp","godot","multiplayer","newtonian-physics","open-source","parsec","space-sim"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/donkey-projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-01T15:57:43.000Z","updated_at":"2026-05-01T19:50:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/donkey-projects/ParSecNova","commit_stats":null,"previous_names":["cute-donkey/parsec2026","cute-donkey/parsecnova"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/donkey-projects/ParSecNova","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkey-projects%2FParSecNova","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkey-projects%2FParSecNova/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkey-projects%2FParSecNova/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkey-projects%2FParSecNova/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/donkey-projects","download_url":"https://codeload.github.com/donkey-projects/ParSecNova/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/donkey-projects%2FParSecNova/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32577126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","godot","multiplayer","newtonian-physics","open-source","parsec","space-sim"],"created_at":"2026-05-03T17:01:28.986Z","updated_at":"2026-05-10T23:16:22.668Z","avatar_url":"https://github.com/donkey-projects.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ParSec Nova\n\nA modern, open-source rebirth of the legendary linux space combat simulator **ParSec** (1999/2002). \n\nThis project aims to bridge the gap between classic Newtonian flight physics and modern game engine technology. By leveraging **Rust** and **Bevy**, we are rebuilding the experience from the ground up, focusing on decentralized multiplayer and AI-driven world-building.\n\n## ✨ Core Vision\n\n- **Authentic Physics:** Implementation of the original Newtonian flight model for deep, skill-based space combat.\n- **AI-Driven World Building:** Every player can define their own static sectors using AI prompts, saved in a standardized JSON format.\n- **Decentralized Multiplayer:** No central server authority. Players host their own worlds and share sector data peer-to-peer.\n- **Open Source Heritage:** Built on the spirit of the original GPL sources, keeping the galaxy free and moddable forever.\n\n## 🛠 Tech Stack\n\n- **Language:** [Rust](https://www.rust-lang.org/)\n- **Engine:** [Bevy](https://bevyengine.org/) (ECS-based game engine)\n- **Physics:** Custom Newtonian physics systems using Bevy's ECS architecture.\n- **Architecture:** Strict separation of simulation (headless) and visualization.\n- **Data Format:** JSON-based world definitions with dynamic runtime loading.\n- **Build System:** Cargo with static compilation for portable binaries.\n- **Development:** Docker/DevContainer for isolated build environment.\n\n## 📂 Repository Structure\nThis project is part of the [donkey-projects](https://github.com/donkey-projects) organization. To facilitate development, the following repositories are used:\n\n* **Development:** [ParSecNova](https://github.com/donkey-projects/ParSecNova) (This repository)\n* **Legacy Assets:** [orig-openparsec-assets](https://github.com/donkey-projects/orig-openparsec-assets) (Original artwork and sound archives)\n* **Legacy Sources:** [orig-openparsec](https://github.com/donkey-projects/orig-openparsec) (Original ParSec source code)\n\n## 🚀 Getting Started\n\n**⚠️ Important Notice:** This project is currently in **early development**. We have completed the analysis and planning phase (Phase 1) and set up the basic project structure (Phase 1.4). The actual game implementation (Phase 2+) has not yet begun. Please see the [Project Plan](plans/) for detailed development progress.\n\n### Prerequisites\n- Rust toolchain (stable)\n- Docker and DevContainer support (recommended)\n- For visualization: Native graphics drivers (Vulkan/Metal/DX12)\n\n### Installation\n1. Clone the repository:\n```bash\n   git clone https://github.com/donkey-projects/ParSecNova.git\n   cd ParSecNova\n```\n\n2. Open in DevContainer (recommended):\n```bash\n   # Open in VS Code with DevContainer extension\n   code .\n   # Reopen in Container when prompted\n```\n\n3. Or build locally:\n```bash\n   cargo build --release\n```\n\n### Current Development Status\n- ✅ **Phase 1.1**: Original ParSec Analysis (completed)\n- ✅ **Phase 1.2**: Technical Requirements (completed)\n- ✅ **Phase 1.3**: Asset Analysis \u0026 AI Modernization (completed)\n- 🟠 **Phase 1.4**: Project Structure \u0026 Tech Stack Migration (in progress)\n- ⏳ **Phase 2**: Early Prototype (upcoming)\n\n### Project Structure\n```\nParSecNova/\n├── src/                    # Rust source code\n│   ├── core/              # Core ECS systems (Physics, Components)\n│   ├── simulation/        # Headless simulation logic\n│   ├── visualization/     # Client-side rendering systems\n│   └── systems/           # Bevy systems and queries\n├── assets/                # Game assets\n│   ├── models/            # 3D models (glTF/GLB)\n│   ├── textures/          # Textures (PNG/WebP)\n│   ├── sounds/            # Audio files (WAV/OGG)\n│   └── worlds/            # JSON world definitions\n├── benches/               # Performance benchmarks\n├── tests/                 # Integration and unit tests\n└── target/                # Cargo build output\n```\n\n### Building\n```bash\n# Development build\ncargo build\n\n# Release build with optimizations\ncargo build --release\n\n# Run tests\ncargo test\n\n# Run benchmarks\ncargo bench\n```\n\n### Running\n```bash\n# Headless simulation (server mode)\ncargo run --bin simulation\n\n# Full client with visualization\ncargo run --bin client\n\n# Both simulation and client\ncargo run\n```\n\n### Architecture Highlights\n\n#### ECS-Based Design\nParSecNova uses Bevy's Entity Component System for massive parallel processing:\n- **Entities**: Game objects (ships, asteroids, projectiles)\n- **Components**: Data (position, velocity, mass, visual assets)\n- **Systems**: Logic that processes components (physics, rendering, AI)\n\n#### Headless Simulation\nThe core simulation runs completely headless, enabling:\n- Server-side world generation with AI\n- Massive-scale physics calculations\n- P2P world sharing without visual dependencies\n\n#### Dynamic World Loading\nWorlds are defined entirely in JSON format:\n- Entities and their physical properties\n- Asset references (models, textures, sounds)\n- Complete world state can be shared between players\n- No code changes required for new content\n\nFor detailed licensing and a list of original contributors, see **[CREDITS.md](CREDITS.md)**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonkey-projects%2Fparsecnova","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdonkey-projects%2Fparsecnova","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdonkey-projects%2Fparsecnova/lists"}