# valkyr-engine

**Repository Path**: aphx/valkyr-engine

## Basic Information

- **Project Name**: valkyr-engine
- **Description**: 我的自制游戏引擎，试验各种游戏渲染技术
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-06
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# my-engine

High-performance C++ RTS/TD game engine — macOS Metal (primary), Windows DX12.

**Docs:** [Tech Stack](CLAUDE.md) · [Roadmap](.planning/ROADMAP.md) · [Architecture](.planning/research/ARCHITECTURE.md) · [Phase Plans](.planning/phases/01-foundation/)

## Build & Test

Requires: CMake 3.28+, Ninja, Xcode 14+ (macOS).

```sh
# Headless CI (no GPU)
cmake --preset null-ci && cmake --build --preset null-ci
ctest --preset null-ci --output-on-failure

# macOS Metal
cmake --preset macOS-metal-debug && cmake --build --preset macOS-metal-debug
./build/macos-debug/game/my-engine-game
```

Other presets: `macOS-metal-release`, `windows-dx12-debug`

## metal-cpp (Metal builds only)

Download from https://developer.apple.com/metal/cpp/ → extract to `third_party/metal-cpp/`.  
Not needed until Plans 01-07/01-08.

## Troubleshooting

| Symptom | Fix |
|---------|-----|
| `cmake --preset` not found | `brew upgrade cmake` (need 3.20+) |
| Metal compiler errors | Xcode → Settings → Components → Metal Toolchain |
| CPM download failures | Uses Gitee mirrors; pre-populate `CPM_SOURCE_CACHE` |