跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

unity-vrc-world-sdk-3

VRChat World SDK 3 guide for scene and Inspector setup, component placement, optimization, and upload. Use for VRChat world scene configuration, VRC SDK components, layers, baked lighting, Quest/Android performance, Dynamics for Worlds, Build Panel warning triage, validation, and upload. Covers WorldQualitySettings, VRC_SceneDescriptor, VRC_Pickup, VRC_Station, VRC_Mirror, VRC_ObjectSync, VRC_CameraDolly, spawn points, collision matrices, PhysBone and Contact component placement, Box Contacts, Global Avatar PhysBone Colliders, and VRCPhysBoneCollider component setup. Active support / last verified: SDK 3.10.5. Triggers on: VRChat world scene, VRC SDK, scene setup, component placement, optimization, Quest support, light baking, upload, SDK validation, Build Panel warning, Auto Fix, red warning, yellow warning, or white warning. Do not use for UdonSharp C# or VRCTween calls; use unity-vrc-udon-sharp for runtime scripting. UdonSharp package, asmdef, and Version Defines work also belongs t

niaka3dayo · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add niaka3dayo/agent-skills-vrc-udon --skill unity-vrc-world-sdk-3

技能说明


name: unity-vrc-world-sdk-3 description: > VRChat World SDK 3 guide for scene and Inspector setup, component placement, optimization, and upload. Use for VRChat world scene configuration, VRC SDK components, layers, baked lighting, Quest/Android performance, Dynamics for Worlds, Build Panel warning triage, validation, and upload. Covers WorldQualitySettings, VRC_SceneDescriptor, VRC_Pickup, VRC_Station, VRC_Mirror, VRC_ObjectSync, VRC_CameraDolly, spawn points, collision matrices, PhysBone and Contact component placement, Box Contacts, Global Avatar PhysBone Colliders, and VRCPhysBoneCollider component setup. Active support / last verified: SDK 3.10.5. Triggers on: VRChat world scene, VRC SDK, scene setup, component placement, optimization, Quest support, light baking, upload, SDK validation, Build Panel warning, Auto Fix, red warning, yellow warning, or white warning. Do not use for UdonSharp C# or VRCTween calls; use unity-vrc-udon-sharp for runtime scripting. UdonSharp package, asmdef, and Version Defines work also belongs to that skill. license: MIT metadata: author: niaka3dayo version: "4.1.0" tags: vrchat, world-sdk, scene-setup, optimization, components, upload, sdk-validation, build-panel

VRChat World SDK 3 Guide

Table of Contents

SectionContentReference
Scene SetupVRC_SceneDescriptor, SpawnThis file
ComponentsPickup, Station, Mirrorreferences/components.md
Layers & CollisionLayers, Collision Matrixreferences/layers.md
PerformanceOptimization guidereferences/performance.md
LightingLighting settingsreferences/lighting.md
Audio & VideoAudio, Video playersreferences/audio-video.md
Build ValidationRed/yellow/white SDK alertsreferences/build-validation.md
World UploadUpload workflowreferences/upload.md
TroubleshootingProblem solvingreferences/troubleshooting.md
CheatsheetQuick referenceCHEATSHEET.md

Method Migration

The following public methods were renamed because an unprefixed, parameterless public UdonSharp method remains callable through legacy network dispatch:

BeforeAfter
ForceDropPickup_ForceDropPickup
IsHeld_IsHeld
IsOccupied_IsOccupied
StopSound_StopSound
SlowUpdate_SlowUpdate

Update Inspector event strings, SendCustomEvent* calls, delayed events and nameof(...) expressions, and cross-behaviour calls. Compatibility aliases are not provided because an old unprefixed alias would restore the same legacy network exposure.


Common Mistakes (NEVER List)

These cause silent world failures, performance disasters, or Quest incompatibility:

#NEVER do thisWhy it hurtsUse instead
1Enable Mirror by default (active on world join)A mirror adds another costly scene render; the impact depends on view, scene, resolution, and deviceDefault Mirror OFF; add a player-controlled toggle and profile each target device
2Use realtime directional lights with real-time shadows without profilingRealtime shadow cost varies with scene geometry, view, and target device and can dominate frame time on AndroidPrefer baked lightmaps + light probes; profile the target device before keeping any realtime shadows
3Set Respawn Height at or above the world floorPlayer respawns → falls → respawns again → infinite loop; players cannot recoverSet to an unreachable depth (e.g., floor at Y=0 → Respawn at Y=-100)
4Skip "Setup Layers for VRChat" on a new projectLayer collision matrix is wrong by default — players walk through walls, Pickups clip floorsRun VRChat SDK > Builder > "Setup Layers for VRChat" before placing any colliders
5Enable Post-Processing without an Android build profilePost-processing is disabled at runtime on Android, so the authored effect will not appear and unnecessary resources can still enlarge the buildUse a separate Android build profile with post-processing removed
6Place more than 2 active video players simultaneouslyEach player adds significant decoding overhead; running >2 simultaneously is a common cause of frame drops and audio issues in practiceDisable extra players at scene start; activate only the currently playing one
7Use Cloth on Android, or add many Unity Constraints without profilingCloth is disabled on Android. Unity Constraints are permitted in worlds, but overuse can significantly affect performanceRemove Cloth from the Android build; prefer VRC Constraints for new work and profile any constraint-heavy setup
8Upload without completing a lightmap bakeRealtime GI adds substantial scene-dependent render cost and is unsuitable as an unmeasured fallback on AndroidBake lights before upload, then verify the result on the target device
9Place player walkable surfaces on Default layer (0)Collision matrix is wrong by default — avatar physics collision is unreliable; players may clip through geometryUse Environment (layer 11) for all walkable geometry, walls, and floors
10Use very high lightmap resolution for large areas without profilingTexture memory can spike significantly at high resolution
阅读完整来源 ↗