Skip to content

简介 ​

Natsume 是一个运行在浏览器里的 Unity 特效运行库,基于 PixiJS v8 和 WebGL2,使用纯 TypeScript 编写。

它读取由 Noa 编译的 NOAP(Noa Package)资源包,解析场景层级、动画、粒子系统、材质和纹理,在 Pixi 的渲染循环里模拟并绘制 Unity 特效。Noa 负责把 Unity 资源编译成资源包,Natsume 负责运行和渲染。

text
Unity Prefab → Noa → NOAP (Noa Package) → Natsume → PixiJS

适用场景 ​

如果你的 Web 项目已经使用 PixiJS,并且需要播放在 Unity 里制作的粒子特效,Natsume 可以直接接入现有的 Application。每个特效实例提供一个独立的 Pixi 容器,宿主像对待其他显示对象一样放置、缩放和裁剪它。

Natsume 不是 Unity 的完整移植。它不运行 C# 代码,不提供完整的 Unity 相机系统,也不生成三维光照环境。自定义 MonoBehaviour 的序列化数据会交给 Script Bridge,由宿主实现对应行为。

项目状态 ​

Natsume 目前以预发布版本(alpha)提供,只支持一部分 Unity 特性,公开 API 在 1.0 正式版之前可能调整。

  • 已支持的粒子模块、动画和渲染范围见支持范围。
  • 未支持的运行配置会在预检或实例化时报告错误,不会静默降级。
  • Noise 等近似行为的适用范围和误差见 Unity 行为差异。

从哪里开始 ​

基于 Apache License 2.0 发布