Home

Awesome

<img src="./coa_tools_logo.png" width="250">

Cutout Animation Tools - Documentation

This is the Documentation for the Blender/Godot Addon Cutout Animation Tools.

If you like this addon and want to thank me with a small donation feel free to do this here:

Description

The Cutout Animation Tools (COA Tools) Addon for blender is a 2D rigging and animation suite. It offers you similar tools as for example programs like Spine or Spriter. COA Tools offer you a rapid workflow to create 2D Cutout Character/Animations in blender. Thanks to blenders great animation system and and this addon you get a powerfull solution to create 2D animations. It is parted into 3 different components. Photoshop sprite exporter, Blender Addon, Godot importer.

Take a look at the addon in action.

Photoshop sprite exporter

Quickly export photoshop layers into separate files with json coordinate informations. This can be used in blender to import sprites very quickly. Features:

GIMP sprite exporter

Export GIMP layers and layer groups into separate files with json coordinate information. For additional usage information see the README.md in the GIMP folder.

Cutout Animation Tools Blender

This is the biggest component, as most of the work will be done here. Features the addon offers are:

Godot Cutout Animation Importer

This is an advanced importer that helps you get all your exported blender data into godot. Features:

Download and Installation

Download or Clone the github repository to your local drive. If you download the ZIP File from Github, please make sure to unzip. Don't try to install the downloaded zip file directly in blender. This won't work. Once unzipped follow the installation instructions below.

Photoshop Exporter:

The .jsx file has to be copied into the photoshop scripts folder which is located in:

C:\Program Files\Adobe\Adobe Photoshop CC 2015\Presets\Scripts

Don’t forget to restart Photoshop and then go to File -> Scripts -> BlenderExporter.jsx

Krita Exporter:

Start Krita, go to Settings -> Manage Resources and click the "Open Resource Folder" in the new window. This will open up the krita resource directory. If no pykrita directory exists, create one. Now copy all content from the the Github Krita directory into the pykrita directory. Restart Krita. Now go to Settings -> Configure Krita, then to Python Plugin Manager and enable the COA Tools Exporter. Once the plugin is activated, you can enable the docker under Settings -> Dockers -> COA Tools Exporter.

Now just select the desired layers you want to export. Define a project name and path in the docker and export the images.

GIMP Exporter:

The coatools_exporter.py should be copied to your GIMP plug-ins folder which is located in:

It should show up under Files>Export to CoaTools... after your restart GIMP

Blender Addon:

Zip the coa_folder. Go to File -> User Preferences -> Add-ons and click the “Install from file...” button. This will install and enable the Addon for Blender. Don’t forget to save the user preferences, otherwise the addon will not be activated after restart.

Godot Importer:

Notice, this importer will only run with current godot 2.1 dev builds. Create an /addons folder in your game projects folder and copy the coa_importer folder into that addons folder. Once the files are loaded go to Project Settings -> Plugins -> Cutout Animation Importer and activate the Plugin.