com.staryevo.storyeditor (1.0.0)
Published 2026-01-06 14:25:40 +08:00 by root
Installation
registry=npm install com.staryevo.storyeditor@1.0.0"com.staryevo.storyeditor": "1.0.0"About this package
可视化剧本编辑器
创建剧本
- 点击Unity顶部菜单栏
Evo/剧本编辑器/创建剧本 - 在打开的小窗口中选择要创建剧本的包,然后点击
创建剧本 - 新创建的剧本会在
*/Modules/[包体ID]/Main/Res/Graphs路径下生成
编辑剧本
- 双击剧本打开可视化编辑窗口
- 右键空白处可以新建节点(节点类型详见后续附录)
- 按住Exit端口(或其他Output端口)可以拖拽出一条连接线,将其拖到任一节点的Enter端口(或其他Input端口)可以在两个节点之间建立连接,原则上禁止将一个节点的Exit端口与其自身的Enter端口相连,其造成的死循环问题自负
- 原则上剧本需要从
Begin节点连接到End节点 - 剧本会自动保存,但建议在关闭窗口前Ctrl+S进行手动保存以防万一
导出剧本
- 导出剧本前需要先选择
资源加载方式,为此需要创建一个继承IResource接口的类,实现接口后选中剧本,即可在Inspector面板选择资源加载方式 - 选择资源加载方式后,点击
导出即可在同级目录下生成剧本的json文件
使用剧本
- 使用前需要先调用ScriptPlayer.Init初始化剧本执行模块,并根据需要将字幕组件(SpriteRenderer)和音频组件(AudioSource)传入,加载器(IResource)是必传项
- 确保剧本的json文件能够被加载到(例如热更环境下需要将其打包到对应的AB包中),随后调用ScriptPlayer.Play即可播放剧本
- 在场景结束时需要调用ScriptPlayer.Release释放资源,以防止内存泄漏
Dependencies
Dependencies
| ID | Version |
|---|---|
| com.cysharp.unitask | 2.5.10 |
| com.github.siccity.xnode | 1.8.0 |
| com.unity.nuget.newtonsoft-json | 3.2.1 |
Keywords
unity
story
visual
editor
graph