Animator Controller Editor

Report Bug · Request Feature

Table of Contents

1. About The Project
2. Requirements
3. Installation
4. Features
5. Contributing
6. License
7. Contact and Links
8. Project tools

About The Project

ACE (Animator Controller Editor) is designed to simplify, hasten, and improve your workflow with everything related to Animator Controllers.
The package provides visual enhancements and tools that make working with complex animation systems more intuitive and efficient.

Note

This Project is a work in progress, not all features are implemented yet

(back to top)

Requirements

• Unity Version: 2021.3.23f1 or later
• Dependencies: 0Harmony (included)

(back to top)

Installation

To install this package in your Unity project, follow these steps:

Method 1: Using Unity Package Manager (Recommended)

1. Open your Unity project

2. Go to Window > Package Manager

3. Click the + button in the top-left corner

4. Select Add package from git URL...

5. Enter the following URL:

   https://github.com/NovaVoidHowl/ACE.git
   

6. Click Add

Method 2: Manual Installation via Git

1. Open your Unity project folder

2. Navigate to the Packages folder

3. Clone the repository:

   git clone https://github.com/NovaVoidHowl/ACE.git uk.novavoidhowl.dev.ace
   

Method 3: Download and Install

1. Go to the releases page
2. Download the latest release
3. Extract the contents into your project's Packages folder

After installation, you can configure the tool from the Unity menu under NVH > ACE > Settings

(back to top)

Features

Configuration

Access the ACE Settings window through:

• Unity Menu: NVH/ACE/Settings

Write Defaults Indicator

• Visual State Indicators: Instantly see the "Write Defaults" setting for each state in your Animator Controller
• Color-Coded System: Green indicators for enabled states, blue for disabled states
• Dynamic Text Labels: Clear text indicators alongside visual cues
• Non-Intrusive: Uses Harmony patching to integrate seamlessly with Unity's existing UI

Transition Tools

• Multi-Transition Editing: Edit multiple animator transitions simultaneously, solving Unity's limitation where
  multi-selecting transitions only applies changes to the last selected transition
• Bulk Property Changes: Modify exit time, duration, offset, interruption settings across all selected transitions
• Advanced Condition Management: Add, remove, and edit transition conditions with smart parameter type filtering
• Intelligent UI: Mixed value indicators, external change detection, and real-time validation
• Full Documentation: Comprehensive guide available at Editor/Transition Tools/TRANSITION_TOOLS_README.md

Access via: NVH > ACE > Tools > Transition Tools

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are appreciated. Please see CONTRIBUTING.md for more details.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Please see LICENSE.md for information.

This package includes third-party dependencies:

• 0Harmony: MIT License (see Dependencies/Harmony/LICENSE.md)

(back to top)

Contact and Links

@NovaVoidHowl

(back to top)

Project tools

• VS Code, IDE
• Visual Studio, IDE
• Pre-Commit, linting and error detection
• Github Copilot, Code error/issue analysis

(back to top)