The zandronum-mcp server lets an AI assistant control and interact with Zandronum (Doom engine) instances for game development, modding, testing, and debugging.

Engine Control

• Launch/kill instances with custom IWAD, PWADs, maps, skill, and resolution settings

• Run console commands and capture output

• Pause/resume the game, advance simulation by tics (35 = 1 second)

• Reset all instances and reap orphaned processes

Gameplay Interaction

• Load maps, summon actors, give/take inventory items

• Inspect any actor's live state (class, health, position, DECORATE state, inventory)

• List actors within a radius, inspect aimed target

• Press menu keys, navigate menus, type into text fields

ACS Scripting & Debugging

• List, run, and profile ACS scripts and functions

• Read/write world, global, and map-scope ACS variables and arrays

• Index ACS source files for symbols, resolve script numbers/names to source locations

• Extract function/script names from compiled BEHAVIOR lumps

Game State Inspection

• Get player state (position, angle, sector, light level)

• Read on-screen HUD elements (text, images, ACS HUD messages)

• Query renderer info (backend, resolution, GL vendor), viewport dimensions, and HUD settings

Savegames & Demos

• List savegames with metadata (title, map, engine, creation time)

• Save/load game states; play back recorded demo files

Map Analysis (offline, no running game needed)

• Read map format and entity counts from WAD files

• Inspect sectors and linedefs, find sectors by tag

Debugging

• Surface DECORATE/ACS compile errors and fatal startup errors from engine logs

• Retrieve crash backtraces (signal, faulting address, symbolized stack trace)

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@zandronum-mcp Spawn a cyberdemon on MAP01 and give me a BFG"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.