Autism-Client/addon-templates/advanced/README.md

AUTISM Advanced Addon Template

A standalone reference addon for AUTISM Client. It registers one of each supported extension point, so you can copy it when you need the full API surface.

Start small: keep ExampleModule, build once, then add macro actions, commands, HUD elements, events, or mixins as needed.

What It Demonstrates

Extension point	File
Addon lifecycle	ExampleAddon
Module	modules/ExampleModule
Macro action	macro/ExampleSayAction
Macro condition	macro/ExampleHeightCondition + macro/ExampleCondition
Macro preset	macro/ExamplePresets
Command	commands/ExampleCommand
HUD element	hud/ExampleHud
Event hooks	events/ExampleEvents
Mixin	mixin/ExampleMixin + autism-advanced-addon-template.mixins.json

Presets are first-class addon entries. ExamplePresets appears in the macro editor Presets picker under this addon's category, and it can insert any normal stack of macro actions.

Your modules, macro actions, conditions and presets automatically group under a category named after your addon from fabric.mod.json. Custom categories are scoped under your addon so they cannot collide with built-ins or another addon.

Build

1. In the AUTISM Client project, publish the API to your local Maven repo:

   ./gradlew publishToMavenLocal
   

2. Make sure the autism version in gradle/libs.versions.toml matches what you published.
3. Build this addon:

   ./gradlew build
   

The addon jar lands in build/libs/.

Run

Drop both jars into your mods/ folder:

• the AUTISM Client jar;
• this addon's jar from build/libs/.

Make It Yours

Recommended:

..\addon-toolkit.ps1 -Action Setup -Template advanced -OutputPath ..\..\..\MyAdvancedAddon

The toolkit asks for the addon name, output folder, version, and author. Blank version bumps the current template version by one patch step. It derives the boring stuff and rewrites Gradle files, package paths, fabric.mod.json, entrypoints, and the mixin config in one shot.

Manual path:

1. Rename the package com.example.addon.
2. Change ExampleAddon.ID.
3. Update src/main/resources/fabric.mod.json: id, name, entrypoints, mixins, and autism:color.
4. Rename autism-advanced-addon-template.mixins.json and update its package.
5. Keep apiVersion() and the autism dependency range honest for the client version you target.

Project Structure

addon-templates/advanced/
|-- gradle/
|-- src/main/java/com/example/addon/
|   |-- ExampleAddon.java
|   |-- ExampleInit.java
|   |-- modules/ExampleModule.java
|   |-- macro/ExampleSayAction.java
|   |-- macro/ExampleHeightCondition.java
|   |-- macro/ExampleCondition.java
|   |-- macro/ExamplePresets.java
|   |-- commands/ExampleCommand.java
|   |-- hud/ExampleHud.java
|   |-- events/ExampleEvents.java
|   `-- mixin/ExampleMixin.java
|-- src/main/resources/
|   |-- fabric.mod.json
|   `-- autism-advanced-addon-template.mixins.json
|-- build.gradle.kts
`-- gradle.properties