Copy To Selected

The Copy To Selected tool duplicates one base object onto a set of target objects. It is useful for placing the same prop, helper object, trigger, or child object at many existing object positions.

The tool keeps the base object as the object to duplicate, then uses each target object’s transform as a placement reference.

Open it from the World Editor window menu as Copy To Selected.

Base Object

The Base Object is the object that will be copied.

To set it:

1. Select the object in the scene or Scenetree.
2. Click Pick From Selection.

The selected base object remains the source for all copies until another base object is picked.

Pick the object exactly as you want it copied. The duplicate is created from the base object’s current fields and asset references, then moved to each target location according to the selected options.

Common base objects include:

• A prop that should be repeated at several markers.
• A trigger or helper object that should be attached to many scene objects.
• A light, sound emitter, or decal helper that should follow a set of existing placements.

Target Objects

Target objects provide the destination positions for the copies.

Available target actions:

• Use Current Selection: uses the current object selection as the target list.
• Clear: clears the target list.
• Use same Class: fills the target list with all objects that share the reference object’s class.
• Use same TSStatic Mesh: fills the target list with all TSStatic objects that use the same mesh as the reference object.

If target objects are already set, the first target is used as the reference for same-class or same-mesh selection. Otherwise, the current selection is used.

The base object is skipped if it is also present in the target list. This prevents the source object from being copied onto itself.

Use Use same Class when all objects of a certain class should receive a copy, such as all markers or all triggers. Use Use same TSStatic Mesh when every instance of a specific mesh should receive a related object, such as adding a helper to every copy of the same prop.

Options

• Apply Target Rotation: copies are rotated to match each target object.
• Relative Rotation (target * base): combines target rotation with the base object’s rotation when target rotation is not applied directly.
• Apply Target Scale: copies use each target object’s scale.
• Put Copies Into New Folder: places the created copies inside a new SimGroup.
• Select Created: selects the created copies after the operation.

Rotation options are useful when the copied object needs to align with each target. If Apply Target Rotation is enabled, the target orientation drives the copy. If Relative Rotation (target * base) is used, the base object’s rotation is preserved relative to the target orientation.

Use Apply Target Scale only when the copied object should inherit target scale. This is useful for helper meshes, but may be undesirable for lights, triggers, sounds, or objects where scale has a specific gameplay meaning.

Use Put Copies Into New Folder for large operations. The new SimGroup keeps generated objects together so they can be reviewed, renamed, moved, or deleted as a batch.

Target Local Offset

The Target Local Offset (m) fields offset each copy in the target object’s local space. Use these values when copies should appear above, beside, or behind each target instead of directly at the target origin.

For example, a positive local Z offset places the copy above each target according to that target’s orientation.

Because the offset is local to each target, the same offset follows target rotation. A local X offset moves sideways relative to each target, local Y moves forward or backward relative to each target, and local Z moves along the target’s up direction.

Use small test values first when targets have different rotations, because local offsets can produce different world-space directions for each target.

Creating Copies

1. Pick the base object.
2. Set the target object list.
3. Choose rotation, scale, grouping, selection, and offset options.
4. Click Create Copies.

The tool creates one copy per target. Created copies are linked back to their target through the target object’s next available child custom field when the copied object has a valid name.

The generated copies use the editor undo stack. If the result is not correct, undo the operation, adjust the target list or options, and run it again.

Example Uses

Add Objects To Matching Meshes

1. Select one TSStatic that uses the mesh you want to target.
2. Click Use same TSStatic Mesh.
3. Pick a base helper object.
4. Set an offset if the helper should sit above or beside the mesh.
5. Click Create Copies.

This creates one helper at every TSStatic using the same mesh.

Copy A Prop To Markers

1. Pick the prop as the base object.
2. Select the marker objects.
3. Click Use Current Selection.
4. Enable Apply Target Rotation if the prop should face the same direction as each marker.
5. Click Create Copies.

This places the prop at each marker transform.

Review After Creation

After creating copies:

• Check the generated group if Put Copies Into New Folder was enabled.
• Verify rotation and offset on a few targets before saving.
• Rename important generated objects if other systems will reference them by name.
• Inspect target child fields if those links are part of the intended setup.

Notes

• The operation supports undo and redo through the editor undo stack.
• The base object itself is skipped if it is also present in the target list.
• Review the generated object names and grouping before saving the level.