Skip to content

Latest commit

 

History

History
86 lines (53 loc) · 3.74 KB

README.md

File metadata and controls

86 lines (53 loc) · 3.74 KB
Raw

COA tools 2

the Addon of Cutout Animation Tools for Blender, which allows you to create cutout animations in Blender.

GitHub release

Table of Contents

Description

COA Tools 2 is an add-on developed by ndee89 and modified/remade by Aodaruma, which enables 2D rigging and animation within Blender.

The original COA Tools by ndee89 provided a rapid workflow for creating 2D cutout characters/animations in Blender. With COA Tools 2, the goal is to support Blender 3.4 and above, introduce automatic mesh generation, and establish a workflow with minimal features, allowing direct editing without going through proprietary modes.

Currently, the focus for development is on two aspects:

  1. Photoshop sprite exporter
  2. Blender add-on

The intention is to concentrate on these areas, specifically addressing the necessary improvements.

Since development is a time and resource-intensive process, it's not easy to being solely undertaken by me. However, if there are multiple developers willing to contribute and if the project necessitates scalability, I am considering inviting collaborators to join :)

Download and Installation

Download

Download the latest release from the releases page.

Installation

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

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

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.

Development

The source code for development is in the main branch. coa_tools2 folder is a main body of the add-on. For efficient development, you can create a link to that folder in the Blender addons folder.

# Linux
LATEST_BLENDER_DIR=$(find "$HOME/.config/blender" -d 1 | grep -e "[0-9]\.[0-9]" | sort -rh | head -n 1)
ln -s "$PWD/coa_tools2" "$LATEST_BLENDER_DIR/scripts/addons/coa_tools2"
# macOS
LATEST_BLENDER_DIR=$(find "$HOME/Library/Application Support/Blender" -d 1 | grep -e "[0-9]\.[0-9]" | sort -rh | head -n 1)
ln -s "$PWD/coa_tools2" "$LATEST_BLENDER_DIR/scripts/addons/coa_tools2"
# Windows PowerShell
$LatestBlenderDir = (Get-ChildItem "$env:APPDATA\Blender Foundation\Blender" -Directory | Where-Object { $_.Name -match "[0-9]\.[0-9]" } | Sort-Object -Descending | Select-Object -First 1).FullName
New-Item -ItemType Junction -Path "$LatestBlenderDir\scripts\addons\coa_tools2" -Value "$(Get-Location)\coa_tools2"

I'm using pipenv for dependency management. You can install the dependencies with pipenv sync if you have already installed pipenv.

Some extensions of vscode are recommended for development and written in .vscode/extensions.json. Feel free to use them.