Reparenting Tool (Pro)

The Reparenting Tool allows you to efficiently move multiple GameObjects to a new parent in the hierarchy. Unlike Unity’s drag-and-drop, this tool offers batch operations, safety validation, and flexible workflow options.

How to Use

Open the tool via Tools > realvirtual > Reparenting (Pro) (Alt+R) or press Alt+R.

Basic Workflow:

1. Select a target parent using the object field or “Use Selected” button
2. Select objects in the hierarchy and click “Add Selected” to add them to the move list
3. Click the green “MOVE TO PARENT” button to execute the operation
4. Use the yellow undo button if needed to reverse the operation

Alternative Workflow: You can also add objects to the move list first, then select a parent later - the tool works in any order.

Interface Elements

• Target Parent: Object field to select the destination parent, or use “Use Selected” button
• Add Selected: Adds currently selected hierarchy objects to the move list
• Clear List: Removes all objects from the move list
• Objects List: Expandable view showing queued objects (click “X” to remove individual items)
• MOVE TO PARENT: Turns green when ready, shows object count in parentheses
• Undo Button: Yellow button appears after successful operations

Safety Features

The tool automatically prevents common errors:

• Circular dependencies: Won’t let you make a parent become its own child
• Prefab protection: Blocks moving into prefab assets or connected prefab instances with helpful error messages
• Smart validation: Excludes the selected parent from objects to move, removes duplicates and null references

Objects maintain their world position and rotation after being moved.

Common Error Messages

• “Cannot move objects into a prefab asset” → Instantiate the prefab in the scene first
• “Cannot move objects into a connected prefab instance” → Unpack the prefab or choose a regular GameObject
• “Would create circular dependency” → Choose a different parent or restructure the hierarchy
• “No valid objects selected to move” → Add different objects or select a different parent

The tool is ideal for organizing imported CAD models, preparing prefabs, or restructuring complex scenes with multiple object groups.

---

© 2025 realvirtual GmbH https://realvirtual.io - All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means, including printing, saving, photocopying, recording, or other electronic or mechanical methods, without the prior written permission of the publisher.