vrc-worlds

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

VRChat Worlds Skill

VRChat世界创建技能

Version: 1.0 Stack: VRChat SDK, Unity

A VRChat world that runs at 30fps on your PC can run at 5fps on Quest. Realtime lights that look great in the editor tank performance for every player in the room. The Unity editor lies about performance — everything looks smooth until you test on actual hardware with actual players. And VRChat's performance ranking system means a poorly optimized world gets fewer visitors, not just a worse experience.

Quest-first building with baked lighting, proper spawn setup, and occlusion culling means your world runs well everywhere and gets promoted by the ranking system.

版本: 1.0 技术栈: VRChat SDK, Unity

在PC上以30fps运行的VRChat世界，在Quest设备上可能仅能以5fps运行。在编辑器中效果出色的实时光照会拖垮房间内所有玩家的性能。Unity编辑器的性能表现具有欺骗性——在真实硬件上与真实玩家测试前，一切看起来都很流畅。而且VRChat的性能排名系统意味着，优化不佳的世界不仅体验更差，还会获得更少的访问量。

以Quest设备优先，采用烘焙光照、合理的出生点设置以及遮挡剔除技术，能让你的世界在所有设备上流畅运行，并获得排名系统的推荐。

Scope and Boundaries

适用范围与边界

This skill covers:

World setup and scene hierarchy
VRChat performance limits
Lighting and baking
Spawn and respawn setup
World optimization
SDK components

Defers to other skills:

```
vrc-udon
```
: Scripting and networking
```
unity-csharp
```
: C# patterns and performance optimization

Use this skill when: Building or optimizing VRChat worlds.

本技能涵盖:

世界设置与场景层级结构
VRChat性能限制
光照与烘焙
出生与重生设置
世界优化
SDK组件

相关技能参考:

```
vrc-udon
```
: 脚本编写与网络功能
```
unity-csharp
```
: C#编程模式与性能优化

适用场景: 创建或优化VRChat世界时。

Core Principles

核心原则

Quest Compatibility — Build for Quest first, enhance for PC.
Bake Everything Possible — Realtime lighting kills performance.
Respect the Limits — Stay within performance ranks.
Test on Device — Editor performance lies.
Spawn Matters — First impression is at spawn.

Quest兼容性 — 优先针对Quest设备开发，再为PC设备增强效果。
尽可能烘焙所有内容 — 实时光照会严重影响性能。
遵守性能限制 — 保持在性能排名范围内。
在真实设备上测试 — 编辑器的性能表现不可靠。
出生点至关重要 — 玩家的第一印象来自出生点。

Performance Limits

性能限制

Quest (Target: Excellent/Good)

Quest设备（目标：优秀/良好）

Metric	Excellent	Good	Medium
Triangles	50,000	100,000	200,000
Batches	50	100	200
Materials	25	50	75
Lights (realtime)	0	1	2

指标	优秀	良好	中等
Triangles	50,000	100,000	200,000
Batches	50	100	200
Materials	25	50	75
实时光源	0	1	2

PC (Target: Excellent/Good)

PC设备（目标：优秀/良好）

Metric	Excellent	Good	Medium
Triangles	500,000	1,000,000	2,000,000
Batches	100	200	400
Materials	50	100	200
Lights (realtime)	2	4	8

指标	优秀	良好	中等
Triangles	500,000	1,000,000	2,000,000
Batches	100	200	400
Materials	50	100	200
实时光源	2	4	8

Patterns

实践模式

Scene Hierarchy

场景层级结构

World
├── Environment
│   ├── Static (mark as static)
│   │   ├── Ground
│   │   ├── Buildings
│   │   └── Props
│   └── Dynamic
│       └── Interactive objects
├── Lighting
│   ├── Directional Light (baked or mixed)
│   ├── Light Probes
│   └── Reflection Probes
├── Audio
│   └── Audio sources
├── VRChat
│   ├── VRCWorld (descriptor)
│   ├── Spawn Points
│   └── Mirrors/Portals
└── Udon
    └── Scripts and behaviors

世界根节点
├── 环境
│   ├── Static（标记为静态）
│   │   ├── 地面
│   │   ├── 建筑
│   │   └── 道具
│   └── 动态物体
│       └── 交互对象
├── 光照
│   ├── Directional Light（烘焙或混合模式）
│   ├── Light Probes
│   └── Reflection Probes
├── 音频
│   └── 音频源
├── VRChat
│   ├── VRCWorld（描述符）
│   ├── 出生点
│   └── 镜子/传送门
└── Udon
    └── 脚本与行为

Spawn Area Setup

出生区域设置

Spawn Checklist:
- Multiple spawn points (avoid stacking)
- Clear floor (no obstacles)
- Good lighting (players see themselves)
- Mirror nearby (avatar check)
- Safe area (no hazards)
- Interesting view (sets the mood)

出生点检查清单:
- 多个出生点（避免重叠）
- 地面整洁（无障碍物）
- 光照良好（玩家能看到自己）
- 附近有镜子（用于检查Avatar）
- 安全区域（无危险）
- 视野有趣（营造氛围）

Lighting Setup (Quest-Compatible)

光照设置（兼容Quest设备）

1. Set all lights to "Baked"
2. Mark static geometry as "Contribute GI" + "Reflection Probe Static"
3. Place Light Probes for dynamic objects
4. Place Reflection Probes for shiny surfaces
5. Bake with GPU Lightmapper
6. Delete realtime lights or set to "Not Important"

1. 将所有光源设置为“Baked（烘焙）”模式
2. 将静态几何体标记为“Contribute GI（贡献全局光照）” + “Reflection Probe Static（反射探针静态）”
3. 为动态物体放置Light Probes（光照探针）
4. 为光滑表面放置Reflection Probes（反射探针）
5. 使用GPU Lightmapper进行烘焙
6. 删除实时光源或设置为“Not Important（不重要）”

Occlusion Culling Setup

遮挡剔除设置

1. Mark large static objects as "Occluder Static"
2. Mark all static objects as "Occludee Static"
3. Window > Rendering > Occlusion Culling
4. Set appropriate cell sizes
5. Bake
6. Test with Occlusion visualization

1. 将大型静态物体标记为“Occluder Static（遮挡物静态）”
2. 将所有静态物体标记为“Occludee Static（被遮挡物静态）”
3. 窗口 > 渲染 > 遮挡剔除
4. 设置合适的单元格大小
5. 进行烘焙
6. 使用遮挡可视化工具测试

Anti-Patterns

反模式（错误实践）

Anti-Pattern	Problem	Fix
Realtime lights on Quest	Tanks performance	Bake all lighting
No light probes	Dynamic objects are black	Add light probe groups
Single spawn point	Players stack on join	Multiple spread spawns
Unbaked reflections	Expensive or broken	Use baked reflection probes
No LODs on props	Full detail at distance	Add LOD groups
Post-processing on Quest	Not supported, ignored	PC-only or remove

反模式	问题	修复方案
在Quest设备上使用实时光源	严重降低性能	烘焙所有光照
未设置光照探针	动态物体显示为黑色	添加光照探针组
单一出生点	玩家加入时重叠	设置多个分散的出生点
未烘焙反射	性能消耗大或显示异常	使用烘焙反射探针
道具未设置LOD	远处物体仍显示全细节	添加LOD组
在Quest设备上使用后处理	不被支持，会被忽略	仅在PC设备使用或移除

Checklist

检查清单

Setup

设置项

Performance

性能项

Quality

质量项

References

参考资料

```
references/lighting-baking.md
```
— Baked lighting setup for VRChat worlds

```
references/lighting-baking.md
```
— VRChat世界烘焙光照设置指南