Edit of asset "TileCopy" Accepted

Old/Current New/Edit
Title TileCopy TileCopy
Description # Tile Copy User Guide

Tile Copy copies `TileData` properties between Atlas tiles and replaces Terrain IDs in batches.

`TileData` defines tile behavior, including collision, navigation, terrain, occlusion, rendering properties, and custom data.

Supported version: Godot 4.3 or later.

## Controls

Select an Atlas Source and one or more tiles in the TileSet editor. The following controls appear in the Inspector:

| Control | Function |
| --- | --- |
| **Copy** | Records the source tiles and their relative coordinates. |
| **Paste** | Pastes properties into the target tiles. |
| **Setting** | Configures the position mask and property filter. |
| **Change Terrain** | Replaces a Terrain ID. |

## Property Paste

1. Select the source tiles and click **Copy**.
2. Select the target tiles and click **Paste**.

A single tile uses relative coordinate `(0, 0)`. For multiple tiles, the source and target coordinates are normalized separately and matched by their coordinate intersection. Tiles without a corresponding position are ignored, and gaps in the selection are neither collapsed nor filled.

Without a **Setting** configuration, all available `TileData` properties at matching coordinates are pasted. Target tile textures remain unchanged.

## Selective Paste

Click **Setting** to configure two levels of filtering:

- **Position** on the left is the position mask. Click a tile preview to toggle it; gray tiles are excluded from paste.
- **Property** on the right is the property filter. It controls which property paths are pasted at each coordinate.

The two sides keep independent state and are combined after clicking **OK**. The position mask has priority: a coordinate disabled on the left produces no paste operation; an enabled coordinate then uses the property filter on the right.

Parent checkboxes control their descendants, and partially selected branches show an indeterminate state. Click **OK** to apply changes. Running **Copy** again clears the current filter configuration.

## Terrain ID Replacement

This operation applies directly to the current selection and does not require **Copy**.

1. Enter the source Terrain ID in **From**.
2. Enter the target Terrain ID in **To**.
3. Click **Change Terrain**.

The operation replaces:

- the main `terrain` property when it equals the source ID;
- valid Terrain Peering Bits when they equal the source ID.

Empty Peering Bits and other Terrain IDs remain unchanged. The operation is unavailable when the source and target IDs are equal.

The entered Terrain IDs must belong to the Terrain Set used by the selected tiles.

## Notes

- **Paste** and **Setting** become available after **Copy**.
- Before pasting multiple tiles, confirm that the source and target selection shapes and gaps correspond.
- When pasting across TileSets, both sides should use the same physics, navigation, occlusion, terrain, and custom-data layer configuration.

## License

MIT License. Contact: `[email protected]`
## Installation

Place `addons/tile_copy` in your project, then enable **Tile Copy & Terrain** under **Project > Project Settings > Plugins**.

## Usage

Select tiles in an Atlas source in the TileSet editor. Action buttons will appear in the Inspector.

- **Copy / Paste**: Copies `TileData` properties. When multiple tiles are selected, they are matched by relative coordinates.
- **Setting**: Choose the tiles and properties to paste.
- **Change Terrain**: Replaces the selected tiles' **From** terrain with the **To** terrain and updates valid edge and corner peering bits.

Paste and Change Terrain support Undo / Redo.

For questions or suggestions, contact: [email protected]
Category Tools Tools
License MIT MIT
Repository Provider GitHub GitHub
Repository Url https://github.com/wyfyjc/TileCopy https://github.com/wyfyjc/TileCopy
Issues Url https://github.com/wyfyjc/TileCopy/issues https://github.com/wyfyjc/TileCopy/issues
Godot version Godot 4.3 Godot 4.3
Version String v1.0.2 v1.0.0
Download Commit ec9ed7bc9d44478535cbeb2007f33d7485ef9705 b0d176ad08d39b9f6f15f0910e0d6736a9e18861
Download Url (Computed) https://github.com/wyfyjc/TileCopy/archive/ec9ed7bc9d44478535cbeb2007f33d7485ef9705.zip https://github.com/wyfyjc/TileCopy/archive/b0d176ad08d39b9f6f15f0910e0d6736a9e18861.zip
Icon Url https://godotengine.org/assets/press/icon_color.png
https://godotengine.org/assets/press/icon_color.png