Skip to content

xorblo-doitus/TileSet-Clipboard

Repository files navigation

TileSet Clipboard

Addon's icon

A Godot addon that adds advanced copying-and-pasting to the tile set editor.

Features showcase

You can copy and paste multiple tiles:

Copying and pasting 4 tiles in a TileSet

You can filter which properties are pasted and optionaly duplicate when pasting (for instance when pasting resources):

Choosing properties to paste

You can undo and redo pasting:

Undoing and redoing

Controls are intuitive; they work mostly like in a spreadsheet:

Pasting multiple tiles into one tile, pasting patterns

Features a terrain replacer too:

Replacing a terrain by another in the selection

Example use case:

Pasting a terrain setup and changing the terrain

Static images

Property filters and quick settings:

Property filters and quick settings

Settings:

Settings

RoadMap

I leave the "maybe" stuff for now. If you are interested by their implementation, open an issue.

  • Add shortcut (ctrl + c and ctr + v). Unknown feasibility. Maybe needs this Godot PR.
    • Add shortcut: shift + c and shift + v (Found after a lot of trouble that it was possible by grabing focus and using BaseButton's shortcut, and that the shift modifier was the only one not intercepted by other GUI)
  • Add a way to filter which properties are pasted.
    • Display custom data name instead of "custom_data_0", "custom_data_1", "custom_data_2"...
    • (Maybe) Add a way to filter property components (such as x and y for Vector2 properties)
    • (Maybe) Display value type
    • (Maybe) Fold peering bits into one property
  • Paste from upper left corner. (Similar to LO Calc when pasting multiple cells in one cell). Unknown feasibility.
  • Add wrapping pasting. (Similar to LO Calc when pasting in more cells than there are selected) .
  • (Maybe) Cross instance copy paste (though serialization in the OS paste bin). Unknown feasibility.
  • (Maybe) Add a way to flip or rotate the copied properties (or the selection?)

Installation

You can download the addon:

  • On GitHub: CodeDownload ZIP.
  • Through the editor: AssetLib → Search for "TileSet Clipboard"

By default, this readme is included, along with it's illustrations. If you don't want them, do not download addons/tile_set_clipboard.editor/README.md nor .assets_for_readme/*

You can also exclude *.editor/* or tile_set_clipboard.editor/ from your export presets, because this addon is editor-only.

FAQ

Doesn't Godot's TileSetEditor already have copying-and-pasting?

Yes, but only for one source tile and one property at a time. This addons supports copying-and-pasting multiple properties from multiple tiles at the same time.

Can I copy and paste from a TileSet to another?

Yes, but the addon won't paste properties that are set to the default value (because get_property_list() don't give them for some reason). As a workaround, you can copy-paste a tile from the destination TileSet to the source TileSet at an unused place. When copying tiles from that source, the addon will notice that a cell in the source has more properties and will copy the unmodified properties.

Godot version

Minimal Godot version: 4.4

See the 4.3-backport branch for a Godot 4.3 compatible version.

Credits

The way to interact with the tile set editor trough GDScript was found on github.com/dandeliondino/tile_bit_tools. I used some of his code in scrapper.gd

Development Status

LTS (Only bugfixes)

About

A Godot addon that adds advanced copying-and-pasting to the tile set editor.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published