JSON Atlas Texture

by NickStein_ Games

1

AtlasTextureJSON

AtlasTexture JSON Icon

About

Custom class for the Godot Engine based on AtlasTexture.
This class uses the .json files that are created when exporting sprite sheets to compile Symbols / Tags and their respective frames to create a sprite.

Currently supported sprite sheet formats:

  • Aseprite
  • Adobe Animate / Flash

Features

  • Automatic loading of a .json file when the texture is loaded.
  • Support for both Hash and Array-based .json formats.
  • Aseprite's Tags and Adobe Animate / Flash's Symbols seperated in sections through the symbol property.
  • Texture scaling through a scale property within the AtlasTextureJSON.
    • Customisable scale interpolation via scale_behaviour property.
  • Customisable frame looping behaviour via frame_behaviour property.

Planned

  • Aseprite custom formatting options.

Tentative

  • Custom offsets on symbols.
  • Automatic Atlas creation with presets via the Import tab.
  • A completely independent class TextureJSON (without inheriting AtlasTexture.).

Instructions

  1. Download the plugin (from AssetLib, or through cloning this repository).
  2. No enabling required, this "plugin" is really just a script that adds a new class to your project.
  3. Create a new resource instance of AtlasTextureJSON on any Texture2D-based property.
  4. Load your source image into the texture property of the resource.
  5. Select the sprite and frame you want via the symbol and frame properties.

Exporting

Important

When Exporting from Aseprite,
The Item Filename format must be:

{tag}{tagframe0000}

Important

The .json file must have the same base name as your texture image.

✅ YES:

📁Sprites
  ├─ 🎨 sprite.png
  └─ 📃 sprite.json

❌ NO:

📁Sprites
  ├─ 🎨 sprite_image.png
  └─ 📃 sprite_json_data.json

Issues

  • JSON file is not updated automatically (#2)

Major Contributors

Version

1.1

Engine

4.1

Category

Tools

Download

Version1.1
Download Now

Support

If you need help or have questions about this plugin, please contact the author.

Contact Author