Skip to content

World settings reference

Edit client.toml and restart the client to apply world settings.

World settings

Choose the table for your world:

World Settings table
Flat 3D [worlds.flat-3d]
Flat 2D [worlds.flat-2d]
Imported scene worlds [worlds.scene-worlds]
Bistro (separate download) Shared scene settings, then [worlds.bistro]
  • A world's terminal subtable overrides global [terminal] appearance.
  • Worlds validate their own settings; --check-config does not check these tables.
  • Plugin authors: see world-owned settings.

Pane padding and rounded corners

[worlds.flat-3d.terminal_window]
padding = [8, 8, 8, 8] # Left, top, right, bottom.
corner_radius = 12    # 0–64; 0 for square corners.

Use worlds.flat-2d for Flat 2D.

Terminal backdrop blur per world

Blur scenery behind translucent panes while keeping text sharp. This does not blur the desktop behind the app.

[worlds.flat-3d.terminal_window]
blur_radius = 8 # 0–32; default 0.

[worlds.scene-worlds.terminal_window]
blur_radius = 6

[worlds.bistro.terminal_window]
blur_radius = 8 # Overrides the shared scene setting for Bistro.

Blur needs visible scenery: opaque panes and solid backgrounds hide the effect.

Tab and session transitions

Use View () → Tab Transition / Session Transition.

Transition Choices Default
Tab None, Push/Pull Push/Pull
Session None, Fly away, Fly away and in Fly away in Flat worlds; Fly away and in for scenery worlds
[worlds.flat-3d.tab_switch]
effect = "push_pull" # Or "none".

[worlds.flat-3d.session_switch]
effect = "fly_away" # Or "none", "fly_away_and_in".

Fly away reveals the destination while the old view disperses. Fly away and in also animates the arriving letters.

See letter and dust settings.