Skip to article
KAGRENAC Get started

Testing

A mod is tested in four separate ways, and each says something different. Your agent reports them separately, and only you can confirm what happens in game.

Four Kinds Of Evidence

KindShowsDoes not show
Server and fixturesThe server is deployed and healthy, and automated checks passAnything about the game or a real provider
Game-side buildThe actual game mod builds and is installed for your game versionThat it loads or works in game
ProviderYour chosen dialogue model or voice service answers a real callThat the player sees or hears it
In gameYou played it: the loop, heard voice and each action's visible resultOther games or other loaders

A generated sound file is not heard voice, and an action the game accepted is not an action you saw happen. Each action gets its own in-game check.

In-Game Checks

Start the game the normal way, using its offline loader profile if it needs one (see Game integration), and check:

  • Loading. The mod loads and connects by itself, with no extra command.
  • Chat. You type your own line to the character the chat box shows, get a reply, and your controls work normally afterwards.
  • Automatic remarks. If you asked for them, the real game event triggers one and it stops cleanly.
  • Voice. If you asked for voice, you hear it. If you asked for speech input, push-to-talk fills the draft and Enter sends it.
  • Each action. You ask, and see the result in game.
  • No server. With only this mod's server route unreachable (your agent can set this up), and DwemerDistro and other mods left running, the game stays playable and tells you, and the next request works once it is back.

Cancellation And Stale Replies

A reply that arrives too late must not play. While a reply is still coming, try leaving the character, loading a save, starting another conversation and quitting. The late reply should be dropped quietly, with no crash or hang. Failed requests are never retried automatically.

Find A Request In Logs

Every request has an ID. On your mod's dashboard, open Control Panel > Logs, filter by Request ID and open Details. Voice, NPC selection and memory calls are on Control Panel > Connector calls.

  • complete means the server finished, not that the game showed or did anything.
  • cancelled or superseded is expected after a cancel, a character change or a session change.

When asking for help, share request IDs and error codes, never tokens or keys.

Optional Dashboard Checks

KagrenacServer dashboard Conversation page in mock mode. The form uses NPC ID npc_guide, NPC name Guide, player Traveler and session dashboard-demo, with the message Hello, can you help me find the market? Below are the Game event test panel and the Conversation log, where the mock Guide replies: Guide heard you say: Hello, can you help me find the market? Actions: none.
The dashboard Conversation page with test replies. No game or provider is involved.

Roleplay > Conversation lets you send a test line and see the reply, and Game event test sends a test game event. It is useful for checking bios, facts and providers, but it shows actions without running them and is not an in-game test.

Troubleshooting

SymptomCheck
The game says the server is unavailableStart DwemerDistro, then try again in game.
401 unauthorizedThe game mod's connection file does not match this server. Ask your agent to pair again.
502 llm_unavailableThe provider failed. Check the key and model with Send test.
503 not_migrated or schema_too_newThe code and database do not match. See Updates & recovery.
The dashboard cannot save settingsAsk your agent to deploy again; it repairs ownership.

Full reference: START_HERE.md, Troubleshooting by request ID and SETUP.md, Troubleshooting.

Next step: Updates and recovery.