@meta
  v: 1
  route: /help/
  generated: 2026-10-17T04:26:11Z
  ttl: 1d

@intent
  purpose: "Help for Jebbie's Mods: troubleshooting, common questions, reporting a problem, installing"
  audience: player, visitor, ai-agent
  capability: learn, troubleshoot, report

@state
  report_in_launcher: Report a problem button; sends details and an optional screenshot
  report_in_game: "/jbug (Jebbie's Almanac), /jbug (Jebbie's Satchel), /voices bug (Jebbie's Voices), /jbug (Jebbie's Ledger), /jbug (Jebbie's Talents), /jbug (Jebbie's Dungeon Journal), /jbug (Jebbie's Attunement), /jbug (Jebbie's Mage Companion), /jbug (Jebbie's Hunter Companion), /jbug (Jebbie's Warlock Companion)"
  report_on_web: https://jebbiesmods.com/bug/
  install_by_hand: "Unzip into World of Warcraft/_classic_beta_/Interface/AddOns; restart the game the first time or when an update adds a folder, /reload after other updates"
  beta_builds: through the launcher only (Beta switch)
  changelog: https://jebbiesmods.com/changelog/
  launcher:
    name: The Jebbie's Mods launcher
    what: A small app that installs and updates every Jebbie's Mods addon for WoW Forever and keeps your settings
    channel: stable
    version: 0.1.23
    page: https://jebbiesmods.com/app/
    downloads[2]{system,label,url,sha256,size_bytes}:
      mac,for Mac (Apple Silicon and Intel),https://downloads.jebbiesmods.com/app/0.1.23/JebbiesMods-0.1.23-universal.dmg,c0b713914ed4f4ea64f20d6db8ccd0f8593f446c7b4e1d68594d42b9c1dbccfc,9775388
      windows,for Windows,https://downloads.jebbiesmods.com/app/0.1.23/JebbiesMods-0.1.23-x64-setup.exe,ac7df1c1bd34731bb89ec8b609205c5a85e0b4e89dee746c11f97cbabac26c6e,2435840
    coming_soon: Linux (install the addons by hand meanwhile)
    live_feed: https://downloads.jebbiesmods.com/app/downloads.json
  troubleshooting[8]{id,problem,fix}:
    not-in-game,The addon doesn't show up in the game,"After a first install, quit the game completely and start it again. The game only finds new addon folders when it starts; /reload is not enough for a folder it has never seen. At the character screen, open AddOns and check that the addon is listed and ticked. Installing by hand? The addon's folder must sit directly in World of Warcraft/_classic_beta_/Interface/AddOns, not inside another folder. A common slip is AddOns/JebbiesAlmanac-0.9.50/JebbiesAlmanac: move the inner folder up one level. Using the launcher? Check it points at your WoW Forever folder: Copy diagnostics shows the folder and which game it found there."
    reload-or-restart,Do I need /reload or a full restart?,"Restart the game after a first install, or when an update adds a new folder (the release notes say so when it does). Type /reload after an ordinary update, and whenever the companion writes you a new plan: the game reads your plan only on /reload. The game also saves your addon data (SavedVariables) only on /reload or logout, so the companion and bug reports see new data after one of those."
    game-moved,"I moved the game, or the launcher can't find it","Press Locate game... in the launcher and pick your WoW Forever folder (the one called _classic_beta_). The launcher remembers it. If it says the folder isn't WoW Forever, you probably picked Retail or Classic Era. If you're sure it's the right folder, choose Use this folder anyway."
    launcher-errors,What the launcher's error messages mean,"Launcher 0.1.21 and later say these in plain words, with the raw error kept underneath. Older versions show only the raw error, which usually names the same problem. Can't reach jebbiesmods.com: check your internet connection, then try again. The app can't write to the game's AddOns folder: close the game and try again. If it keeps happening, check that the folder isn't read-only. A file is in use: the game is holding it. Close WoW Forever and try again. The disk is full: free some space and try again. The download didn't match: nothing was installed. Try again in a minute. Anything else: press Report a problem. The full error is kept under each message, and the report includes it."
    companion,"The Almanac companion won't start, or its page stopped updating","Start it from the launcher: the Almanac row has a start button, and the launcher stops the companion when it quits. On a Mac the companion needs Python 3.10 or newer, and macOS ships an older one. If the launcher says there is no Python it can use, install the current Python from python.org (https://www.python.org/downloads/) and start the companion again. Its page is at http://127.0.0.1:8765. If something else already uses that address, it starts on the next free one, and the launcher says so. If the page says it's offline, the companion stopped: start it again from the launcher. Still stuck? Copy diagnostics in the launcher shows the companion's state; send it with Report a problem."
    plan-not-updating,My Almanac plan didn't change in the game,"The companion writes your plan, and the game reads it on /reload. With the companion running, type /reload. The companion only sees what you've done after the game saves, which happens on /reload or logout."
    go-back,Something broke after an update,"In the launcher, choose Go back to the previous version on the addon's row. The launcher keeps the version it replaced. Then tell us what broke with Report a problem, or /jebbie bug in the game, so the next build fixes it."
    leftovers,Old Jebbie folders are left in AddOns,"Use Clean up leftovers in the launcher. It lists Jebbie folders that no current release uses, and moves the ones you pick into the launcher's own folder, so nothing is deleted outright."
  faq[8]{id,question,answer}:
    free,Are the addons free?,"Yes, all of them, for good. There are no premium features, nothing in the game asks for money, and there are no ads. Tips are optional and live only on this website."
    launcher-needed,Do I need the launcher?,"No. Each addon's page has a zip you can install by hand. The launcher just does it in one click, keeps everything up to date, can go back a version, and starts the Almanac companion."
    beta-stable,What's the difference between beta and stable?,Stable is what everyone gets. Beta gets new builds first and may have bugs; turn on Beta in the launcher's settings to get it. Beta builds come through the launcher only.
    other-addons,Will the launcher touch my other addons or my settings?,"No. It only creates, replaces or removes the folders of Jebbie's own addons. Other addons are left alone, and it never opens the WTF folder where your settings and SavedVariables live."
    settings-kept,Are my settings kept when I update?,"Yes. Your settings live in the game's WTF folder, which updates never touch, and the Almanac plan the companion writes is kept across updates too."
    which-game,Which game are these for?,World of Warcraft: Forever only (interface 16001). They are not for Retail or Classic Era.
    report,How do I report a bug?,"Report a problem in the launcher, the bug command in the game (for example /jebbie bug), or the bug form (https://jebbiesmods.com/bug/) on this site. All three reach the people who make the addons."
    changes,Where can I see what changed?,"The changelog (https://jebbiesmods.com/changelog/) lists every addon's latest versions, with a link to each addon's full history."

@actions
  - id: report_bug
    method: GET
    href: https://jebbiesmods.com/bug/
    description: The bug form (works when the launcher won't start)
  - id: download_launcher
    method: GET
    href: https://downloads.jebbiesmods.com/app/0.1.23/JebbiesMods-0.1.23-universal.dmg
    description: Download the Jebbie's Mods launcher 0.1.23 for Mac (Apple Silicon and Intel)
  - id: download_launcher_windows
    method: GET
    href: https://downloads.jebbiesmods.com/app/0.1.23/JebbiesMods-0.1.23-x64-setup.exe
    description: Download the Jebbie's Mods launcher 0.1.23 for Windows
  - id: read_launcher
    method: GET
    href: https://jebbiesmods.com/app/
    description: "What the launcher does, the Beta switch, and which systems it runs on"
  - id: answer_not_in_game
    method: GET
    href: https://jebbiesmods.com/help/#not-in-game
    description: The addon doesn't show up in the game
  - id: answer_reload_or_restart
    method: GET
    href: https://jebbiesmods.com/help/#reload-or-restart
    description: Do I need /reload or a full restart?
  - id: answer_game_moved
    method: GET
    href: https://jebbiesmods.com/help/#game-moved
    description: "I moved the game, or the launcher can't find it"
  - id: answer_launcher_errors
    method: GET
    href: https://jebbiesmods.com/help/#launcher-errors
    description: What the launcher's error messages mean
  - id: answer_companion
    method: GET
    href: https://jebbiesmods.com/help/#companion
    description: "The Almanac companion won't start, or its page stopped updating"
  - id: answer_plan_not_updating
    method: GET
    href: https://jebbiesmods.com/help/#plan-not-updating
    description: My Almanac plan didn't change in the game
  - id: answer_go_back
    method: GET
    href: https://jebbiesmods.com/help/#go-back
    description: Something broke after an update
  - id: answer_leftovers
    method: GET
    href: https://jebbiesmods.com/help/#leftovers
    description: Old Jebbie folders are left in AddOns
  - id: read_changelog
    method: GET
    href: https://jebbiesmods.com/changelog/
    description: What changed in every addon
  - id: view_human
    method: GET
    href: https://jebbiesmods.com/help/
    description: The human page

@context
  > Stuck? Most fixes are on this page. If yours isn't, report a problem from the launcher, in game, or on the web; every report goes to the people who make the addons.

@nav
  self: /help.agent
  parents: [/.agent]
  peers: [/.agent, /almanac.agent, /satchel.agent, /voices.agent, /ledger.agent, /talents.agent, /dungeon-journal.agent, /attunement.agent, /mage.agent, /hunter.agent, /warlock.agent, /app.agent, /changelog.agent, /patrons.agent, /about.agent, /bug.agent]