SuperAPI AI 工具集

unity-vrc-world-sdk-3

设计与创作

查看项目

更新于 10-14 05:34

技能介绍

用途

本技能是一份 VRChat World SDK 3 指南,用于指导 VRChat 世界的场景与 Inspector 设置、组件放置、性能优化以及上传流程。它按主题组织内容,并通过参考资料文件分发细节,适合在以下任务中使用:新建世界场景、配置可抓取对象(VRC_Pickup)、设置座位(VRC_Station)、配置世界用 Dynamics(PhysBones、Contacts、Box Contacts、全局 Avatar PhysBone Colliders、世界 VRCPhysBoneCollider 的 Udon 访问)、添加音视频播放器或语音区域、配置 WorldQualitySettings、烘焙光照、处理 SDK 构建面板校验告警、上传发布世界、排查碰撞或层问题以及配置镜像。

内容结构以表格形式列出各主题对应的参考文件,包括场景设置、组件、层与碰撞、性能、光照、音视频、构建校验、上传、故障排查以及速查表(CHEATSHEET.md)。技能要求按任务只加载所需的参考资料,并给出“必读 / 可选 / 不要加载”的对应关系。

主要能力与关注点

技能覆盖的核心内容包括:

  • 场景设置:VRC_SceneDescriptor 为必需组件,每个 VRChat 世界必须且只能有一个;VRCWorld Prefab 可包含 VRC_PipelineManager(自动添加)、VRCWorldSettings(可选)、AvatarScalingSettings(可选)。Spawn 点、Spawn Order、Spawn Orientation、Respawn Height、Reference Camera 等属性均有说明。
  • 组件:列出 VRC_Pickup、VRC_Station、VRC_ObjectSync、VRC_MirrorReflection、VRC_PortalMarker、VRC_SpatialAudioSource、VRC_UIShape、VRC_AvatarPedestal、VRC_CameraDolly、VRCCameraSettings 等组件及其必需元素与用途。
  • 层与碰撞:说明 VRChat 保留层(如 0 Default、9 Player、10 PlayerLocal、11 Environment、13 Pickup、14 PickupNoEnvironment、17 Walkthrough、18 MirrorReflection、22-31 User Layers),并要求运行 VRChat SDK 的 “Setup Layers for VRChat”。
  • 性能:强调从支持设备、代表性场景和预期玩家数定义性能目标;给出镜像默认关闭、视频播放器建议 1-2 个、实时光照默认烘焙、光照贴图需烘焙并验证等建议。
  • 方法迁移:列出因未加前缀的无参public UdonSharp 方法仍可通过旧网络分发调用而被重命名的方法,如 ForceDropPickup→_ForceDropPickup、IsHeld→_IsHeld、IsOccupied→_IsOccupied、StopSound→_StopSound、SlowUpdate→_SlowUpdate,并提示需同步更新 Inspector 事件字符串、SendCustomEvent* 调用、延迟事件、nameof(...) 表达式以及跨行为调用;不提供兼容别名。

使用方式

技能本身以参考文档形式提供,按任务选择加载对应文件。例如:从零搭建新场景时必读 components.md、layers.md;制作可抓取物体时必读 components.md;Quest 性能优化时必读 performance.md、lighting.md;上传发布时必读 upload.md。世界设置部分说明:Spawn 点为空 GameObject,玩家进入时面向 Spawn Transform 的 Z+ 方向;建议至少 2-3 个 spawn 点、略高于地面约 0.1m、避开障碍物并考虑 VR guardian 边界。Reference Camera 配置后必须禁用该 Camera 组件,VRChat 只读取相机设置而非其输出。

适用场景与限制

适用场景包括 VRChat 世界制作中的场景配置、组件放置、层与碰撞调试、性能与光照优化、构建校验、上传发布和故障排查。技能支持边界:当前最后验证目标为 SDK 3.10.5;从 v4.0.0 起策略为仅支持最新稳定版 SDK,且需该仓库验证后才迁移支持,新稳定版不会自动获得支持。表中 3.7.1-3.10.4 的特性条目仅为历史迁移参考,不是该技能的活动支持或验证目标。示例默认面向 SDK 3.10.5。文档指出 VRChat 未提供固定的世界上传 FPS 阈值,性能目标应依据设备与场景自行定义;Quest 与 PC 需分别测试,PC 结果不能说明 Android 性能。

资料中未提供价格、收费、具体效果保证或完整的各参考文件内容(如 components.md 约 800 行内容仅被提及需完整加载,未在资料中展开)。