2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00
2026-11-07 17:21:54 -06:00

OctoAI

Ask an AI about your own OctoWoW character. Type /octoai, press Copy, paste into any AI chat, ask your question.

For OctoWoW (Turtle WoW 1.18.1 content on the 1.12 client). The one-click Copy button needs ClassicAPI.dll; everything else works on a plain 1.12 client.

Install

Launcher: if your launcher lists OctoAI, install it there.

Manual: download the zip (Code > Download ZIP), extract it into Interface\AddOns\ and rename the folder from OctoAI-main to OctoAI. You should end up with:

Interface\AddOns\OctoAI\OctoAI.toc

Restart the game completely (a new addon is not loaded by /reload) and make sure OctoAI is ticked in the AddOns list on the character screen.

Use

/octoai            Summary: character, talents, gear (with stats), quest log
/octoai gear       character + equipped and bagged gear
/octoai quests     character + quest log with quest IDs, objectives, progress
/octoai bags       character + bag items with item IDs (+ bank if opened)
/octoai talents    character + talents you have picked
/octoai skills     skill levels + recipes that still give skill points
/octoai all        everything above

The window has the same choices as tabs at the top. Copy puts the text on the clipboard (needs ClassicAPI.dll; otherwise it is greyed out, use Select all and Ctrl+C). Paste it into the AI chat and write your question after My question:.

Example questions:

  • "Which items in my bags can I sell?"
  • "Is the gear in my bags better than what I wear?"
  • "Where do I go for the quests in my log, in what order?"
  • "How should I spend my next talent points?"

The text starts with a short note telling the AI that this is OctoWoW, not retail or Classic, and to look things up on https://octowow.st/db/ by the IDs given. AIs still make mistakes about private server content, so double check anything important in game.

Some data only appears after you open a window once

  • Bank: open the bank.
  • Profession recipes: open the profession window.
  • Trainer offers and costs: open the trainer window.

Full snapshot

/octo writes a complete JSON snapshot (everything above plus spells, buffs, reputation, full talent trees and tooltips). It is also saved automatically when things change, out of combat.

  • With VanillaHelpers.dll: <WoW>\VanillaHelpersData\octo_<Name>.json
  • Otherwise: WTF\Account\<account>\<realm>\<character>\SavedVariables\OctoAI.lua (written on logout or /reload)

Other commands: /octo auto on|off, /octo verbose, /octo status.

AI tools (optional, advanced)

tools/ is not used by the game. It is for people whose AI assistant can read their WoW folder (for example the Claude desktop app with the WoW folder connected):

  • tools/octo_query.py: command line lookup (Python 3.8+, standard library only) for quests, NPCs, items, zones and your snapshots. Run python tools/octo_query.py -h.

  • tools/skill/SKILL.md: instructions for the AI on how to use the tool and which rules to follow. Add it as a skill (or paste it into a project's instructions).

  • tools/data/: the quest database from OctoQuestDatabase (MIT, attribution in data/NOTICE.md after download). It is not stored in this repository; download it once with:

    python tools/update_data.py           # latest version
    python tools/update_data.py --check   # compare installed and latest
    

    Run the same command again later to update. Character snapshot commands work without the database.

Privacy

Nothing leaves your computer unless you paste it somewhere yourself. The addon has no network access. The text contains your character name, realm, location and gold.


中文说明

让 AI 根据你自己角色的真实数据回答 OctoWoW 的问题。

  1. 安装:启动器里有就直接装;手动安装就把压缩包解压到 Interface\AddOns\,文件夹名改成 OctoAI(不是 OctoAI-main),然后完全重启游戏。
  2. 游戏里输入 /octoai,上面一排按钮选内容(Summary、Gear、Quests、Bags、Talents、Skills、All)。
  3. 点 Copy(需要 ClassicAPI.dll;没有的话按钮是灰的,点 Select all 再按 Ctrl+C)。
  4. 粘贴到任何 AI 聊天里,在最后的 My question: 后面写问题,可以用中文问。

银行、专业配方、训练师列表要先在游戏里打开对应窗口一次才会记录。tools 文件夹是给能直接读取 WoW 目录的 AI(比如连接了文件夹的 Claude 桌面版)用的,普通玩家不需要。要用的话先运行一次 python tools/update_data.py 下载任务数据库(以后再运行一次就是更新)。

License

MIT, see LICENSE. The quest database downloaded into tools/data/ comes from OctoQuestDatabase and keeps its own license and notices.

S
Description
Ask an AI for accurate OctoWoW information regarding your character status. /octoai turns your gear, quests, talents, spells and professions into text you can paste into any AI chat.
Readme MIT
120 KiB
Languages
Lua 61.6%
Python 38.4%