okooooooo/EVEngine

0 Fork 0

Files

T

History

西风逍遥游 e82a42d2e3 feat(asset): package and play native shader mesh effects

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

..

test(procgen): add GPU execution acceptance suite

2026-08-26 15:14:51 +08:00

feat(fluids): build oriented droplet render instances

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

docs: review every user module chapter

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

reference/civ5-terrain

feat: add procedural civilization-style hex terrain

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

fix(fluids): stabilize surface simulation timesteps

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

Nest satellite packages under their host modules.

2026-09-06 17:56:12 +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

feat(graphics): add unified 2D and 3D primitive drawing

2026-09-02 16:08:15 +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-shader-effect-assets.md

feat(asset): package and play native shader mesh effects

2026-09-09 17:22:04 +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

Container、Zone与Transfer协议.md

refactor: consolidate engine architecture contracts

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

editor-module-gap-analysis.md

feat(editor): complete module tooling and profiler

2026-08-29 09:34:27 +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

GUI框架设计.md

refactor(editor): split domain editors and unify results

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

HDR与反射链AAA升级.md

fix(ci): restore merged graphics contracts

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

hex-terrain-capability-audit.md

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +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): Tilemap dual-grid autotile resolve (#15 )

2026-08-10 14:03:37 +08:00

top-down-level-format.md

refactor(editor): split domain editors and unify results

2026-09-02 08:22:51 +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(editor): add interactive combat action example

2026-08-28 21:49:14 +08: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

fix(script): preserve ECS bindings across full composition

2026-09-02 08:35:51 +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

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

2026-08-25 22:15:01 +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

refactor: consolidate engine architecture contracts

2026-08-27 12:54:48 +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 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

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: consolidate engine architecture contracts

2026-08-27 12:54:48 +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): add marker-based locomotion sync

2026-08-25 19:43:07 +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 制作游戏，而不是修改引擎，请从用户指南开始。