{"id":49023136,"url":"https://github.com/garnizeh-labs/aetheris-engine","last_synced_at":"2026-05-19T00:00:41.405Z","repository":{"id":352283484,"uuid":"1214560810","full_name":"garnizeh-labs/aetheris-engine","owner":"garnizeh-labs","description":"The authoritative server framework for the Aetheris Engine. It provides the core 5-stage tick pipeline, spatial partitioning, interest management, and priority-channel multiplexing for massive real-time multiplayer simulations.","archived":false,"fork":false,"pushed_at":"2026-05-14T22:55:30.000Z","size":1088,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T00:42:26.666Z","etag":null,"topics":["aetheris","authoritative-server","ecs","game-engine","garnizeh-labs","multiplayer","networking","rust","simulation","spatial-partitioning"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garnizeh-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY_DESIGN.md","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-04-18T18:38:15.000Z","updated_at":"2026-05-14T22:53:17.000Z","dependencies_parsed_at":"2026-04-24T08:01:59.491Z","dependency_job_id":null,"html_url":"https://github.com/garnizeh-labs/aetheris-engine","commit_stats":null,"previous_names":["garnizeh-labs/aetheris-engine"],"tags_count":136,"template":false,"template_full_name":null,"purl":"pkg:github/garnizeh-labs/aetheris-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garnizeh-labs%2Faetheris-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garnizeh-labs%2Faetheris-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garnizeh-labs%2Faetheris-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garnizeh-labs%2Faetheris-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garnizeh-labs","download_url":"https://codeload.github.com/garnizeh-labs/aetheris-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garnizeh-labs%2Faetheris-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33192578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"ssl_error","status_checked_at":"2026-05-18T09:27:28.300Z","response_time":71,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["aetheris","authoritative-server","ecs","game-engine","garnizeh-labs","multiplayer","networking","rust","simulation","spatial-partitioning"],"created_at":"2026-04-19T05:01:02.872Z","updated_at":"2026-05-19T00:00:41.347Z","avatar_url":"https://github.com/garnizeh-labs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eAetheris Engine\u003c/h1\u003e\n  \u003cp\u003eThe deterministic heart and authoritative simulation core of the Aetheris multiplayer platform.\u003c/p\u003e\n\n  [![CI](https://img.shields.io/github/actions/workflow/status/garnizeh-labs/aetheris-engine/ci.yml?branch=main\u0026style=flat-square\u0026logo=github\u0026label=CI)](https://github.com/garnizeh-labs/aetheris-engine/actions)\n  [![Rust Version](https://img.shields.io/badge/rust-1.95.0%2B-blue?style=flat-square\u0026logo=rust)](https://www.rust-lang.org/)\n  [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=flat-square)](https://conventionalcommits.org)\n  [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/garnizeh-labs/aetheris-engine/pulls)\n\u003c/div\u003e\n\n---\n\n## ⚙️ The Deterministic Heart — Authoritative Simulation\n\nIn modern multiplayer architecture, the server is more than a message relay — it is the absolute source of truth. **Aetheris Engine** provides the sub-millisecond precision, high-frequency tick scheduling, and deterministic ECS bridging required to synchronize complex worlds across unreliable networks.\n\n\u003e [!IMPORTANT]\n\u003e 🚀 **Current State:** **Phase 1 Performance Stabilization complete!** Upgraded to Protocol v0.2.13. Implemented a Rayon-parallelized replication pipeline and stabilized gRPC/internal auth integration. All 11+ integration tests are green, providing a deterministic foundation for the upcoming Phase 2 stress-testing and telemetry phase.\n\n### 📦 Workspace Components\n\n| Crate | Link | Documentation |\n| :--- | :--- | :--- |\n| **`aetheris-server`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-server?style=flat-square)](https://crates.io/crates/aetheris-server) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-server?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-server) |\n| **`aetheris-ecs-bevy`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-ecs-bevy?style=flat-square)](https://crates.io/crates/aetheris-ecs-bevy) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-ecs-bevy?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-ecs-bevy) |\n| **`aetheris-transport-renet`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-transport-renet?style=flat-square)](https://crates.io/crates/aetheris-transport-renet) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-transport-renet?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-transport-renet) |\n| **`aetheris-transport-webtransport`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-transport-webtransport?style=flat-square)](https://crates.io/crates/aetheris-transport-webtransport) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-transport-webtransport?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-transport-webtransport) |\n| **`aetheris-transport-quinn`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-transport-quinn?style=flat-square)](https://crates.io/crates/aetheris-transport-quinn) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-transport-quinn?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-transport-quinn) |\n| **`aetheris-ecs-custom`** | [![Crates.io](https://img.shields.io/crates/v/aetheris-ecs-custom?style=flat-square)](https://crates.io/crates/aetheris-ecs-custom) | [![Docs.rs](https://img.shields.io/docsrs/aetheris-ecs-custom?style=flat-square\u0026logo=docs.rs\u0026label=docs)](https://docs.rs/aetheris-ecs-custom) |\n\n## Workspace Components\n\nThe engine is built on modular, specialized crates for maximum reuse and testing isolation:\n\n- **[`aetheris-server`](crates/aetheris-server)**: The authoritative heartbeat. Handles tick scheduling (60Hz), delta extraction, and multi-transport orchestration.\n- **[`aetheris-ecs-bevy`](crates/aetheris-ecs-bevy)**: The primary simulation adapter. Bridges Aetheris Protocol traits to the Bevy ECS ecosystem with zero-cost abstractions.\n- **[`aetheris-ecs-custom`](crates/aetheris-ecs-custom)**: Phase 3 custom SoA ECS. Optimized for extreme entity densities and cache-friendly iteration.\n- **[`aetheris-transport-renet`](crates/aetheris-transport-renet)**: Phase 1 UDP transport using the `renet` protocol. Optimized for raw performance and low latency.\n- **[`aetheris-transport-quinn`](crates/aetheris-transport-quinn)**: Phase 3 native QUIC transport. Provides reliable streams and unreliable datagrams with modern security.\n- **[`aetheris-transport-webtransport`](crates/aetheris-transport-webtransport)**: Phase 3 browser-native transport. Enables sub-millisecond latency for web-based clients.\n\n## Quickstart\n\n```bash\n# 1. Run the quality gate (fmt, clippy, tests, security, docs)\njust check\n\n# 2. Automatically apply formatting and clippy fixes\njust fix\n\n# 3. List all specialized maintenance and run commands\njust --list\n```\n\n### 🛠️ Common Tasks\n\n| Command | Category | Description |\n| :--- | :--- | :--- |\n| `just check` | **Quality** | Fast local validation: fmt, clippy, integration tests, and security audit. |\n| `just fix` | **Lint** | Forces formatting and applies legal clippy suggestions. |\n| `just test` | **Test** | Runs the full integration suite using `nextest`. |\n| `just server` | **Run** | Boots the game server in debug mode with auth bypass enabled. |\n\n## The Three Pillars\n\n1. **Authoritative Scheduling**: A high-precision 60Hz loop governing the five stages of a tick: **POLL**, **APPLY**, **SIMULATE**, **EXTRACT**, and **SEND** — each must complete within 16.6 ms total; no blocking I/O is permitted inside any stage.\n2. **Simulation Abstraction**: A trait-driven bridge allowing the engine to drive any ECS (Bevy or custom) without modifying networking logic.\n3. **Hardened Integrity**: Every input is validated, every state is replicated, and every vital is protected against division-by-zero or out-of-bounds corruption.\n\n## 🚀 Performance \u0026 Determinism (VS-07)\n\nThe engine implements strict performance and architectural integrity contracts:\n\n### Microbenchmarks \u0026 Zero-Alloc\nWe use `criterion` for sub-microsecond precision and `alloc_counter` to enforce a **Zero Heap Allocation** policy in hot-path pipelines.\n- **Run all benchmarks:** `just bench`\n- **Zero-Alloc Assertion:** The `ecs_extract_dirty` benchmark will `panic!` if any heap allocation occurs during extraction.\n- **Warmup:** Benchmarks include a mandatory 100-tick warmup to stabilize Bevy query states before measurement.\n\n### Determinism Validation (Golden Files)\nTo prevent drift across platforms or versions, we use **Golden File Recording**:\n1. **Record:** `just record-golden` (Captures 600 ticks of world state hashes to `golden_600ticks.bin`).\n2. **Verify:** `rtk cargo test --test determinism --features phase1` (Replays simulation and verifies hashes bit-for-bit).\n\n---\n\nLicense: MIT / Apache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarnizeh-labs%2Faetheris-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarnizeh-labs%2Faetheris-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarnizeh-labs%2Faetheris-engine/lists"}