CrownyEngine

핵심 구성요소

설치 및 실행

# CrownyEngine으로 새 게임 프로젝트 만들기
crowny new 나의게임
cd 나의게임
cargo run

# 자동 생성:
#   src/main.rs          ← CrownyReal GPU 3D 게임 템플릿
#   assets/maps/main.crs ← 씬 파일
#   scripts/시작.kps     ← 한선씨 스크립트

# 생활 시뮬레이션
cargo run -p crowny-world                    # 2D (설정→타이틀→게임)
cargo run -p crowny-world -- world3d         # 3D 마을 (하이트맵+NPC+낮밤)

# 레이싱
cargo run -p crowny-world -- race            # 오벌 트랙
cargo run -p crowny-world -- race 2          # S자 트랙
cargo run -p crowny-world -- race 3          # 8자 트랙

# 게임 내 F1=2D, F2=2.5D, F3=3D, F4=CrownyReal GPU

# 한국어 프로그래밍
crowny repl                   # 대화형 모드
crowny run 안녕.kps           # 스크립트 실행
crowny build 게임.kps -o 게임  # ARM64 바이너리 컴파일
crowny teach                  # 5단계 튜토리얼

아키텍처

크라우니월드 (게임)
    ↓
CrownyEngine (엔진 — 씬, AI, 물리, UI, 오디오)
    ↓
CrownyReal GPU (Metal/DirectX 대체 — 소프트웨어 렌더러)
    ↓
한선씨 컴파일러 → ISA729 VM → ARM64 JIT
    ↓
CrownyOS (bare-metal) 또는 macOS/Linux

CrownyReal v1.0 — GPU 표준 규격

Apple Metal / Microsoft DirectX 12를 대체하는 소프트웨어 GPU 렌더러. 크라우니 패밀리 병렬 엔진 표준.

7단계 렌더링 파이프라인

CrownyReal vs Metal vs DirectX 12

GpuRenderer API (trait)

// 게임 코드는 trait만 사용 — 백엔드 무관
let mut gpu: Box<dyn GpuRenderer> = Box::new(CrownyReal::new(800, 600, GpuBackend::Software));

gpu.set_camera(cam_pos, cam_target, fov);
let mesh = gpu.add_mesh(Mesh::cube());
let toon = gpu.add_shader(CrShader::Toon { levels: 3 });
let obj = gpu.add_object("플레이어", transform, Color::RED, mesh);
gpu.bind_shader(obj, toon);
gpu.render();

// 16개 trait 메서드: set_camera, clear, add_object, set_transform,
// bind_texture, bind_shader, remove_object, add_texture, add_shader,
// add_light, clear_lights, add_mesh, render, apply_post_effect,
// enable_shadows, stats

CrownyReal 고유 기술: 4상 가시성 FSM

Unaware → (보임) → Unconfirmed → (보임) → Confirmed
  ↑                    ↓                       ↓
  └── (안 보임) ──── (안 보임) ← Misunderstood ← (안 보임)

Metal/DirectX에 없는 CrownyReal 고유 기술:
- Confirmed에서 한 프레임 안 보여도 바로 끄지 않음 (팝인 방지)
- LOD 레벨 자동 결정 (Confirmed=0, Unconfirmed=1, Unaware=2)
- 4상균형3진 아키텍처와 통합

모듈 목록 (86개)

4상균형3진 (핵심 차별점)

Claude 에이전트 참조

# 이 엔진을 참조하는 Claude 인스턴스는:
# 1. /Users/ef/Downloads/CrownyEngine/ 경로에서 소스 접근
# 2. CLAUDE.md 읽고 코딩 규칙 준수
# 3. 4상균형3진 원칙 유지
# 4. 외부 의존성 0 원칙
# 5. cargo test --workspace 전체 통과 필수
# 6. crownybus.com 상태 확인 (200 OK 유지)

# 핵심 파일:
#   CLAUDE.md — 프로젝트 규칙
#   docs/CROWNYFRAME_SPEC.md — 전체 규격서
#   docs/HANDOFF.md — 인스턴스 간 인계
#   src/engine/src/lib.rs — 엔진 메인
#   src/game/src/main.rs — 게임 메인