STFO

STFO adds a sandboxed scripting language to BetterTerminal. BetterTerminal works without STFO; STFO requires BetterTerminal.

Installing through Thunderstore or r2modman automatically installs the required Daem0n-BetterTerminal dependency.

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

Credits

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

Features

Interactive programs using RUN.
Pipeline scripts using LIST ... | STFO SCRIPT | QUERY.
Program and pipeline entry points in one .stfo file.
Variables, functions, conditions, loops, lists and maps.
Private text, number, boolean and option input.
PRINT, OUTPUT, imports and workspace-confined file access.
Instruction, time, memory, recursion, collection and string limits.
Static checks through STFO CHECK SCRIPT.
Recursive script folders and safe relative imports.
Case-preserving private input with configurable maximum length.
Filtered and bounded SCRIPTS output.
Configurable prompt, option marker and execution statistics.

Script workspace

Created automatically when STFO loads:

BepInEx/config/STFO/Scripts

Commands:

SCRIPTS
SCRIPTS FILTER
STFO CHECK DEMO
STFO CONFIG
RUN DEMO
LIST MEDIPACK | STFO DEMO | QUERY

File writes are disabled by default. When enabled, writes remain restricted to the STFO workspace.

Runtime customization:

STFO CONFIG
STFO CONFIG RELOAD
STFO CONFIG ENABLED ON|OFF
STFO CONFIG WRITES ON|OFF
STFO CONFIG STATS ON|OFF
STFO CONFIG UPPERCASEINPUT ON|OFF
STFO CONFIG INPUTLIMIT 1-65536
STFO CONFIG LISTLIMIT 1-1000
STFO CONFIG PROMPT TEXT
STFO CONFIG MARKER TEXT