BetterTerminal

BetterTerminal 1.1.0 expands GTFO's computer terminals with faster search, command pipelines, item tracking, configurable visuals, localization, guided help, and extended command history.

Development disclosure: this project was created with assistance from OpenAI Codex. Design decisions, testing, packaging, and publication remain the author's responsibility.

BetterTerminal is designed as a convenience layer over GTFO's native terminal, not as a replacement for its command system.

What's new in 1.1.0

• Guided help, command topics, status diagnostics, and documentation links.
• Command and configuration autocomplete.
• Configuration profiles, section views, validation, reset, and text glow intensity.
• Better token-by-token fuzzy matching, spacing recovery, pipelines, and visible history.
• Interactive web documentation and terminal trainer.
• Visual, localization, consumable, map-marker, and runtime-safety improvements.

See CHANGELOG.md for detailed verification notes and limitations.

Main features

• Fuzzy completion for commands and terminal item identifiers.
• Common-prefix completion or interactive arrow selection for ambiguous matches.
• Configurable Levenshtein distance.
• Searchable extended command history inspired by interactive shells.
• LIST and QUERY support for ID ranges and result limits.
• Typed pipelines with filtering, sorting, limiting, querying, pinging, marking, and text processing.
• Terminal registration, QUERY, PING, and map markers for uncollected consumables.
• Runtime settings through CONFIG; most changes apply without restarting GTFO.
• JSON localization with runtime language switching and custom language files.
• Configurable neofetch-style terminal status.
• Optional sleeping-terminal image and interactive background customization.
• Optional STFO scripting support through the separate STFO package.

Installation

Mod manager

Install BetterTerminal through r2modman or Thunderstore Mod Manager. Required dependencies are installed automatically.

Manual

Install the GTFO BepInEx pack, then place BetterTerminal.dll inside:

GTFO/BepInEx/plugins/BetterTerminal/

Getting started

Use these commands in any GTFO terminal:

COMMANDS
HELP
CONFIG
NEOFETCH
IDLESCREEN
HELP BETTERTERMINAL
BETTERTERMINAL STATUS
DOCS

Examples:

LIST MEDIPACK 3
LIST MEDIPACK_100-500
QUERY MEDIPACK 2
LIST GLOW_STICK | WHERE ZONE 49 | TAKE 1 | PING
LIST TOOL_REFILL | SORT ID | TAKE 3 | QUERY
COMMANDS | WHERE TEXT PING

Press Up on an empty command line to open searchable history. Type to narrow results, use Up/Down to select, then press Enter.

Consumable tracking

BetterTerminal can expose supported consumables that vanilla terminals do not normally list. Only items still present in the level are tracked. Supported categories include:

• Fog repellers
• C-Foam grenades
• Lock melters
• Glow sticks
• Long-range flashlights
• I2-LP syringes
• IIx syringes
• Explosive tripmines
• C-Foam tripmines

This feature is experimental and can be disabled per category through CONFIG or BetterTerminal.cfg.

Localization

Language files are created under:

BepInEx/config/BetterTerminal/Localization/

English and Spanish are included. template.json can be copied and translated to add another language. Change language at runtime:

CONFIG LANGUAGE EN
CONFIG LANGUAGE ES
CONFIG RELOAD

Terminal appearance

BetterTerminal exports replaceable files under:

BepInEx/config/BetterTerminal/neofetch.txt
BepInEx/config/BetterTerminal/idle-screen.png

Neofetch output is configurable. Sleeping-terminal replacement is configurable; the experimental interactive background is disabled by default. Image rotation, flipping, opacity, intensity, color behavior, and terminal text color can be adjusted through CONFIG or BetterTerminal.cfg.

Multiplayer and achievements

• BetterTerminal is client-side for its interface and convenience features.
• Other players do not need it for you to use local terminal improvements.
• GTFO does not officially support mods; use a modded profile and private sessions.
• BetterTerminal does not intentionally disable Steam achievements. This is not a guarantee from GTFO or Steam.
• Tracking and pipeline features may expose information unavailable through vanilla terminal commands.

STFO compatibility

STFO is optional. BetterTerminal works without STFO. STFO requires BetterTerminal and declares it as a Thunderstore dependency.

Support

When reporting a problem, include:

• BepInEx/LogOutput.log
• BetterTerminal version
• GTFO rundown/version
• Command entered
• Relevant configuration values
• Reproduction steps

Issues and source: github.com/AlexanderMakunin/BetterTerminal

Detailed documentation: alexandermakunin.github.io/BetterTerminal

GTFO does not officially support mods. Game updates, IL2CPP changes, rundowns, and other mods can expose untested behavior. Local validation cannot guarantee every runtime combination.

Credits

• Code and project: AlexanderMakunin
• Icon artwork: hawry
• AI-assisted development: OpenAI Codex

License

MIT License.