WOW Legends bots don't just run combat — they talk. Whisper one and it answers in character, remembers you across days, and has a temper if you push it. That conversation is powered by a real, high-tier language model, not a tiny model bundled in the repack — so the hosted version runs on credits (1 credit = 1 reply). You can also point it at your own model and pay nothing to us. This guide covers exactly how it works and every dial.

What's free, and what uses credits

The single most common question — so let's nail it first.

If no AI backend is reachable, bots simply stay silent — no error, no crash. And the HTTP call runs off the main thread, so AI replies never lag your server; the answer just arrives on the next tick.

When & where bots use the AI

Four things make a bot actually think and reply. Everything else is free canned chatter.

Plain whisper = AI chat. A $-prefixed message is a bot order. So /w Grom hello there talks to the AI (1 credit), while /w Grom $follow or $summon is a command handled by the bot engine — the AI ignores it and no credit is spent. ($ is the AiPlayerbot.CommandPrefix.) Want a chattier open world like the demo realm? Raise ProximityChance / PartyAmbientChance — more ambient AI replies, more credits.

Power it your way — three options

You own the brain. Pick one:

Quick setup recipes

• Hosted (easiest) — leave Provider=openai and the default ApiUrl, paste your wlk_ key into ApiKey, leave Model empty. Done.
• Your own cloud key — Provider=openai, set ApiUrl to your provider, ApiKey to your key, Model to their model name.
• Local Ollama (free) — Provider=ollama, set OllamaHost/OllamaPort and Model to a pulled model. No key needed.

# Hosted WoW Legends AI — the whole setup:
WowLegends.AiChat.Provider = "openai"
WowLegends.AiChat.ApiUrl   = "https://wow-legends.eu/api/v1/ai/chat/completions"
WowLegends.AiChat.ApiKey   = "wlk_your_key_from_the_dashboard"
WowLegends.AiChat.Model    = ""        # empty = the hosted endpoint chooses

⚠️ Using a reasoning model (e.g. OpenAI's o-series)? Set MaxTokens higher (~2000) or replies can come back empty — the reasoning eats the budget. And keep VerifyTLS = 0 — 1 is known to silence AI chat unless the host has a proper CA bundle.

Memory, personality & mood

Replies are plain text only — the 3.3.5a client can't render emoji (they'd show as ?), so the model is told to skip them.

Per-race & per-faction personas

Every reply is shaped in three layers: the base System rules + that bot's race line + its faction line. Only those two flavour lines are injected per call, so it stays token-cheap. All are editable in mod_wowlegends.conf — rewrite a line to re-flavour a race or side, or set a race to "" to suppress it. These are the shipped defaults:

Per-race WowLegends.AiChat.Race.<Name>

• Human · Alliance"You are a human of the Alliance: earnest, dutiful, and resolute, speaking plainly with steady resolve and faith in the kingdoms of men. You rally to honor, hold the line against the Scourge, and treat any cause as worth fighting for."
• Orc · Horde"You are an orc of the Horde: blunt, warlike, and fiercely honor-bound, speaking in short, gruff bursts with pride in strength and the Horde. You respect a worthy foe, scorn cowardice, and would sooner charge than bargain."
• Dwarf · Alliance"You are a dwarf of Khaz Modan: hearty, gruff, and quick to laugh, fond of ale, gunpowder, and a good brawl, peppering your speech with 'lad' and 'aye'. You face danger with a grin and never back down from a fight."
• NightElf · Alliance"You are a night elf, ancient and aloof, bound to nature and the goddess Elune, speaking with formal, measured solemnity earned over ten thousand years. You regard mortals' haste with patient disdain and guard the wilds with quiet vigilance."
• Undead · Horde"You are a Forsaken of the Undercity: cold, sardonic, and bitter, dripping with gallows humor and contempt for the living you once were. You serve the Dark Lady, trust no one fully, and find grim amusement in death."
• Tauren · Horde"You are a tauren of Mulgore: calm, wise, and deeply spiritual, reverent of the Earth Mother and slow to anger, speaking with gentle, deliberate dignity. You seek balance and harmony, but your fury, once roused, is like the thunder."
• Gnome · Alliance"You are a gnome of Gnomeregan: chipper, hyper-intelligent, and irrepressibly curious, prone to tangents about gadgets, gears, and grand inventions, talking fast and a touch verbosely. You meet every problem with bright optimism and a clever contraption."
• Troll · Horde"You are a Darkspear troll, laid-back and mystical, speakin' wit' a relaxed 'mon' cadence and a fondness for the loa and old superstitions. You stay cool under pressure, trust da spirits, and got a sly sense of humor."
• BloodElf · Horde"You are a blood elf of Silvermoon: haughty, refined, and elegant, carrying yourself with cultured superiority and a barely-veiled hunger for arcane magic. You value beauty and power, and regard lesser beings with cool, condescending grace."
• Draenei · Alliance"You are a draenei, serene and devout, formal in speech and unwavering in faith in the Light and the Naaru, often invoking their blessing. You bear ages of exile with dignified patience and offer wisdom with calm, otherworldly grace."

Per-faction WowLegends.AiChat.Faction.<Side>

• Alliance"You stand for the Alliance: bound by honor, duty, and the defense of the innocent. Treat the Horde as savage rivals to be opposed, though the Scourge is the greater threat."
• Horde"You stand for the Horde: bound by strength, survival, and fierce loyalty to your people. Treat the Alliance as soft rivals to be challenged, though you'll unite against the Scourge when you must."

The base System prompt is editable too — the shared rulebook every bot follows: reply in 1–2 in-character sentences, match the player's language, plain text only (no emoji), and never break character or invent facts. Rewrite any of these to give your whole realm its own voice.

Living Chatter — the world talks around you v1.2 · opt-in

Everything above is bots answering you. Living Chatter is the reverse: bots near you speak unprompted, AI-generated and about their actual life — their zone, class, level, what they're doing right now. A level 12 in Elwynn gripes about wolves, not raids. It comes in three flavours:

• Ambient lines — a nearby bot says something in-character about its own situation.
• Two-bot scenes — pairs of same-faction bots act out a short AI-written conversation (a 4-line scene) near you: campfire talk, road gossip, delivered line by line with natural pauses.
• AI recognition greetings — when a bot that knows you greets you (the v1.2 social-memory system), the canned line upgrades to an AI whisper that weaves in your shared history.

It's off by default, because it spends. Every generated line is one AI call — 1 credit on the hosted AI, or your own meter on Ollama / your API key. Three guards keep it affordable: generation is witnessed-only (nothing generates unless a real player is within WitnessRange to read it — an empty realm spends nothing), the intervals throttle the pace, and MaxRequestsPerDay is a hard daily cap across all of Living Chatter. Player whispers are never counted against this budget.

Try it before enabling — the test commands

Two GM commands (account gmlevel 2+) force one sample on demand. They work even while LivingChatter.Enabled = 0 — they bypass the master toggle and cooldowns, but not the daily budget — so you can see what a line costs and reads like before turning it on. Both are in-game only (they pick bots near your character); the full option list for test is ambient and scene.

The Living Chatter settings

Prefix WowLegends.LivingChatter. in mod_wowlegends.conf — defaults as shipped:

Every setting

All keys live in mod_wowlegends.conf under "BOT AI CHAT" and are prefixed WowLegends.AiChat. Changes apply on a worldserver restart or .reload config.

That's the whole brain. Start with the hosted AI for zero setup, or point it at your own Ollama and chat for free — either way, whisper a bot something and watch it answer. 🐉 Pair it with your permanent Companion, or see the Owner Guide for the rest.