The VRChat Documentation Hub

Welcome to the VRChat Documentation hub. You'll find comprehensive guides and documentation to help you start working with VRChat as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

World Creation, Optimization, and Community Labs Tips

Want to make your world public? You've come to the right place. There's a few things you should take into consideration before submitting your world to Community Labs. Make sure you read all of this! Failure to do so may result in your world being taken down, or never leaving Community Labs!

If your world is already Public, you don't need to re-submit the world if you update it. It should update automatically and you should not lose your Public status.

To be clear, you should be submitting your world to Community Labs using the SDK. This will make your world immediately available to all users that opt-in for Community Labs, and your world will eventually go public! Read more about Labs here.

Important Info

  • You can only submit one world per user per seven days to Community Labs.
  • You can update your world as often as you like. Just push an update! It won't change the status of your world.
  • If your world is already Public, you don't need to re-submit the world if you update it. It should update automatically and you will not lose your Public status.
  • If your world or any content in the world (videos, avatars, images) violates the VRChat Terms of Service or the Community Guidelines, your ability to submit worlds to Community Labs will be suspended for a period of time. Repeated suspensions may result in in-app moderation action.
  • We do not approve worlds via Discord DMs, emails to VRChat, or any other channel.
  • If your world is very large in filesize, we may ask you to reduce the size of the world and remove it from Public in the meantime. Try to keep your worlds under 200MB.

Avatar Worlds / All Avatar Pedestals in any World

  • Avatars on pedestals are expected to be "reasonably optimized". Check out our Avatar Optimization Docs for more details, and see below for a table of the limits for pedestals.. This applies to all worlds, not just avatar worlds. If any avatars in your world exceed the limits given there, your world may be removed from Public or Community Labs.
Component TypeLimit
Skinned Mesh RenderersMax 8, ideally 1
Material SlotsMax 16, ideally 1-4
Dynamic Bone Affected TransformsMax 32, ideally between 0-16
Dynamic Bone Collider ComponentsMax 2, ideally 0
PolygonsMax 70,000, ideally below 32,000
  • If you upload a world with placeholder avatars and replace them with TOS-violating avatars after being made public, you will be suspended from World Submission for a month and may be moderated in-app depending on the offense severity.
  • If you have an avatar world, none of your avatars may violate TOS/Community Guidelines.
  • Look into using Cat's Blender Plugin and Shotariya's Texture Combiner addons for Blender to optimize your models.

Performance Tips

  • Aim for greater than 45 FPS with a single VR user at the spawn. If you do not have VR, have a friend test the world for you. Having a badly performing world will mean people don't spend time in your world, and you probably won't make it out of Labs very easily.
  • Don't use shaders that are not VR-compatible (as in, it does not support single-pass stereo). If you are looking for a good water shader, check out Silent's Water Shader on VRCat.
  • Be very careful with post-processing effects. Many screen-space post-processing effects look very bad or cause major issues for VR users. In particular be careful with chromatic aberration, screen-space reflection, and screen-space ambient occlusion.
  • Bad things happen when you put more than 2 video players in a room. It usually impacts performance negatively.
  • Bad things also happen when you put more than 1 mirror in your room. Definitely impacts performance. If you have 1 mirror in the room, make sure to set it to toggle.
  • We STRONGLY SUGGEST making any and all mirrors in your world toggleable with a trigger, either a button or an area trigger.
  • JetDog made a great tutorial on performance improvements. Check it out!
  • Do NOT overuse real time lights. They are very expensive and can kill your world's performance if used incorrectly.
  • Baking your lighting is exceedingly important and can give you pretty huge performance gains. Xiexe has provided some excellent information on baking lighting.
  • The VRCat World Building forum is an excellent source of information for lots of performance (and other world-creation-related) questions and issues.

General Tips

  • Do not use Blendfiles for import. This can cause significant issues later on. Please export FBX files from Blender for use in VRChat!
  • Test your world! It isn't uncommon for us to see worlds where you immediately drop out of the portal forever.
  • Test your world in VR, as well. Check to ensure your shaders are working properly and display properly in VR. If you don't have a VR headset, ask a friend to take a look around.
  • TEST YOUR LIGHTING! Lighting a world is very important and doing it properly is wildly important. Don't just test using Toon shaders as they do not represent lighting properly, use Standard or a PBR shader to see how lighting affects it. If you look blown-out, you probably have too many lights, your intensity is too high, or you need to look into using Tonemapping.
  • Want to make your world private again? Edit your world on the website and you can set it to Private.

If you have any questions about the process please email [email protected] with your question. If you run an event or have a highly trafficked world in the app and need a world made public at a different time, please reach out to us via email at least 48 hours in advance.

Submitting to Community Labs

Once you've read everything above, submit your new world to Community Labs! If you're curious about how Community Labs works, check out our VRChat Community Labs documentation.

Becoming a Game or Avatar World

If you want your world to be categorized as an Avatar World or Game World, just add the appropriate tag during upload.

To categorize your world as an avatar world, add the tag avatar.

To categorize your world as a game world, add the tag game.

Updated 4 months ago


World Creation, Optimization, and Community Labs Tips


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.