场景内容物 SceneContent

让「关卡里有什么」成为可编辑、可导出、可加载的数据，而不是散落在 prefab 里的隐式引用。与 Config / BT / Attr 平级，不绑定任何具体玩法。

生成物命名空间由「命名空间 root」派生：{root}.scene。

两个来源

• A · 实例条目：在关卡 prefab 上逐个摆的内容物实例（prefab 引用 + 变换 + payload）。
• B · 标记组件：挂在 prefab 子树上的 ISceneContentMarker，由 SceneContentAuthoring 自动发现。

两者由 SceneContentAuthoring 合并成一个 blob。

核心类

运行期加载

// 游戏自己的关卡加载完成后（第三个参数默认 Client）
SceneContentLoader.Load(levelId, mySpawner);
// 专用服务器进程读另一份产物：
SceneContentLoader.Load(levelId, serverSpawner, SceneContentSide.Server);

public class MySpawner : ISceneContentSpawner
{
    public void Spawn(int contentTypeId, float3 pos, quaternion rot, float3 scale, NativeArray<byte> payload)
    {
        // 按 id 解析到 prefab / entity，从 payload（UTF8 JSON）读参数
        var json = System.Text.Encoding.UTF8.GetString(payload.ToArray());
        // ... 生成 GameObject 或 EntityManager.Instantiate(...) ...
    }
}

编辑器入口

• HYC Framework/Scene Content/New Scene Content Type
• HYC Framework/Scene Content/（priority 70–72，含 Scene Content Window / Export All Blobs / Export Blob (Selected)）
• 组件挂载：Add Component → HYC/SceneContent/<类名>

关键约束