Skip to content

星火编辑器 2.0 - 资深用户快速上手指南 ​

欢迎,星火编辑器1.0的老用户!

本系列文档将帮助您快速了解星火编辑器2.0(WasiCore框架)与1.0版本的主要差异,并快速上手纯代码开发模式。

如果希望先了解已有的数据、触发器和地图开发经验如何继续使用,以及何时让 AI 帮助补充 Node / 组件能力,可先读理解星火:从地图编辑器到游戏引擎。这份概念指南也适合暴雪地图编辑器与 Unity / Urho 用户;使用 GameGraph 不要求把原有图形化玩法全部改写成纯代码。

📚 文档导航 ​

00 - 快速开始 ​

  • 新建项目
  • 文档和API位置
  • 编译和运行
  • 开发环境准备

01 - 核心差异 ​

  • 触发器系统的全新设计
  • 数编表(GameData)系统
  • 数编Link的强类型设计
  • 服务器与客户端代码
  • 日志系统

02 - 高级功能 ​

  • 扩展枚举系统
  • 自定义效果节点
  • 自定义响应节点
  • 通用公式系统
  • 技能指示器

03 - UI系统 ​

  • UI创建的三种方式
  • 流式UI语法
  • Canvas与路径绘制
  • 客户端组件信息获取

04 - 当前版本限制与未来展望 ​

  • 当前版本的限制
  • 已知缺失的功能
  • 可以期待的功能

05 - 联机同步 ​

  • 服务端权威与三条同步路(PropertyObject / Node+PropertyHostComponent / 裸 SyncVar)
  • 选型一张表
  • 混合同步:位置走 Node(原生平滑)、数据走属性组件
  • per-property 反作弊(属性级可见性)

🎯 适合人群 ​

本指南面向以下用户:

  • 熟悉星火编辑器1.0的开发方式
  • 对C#语言有一定了解,或懂得如何使用AI工具进行C#开发
  • 希望提前尝试2.0纯代码开发模式

💡 版本说明 ​

星火编辑器2.0版本仍在开发中。触发编辑器、数据编辑器、UI编辑器和 AI/MCP 工具都已经进入 2.0 工具链,但它们和 1.0 的成熟度、覆盖范围、操作习惯并不完全等价。老用户迁移时应把 2.0 理解为“代码 + 数据编辑器 + 生成代码 + AI 工具”的组合开发模式,而不是 1.0 图形化触发器的简单替换。

星火编辑器2.0使用.NET 9.0/10.0和WASI环境重写了整个游戏开发框架,我们称之为WasiCore框架。如您在2.0文档中遇到了这个新词,请不要惊讶,它就是星火编辑器2.0框架的代号。

🌟 核心理念 ​

WasiCore框架是星火编辑器1.0开发理念的扩展和升级。框架重写使我们得以从底层开始解决1.0开发体验中的许多痛点,使游戏开发工具与开发理念能够更加契合,更加一致。

在2.0版本中:

  • 开发者无需再记忆那些令人头疼的特殊逻辑和魔法字符串
  • 整个开发理念变得更为普适,而非只能在编辑器的特定模块中生效
  • 类型安全得到了极大的增强
  • 服务器与客户端的代码组织更加清晰

🚀 开始学习 ​

建议按照文档顺序阅读:

  1. 首先阅读快速开始,了解如何创建和运行项目
  2. 然后阅读核心差异,理解2.0版本的核心变化
  3. 接下来学习高级功能和UI系统
  4. 最后了解当前版本限制,避免踩坑

📖 其他资源 ​

💬 反馈与建议 ​

星火编辑器2.0版本仍在开发中,我们欢迎您积极探索和学习,并对新版本提出反馈和建议。您的反馈将帮助我们改进框架和文档。