Skip to main content

Migrate from Object Spawn System

Use the included editor migration tool to replace Object Spawn System components and settings in the current scene with their Extension versions.

Before migration​

  1. Back up the Unity project
  2. Import the Object Spawn Extension unitypackage
  3. Open the scene to migrate
  4. Save the scene
Prefab Assets are not modified directly

The migration tool creates added- and removed-component overrides on Prefab instances in the scene. It does not modify Prefab Assets in the Project window.

Run the tool with a scene open

The migration tool cannot run in Prefab Mode. Open the scene containing the migration targets before running it.

Open the migration tool​

Select the following item from the Unity menu.

Tools > Purabe Works > Object Spawn Extension

Object Spawn Extension migration tool

The tool searches the active scene for the following components. Inactive GameObjects are also included.

  • SpawnObject
  • ReturnObject
  • ResetSwitch

Automatically migrated content​

Before migrationAfter migration
SpawnObjectSpawnObjectExt
ReturnObjectReturnObjectExt
ResetSwitchThe component is retained and its reference is changed to the migrated ReturnObjectExt

The following settings are transferred to the new components.

  • VRC Object Pool
  • Random Spawn
  • Move Item To Hand
  • Spawn Point
  • Spawn Delay Frames
  • Pools, Reference, and Layer
  • Audio sources and clips for Spawn and Return

Run the migration​

  1. Check the number of targets displayed in the window
  2. Review any warnings
  3. Select 移行を実行 (Run migration)
  4. Review the migrated counts and warnings on the completion screen
  5. Check the Inspector references and test the behavior in the world
  6. If everything works, save the scene

Object Spawn Extension migration result

You can undo the migration with Unity's Undo command. The scene is not saved automatically.

Settings to configure after migration​

  • The existing Spawn Point is retained as a single spawn destination. To use multiple points, change the destination mode on SpawnObjectExt to 複数 (Multiple).
  • Spawn and Return event notifications are created disabled. Enable them only on the components that need them.
  • CompSpawnHelper and HGSpawnHelper are not added automatically. Configure them for each complex item as needed.

When migration is skipped​

If the same GameObject already contains the destination SpawnObjectExt or ReturnObjectExt, the tool does not merge them automatically and skips that component.

If any migration target remains, review the warning and configure it manually.