Skip to content

Core Structure

JLangisch edited this page Dec 23, 2025 · 1 revision

Runfile Core Fields Reference

meta

Field Type Required Description
name string Yes Must match filename's <GameName> exactly
version string No Your runfile version (e.g., "1.0")
author string No Your name/handle
image string No URL to banner image for gallery
logo string No URL to square logo/icon

steam_app_id

Type Required Notes
string Yes Must be numeric digits only (Steam AppID)

Executables

Field Type Required Notes
windows_executable string Conditional Required if running on Windows (or architecture="windows"). Must end with .exe
linux_executable string Conditional Required if running on Linux. Must not end with .exe

Note

Validation checks file extensions strictly.

backup_content_dir

Type Required Description
string No Relative path to the folder containing saves/worlds. SSUI uses this for its built-in backup and restore tools (e.g., "./saves" or "./Stationeers/saves")

architecture (Legacy/Deprecated)

Values Behavior
(empty or "all") Default: pick executable based on current OS
"windows" Force Windows only (errors if run on Linux)
"linux" Force Linux only

Tip

Omit this field or set to "all" in new runfiles.

steam_login_required

Type Notes
boolean Planned for future use (when SSUI supports Steam login). Currently ignored.

Clone this wiki locally