Chatter Companion

Chatter is a World of Warcraft 3.3.5 addon that acts as a companion UI for the mod-llm-chatter AzerothCore module.

It lets the player manage persistent personality traits for bots they have grouped with before. The addon shows known bots, allows editing the three stored traits for a selected bot, and displays the tone that mod-llm-chatter generates from those traits.

Repository: https://github.com/Hokken/Chatter-Companion

---

What It Does

• Lists bots the player has previously grouped with
• Lets the player edit each bot's 3 persistent traits
• Shows the generated tone derived from those traits
• Syncs with the server-side mod-llm-chatter data model

Companion To mod-llm-chatter

This addon is not a standalone system. It only works against an AzerothCore server that has mod-llm-chatter installed and running (worldserver + Python bridge). On a vanilla server the addon will load but the roster will stay empty and saving traits will do nothing.

Requirements

• World of Warcraft 3.3.5a client
• AzerothCore server with mod-llm-chatter installed and the Python bridge running
• You must have grouped with at least one bot before that bot appears in the roster

---

Installation

The single most common reason the addon "does not show up in the AddOns menu" is a wrong folder layout. Follow these steps exactly.

1. Download

• Go to https://github.com/Hokken/Chatter-Companion
• Click Code → Download ZIP, or git clone the repo

2. Place the folder correctly

The addon folder must be at:

<WoW install>\Interface\AddOns\Chatter\

Inside that Chatter folder you must see:

Chatter\
├── Chatter.toc
├── Chatter.lua
├── README.md
└── images\

The folder name must be exactly Chatter (matching Chatter.toc). If WoW does not see a folder whose name matches the .toc filename, the addon will not appear in the AddOns list.

Common mistakes

Wrong layout	Why it fails	Fix
Interface\AddOns\Chatter-Companion-master\Chatter.toc	Folder name (Chatter-Companion-master) does not match Chatter.toc	Rename folder to Chatter, or open it and move the inner files up one level
Interface\AddOns\Chatter-Companion-master\Chatter\Chatter.toc	The real Chatter folder is one level too deep	Move the inner Chatter folder up into Interface\AddOns\
Interface\AddOns\Chatter\Chatter\Chatter.toc	Doubled-up Chatter\Chatter\ from a re-extracted ZIP	Move the inner files up one level so Chatter.toc sits directly under AddOns\Chatter\
Folder placed in World of Warcraft\AddOns\	Wrong path — addons live under Interface\	Move to Interface\AddOns\

3. Enable the addon in WoW

1. Fully quit WoW (don't just /reload — a full restart is the safest first time).
2. Launch the game and stop at the character select screen.
3. Click the AddOns button in the bottom-left.
4. Make sure Chatter is in the list and its checkbox is enabled.
5. Tick "Load out of date AddOns" — the .toc is tagged Interface: 30300, which is correct for 3.3.5a, but some clients still flag it.
6. Log into your character.

4. Verify the addon loaded

In-game, type:

/chatter

The Chatter Companion window should open. If it doesn't, see Troubleshooting below.

---

Usage

• Open the addon with /chatter or /llmc
• Select a known bot from the roster
• Edit the three traits
• Click Save Changes
• The server regenerates the tone from the saved traits
• The addon refreshes and displays the generated tone

Tone is generated by the backend and shown in the UI as read-only output.

---

Troubleshooting

"Chatter does not appear in the AddOns menu"

• Almost always a folder-layout problem — re-check the table in Installation step 2.
• Confirm Chatter.toc is at Interface\AddOns\Chatter\Chatter.toc exactly.
• Fully restart the WoW client (not just /reload).

"Chatter window opens but the bot roster is empty"

• This is expected on first use. Bots appear only after you have grouped with them and the server has stored their chatter identity.
• Group up with a playerbot, run any content for a minute, then /reload and reopen /chatter.
• If it stays empty across multiple sessions, the server-side mod-llm-chatter module is probably not running. Check that the Python bridge is up and that LLMChatter.Enable = 1 in mod_llm_chatter.conf.

"Saving traits seems to do nothing"

• The save path goes through the server. If mod-llm-chatter is not installed or the bridge is offline, the addon has nothing to talk to.
• On the server, confirm ac-llm-chatter-bridge (Docker) or your llm_chatter_bridge.py process is running and connected to the database.

"/chatter says unknown command"

• The addon is not loaded. Re-check Installation step 3, especially the Load out of date AddOns checkbox.

---

Notes

• Saved traits are stored per-character in ChatterDB (see Chatter.toc SavedVariablesPerCharacter).
• The addon never invents data on its own — every bot, trait, and tone you see came from the server.