Skip to content
Thomas Jones edited this page Aug 17, 2026 · 1 revision

minqlxtended extends the Quake Live dedicated server with extra functionality and a Python plugin API. It is an extension of MinoMino's minqlx, and it powers The Purgery.

Needs Python 3.12 or later and a 64-bit Linux server. See the README to build and install it.

Writing plugins

Page What's on it
Writing Plugins Registering hooks and commands, the plugin lifecycle
Events Every event, its arguments, and what a map change looks like
Engine Views level, Entity, server, match_state — reading and writing engine memory
Maps and Factories Installed maps, .arena data, BSP entities
Console Commands console_command() and the two cases that defer

Running a server

Page What's on it
Configuration Every qlx_* cvar
Command List What the bundled plugins add
Internals Engine offsets, byte patterns, qlx_prof

Coming from minqlx

Upgrading lists every breaking change and what to write instead. Plugins written for minqlx, or for minqlxtended before v1.0.0, will not load without alteration.

The plugins repository is already ported and is the best worked example of everything here.

Clone this wiki locally