主题
当前版本限制与未来展望
本文档介绍星火编辑器2.0当前纯代码开发版本的限制、已知缺失的功能、已经加入的能力和未来展望。
目录
当前版本的限制
星火编辑器2.0的图形化触发、数据、UI 编辑能力仍在持续迭代。当前版本已经不是“完全只能纯代码”的早期状态，但它和 1.0 的低代码体验、功能覆盖、稳定程度仍不完全等价，因此迁移时仍需要理解下面这些限制。
1. 缺少部分小卡片机制
现状：
- 目前编辑器中没有提供与1.0对应的小卡片机制功能
- 这些机制在后续版本中会逐步添加，但可能不会与1.0版本完全一致
原因：
- 在2.0版本中，许多扩展功能的开发都变得更加简单了
- 设计团队正在重新思考这些功能的实现方式
影响：
- 商城功能已提供，不再属于当前缺失项
- 其他小卡片机制若尚未覆盖，可以先通过代码/API方式实现对应逻辑
2. 捏人动画重定向仍需要手动触发
现状：
- 数据编辑器和 GameData 生成链已经存在，但捏人动画重定向还不是完全自动的普通编辑操作
- 需要使用捏人模型共享 Humanoid 动画时，仍需要用户手动执行重定向生成
- 资源统计
ref已由编辑器发布流程自动生成，发布项目前不再需要手动执行生成资源统计ref.bat
解决方案：
步骤1：配置捏人动画
- 常见的单位技能配置可由资源统计自动展开：
GameDataUnit.Model/Abilities→GameDataAbility.Animation→GameDataAnimation动画素材 - 分析器依赖代码的静态结构，helper、工厂、运行时条件或动态集合修改不一定能完整覆盖
- 为了保证关键动画一定进入烘焙列表，仍可在对应
GameDataModel.HumanoidSourceAnimations中显式填写动画路径 - 这相当于1.0版本数据编辑器中的"额外加载动画"字段
- 另一种保险方式是手动编辑
ref/model_animation.json，然后只执行编辑器菜单 “工具 → 资源统计和动画重定向 → 生成”；再次统计资源会覆盖手工 JSON
步骤2：生成重定向动画
- 在编辑器中打开项目
- 点击菜单中的 "工具 → 资源统计和动画重定向 → 统计资源并生成"
- 这将生成重定向动画文件；资源统计
ref在发布项目时会自动处理
⚠️ 为什么需要这些操作？
资源统计的变化：
- 资源统计工具用于统计当前项目使用了哪些模型、音效、动画、粒子、纹理等资源
- 当玩家使用客户端进行游戏前，会根据这一列表来下载云端资源
- 如果资源统计列表文件缺失，玩家可能会遇到游戏客户端模型粒子资源缺失等问题
- 现在编辑器发布项目时会自动生成资源统计
ref，因此发布前不再需要为了资源统计单独手动执行脚本或菜单操作
开发阶段的特殊性：
- 开发者在编辑器中开发游戏时，即使没有生成资源列表，由于编辑器本身下载了所有云端资源，所以在编辑器调试模式下不会遇到资源缺失问题
- 如需排查发布资源统计结果，可以在发布后检查项目
ref目录下的objref.txt
动画重定向的作用：
- 动画重定向用于将共享的人形动画资源烘焙到特定的捏人模型上
- 若没有预先烘焙资源，游戏中的捏人模型可能会遇到无法正常播放指定动画，或者使用技能时不播放动画的问题
- 与缺少资源统计列表不同的是，用户在编辑器调试阶段就能看到由于重定向动画文件缺失而导致的动画无法播放问题
如何检查是否正确生成：
- 用户可以查看项目
anim目录以检查被生成的重定向动画文件
已知缺失的功能
以下是一些已知的相对1.0版本缺失的功能，用户不必反复反馈，我们已经在规划中：
1. 小地图
状态：开发中
计划：我们会在后续版本中添加小地图功能。
当前替代方案：1.0 没有 Canvas，缺官方支持的表现（如小地图）就做不了；2.0 新增了 Canvas 控件，在内置小地图加入前，可用 Canvas 自行绘制小地图等表现。见 Canvas 绘图系统 与 Canvas / CanvasAnimated 游戏开发指南。
2. UI场景
状态：规划中
计划：我们会在后续版本中添加UI场景功能。
已经加入的能力
以下能力已经加入，不再属于仅可期待或试验性规划中的功能。
1. Box2D物理引擎
状态：已支持
能力：
- Canvas 2D游戏可以使用基于Box2D的Physics2D能力
- 支持刚体、碰撞检测、触发器、关节约束等常见2D物理特性
应用场景：
- 横版动作游戏
- 物理解谜游戏
- 2D平台跳跃游戏
2. 客户端3D物理引擎支持
状态：已支持
能力：
- 客户端已经加入3D物理引擎支持
- 可以用于客户端侧的3D物理碰撞、刚体、重力等表现和交互
- 复杂玩法仍应结合项目的同步、判定和性能要求进行设计
应用场景：
- 需要客户端3D碰撞表现的玩法
- 3D动作游戏
- 物理表现驱动的机关、道具和场景交互
探索、学习、反馈和改进
前面提到的内容只是星火编辑器2.0版本中的一小部分功能和特性。
探索更多功能
用户可以通过阅读文档和API列表来学习更多的功能和特性。有许多令人惊喜的新功能等待你的发掘：
学习资源
- 示例项目中包含了丰富的示例代码
- 文档中提供了大量的最佳实践
- 可以参考框架内部UI的实现源码
反馈渠道
星火编辑器2.0版本仍在开发中，我们欢迎用户积极探索和学习，并对新版本提出反馈和建议：
- 功能建议 - 提出您希望看到的新功能
- 问题反馈 - 报告遇到的问题和bug
- 文档改进 - 指出文档中的错误或不清晰的地方
- 最佳实践 - 分享您在使用过程中发现的好方法
持续改进
您的反馈将帮助我们：
- 改进框架的易用性
- 优化性能和稳定性
- 完善文档和示例
- 规划未来的功能开发
总结
虽然当前版本存在一些限制，但星火编辑器2.0的纯代码开发模式已经提供了强大的游戏开发能力：
已有的优势
✅ 完整的游戏逻辑开发能力 ✅ 强大的触发器和事件系统 ✅ 类型安全的数编系统 ✅ 灵活的UI创建方式 ✅ 组件化的架构设计 ✅ 服务器客户端代码共享 ✅ 2D游戏开发能力（Canvas） ✅ Box2D 2D物理引擎支持 ✅ 客户端3D物理引擎支持
未来的发展
🚀 图形化编辑器的完善 🚀 更多内置功能和组件 🚀 更丰富的示例和文档
我们期待您在星火编辑器2.0的开发之旅中创造出精彩的游戏！
下一步
- 返回导航页面查看所有文档
- 开始您的第一个2.0项目
- 加入社区，与其他开发者交流