Help

Troubleshooting and FAQ

Nothing happens when a chat game appears.

Check in order: the Solver toggle is on, an API key is set (the menu header says "Setup needed" if not), the server is not on your block list (or is on your allow list if you use one), and the chat line contains one of your keywords. Open the Activity log: every skipped or failed round has a reason there. Turning on Debug messages shows each filter decision in chat.

Test connection fails.

Read the message under the button. A rejected key means the key is wrong or belongs to another provider. A model error means the provider retired the model: press Next model, or use the one-click "Use ... and retest" button. A rate limit means wait a minute or check your usage. A network error means check your internet and the Base URL.

The log says "truncated by the token cap".

Your model spent its whole token budget on hidden reasoning. Raise Max solve tokens in Answers and typing to 1500 to 3000, or use a non-reasoning model.

It answers too slowly.

Keep Fast mode on, keep Quick detect on, use a fast model such as Groq or Gemini Flash, and lower the delay range. Turn on Instant built-in so math and word answers skip the random delay. Lower Debounce if rounds start late, but not so low that half-finished questions are sent.

It never answers, or the confidence is too low.

The AI may be less sure than Min confidence (0.80). Lower it toward 0.60. Also check Max answer length and the "Give up after" time.

It reacts to normal chat.

Leave Trigger mode on Keywords only, remove broad keywords, and add noisy phrases to Ignore phrases. Smart mode is more eager and costs more API calls.

A player's fake announcement fooled it.

Add your server's exact chat format to Player-chat patterns as a regex. The mod also ignores lines where an online player's name appears before the chat separator.

It stopped after one guess in a guess-the-number round.

Guess the number needs Auto-send. Check that the option is on and that Show only is off.

Is this allowed on my server?

Not everywhere. Automated chat is against the rules on some servers. Read the rules first. Show only and Fill chat give you control over what is sent.

Where is my API key stored? Who sees my chat?

The key is saved only in config/aichatgamesolver.json. Chat lines that pass the local filter are sent to the AI provider you chose, and nothing is sent for normal chat.

The mod does not load.

Make sure you have Fabric Loader 0.17.0 or newer, Fabric API, and a supported Minecraft version (1.21.11, 26.1, 26.2 or 26.3). Check the game log: the first line from the mod names the build it picked.

Update checks never find anything.

Checks need an internet connection and enabled must be true in the updater file. Use the banner's try again button in the menu. Modrinth and CurseForge copies are looked up through Modrinth by file hash.