AutoMod AI Profiles

AutoMod AI Profiles helps you save and apply a World of Warcraft Classic Era control setup. A profile can manage macros, action-bar slots, keys, and two safe game settings.

AutoMod AI Profiles does not include profiles. You add each profile by copying and pasting a profile definition.

AutoMod AI Profiles never casts combat abilities or controls your character. It does not apply changes during combat.

Compare saved profiles, read their purpose, and select the setup you want to use.

AutoMod AI Profiles showing two Mage control profiles

Review the main controls and usage notes before the profile changes your setup.

A Mage profile with its main controls and usage notes

1. Exit World of Warcraft Classic Era.
2. Download AutoMod.zip.
3. Extract the zip file.
4. Open /Applications/World of Warcraft/_classic_era_/Interface/AddOns.
5. Move the current AutoMod folder to a safe backup location.
6. Copy the new AutoMod folder into AddOns.
7. Start WoW and enable AutoMod AI Profiles in the AddOns list.

The latest release page is github.com/ericwooley/wow-automod/releases/latest.

Enter /automod in the WoW chat box.

AutoMod AI Profiles uses one window with five tabs:

• Profiles shows your profiles and their main controls.
• Add Profile lets you name a profile and paste its definition.
• Instructions stores preferences for this character or every character.
• Character Export creates a current character snapshot for an LLM.
• Help explains setup, profiles, instructions, export, notes, and shortcuts.

The green check beside a profile means that profile is active. Selecting a different profile does not change your character.

1. Open AutoMod AI Profiles with /automod.
2. Choose Add Profile.
3. Enter a short profile name.
4. Paste the complete profile definition.
5. Choose Add Profile.
6. Select the new profile in the Profiles tab.
7. Choose Use This Profile.
8. Review the changes.
9. Choose Apply Changes.

The name belongs to AutoMod AI Profiles. The pasted text contains only the profile definition. You can rename a profile without changing its definition.

AutoMod AI Profiles saves profiles for the current character. A profile appears only when its class and race match that character.

AutoMod AI Profiles can prepare instructions for an AI assistant or LLM. You choose where to copy and share those instructions.

1. Open the Instructions tab.
2. Choose This Character and enter preferences for the current character.
3. Choose Save Instructions.
4. Use All Characters for preferences that should apply everywhere.
5. Save those instructions if you added any.
6. Open the Add Profile tab.
7. Choose Create LLM Instructions.
8. Choose Select All Instructions.
9. Copy the selected text.
10. Paste the text into your LLM.
11. If the LLM needs an essential detail, answer its short question.
12. Copy the definition from the final code block.
13. Return to AutoMod AI Profiles and paste the definition.

When your request is clear, the LLM returns the complete profile at once. It asks a question only when an essential detail is missing.

The LLM instructions include the current character, known abilities, action bar, keys, and both saved instruction sets. They also include the selected profile when you update one.

The LLM returns AUTOMOD_PROFILE_V2 definition text. This text does not contain the profile name or an internal identifier.

AutoMod AI Profiles collects a current character export for an AI assistant or LLM. The addon shows the export inside a copyable text box.

1. Open the Character Export tab.
2. Choose Select All.
3. Copy the selected text.
4. Paste the text into your LLM and add your question.

AutoMod AI Profiles creates a current export each time you open the tab.

The snapshot includes your location, known flight paths, level, progress, stats, equipment, bag items, saved bank inventory, quests, spells, talents, skills, known profession recipes, reputation, active effects, action bars, keys, and macros. The text also tells the LLM how to use the snapshot.

AutoMod AI Profiles reads your known profession recipes when you open Character Export. It updates the saved recipe list when you learn or use recipes. Character Export can briefly open and close profession windows to refresh missing recipe data.

AutoMod AI Profiles reads known flight paths when you open a flight master's taxi map. It keeps those paths available for later character exports.

AutoMod AI Profiles reads bank inventory while the bank window is open. It keeps the latest bank snapshot available for later character exports.

1. Open the Profiles tab.
2. Select the profile.
3. Choose Update Profile.
4. Keep or change the profile name.
5. Paste the updated definition.
6. Choose Save Update.
7. Choose Use This Profile when you want to apply the changes.

AutoMod AI Profiles increases the profile version when the definition changes. A new version can apply automatically after login or /reload when the profile is active.

1. Select the profile in the Profiles tab.
2. Choose Update Profile.
3. Change the profile name.
4. Choose Save Update.

Renaming does not change the profile definition or your character setup.

1. Open the Profiles tab.
2. Select the profile.
3. Choose Delete Profile.
4. Confirm the deletion.

Deleting a profile removes it from the current character. It does not change your current action bars, macros, keys, or game settings.

AutoMod AI Profiles adds a button near the minimap.

• Right-click the button to open AutoMod AI Profiles.
• Left-click the button to show the selected profile instructions.
• Drag the button to move it around the minimap.

You can move the profile instructions window. Choose Lock to prevent accidental movement.

Open Help for task steps inside the game. Choose Start, Profiles, Instructions, Notes, Export, or Tips to find the related instructions.

• /automod opens or closes AutoMod AI Profiles.
• /automod apply opens AutoMod AI Profiles and starts the selected profile review.
• /automod status opens AutoMod AI Profiles.
• /automod help shows command help.

AutoMod AI Profiles parses pasted definitions as data. It never executes pasted text as Lua code.

AutoMod AI Profiles checks the complete definition before it changes the character. It rejects unsafe macro commands, unsupported settings, duplicate keys, and actions that it cannot safely replace.

Before AutoMod AI Profiles changes a managed setting, it saves the previous value internally. If an apply operation fails, the addon restores the previous setup. If that repair cannot finish, the Profiles tab shows Repair Previous Setup.

AutoMod AI Profiles accepts only alwaysShowActionBars and autoLootDefault as game settings. It rejects imported macros that use /run, /script, /dump, /console, or /click.

The first line must be:

AUTOMOD_PROFILE_V2

The next line defines the behavior:

definition<TAB>version<TAB>auto-apply<TAB>description<TAB>class-token<TAB>race

The definition can then contain note tabs, requested values, macros, actions, keys, and supported game settings. The final line must contain only end.

Use these records to add compact note tabs:

note_tab<TAB>overview<TAB>Overview<TAB>freeform
note_text<TAB>overview<TAB>Briefly explain the profile design and basic use.
note_tab<TAB>id<TAB>title<TAB>structured
note_row<TAB>id<TAB>input<TAB>action<TAB>when<TAB>next<TAB>icon
note_tab<TAB>caveats<TAB>Caveats<TAB>freeform
note_text<TAB>caveats<TAB>Important information for the player.

Every new profile starts with a brief, freeform Overview tab. Use separate tabs for controls, combat flows, and caveats. AutoMod AI Profiles still reads old note records.

Key bindings can use these Classic Era action slots:

• Main Bar 1 uses slots 1-12.
• Right Bar uses slots 25-36.
• Right Bar 2 uses slots 37-48.
• Bottom Right uses slots 49-60.
• Bottom Left uses slots 61-72.

Slots 13-24 and 73-120 do not have native standalone binding commands. AutoMod AI Profiles can place actions there, but a profile cannot bind keys to them.

The visible <TAB> token separates fields. AutoMod AI Profiles converts each token during validation. The LLM instructions contain the complete record rules and a valid example.

AutoMod AI Profiles uses the MIT License.

Use Conventional Commits 1.0.0 for every commit. Use feat: for a minor version, fix: for a patch version, and ! or BREAKING CHANGE: for a major version. Other allowed types select a patch version so every main push can produce a beta build.

Run all tests and validation:

./scripts/validate.sh

Build dist/AutoMod.zip with the addon and MIT license:

./scripts/package.sh

Install while WoW is closed:

./scripts/install.sh

The installer validates the addon, backs up the current installation, and copies the complete AutoMod folder.