Skip to content

Saves & Files

Survival Cubed stores worlds, screenshots, and structures under your operating system's standard data directory, and saved logins and trusted-host fingerprints under its standard config directory. Both are namespaced with a survival-cubed/ subfolder. The two base directories resolve like this:

Platform Data directory Config directory
Linux $XDG_DATA_HOME, else ~/.local/share $XDG_CONFIG_HOME, else ~/.config
macOS ~/Library/Application Support ~/Library/Application Support
Windows %APPDATA% (C:\Users\<you>\AppData\Roaming) %APPDATA% (C:\Users\<you>\AppData\Roaming)

On macOS and Windows the data and config directories are the same folder, so everything below lands under a single survival-cubed/ directory there. If no directory can be determined, paths fall back to the current working directory (e.g. ./saves/<world>).

Where things live

Each entry below is relative to the matching base directory above — for example, the data-directory saves/<world>/ is ~/.local/share/survival-cubed/saves/<world>/ on Linux, ~/Library/Application Support/survival-cubed/saves/<world>/ on macOS, and %APPDATA%\survival-cubed\saves\<world>\ on Windows.

Base Path Contents
Data survival-cubed/saves/<world>/ A singleplayer/host world
Data survival-cubed/server-<port>/ A dedicated server's world
Data survival-cubed/structures/ Saved .scst structures
Data survival-cubed/screenshots/ F2 screenshots (PNG + JPEG)
Config survival-cubed/credentials Remembered per-server logins
Config survival-cubed/known_hosts Trusted server fingerprints

What a world contains

saves/<world>/
  world.dat              # metadata: seed, clock, spawn, players, creatures
  chunks/                # modified overworld chunks (<cx>_<cy>.dat)
  chunks_underworld/     # modified underworld chunks
  bans.txt               # banned IPs (servers only), one per line

world.dat holds everything that isn't terrain:

  • The seed and the in-world clock (so day/night resumes where it left off).
  • Every player's name, position, dimension, health, inventory, respawn point, and waypoints — and a hashed password for registered accounts.
  • All server-simulated creatures (type, position, health).
  • Lit campfires (position and remaining burn time) and player-placed logs.
  • Whether the server is creator-enabled, and which natural structures have already spawned their creatures.

What is and isn't saved

  • Saved: only the chunks you've modified, plus all the metadata above.
  • Not saved: untouched terrain — it regenerates identically from the seed, so unexplored areas cost nothing on disk.

Autosave & shutdown

The server saves the world automatically at intervals, and again on a clean shutdown (Ctrl+C or SIGTERM). Saves are written atomically (to a temporary file, then renamed), so a crash mid-write can't corrupt your world.

Screenshots

Pressing F2 saves a HUD-free screenshot to your data directory as both a lossless PNG and a compressed JPEG.

Saved logins

To save retyping your credentials, the client can remember your per-server name and password in the config directory's survival-cubed/credentials (e.g. ~/.config/survival-cubed/credentials on Linux). This file is stored in plaintext for convenience, so treat it like any other local secret. The server only ever stores your password hashed — see Multiplayer › Accounts.

Structures

Structures saved in creator mode are written as .scst files in the structures/ directory and can be loaded into any world.