AnimatorController as a Code

#ACaaC: A small Unity Editor Library to generate AnimatorController with C# Code.

Inspired by AV3 Animator as Code but it depends on VRChat SDK. This library is made for vanilla Unity without any libraries.

Installation

Using OpenUPM

This project is also published on OpenUPM. See Package Page on OpenUPM for Installation steps.

Using add package from git url

You can add https://github.com/anatawa12/AnimatorController-as-a-Code.git#<version> as git-based UPM dependencies.

See Installing from a Git URL on Unity Documentation for more details.

Using VPM CommandLine Interface

You may install this package using VPM/VCC CLI. This is recommended step for VRChat Avatars/Worlds Projects.

# add our vpm repository
vpm add repo https://vpm.anatawa12.com/vpm.json
# add package to your project
cd /path/to/your-unity-project
vpm add package com.anatawa12.animator-controller-as-a-code

Using Installer UnityPackage with VPM

With VPAI You can include this package with

1. download installer unitypackag here.
2. Make sure your project contains vpm-resolver. If your project is VRChat Avatars/Worlds project with VCC, It's installed.
3. Import the unitypackage into your project.

How to Use

Overview Steps

1. Install ACaaC to your Unity Package

2. If your project is version controlled, please ignore *.generated.controller from version control.

3. Create Assembly Definition file for ACaaC Generators.

   It's recommended to completely separate your main module and ACaaC Generator Code to reduce regeneration. However, it's supported to use asmdef for your main module.

4. Reference com.anatawa12.animator-controller-as-a-code.framework.asmdef in Packages/com.anatawa12.animator-controller-as-a-code/Framework

5. Create class extends Anatawa12.AnimatorControllerAsACode.Framework.GeneratorLayerBase in your module & write generation code

6. Create/Animator Controller Generator in context menu of Project tab in Unity to create AnimatorControllerGenerator

7. Click Add Generaor and select your Generator created in step 5.

8. Configure your generator.

9. Close Inspector or click Manual Generate to generate your AnimatorController

When you modify something, ACaaC will automatically re-runs generator to keep up-to-date generated controller.

For detail API documentation, see documentation comments.

Versioning

This system uses Semantic Versioning.