Installation and testing

Requirements

Prepare a Worlds project created with VCC (VRChat Creator Companion).

Back up your project

Back up your Unity project

Create a backup before importing Object Spawn System so that you can restore the project if a problem occurs.
Close Unity, save the entire project folder as a ZIP archive, and keep it in a location separate from the original project.

ALCOM, an unofficial alternative to VCC, can create a ZIP backup of a Unity project with a single button.

Import

1. Open the target world project in Unity
2. Import the Object Spawn System unitypackage
3. Confirm that the PurabeWorks/ObjectSpawn folder appears in the Project window
4. Confirm that there are no compilation errors in the Console

Test the sample scene

1. Open PurabeWorks/ObjectSpawn/SampleScene.unity
2. Start the world with the VRChat SDK testing feature
3. Interact with a Spawn switch and confirm that an object appears
4. Place the spawned object in a Return trigger and confirm that it becomes hidden
5. Spawn multiple objects and confirm that the Reset switch hides all of them

Start by duplicating the sample

Until you are familiar with the system, the most reliable approach is to duplicate the working sample setup and replace the Pool contents and appearance.

Next steps

1. Prepare a Pickup for spawning
2. Configure VRCObjectPool
3. Create a Spawn switch
4. Create a Return trigger
5. If needed, create a Reset switch

Structure supported by the standard version

Pool target and Return target

The GameObject registered in VRCObjectPool, the GameObject entering the Return trigger, and therefore the GameObject containing VRCPickup, must all be the same GameObject.

If you need to use objects with a different structure, consider the Object Spawn Extension.