TABSAimod

TABS AI Chat (TABSAimod)

An in-game AI assistant for Totally Accurate Battle Simulator.

Press F11 to open a chat panel, ask questions about the game, and get concrete deployment advice based on the enemy lineup — optionally with a screenshot of the current battle attached.

Status: work in progress. The mod is functional but still being iterated on. Bug reports and suggestions are welcome (contact at the bottom).

Vibe

Features

• F11 panel — a draggable in-game window. The plugin persists across scenes,

so it should be reachable from the menus as well as in battle.

• AI chat — OpenAI-compatible chat protocol, so it works with local

Ollama, or any OpenAI-compatible cloud API.

• Battle context — on every message the mod scans the field and reports

both sides to the AI: how many units, which types, on Red and Blue.

• Screenshot support — attach the current frame (JPEG) so vision models can

see actual unit positions. Auto-disabled for text-only models.

• Placement advice — the system prompt forces the AI to answer with

concrete suggestions: which units, how many, and where (left / center / right, front / back / flank).

• TABS-only — the assistant refuses non-TABS topics and steers back.
• Bilingual — switch the UI and the AI reply language between Chinese and

English at any time.

Requirements

Item — Notes

Totally Accurate Battle Simulator — Steam version

BepInEx 5.4.16 — BepInExPack_TABS

A model to talk to — Either local Ollama, or a cloud API key

There is no built-in free cloud endpoint. You must supply your own model: either run one locally with Ollama, or point the Custom preset at a cloud API you have an account with.

Installation

1. Install BepInEx 5.4.16 for TABS if you have not already.
2. Copy the AIChat folder into:

   \BepInEx\plugins\AIChat\

The result must look like:

   BepInEx\plugins\AIChat\AIChat.dll

1. Launch the game once, then quit. The config file is created on first launch:

   BepInEx\config\com.inf.aichat.cfg

1. Edit that file (see Configuration below), then launch the game again.
2. Press F11 in game.

On a successful load the BepInEx console prints:

[Info   :   BepInEx] Loading [TABS AI Chat 1.5.0]
[Info   :TABS AI Chat] TABS AI Chat loaded. Press F11 to toggle. Model: ...

Quick start (local Ollama)

1. Install Ollama from — or press the

"下载 Ollama" / "Get Ollama" button inside the panel, which opens the download page for you.

1. Download a model:

   ollama pull qwen2.5vl:7b

Use qwen2.5vl:3b instead if you have 8 GB of RAM or less.

1. Make sure Ollama is running (ollama list should respond).
2. In game, press F11 and type. The default preset already points at

http://127.0.0.1:11434.

That is all — no config editing needed for the default local setup.

The panel

+---------------------------------------------------------------+
| [Language: 中文] [Screenshot: Off] [Clear] [Reload]   F11 ... |  toolbar
| [Model:  local qwen2.5vl 7b  >]  [Get Ollama]                 |  model row
|---------------------------------------------------------------|
|  You: how do I counter this lineup?                           |
|  AI:  ...                                                     |  chat log
|                                                               |
|---------------------------------------------------------------|
| [ type here .................................. ] [ Send ]      |  input
+---------------------------------------------------------------+

Control — What it does

Language / 语言 — Toggles the UI language and the language the AI replies in.

Screenshot / 附截图 — Whether to attach the current screen to the next message. Auto-turned off for text-only models.

Clear / 清空 — Clears the conversation log.

Reload / 重载配置 — Re-reads the config file from disk. Use this instead of restarting the game.

Model / 模型 — Cycles through the built-in presets. See below.

Get Ollama / 下载 Ollama — Opens the Ollama download page and prints the ollama pull command in chat.

Send / 发送 — Sends. You can also press Enter in the input box.

Drag the window by its title bar. While the panel is open the mouse cursor is forced visible, and the original cursor state is restored when you close it.

Configuration

File:

\BepInEx\config\com.inf.aichat.cfg

Key — Type — Default — Meaning

Endpoint — string — http://127.0.0.1:11434/v1/chat/completions — Chat completions URL. Only read by the Custom preset.

ApiKey — string — (empty) — Bearer token. Local Ollama does not check it. Only read by Custom.

Model — string — qwen2.5vl:7b — Model name. Only read by Custom.

Hotkey — string — F11 — Any Unity KeyCode name, e.g. F11, F12, Insert.

Language — string — zh — zh or en.

JpegQuality — int — 55 — Screenshot JPEG quality, 1–100. Lower = smaller upload.

HistoryTurns — int — 8 — How many past turns to resend as context.

TimeoutSec — int — 60 — HTTP timeout.

Preset — int — 0 — Which built-in preset to use. See below.

Important: only the Custom preset uses Endpoint / Model / ApiKey

Presets 0–3 are hardcoded to http://127.0.0.1:11434 with a fixed model name. If you fill in Endpoint but leave Preset = 0, your endpoint is ignored and the mod still talks to local Ollama.

To use your own endpoint you must set:

Preset = 4

Model presets

Preset — Model — Endpoint — Vision — Needs key

0 — qwen2.5vl:7b — local Ollama — yes — no

1 — qwen2.5vl:3b — local Ollama — yes — no

2 — llava:7b — local Ollama — yes — no