Check out our latest project โœจ OpenChapter.io: free ebooks the way its meant to be ๐Ÿ“–

JSON Atlas Texture

An asset by NickStein_ Games
The page banner background of a mountain and forest
JSON Atlas Texture hero image

Quick Information

0 ratings
JSON Atlas Texture icon image
NickStein_ Games
JSON Atlas Texture

Adds a small class based on `AtlasTexture' that allows you to use `.json` files for sprite sheets.

Supported Engine Version
4.4
Version String
2.0
License Version
MIT
Support Level
community
Modified Date
29 days ago
Git URL
Issue URL

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

    Adds a small class based on `AtlasTexture' that allows you to use `.json` files for sprite sheets.

    Reviews

    0 ratings

    Your Rating

    Headline must be at least 3 characters but not more than 50
    Review must be at least 5 characters but not more than 500
    Please sign in to add a review

    Quick Information

    0 ratings
    JSON Atlas Texture icon image
    NickStein_ Games
    JSON Atlas Texture

    Adds a small class based on `AtlasTexture' that allows you to use `.json` files for sprite sheets.

    Supported Engine Version
    4.4
    Version String
    2.0
    License Version
    MIT
    Support Level
    community
    Modified Date
    29 days ago
    Git URL
    Issue URL

    Open Source

    Released under the AGPLv3 license

    Plug and Play

    Browse assets directly from Godot

    Community Driven

    Created by developers for developers