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
terminalsubtable overrides global[terminal]appearance. - Worlds validate their own settings;
--check-configdoes 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.