Giter Club home page Giter Club logo

aseprite_importer's Introduction

A plugin for the Godot Engine that imports animations from Aseprite

What does it actually do?

This plugin simply creates / modifies animations in an AnimationPlayer that change the offset and region_rect properties of a Sprite/Sprite3D node based on the animation tags of a Sprite Sheet JSON data file generated by Aseprite. For a more in-depth explanation see this code.

Download and Installation

Downloading from the Godot Asset Library

  1. In the Godot editor, open the AssetLib tab
  2. Search for Aseprite Importer
  3. Click on the asset name and click the Download button in the preview window
  4. After the download is finished, click Instal... and then Install in the popup
  5. Go to Projects -> Project Settings... and enable the plugin in the Plugins tab

Downloading from the GitHub repository

  1. Download or clone this repository and copy the /addons/aseprite_importer folder into your project/addons folder
  2. In the Godot Editor, go to Projects -> Project Settings... and enable the plugin in the Plugins tab

Usage

Exporting from Aseprite

  1. In Aseprite, go to File -> Export Sprite Sheet
  2. Configure how you want the Sprite Sheet image to be exported
  3. In the Output section:
    • Enable the option Output File and select the directory where you want the texture file to be saved;
    • Enable the option JSON Data and select the directory where you want the JSON data file to be saved (preferably in the same directory of the image)
    • Enable the option Meta -> Tags

Importing to Godot

  1. Open the scene where you want to import the animations
  2. Select the JSON Data file
  3. Select the texture file if it has not been automatically loaded
  4. Select which tags you want to be imported
  5. Select the AnimationPlayer node where you want the animations to be added/modified
  6. Select The Sprite/Sprite3D node you want to be affected by the animations
  7. Press Generate Animations

Limitations

  • For now the plugin doesn't keep track of the selected files in the disk to automatically re-import the changes;
  • It also is not integrated with the Godot's UndoRedo system.

License

MIT License

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.