0 Fork 0

Files

T

Cursor Agentand西风逍遥游 a118a4876a Add procedural road network system under procgen

Introduce math-only road baking (profile loft, piers, markings,
navigation overlays) with mesh.roadNetwork / tex.roadMarkings recipes,
design docs, unit tests, and a procedural-road example.

Co-authored-by: 西风逍遥游 <sunxfancy@gmail.com>

2026-09-18 13:50:36 +00:00

baselines

feat: add scalable terrain streaming and editor persistence

2026-09-10 08:11:01 +08:00

images

feat(fluids): build oriented droplet render instances

2026-08-23 18:58:29 +08:00

img

docs: review every user module chapter

2026-08-09 21:41:58 +08:00

plans

feat(animation): add reference-driven motion matching runtime

2026-09-15 11:40:12 +08:00

reference/civ5-terrain

feat: add procedural civilization-style hex terrain

2026-08-26 02:50:01 +08:00

specs

fix(fluids): stabilize surface simulation timesteps

2026-08-23 19:11:18 +08:00

superpowers

feat(dnut): add host-injected movement and animation ports

2026-09-18 12:47:55 +08:00

2.5D-tilemap-developer-evaluation.md

feat(map): add composable 2.5D tileset workflow

2026-08-24 13:38:11 +08:00

2d-sprite-animation-api-evaluation.md

feat(animation): add production sprite sequence workflow

2026-08-24 12:39:59 +08:00

2D渲染API设计.md

Report retained draw failures and fix offscreen layout tracking

2026-09-09 16:50:54 +08:00

3D渲染管线.md

chore: update .gitignore to exclude log files; enhance Makefile with debug targets for win32, linux, and macosx; refine ClassicScenes documentation and add phase frame dumping; adjust inventory example UI layout

2026-08-28 21:47:16 +08:00

2026-08-26-architecture-consolidation-checklist.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-26-definition-runtime-instance.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-26-profile-quality-gates.md

refactor(editor): separate domain editing satellites

2026-08-31 08:56:26 +08:00

2026-08-26-resource-account-gameplay-adapters.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-26-third-party-patch-repair.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-26-three-day-integration-audit.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-26-time-subscription-consumer-migration.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

2026-08-29-agent-native-engine-architecture.md

refactor(editor): integrate domain editing satellites

2026-08-29 18:12:02 +08:00

2026-08-29-editing-editor-layering.md

refactor(editor): separate domain editing satellites

2026-08-31 08:56:26 +08:00

2026-08-30-ecs-gpu-efficiency.md

feat(gpgpu): add resident ECS simulation and script rendering

2026-08-31 18:07:52 +08:00

2026-08-31-realtime-material-studio.md

feat(editor): add real-time material studio

2026-08-31 08:52:04 +08:00

2026-09-04-domain-editor-workspace-ui.md

feat(editor): add procgen script, UI theme, and voxel catalog workspaces

2026-09-05 19:08:50 +08:00

2026-09-05-play-verify-evolve.md

feat(devtools): add Play Host, Play Trace, and evidence-gated session close

2026-09-05 19:09:00 +08:00

2026-09-09-scene-editing-composition.md

Add composable scene editing sessions and in-game builder examples

2026-09-09 23:24:34 +08:00

2026-09-09-shader-effect-assets.md

style: remove trailing blank lines in shader package files

2026-09-09 17:22:35 +08:00

2026-09-10-agent.md

feat(agent): add evolutionary learning with Squirrel and tensor GPU backends

2026-09-10 16:46:56 +08:00

2026-09-12-physics-integration-review.md

feat(physics): integrate runtime domains and transactional snapshots

2026-09-13 01:03:33 +08:00

2026-09-14-archspace-editor.md

feat(archspace): interactive tools, catalog furniture, parametric openings (#395 )

2026-09-15 07:25:24 +08:00

2026-09-14-litmotion-tween-capability-research.md

feat(animation): LitMotion-style Motion APIs (Phases 1–4) (#389 )

2026-09-15 00:27:46 +08:00

Agent游戏开发范式.md

feat(devtools): add Play Host, Play Trace, and evidence-gated session close

2026-09-05 19:09:00 +08:00

AI与MCP支持.md

feat(devtools): add evidence-gated agent game development workflow

2026-08-30 21:32:08 +08:00

AI场景导演.md

feat(story-scene-agent): story-to-qualified-stage orchestrator + example

2026-08-17 10:10:37 +08:00

API-CONVENTIONS.md

api(graphics): align C++/script names, validate sampler strings, document error contracts

2026-08-22 02:30:12 +08:00

canonical-mesh-v2.md

feat(procgen): add integrated terrain world generation pipeline

2026-09-15 11:34:02 +08:00

Container、Zone与Transfer协议.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

dnut序列语言与解释器.md

feat(dnut): add the L1 .dnut sequence language and the RPG story dialect

2026-09-17 17:19:02 +08:00

dynamic-skin-palettes.md

Support UE skeletal assets, extensible skin palettes and PBR materials

2026-09-10 08:34:07 +08:00

editor-module-gap-analysis.md

refactor(property_access): fold scriptmodel into the squirrel adapter

2026-09-09 20:59:30 +08:00

editor-tool-protocol.md

docs(editor): explain protocol-first editor composition

2026-08-23 19:36:25 +08:00

Eve-Schema子集与绑定契约.md

fix: complete architecture consolidation contracts

2026-08-28 00:01:55 +08:00

EVEngine资产包与运行时包规范.md

feat(asset): import Unity packages, static prefabs and sprite animations

2026-09-09 13:35:28 +08:00

EveScript语言设计.md

Enhance module configuration and instantiation in EveScript. Updated documentation to clarify the behavior of modules and optionalModules, ensuring only specified slots are instantiated during startup. Improved runtime checks and added support for deferred module binding. Removed deprecated compute shaders and example maps to streamline the project structure.

2026-09-01 00:56:50 +08:00

fuzz-testing.md

test: add zeroerr fuzzing for shared JSON parser

2026-08-24 20:32:49 +08:00

gltf-material-extensions.md

fix: bind PBR UV vertex streams and register VRM format coverage

2026-09-10 15:07:42 +08:00

gltf-skeletal-import.md

Merge remote-tracking branch 'origin/dev' into codex/ue-assets-materials-skinning

2026-09-10 08:35:14 +08:00

GUI框架设计.md

refactor(property_access): fold scriptmodel into the squirrel adapter

2026-09-09 20:59:30 +08:00

HDR与反射链AAA升级.md

fix(ci): restore merged graphics contracts

2026-08-29 12:18:13 +08:00

hex-terrain-capability-audit.md

feat(hexmap): port the Catlike Coding hex map as a module and interactive example Adds src/modules/hexmap, an editable pointy-top hex grid with 5x5 chunk dirty tracking, per-chunk mesh generation (terrain fans, blend strips, terraces, cliffs, water, river channels, roads, city walls, decorations and a fog overlay), A* pathfinding, reference-counted fog of war, a unit registry with destination-reserving travel, a versioned save payload and a procedural map generator ported from the reference MapGenerator. Ships the interactive example as a new examples/hex-terrain-3d directory; the unrelated mesh.hexterrain procgen example in examples/hex-terrain is left byte-identical to dev.

2026-09-18 10:09:33 +08:00

particle-system-professional-roadmap.md

feat(particles): add exposed gameplay parameters

2026-08-26 03:45:07 +08:00

PixelWorld-Noita技术路线.md

feat(pixelworld): add deterministic Noita-style simulation stack

2026-08-31 17:55:05 +08:00

ported-material-shaders.md

feat(stylize): port mature Unity/Godot-style effect shaders

2026-08-26 08:22:30 +08:00

README.md

feat(rpg): RPG-Maker-style main model + complete RPG interface

2026-08-28 15:02:13 +08:00

Result检查与不得丢弃返回值规范.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

RPG任务系统设计.md

feat(rpg): RPG-Maker-style main model + complete RPG interface

2026-08-28 15:02:13 +08:00

RPG系统设计.md

feat(rpg): RPG-Maker-style main model + complete RPG interface

2026-08-28 15:02:13 +08:00

sprite-animation-material-19-contact-sheet.png

feat(animation): add production sprite sequence workflow

2026-08-24 12:39:59 +08:00

sprite-stacking模块设计.md

feat(spritestack): sprite-stacking pseudo-3D rendering

2026-08-17 13:58:03 +08:00

stylize-architecture.md

docs(stylize): document recipe workflow and boundaries

2026-08-24 23:46:35 +08:00

Tilemap设计.md

feat(map): generate procedural terrain transition masks

2026-09-17 19:07:02 +08:00

top-down-level-format.md

fix(map): preserve tilemap editor data

2026-09-09 23:27:04 +08:00

VIRTUAL_GEOMETRY.md

feat(virtualgeometry): add Nanite-style virtualized geometry rendering

2026-08-16 21:49:40 +08:00

virtual-texture-material-blending.md

feat(graphics): add virtual texture material blending

2026-08-31 08:50:20 +08:00

体积光模块设计.md

feat(graphics): add procedural volumetric cloud rendering

2026-08-23 16:33:32 +08:00

体素引擎差距分析.md

test(graphics): verify voxel AO backend parity

2026-08-25 08:04:16 +08:00

体素渲染模块设计.md

test(graphics): verify voxel AO backend parity

2026-08-25 08:04:16 +08:00

依赖项.md

deps: own libraries in external/, third-party deps in third-party/

2026-08-16 13:34:12 +08:00

修改思路.md

docs: review every user module chapter

2026-08-09 21:41:58 +08:00

全局光照模块设计.md

feat(graphics): enhance rendering capabilities with 3D pipeline and ambient occlusion

2026-08-13 10:01:04 +08:00

动态视野系统设计.md

feat(map): 动态视野系统 Phase A/B/C (#21 )

2026-08-11 02:12:33 +08:00

发布流程.md

docs(release): document the consumer-side validation gates in the release flow

2026-08-22 10:38:12 +08:00

可组合2.5D-TileSet资产管线.md

feat(map): add composable 2.5D tileset workflow

2026-08-24 13:38:11 +08:00

命令行设计.md

feat(mcp): headless eve mcp host with AI-crafted MVVM editors

2026-08-17 22:43:08 +08:00

场景节点ECS打通设计.md

feat(scene): scene/script-ECS integration, generic links, serialization & picking

2026-08-17 22:45:18 +08:00

城市布局协同生成模块设计.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

大气雾系统补全计划.md

docs(graphics): record atmosphere implementation status

2026-08-24 15:42:17 +08:00

对话与Avatar模块设计.md

feat(dialogue): procedural dialogue generation v1

2026-08-18 21:08:19 +08:00

寻路系统设计.md

feat(map): 可扩展格子寻路与群体 Flow Field 优化 (#13 )

2026-08-10 13:02:57 +08:00

建筑放置系统设计.md

feat(building): add static mesh surface BVH

2026-09-03 21:43:18 +08:00

感知与目标选择系统设计.md

feat(sensing): UE5-aligned QuerySpec, TargetingPipeline, RTS migration, spatial debug (#402 )

2026-09-15 15:17:58 +08:00

战斗系统与动作编辑器.md

feat(combat): adapt map pathfinding to locomotion

2026-09-13 12:29:16 +08:00

战斗载体与投射物行为组合框架.md

Extend combat carriers with body avoid, volleys, and curves

2026-09-11 08:26:36 +00:00

战棋系统设计.md

feat(tactics): add deterministic battle module and KayKit showcase

2026-08-29 09:23:46 +08:00

抗锯齿模块设计.md

feat(graphics): implement hardware MSAA support for 3D scene color pass

2026-08-14 10:15:07 +08:00

数据库模块设计.md

docs: remove outdated modules and documentation

2026-08-11 00:28:49 +08:00

整体架构.md

feat(devtools): add embedded MCP server and AI panel for agent testing

2026-08-10 00:43:11 +00:00

模块编排与裁剪架构.md

Nest satellite packages under their host modules.

2026-09-06 17:56:12 +08:00

模块设计.md

refactor(physics): extract cloth satellite module

2026-09-11 14:15:29 +08:00

模型转换器插件设计.md

feat(plugin): add model converter that drives Blender bpy to reshape primitives

2026-08-16 03:56:07 +08:00

武器系统-对比Unity插件-差距分析.md

Add composable combat-carrier projectile framework

2026-09-11 08:08:33 +00:00

毛发Groom子系统设计.md

feat(graphics): hair/groom subsystem (Phases 1–5 + Cards wiring) (#401 )

2026-09-15 11:32:53 +08:00

测试覆盖.md

Merge remote-tracking branch 'origin/dev' into codex/rpg-api-gap

2026-08-29 03:13:27 +08:00

游戏内容编辑器组件设计分析.md

feat(editor): complete P0 and P1 authoring services

2026-08-24 22:47:23 +08:00

游戏开发系统与工具差距分析.md

feat(devtools): add EveScript LSP and name debugger call stacks

2026-09-03 00:58:22 +08:00

游戏模型设计.md

docs: review every user module chapter

2026-08-09 21:41:58 +08:00

物理系统分层与后端契约.md

feat(physics): add modular volumetric soft bodies

2026-09-11 16:17:20 +08:00

玩家与AI共用游戏控制API.md

feat(gameplay): unify player and AI control API

2026-09-02 11:27:57 +08:00

环境光遮蔽模块设计.md

feat(graphics): enhance rendering capabilities with 3D pipeline and ambient occlusion

2026-08-13 10:01:04 +08:00

界面设计.md

docs: review every user module chapter

2026-08-09 21:41:58 +08:00

程序化生成模块设计.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

程序化道路系统设计.md

Add procedural road network system under procgen

2026-09-18 13:50:36 +00:00

空间索引模块设计.md

Add spatial module with QuadTree, Octree, hash, and BSP indexes

2026-08-09 16:49:59 +00:00

组合式游戏机制架构.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

编辑器具体API与组件设计.md

refactor(editor): integrate domain editing satellites

2026-08-29 18:12:02 +08:00

编辑器模块设计.md

feat(editor): 编辑器构件模块 — Gizmo / 笔刷 / UI 壳 (#36 )

2026-08-12 17:35:09 +08:00

群体行为与流场模块设计.md

feat(crowd): flow-field pathfinding + boids crowd behavior module

2026-08-23 19:17:12 +08:00

背包系统设计.md

feat: 高扩展性背包 / 物品栏模块 (inventory) (#17 )

2026-08-10 13:03:46 +08:00

贴花渲染模块设计.md

fix(webgpu): align voxel validation semantics

2026-08-25 13:04:58 +08:00

资源格式系统测试.md

docs(resources): clarify validation baseline and unique test counts

2026-09-10 08:10:55 +08:00

通用武器系统设计.md

weapon: multi-form weapon system (kind/resource/stage) + P0 combat features

2026-08-25 22:15:01 +08:00

通用载具系统设计.md

refactor(vehicle): isolate optional physics backend

2026-09-02 08:22:52 +08:00

重构代码质量与系统完整性规范.md

refactor(property_access): fold scriptmodel into the squirrel adapter

2026-09-09 20:59:30 +08:00

预编译网格Shader脚本加载.md

Add GPU surface ink demo and persistent RGBA8 canvas rendering

2026-09-10 14:40:37 +08:00

领域短根继承与跨域组合架构.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +08:00

风格化渲染模块设计.md

Add Material, RenderControl, and sampleable G-buffer for post effects (#43 )

2026-08-12 20:25:41 +08:00

骨骼动画能力差距与演进.md

feat(animation): MeshRet neural SMR via animation_tensor (#396 )

2026-09-15 07:21:29 +08:00

高引用头文件编译成本审计.md

Audit and trim high-impact public headers

2026-08-30 03:36:53 +08:00

README.md

EVEngine 开发者文档

本目录保存引擎的架构、模块设计、测试策略和实现计划，面向 EVEngine 本身的维护者与贡献者。

如果你是游戏开发者而不是引擎开发者：请从官网发布页下载预编译 SDK 直接使用，不需要编译引擎；用户文档见用户指南与模块使用手册。本目录及下文“从源码构建”只对需要修改引擎的人有意义。

架构与工程约定

发布流程（main / dev / vX.X.X，Pre-release 发版）
整体架构
模块设计与实现进度
模块编排与裁剪架构（实测依赖分层、协作接缝、按需裁剪；用户侧用法见按需裁剪模块）
EveScript 语言设计（统一 .nut 前端、脚本模块、类型、持久变量与异步 lowering）
依赖项
命令行设计
测试覆盖
AI 与 MCP 支持
AI 场景导演（剧情 → 自动搭台 → 质检迭代 → 交付）
游戏开发系统与工具差距分析

功能设计

2D 渲染 API
3D 渲染管线（初始化 / VKBuilder / 异步帧、buffers、数据流、函数与 shader）
体积光模块
抗锯齿模块
风格化渲染模块
GUI 框架
Tilemap
寻路系统
动态视野系统
程序化生成模块
体积光模块
环境光遮蔽模块
风格化渲染模块
RPG 系统
RPG 任务系统
背包系统
建筑放置系统
空间索引模块
游戏模型
界面设计
修改思路

实施记录

阶段性设计稿与实施计划位于 superpowers/。文档使用的图示位于 img/。

构建与文档

生成 C++ API 文档（Doxygen）：make docs（或 cmake --build <build-dir> --target docs），产物位于 docs/api/html/（已加入 .gitignore）。需要先安装 doxygen： Ubuntu/WSL sudo apt install doxygen、macOS brew install doxygen、Windows choco install doxygen。文档配置见 docs/Doxyfile.in 与 docs/CMakeLists.txt，入口 src/、Readme.md 与 docs/usr/。在线版由 GitHub Pages 持续发布：https://evengine.github.io/EVEngine/。
运行时断言：引擎统一通过 zeroerr 的 ASSERT 系列宏做函数参数校验与内部不变量检查，入口见 src/engine/common/Assert.h（EV_PARAM_CHECK / EV_ASSERT）。
- Debug 构建默认启用；
- Release 等非 Debug 构建默认通过 ZEROERR_NO_ASSERT 编译剔除，零运行时开销；
- 需要手动开启时：make build/linux CMAKE_EXTRA_ARGS=-DEVENGINE_ENABLE_ASSERTS=ON （或 CMake 配置时加 -DEVENGINE_ENABLE_ASSERTS=ON）。

如果你是使用 EVEngine 制作游戏，而不是修改引擎，请从用户指南开始。

README.md Unescape Escape

EVEngine 开发者文档

架构与工程约定

功能设计

实施记录

构建与文档

README.md