Studio使用规范

1、中文路径或命名可能导致解析的编码不匹配从而出现乱码；2、地图中的中文资源可能会导致MiniGame下载该游戏地图解压失败。

资源背包命名规范

资源ID简介

资源ID协议（前缀）资源ID信息描述
sandboxSysIdAssetSubCategory::SYS（常用）游戏内置资源目录（res）的资源。（从本地加载）
RainbowIdAssetSubCategory::RAINBOW（常用）引擎云资源（profab等引擎工具产生的资源）。（使用引擎统一接口加载）
sandboxNetworkIdAssetSubCategory::CLOUD（常用）沙盒上传的云资源（可能是图片，音视频，节点包，蓝图等）。（沙盒从云服下载资源后加载）
sandboxIdAssetSubCategory::LOCAL（预留）地图存档目录（data/w1111111111/sandbox/asset）的资源。（主机需要同步给客机）

  1. 内置资源

    前缀是 sandboxSysId:// ，是游戏内置的原生资源，一般在 AssetRuntime/EngineResource/Assets/Resources 文件夹下。

    asset_sandbox_sys_id

  2. 地图目录资源

    前缀是 sandboxId:// ，可以用地图 w\*\*\*\*\*\*\* 文件下的 sandbox/assets 文件夹下资源。

    asset_sandbox_id

  3. 云资源

    上传到云服的沙盒资源，如果是引擎支持的资源，使用引擎的同步加载接口加载（沙盒层封装了请求下载路径并下载的过程），前缀是 sandboxNetworkId:// 。

    动画控制器等asset路径需要指定resType来区分是controller还是overrideController

    目前除了模型资源，其他资源不需要指定文件类型

    filetype规则表

    云资源类型id云资源规则前缀描述
    omodsandboxNetworkId&filetype=1://
    objsandboxNetworkId&filetype=2://
    cmsandboxNetworkId&filetype=3://
    fcmsandboxNetworkId&filetype=4://
    pngsandboxNetworkId&filetype=5://
    jpgsandboxNetworkId&filetype=6://
    jpegsandboxNetworkId&filetype=7://
    mp4sandboxNetworkId&filetype=8://视频
    wavsandboxNetworkId&filetype=9://音频
    map3sandboxNetworkId&filetype=10://音频
    oggsandboxNetworkId&filetype=11://音频
    snpsandboxNetworkId&filetype=12://节点包
    matsandboxNetworkId&filetype=13://材质
    templatematsandboxNetworkId&filetype=14://沙盒先不作区分类型细节，等接口接入需要针对修改时，再作处理
    hlsli shadersandboxNetworkId&filetype=15://
    skAnimsandboxNetworkId&filetype=16://动画
    animsandboxNetworkId&filetype=17://
    skeletonsandboxNetworkId&filetype=18://
    animmasksandboxNetworkId&filetype=19://
    overrideControllersandboxNetworkId&filetype=20://
    controllersandboxNetworkId&filetype=21://
    prefabsandboxNetworkId&filetype=22://预制体
    metasandboxNetworkId&filetype=23://资源描述文件（目前当着prefab 使用）
    scenesandboxNetworkId&filetype=24://场景资源（目前当着prefab 使用）
    gsmsandboxNetworkId&filetype=25://实体模型mesh
    bpsandboxNetworkId&filetype=26://蓝图
    hlslisandboxNetworkId&filetype=27://增加类型
    meshsandboxNetworkId&filetype=28://先使用模型标记吧

    resType规则表

    resType ID描述
    resType=0未知
    resType=1纹理
    resType=2骨骼
    resType=3音频
    resType=4视频
    resType=5预加载
    resType=6材质
    resType=7粒子
    resType=8光源
    resType=9天空盒贴图
    resType=10蓝图
    resType=11动画骨骼文件
    resType=12AnimatorController文件
    resType=13AnimatorOverrideController文件
    resType=14Avatar mask文件
    resType=15Animation Clip 文件
    resType=16Skeleton Animation Clip 文件
    resType=17Blend Tree 文件
    resType=18节点包
    resType=19GIF
    resType=20Mesh
    resType=21模型数据
    resType=22Font

SandboxId&filetype=xx&restype=xxx://xx

骨骼槽位装备规范

  • 骨骼模型简图，如下图：

standard_fcm

  • 附加装备:骨骼增加对应隐藏的槽位用于将装备添加至正确位置
槽位名称中文装备方式对应普通人形对应简单人形对应四肢生物
Root根节点#12641(根骨骼)#12641(根骨骼)#12641(根骨骼)
Hat帽子附加#12644(头) 上方#12644(头) 上方#12644(头)
Mask面具附加#12644(头) 正面#12644(头) 正面#12644(头)
Head头#12644(头)#12644(头)#12644(头)
Handle手持附加#12647(右手)#12645(右上臂) 末端
LeftHandle左手持附加#12650(左手)#12648(左上臂) 末端
LeftHand左手#12650(左手)
RightHand右手#12647(右手)
LeftArm左上臂#12648(左上臂)#12648(左上臂)
RightArm右上臂#12645(右上臂)#12645(右上臂)
LeftShouder左肩附加#12643(胸部) 左上
RightShouder右肩附加#12643(胸部) 右上
LeftForeArm左前臂#12649(左前臂)
RightForeArm右前臂#12646(右前臂)
UpperBody上身#12642(上半身)#12642(上半身)
Medal勋章附加#12643(胸部) 左侧#12642(上半身)
Backpack背包附加#12643(胸部) 背面#12642(上半身) 背面
LowerBody裤子#12651(下半身)
LeftFoot左脚#12654(左脚) 替换#12652(左大腿) 末端 附加
RightFoot右脚#12657(右脚) 替换#12655(右大腿) 末端 附加
LeftThigh左大腿#12652(左大腿)#12652(左大腿)
RightThigh右大腿#12655(右大腿)#12655(右大腿)
LeftLeg左小腿#12653(左小腿)
RightLeg右小腿#12656(右小腿)
Chest胸#12643(胸部)
Tail尾#12651(下半身) 附加#12651(下半身) 附加#12662(尾部) 替换
LegFL左前腿替换#12658(左前腿)
LegFR右前腿替换#12659(右前腿)
LegBL左后腿替换#12660(左后腿)
LegBR右后腿替换#12661(右后腿)
  • 骨骼模型层级结构

standard_fcm_tree

Last Updated: