BetterTerminal
Improved GTFO terminal with fuzzy search, pipelines, consumable tracking, localization and searchable command history.
About this mod Author’s original text
BetterTerminal
BetterTerminal 1.1.3 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.3
- Consumables register after GTFO factory/culling initialization instead of
waiting for a consumable list command.
- CONFIG CONSUMABLESINLIST ON|OFF controls broad native LIST inclusion.
- Consumable pings expire after five seconds without removing MARK markers.
- 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.
- Session-only history by default. Optional disk persistence with
CONFIG HISTORYMODE DISK; clear it with HISTORY CLEAR.
- 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 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
Item filters and queries
LIST keeps GTFO's native substring-filter behavior. For predictable results,
prefer a complete item type instead of a single letter:
LIST GLOW_STICK
LIST MEDIPACK
LIST CONSUMABLES
LIST NATIVE | WHERE ZONE 49
LIST CONSUMABLES shows only supported consumables registered by
BetterTerminal. LIST NATIVE is available as a pipeline source and excludes
those added consumables.
Direct and piped queries both accept native terminal objects and supported
consumables:
QUERY GLOW_STICK_001
LIST GLOW_STICK | WHERE ZONE 49 | TAKE 1 | QUERY
LIST MEDIPACK | TAKE 1 | QUERY
PING GLOW_STICK_001
LIST GLOW_STICK | WHERE ZONE 49 | TAKE 1 | PING
Consumable queries show type, current zone and area, placement state, use, and
ping availability. Registration occurs while level objects initialize, so
results can briefly change during level loading or host migration.
Consumable locator pings clear after five seconds. Pipeline PING accepts one
result only; use TAKE 1 when necessary. MARK remains persistent until
UNMARK.
Press Up on an empty command line to open searchable history. Type to narrow results, use Up/Down to sele
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: