Eustress Engine - Monorepo

A batteries-included Rust game engine and editor built with Bevy + egui.

What's Inside

• Engine - Desktop 3D editor/studio for scene creation
• Client - Generative player/renderer with AI enhancements
• Common - Shared scene format, types, and utilities
• Utilities - Camera controllers, networking, and more

Prerequisites

• Rust (latest stable)
• Cargo

Quick Start

Run the Engine (Studio)

cd eustress
cargo run --bin eustress-engine

# Or use the helper script
.\build-and-run.ps1 engine

Run the Client (Player)

cd eustress
cargo run --bin eustress-client

# Or use the helper script
.\build-and-run.ps1 client

Check All Crates

cargo check --workspace

Building for Production

cd eustress

# Build engine
cargo build --bin eustress-engine --release

# Build client
cargo build --bin eustress-client --release

# Build everything
cargo build --workspace --release

Binaries output to: eustress/target/release/

Architecture

• Engine: Bevy 0.14
• UI: egui (immediate-mode GUI)
• Language: 100% Rust
• Platform: Desktop only (Windows, macOS, Linux)

Features

• Integrated 3D Viewport: Native Bevy rendering with egui overlay
• Scene Hierarchy: Explorer panel with part tree
• Properties Editor: Real-time entity property editing
• Transform Tools: Move, Rotate, Scale with visual gizmos
• Console Output: Real-time logging and debugging
• Zero Overhead: Direct Rust function calls, no IPC

Project Structure

eustress/                     # Workspace root
├── Cargo.toml               # Workspace configuration
├── rust-toolchain.toml      # Rust version pinning
├── build-and-run.ps1        # Build helper script
├── crates/
│   ├── common/              # Shared scene format & types
│   │   ├── src/
│   │   │   ├── scene.rs    # Scene definitions
│   │   │   ├── types.rs    # Common types
│   │   │   └── utils.rs    # Utilities
│   │   └── Cargo.toml
│   ├── engine/              # Desktop editor/studio
│   │   ├── src/
│   │   │   ├── main.rs     # Entry point
│   │   │   ├── ui/         # egui panels
│   │   │   ├── parts.rs    # Part management
│   │   │   └── rendering.rs
│   │   └── Cargo.toml
│   ├── client/              # Generative player/renderer
│   │   ├── src/
│   │   │   └── main.rs     # Client entry
│   │   └── Cargo.toml
│   ├── bevy-camera-controller/  # Camera utilities
│   └── bevy-webtransport/       # Networking
└── assets/                  # Shared assets

See DESKTOP_EGUI.md for detailed documentation.