Skip to content

Praetor

Praetor is a free, open-source desktop client for The Eternal City. It runs on Windows, macOS, and Linux.

Praetor connected to the Welcome Room, showing game output, map, compass, vitals, sidebar tools, command input, and Automation Bar

Features at a glance

  • Minimap and compass, drawn live as you move
  • Character profiles that keep variables, filtered views, action sets, highlights, layouts, and script data separate
  • A flexible layout with main tabs, any number of sidebars, and a Bench for views that are not currently displayed
  • Filtered text views with your own include/exclude rules and a global View Library showing which character uses each one
  • Loot and keyword highlighting, so rare drops don't scroll past you
  • Optional wound highlighting for verified combat and character-inspection phrases
  • Color words shown in their color
  • Whole-line Speech Colors for identifying characters at a glance, with wildcard and variable-based speaker matching
  • Per-alert desktop, browser, and Discord notifications for low health, low fatigue, custom text patterns, and optional Lua alerts
  • A Script Manager for installing and safely updating the shared Lua library or other public Git repositories
  • Restricted and Trusted Lua sources, with Restricted sources isolated from files, processes, and other script collections
  • A session metrics dashboard your automation modes can write to
  • Saved command variables that can be reused from the input, Actions, and Variables sidebar
  • PraetorScript command chains: variables and live my.* vitals, configurable ;; pacing, unbusy-aware &&, waits, text or vital reactions, notifications, saved-variable updates, and bounded or counted repeats
  • Live chain status and immediate cancellation from the Automation Bar or with Alt+X
  • A searchable Esc menu that labels settings by character, all characters, device, or server scope
  • Multiple stored accounts, so you can switch accounts without retyping passwords
  • Scrollback search (Ctrl+F) and command-history search (Ctrl+R)
  • A freeform notepad for notes, backstory, or IOUs

Install

Pick your system below. All downloads live on the GitHub releases page.

Windows

Download the installer

1. Open the latest release and, under Assets, download the installer:

Praetor_<version>_windows_amd64_installer.exe

2. Run it. Windows may show a blue Windows protected your PC box because the installer isn't signed with a paid certificate. Click More info, then Run anyway.

3. Click through the installer. Praetor is added to the Start Menu. Launch it from there.

4. To update later, download the newer installer and run it over the top. Your settings and stored accounts are kept.

Or use Chocolatey

If you already use Chocolatey, you can install and update from there instead:

choco source add -n=praetor -s="https://packages.buildkite.com/cybergodzilla-2099/praetor-nuget/nuget/index.json"
choco install praetor

macOS

With Homebrew

If you already use Homebrew, this is the easiest route and it handles updates for you.

1. Open Terminal and run:

brew tap cyber-godzilla/tap
brew trust --cask cyber-godzilla/tap/praetor
brew install --cask cyber-godzilla/tap/praetor

Homebrew 6 requires trust for packages from third-party taps. The second command trusts only the Praetor desktop cask, not every package in the tap.

2. Open Praetor from Applications (or Spotlight).

3. The first time, macOS will say it cannot verify the developer because Praetor isn't signed or notarized. Try to open Praetor once, then open System Settings → Privacy & Security, scroll to Security, and click Open Anyway for Praetor. Authenticate and confirm Open when prompted. You can also Control-click the app in Applications, choose Open, and confirm once. After that it opens normally.

4. To update later, run:

brew upgrade

Praetor is intentionally unsigned and unnotarized, and there are no plans to change that. Apple's Developer ID enrollment would expose CyberGodzilla's real identity and, through the required business identity records, home address to the community. The one-time macOS security exception preserves the maintainer's privacy while leaving the source and release artifacts available for public inspection.

Without Homebrew

1. Open the latest release and, under Assets, download the zip. It works on both Apple Silicon and Intel Macs:

Praetor_<version>_darwin_universal.zip

2. Double-click the zip to unpack it, then drag Praetor into your Applications folder.

3. The first time, macOS will say it cannot verify the developer. Try to open Praetor once, then open System Settings → Privacy & Security, scroll to Security, and click Open Anyway for Praetor. Authenticate and confirm Open when prompted. You can also Control-click the app in Applications, choose Open, and confirm once. After that it opens normally.

4. To update later, download the newer zip and replace the app in Applications. Your settings and stored accounts are kept.

Linux

Each package adds Praetor to your desktop applications menu and installs a terminal version (praetor-tui) alongside it. Commands below go in a terminal.

Debian / Ubuntu

1. Add the signing key:

curl -fsSL "https://packages.buildkite.com/cybergodzilla-2099/praetor-debian/gpgkey" | sudo gpg --dearmor -o /etc/apt/keyrings/praetor-archive-keyring.gpg

2. Add the repository:

echo "deb [signed-by=/etc/apt/keyrings/praetor-archive-keyring.gpg] https://packages.buildkite.com/cybergodzilla-2099/praetor-debian/any/ any main" | sudo tee /etc/apt/sources.list.d/praetor.list

3. Install:

sudo apt update && sudo apt install praetor

4. Updates arrive with your normal upgrades:

sudo apt upgrade
Fedora / RHEL

1. Create the repository file as root:

sudo tee /etc/yum.repos.d/praetor.repo <<'EOF'
[praetor]
name=Praetor
baseurl=https://packages.buildkite.com/cybergodzilla-2099/praetor-rpm/rpm_any/rpm_any/$basearch
enabled=1
repo_gpgcheck=0
gpgcheck=0
priority=1
EOF

2. Install:

sudo yum install praetor

3. Updates arrive with your normal upgrades:

sudo yum update
Arch

x86_64 only. The 1.0.0 in the section name is the repository's layout version and never changes.

1. Add this to the pacman configuration file:

# /etc/pacman.conf
[praetor-1.0.0]
SigLevel = Never
Server = https://packages.buildkite.com/cybergodzilla-2099/praetor-arch/files

2. Install:

sudo pacman -Sy praetor

3. Updates arrive with your normal upgrades:

sudo pacman -Syu
Other distributions

1. Open the latest release and download the archive for your machine:

praetor_<version>_linux_amd64.tar.gz
praetor_<version>_linux_arm64.tar.gz

2. Unpack it and run the praetor binary inside. This route adds no menu entry, so make a shortcut to the binary if you want one.

First login

Praetor splash screen

Praetor opens with a splash screen. Press any key to continue.

From there you'll see the Sign in to The Eternal City form:

Praetor login screen with account name and password fields

Enter your TEC username and password.

Remember this account is ticked by default, and it stores your credentials in your system's own secure store (Windows Credential Manager, macOS Keychain, or the desktop keyring on Linux). It is never stored in plaintext.

On later launches, a Choose an account screen lists any accounts you've stored, so you can pick one and skip typing your password again.

At startup Praetor also checks GitHub for a newer release and shows a small notice if one is available. To turn this off:

  1. Press Esc
  2. Choose Application, then Application settings
  3. Untick Check for updates on startup
  4. Save

Using Praetor

Game text fills the main area. All is always the first main tab. The other built-in views are Metrics, Map, Compass, Vitals, Action Sets, Modes, and Variables. Filtered text views add your own include/exclude rules.

Open Esc → Layout & display → Arrange layout to drag those views between the main tab row, any number of left or right sidebars, and the Bench. The Bench holds views that are not currently displayed; a view can be in only one place. Layout changes save immediately for the active character. Sidebars have their own names, order, side, width, view order, and view heights. If the window becomes too narrow, Praetor collapses outer sidebars to thin title rails instead of removing them; use the explicit arrow button to collapse or expand one yourself.

Create and edit filtered text views under Esc → Layout & display → View Library. The library is global so you can browse every character's views and see where each one is placed, but each view and its rules belong to the character shown in the editor.

The command input sits at the bottom. Press Esc to open the menu.

The top of the Esc menu has quick actions for switching character or mode, playing a script, sending a file, and reloading scripts. Its search box finds settings and tools by name or explanation. The rest of the menu is grouped into Character, Layout & display, Input & commands, Automation, Notifications & logs, Themes, Tools & help, and Application. Each entry says whether it applies to the current character, all characters, this device, or the Praetor server.

Praetor starts on the global Default character profile. Create profiles under Esc → Character → Manage character profiles and give each one the account and positive character number shown by TEC's character picker. With automatic switching enabled, sending play 1 (or play, then 1) selects that account's character 1 profile after the command is sent. Sending sleep returns to Default. Use the character button on the Automation Bar for a quick switch, or /character to open the full Character menu. New profiles begin with Default's settings, then keep their character-scoped data independently.

Saved variables can be inserted into typed commands with ${name} or ${name:fallback}, and created from the input with /set-variable or /set-var. PraetorScript also supports configurable ;; pacing, unbusy-aware &&, waits, text reactions, titled notifications, variable updates with $(set-var ...) and $(add-var ...), and bounded or exact-count repeats. The Automation Bar below the input shows the active step; while a chain is active, its play control becomes Stop. Click it or press Alt+X to discard the remaining work. See the PraetorScript guide for the complete language.

To identify speakers in fast-moving text, Speech Colors can tint an eligible character's complete line with any Colorword style. Rules support exact names, * and ? wildcards, saved variables, special styles such as rainbow, and optional Think and OOC matching. Open them under Esc → Layout & display → Speech colors, or right-click a recognized speech line and choose Set a speech color. See Speech colors for details.

Anything you type starting with a slash is a slash command, handled by Praetor itself and not sent to the game. A hint appears as you type showing what the command expects. To see them all in the app:

/help

Read more: Praetor Guide

Quick reference: keyboard shortcuts

Some shortcuts do different things depending on what's in front of you. Those get one row per context.

Shortcut Context What it does
Tab Output tabs Next tab (Tabs)
Tab A slash-command hint is showing Complete the command (Typing commands)
Shift+Tab Game view Previous tab
Alt+1 to Alt+9, Alt+0 Game view Jump to that tab (0 is the tenth)
Alt+S Game view Show or hide the sidebar (The layout)
Alt+M Game view Switch to the next quick-cycle mode (Run a mode)
Alt+X A file is being sent Abort the rest of the send (Sending a file)
Alt+X A play script is running Stop the performance (Play scripts)
Alt+X A mode is running Switch to the disable mode (Run a mode)
Alt+X A PraetorScript chain is active Cancel its queued commands, waits, text reactions, and repeats
Alt+I Game view Reveal lines hidden by the ignore filters (Filters)
Esc Game view Open the menu (The Esc menu)
Esc A menu screen, search bar, or history search is open Close it without saving
Ctrl+F Game view Search the scrollback (Search)
Ctrl+R Command input Search your command history (Typing commands)
Ctrl+R History search is open Step to an older match
Enter Command input Send the line
Enter History search is open Send the highlighted match
Enter Scrollback search is open Step to an older match
Shift+Enter, Ctrl+Enter, or Alt+Enter Command input New line without sending (Typing commands)
Shift+Enter Scrollback search is open Step to a newer match
Up, Down Command input, on its first or last line Recall earlier commands
PgUp, PgDn, mouse wheel Output Scroll
Home Output Scroll to the top, or move within a focused input
End Output Scroll to the bottom, or move within a focused input
Ctrl+C Text selected in the output Copy
Ctrl+V Command input Paste
Numpad NumLock off Walk (Moving around)

Quick reference: slash commands

Slash commands are handled by Praetor and never reach the game. The last column says how to get out if you sent one by mistake.

Command Arguments What it does To back out
/help Open Tools & help → Help Esc returns through the menu
/guide Open Application → Getting started Esc returns through the menu
/list Open Automation → Switch mode to browse modes (Run a mode) Esc closes it without starting anything
/character [name|global] Open the Character menu, select a named profile, or return to Default with global Switch back from the Character menu or run the command again with the previous profile
/mode, /sm <name> [args…] Start a mode (Run a mode) /mode disable or Alt+X stops it
/toggle Flip a true/false value in the running mode Run it again to flip it back
/set Set a value in the running mode Set it again to the old value
/set-variable, /set-var <name> <value> Create or replace a persisted command variable Set it again to the old value
/calc, /rb Open Tools & help → Rank-bonus calculator (Calculator) Esc returns through the menu
/wiki [name] Open Tools & help → Wiki bookmarks, or open a named bookmark in your browser (Wiki bookmarks) Esc returns through the menu
/maps, /map [name] Open Tools & help → Map bookmarks, or open a named map in your browser (Map bookmarks) Esc returns through the menu
/kudos [name] [message] Open Tools & help → Kudos, add a favorite, or queue a message (Kudos) Esc returns through the menu. Queued kudos aren't sent until you click Send
/notes [add|open|delete|list] [title] Open Tools & help → Notes or act on a note (Notes) Esc returns through the menu
/send Pick a text file and send it to the game (Sending a file) Cancel the file dialog, or close the preview without clicking Save. Alt+X aborts a send already in progress
/play Pick a play script, preview it, and start it (Play scripts) Close the preview without clicking Save. /stop or Alt+X ends a running performance
/pause Hold the running performance /resume continues it
/resume Continue a held performance /pause holds it again
/stop End the performance and drop its state Nothing to undo. Start it again with /play
/next Release a %wait-key hold in a performance Nothing to undo

Scripts

A mode is a small Lua script that watches the game text as it scrolls by and sends commands for you: auto-attacking, looting, running a training loop, and so on. Only one mode runs at a time.

A shared library of ready-made modes is available through Esc → Automation → Script Manager. Choose Add praetor-scripts, then enable the source after reviewing its Restricted permissions. Praetor downloads and updates it without requiring a separate Git installation. Start a mode by name, and the hint line shows what arguments it takes as you type:

/mode idle

Combat modes lean on in-game @macro entries, which you have to set up once per character before the mode can use them.

Read more: Praetor Scripts

Getting help

Ask in the #unofficial-clients channel of the community Discord: TEC Discord.

The source is on GitHub, and issues and pull requests are welcome: cyber-godzilla/praetor.

When asking for help, include your Praetor version and the relevant lines from the app log.

What Where
App log (errors, script problems) ~/.local/state/praetor/tec.log
Session transcripts ~/.config/praetor/logs/

On Windows, the tilde is your user folder, so the config folder is:

C:\Users\<you>\.config\praetor

Your Praetor version is shown on the splash screen when the app starts, and on the Choose an account screen.

See also

Release history

Dates are the publication dates of the GitHub releases, shown newest first.

Release Date Major features and changes
v0.6.2 2026-11-01 Deliver Lua notify() alerts to the configured Discord webhook when script notifications, Discord delivery, and the Discord script category are enabled, matching the existing desktop and PraetorScript behavior.
v0.6.1 2026-10-31 Add independent enable and disable controls for trusted local script directories while preserving their configured order, and keep the desktop and mobile settings experience visually stable with consistently sized, internally scrolling dialogs.
v0.6.0 2026-10-30 Add character-aware profiles for variables, views, action sets, highlights, and layouts; introduce UUID-based multi-sidebar placement with a Bench and responsive collapse behavior; reorganize settings into a searchable, scope-aware menu; add a managed Script Manager with Restricted and Trusted Lua sandboxes and safe one-click updates; add per-rule desktop, browser, and Discord notifications; and extend PraetorScript with live my.* values while improving command feedback and mobile-sized layouts.
v0.5.7 2026-10-15 Keep Retain Input After Send useful for repeatable game commands while automatically clearing every slash command after submission, including commands added in future releases.
v0.5.6 2026-10-15 Keep Retain Input After Send useful for repeatable game commands while automatically clearing /mode and /sm control commands after submission so mode hints no longer cover fresh output.
v0.5.5 2026-10-15 Add configurable whole-line Speech Colors with Colorword styles, wildcard and variable-based speaker matching, optional Think and OOC coloring, and right-click setup, alongside persisted /set-variable, $(set-var ...), and numeric $(add-var ...) controls that update the Variables UI live.
v0.5.4 2026-10-09 Route typed /mode and /sm commands through Praetor's shared command parser so single-word arguments keep working and quoted multiword values such as from:"2 sack" reach Lua modes as one argument in the desktop and web clients.
v0.5.3 2026-10-09 Allow local command arguments, including Lua mode options, to group multiword values with double quotes so references such as from:2 sack arrive as one argument consistently in the GUI, terminal client, and PraetorScript.
v0.5.2 2026-10-07 Add start-of-line and end-of-line anchors to Lua reaction patterns, preventing embedded text such as NPC dialogue from triggering automation rules intended for complete game responses.
v0.5.1 2026-10-06 Advertise all supported Lua completion handoffs consistently in mode command hints and the mode picker, including mode switches with arguments, direct game commands, and PraetorScript expressions.
v0.5.0 2026-10-06 Introduce PraetorScript with configurable paced and unbusy chains, variables and fallbacks, waits, titled notifications, bounded reactions, and success- or count-based repeats; add Automation Bar status and cancellation; allow Lua modes to submit PraetorScript; refresh mode hints on script reload; and improve GUI responsiveness and sticky scrollback behavior.
v0.4.15 2026-09-24 Render variables in Action Set /mode commands and validate the resulting command before dispatch.
v0.4.14 2026-09-24 Make paced-chain and unbusy-chain delays configurable in General settings.
v0.4.13 2026-09-24 Expand saved variables in multiline submissions and /send file contents.
v0.4.12 2026-09-23 Add a setting to allow or suppress desktop notifications raised by Lua scripts.
v0.4.11 2026-09-23 Complete the GUI parity and stability pass, including command chaining, minimap scaling, variables in the menu, calculator layout, help text, spellcheck visibility, and disconnect fixes.
v0.4.10 2026-09-22 Add live input variables plus paced (;;) and unbusy-aware (&&) command chains.
v0.4.9 2026-09-21 Harden the GUI with a Playwright end-to-end smoke suite and improve release-job retry behavior.
v0.4.8 2026-09-10 Fix Arch package publication by accepting the package service's successful 201 response.
v0.4.7 2026-09-10 Release metadata-only follow-up; no user-facing application changes.
v0.4.6 2026-09-10 Fix the Arch release job by installing the archive tooling needed to build its repository database.
v0.4.5 2026-09-10 Add Arch Linux packages, a pacman repository, and Arch installation documentation.
v0.4.4 2026-08-31 Render game-supplied HTML tables with aligned, bordered columns.
v0.4.3 2026-08-30 Add the GUI's Retain Input After Send setting and prevent consecutive duplicate history entries.
v0.4.2 2026-08-17 Add Tab completion and clickable completion for command hints, including longest-common-prefix completion.
v0.4.1 2026-08-16 Add script-aware /mode argument hints and render attribute tables correctly.
v0.4.0 2026-08-13 Add multiline and file sending, the /play performance language, live command hints, and lossless handling of large server messages.
v0.3.1 2026-07-22 Fix eight regressions found in the v0.3.0 review, including Lua-call behavior.
v0.3.0 2026-07-22 Resolve the broad pre-release review backlog and correct command and build-check documentation.
v0.2.11 2026-07-20 Keep two-digit patch versions from being clipped on the splash screen.
v0.2.10 2026-07-20 Add the /notes notepad with create, edit, rename, delete, and recent-note browsing.
v0.2.9 2026-07-20 Fix persistent-state races, invalid mode-file panics, color-match offset panics, and near-black color crashes.
v0.2.8 2026-07-20 Add scrollback and command-history search, input spellcheck, and update notifications.
v0.2.7 2026-07-17 Add configurable numpad navigation and case-insensitive mode names.
v0.2.6 2026-07-15 Improve arm64 release reliability by forcing apt downloads over IPv4.
v0.2.5 2026-07-15 Add a live metrics-session timer, hide library-only modes, and render empty metrics sessions correctly.
v0.2.4 2026-07-14 Enable WebKit hardware acceleration on Linux.
v0.2.3 2026-07-12 Add collapsible sidebar sections and improve scroll controls, tail-following, and burst handling.
v0.2.2 2026-07-10 Add editable sidebar Action Sets, themed copy/paste controls, and the tabbed Actions/Modes sidebar.
v0.2.1 2026-07-09 Add explicit logout and robust dropped-connection detection, cleanup, and return-to-login behavior.
v0.2.0 2026-07-08 Make the Wails desktop GUI the primary client, restore TUI feature parity, and ship native Linux, macOS, and Windows builds.
v0.1.5 2026-05-16 Reduce stale Kitty-protocol maps while avoiding expensive image resets during long sessions.
v0.1.4 2026-05-13 Improve TUI rendering performance with view caching and add optional pprof diagnostics.
v0.1.3 2026-05-05 Add the /kudos workflow for favorites, queued messages, and login reminders.
v0.1.2 2026-05-01 Add the /calc//rb rank-bonus and training-cost calculator.
v0.1.1 2026-04-29 Fix Kitty and Sixel minimap sizing, flicker, and stale-image behavior.
v0.1.0 2026-04-28 Add OOC/Think ignore filters, expandable suppressed lines, and the /maps bookmark browser.
v0.0.16 2026-04-27 Add the curated /wiki bookmark browser and fix a browser-launch loop.
v0.0.15 2026-04-25 Expand color recognition, improve Sixel scaling on Windows Terminal, and guard the empty mode picker.
v0.0.14 2026-04-23 Add Sixel graphics, terminal capability detection, graphics fallbacks, and Chocolatey distribution.
v0.0.13 2026-04-19 Add editable notification settings with live configuration reload.
v0.0.12 2026-04-15 Fix rendering performance and memory leaks during long sessions.
v0.0.11 2026-04-15 Expand color recognition and fix exclude-only custom-tab matching.
v0.0.10 2026-04-11 Expand recognized in-game color words and refine adjective parsing.
v0.0.9 2026-04-11 Expand color-word, suffix, and adjective recognition from game-log review.
v0.0.8 2026-04-11 Make script reload rescan every script directory for newly added modes.
v0.0.7 2026-04-10 Expand color recognition and fix unread-tab markers for blank lines.
v0.0.6 2026-04-09 Hide HTML-wrapped SKOOT protocol messages from game output.
v0.0.5 2026-04-08 Add mode validation, batched rendering, blank-line support, and safer command pacing.
v0.0.4 2026-04-08 Correct lighting-level ranges and labels to match the game.
v0.0.3 2026-04-07 Add the first how-to guide, improve scrolling and menu layout, and make script reload preserve the active mode.
v0.0.2 2026-04-07 Add Homebrew, Apt, and Yum installation instructions.
v0.0.1 2026-04-07 Initial public release with CI pipelines and package repositories.