BetterTerminal Documentation

Quick start

Install through r2modman/Thunderstore, enter a terminal, then type:

HELP BETTERTERMINAL
BETTERTERMINAL STATUS
CONFIG PROFILE CONVENIENT

BetterTerminal is client-side and keeps native terminal behavior as fallback.

Practice terminal

Safe simulator using sample data. Try HELP BETTERTERMINAL, LIST MEDIPACK, or a pipeline. Up/Down recalls history; Tab completes.

\\ROOT\_

Search and autocomplete

Press Tab. Every command and argument word is completed separately. Prefix matches win; Levenshtein correction runs only when no prefix matches.

QUERY MEDIPAC_123
LIST GLOW_STICK
LIST MEDIPACK_ | WHERE ZONE 49

Ambiguous results use common-prefix completion or arrow selection according to configuration.

Command history

Press Up on an empty line. Type to narrow commands, move with Up/Down, press Enter. History is session-only by default. Use CONFIG HISTORYMODE DISK for persistence or HISTORY CLEAR to remove it.

Pipelines

| passes output to the next independently parsed stage.

LIST MEDIPACK | WHERE ZONE 49 | TAKE 1 | PING
LIST GLOW_STICK | SORT ID | TAKE 3 | MARK
COMMANDS | WHERE TEXT MARK

WHERE FIELD VALUE filters.
SORT FIELD [DESC] sorts.
TAKE N limits.
COUNT, QUERY, PING, MARK, and UNMARK consume results.

Consumables and map markers

Optional tracking exposes uncollected glow sticks, C-Foam items, mines, fog repellers, lock melters, flashlights, and syringes. Picked-up items are removed; dropped items can be registered again.

MARK GLOW_STICK_001
UNMARK GLOW_STICK_001
UNMARK

GTFO supports one active terminal locator ping, while BetterTerminal map markers may represent multiple results.

Command reference

HELP topic

In-game help for SEARCH, HISTORY, PIPELINES, MARKERS, CONSUMABLES, APPEARANCE, CONFIG, STFO, and DOCS.

BETTERTERMINAL STATUS

Version, language, feature state, registrations, paths, and STFO availability.

DOCS / DOCS OPEN

Shows this URL or explicitly opens it in the default browser.

CONFIG

Reads or changes runtime settings. CONFIG RELOAD reloads disk files.

NEOFETCH

Shows terminal/mod information beside replaceable ASCII art.

IDLESCREEN

Shows status or reloads the replaceable sleeping-terminal image.

Configuration

File: BepInEx/config/BetterTerminal.cfg. Most settings update in-session.

CONFIG SEARCH
CONFIG HISTORY
CONFIG ITEMS
CONFIG APPEARANCE
CONFIG PROFILE VANILLA|CONVENIENT|FULL
CONFIG RESET APPEARANCE
CONFIG RESET
CONFIG TEXTCOLOR 950606
CONFIG TEXTINTENSITY 45

VANILLA keeps search/history conveniences. CONVENIENT enables pipelines and tracked items. FULL also enables optional presentation features. Interactive background remains off for safety/readability.

Localization

JSON files live in BepInEx/config/BetterTerminal/Localization/. English is fallback. Copy template.json, translate it, and select it with CONFIG LANGUAGE CODE. Changes are dynamic.

STFO

STFO is an optional scripting plugin distributed separately. BetterTerminal works without STFO; STFO requires BetterTerminal.

Troubleshooting

Run BETTERTERMINAL STATUS.
Run CONFIG RELOAD.
Include BepInEx/LogOutput.log, mod version, command, and reproduction steps in an issue.

Open a GitHub issue