Free, open-source 3D sculpting for Linux, macOS and Windows: dense meshes, remeshing, painting, built-in AI (image/text to 3D), Send to Unreal, game-ready LODs, Gaussian splats and OpenUSD.
C++ 3d3d-sculptingcppdear-imguidigital-sculptingfbxgame-developmentgaussian-splattinggltfimage-to-3dmcpopenglopenusdsculptingtext-to-3dunreal-engine
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>The interface - SculptForge User Guide</title>
<meta name="description" content="SculptForge's window has the 3D view (the canvas) in the middle, shelves of the most-used controls around it, menus along the top that hold every function, and trays at the sides where panels can stay open. It comes in two layouts: the SculptForge layout (the default), with menus by task, and the Cl">
<meta name="theme-color" content="#111114">
<meta name="color-scheme" content="dark">
<link rel="icon" type="image/png" sizes="32x32" href="../img/favicon-32.png?v=7">
<link rel="icon" type="image/png" sizes="64x64" href="../img/favicon-64.png?v=7">
<link rel="apple-touch-icon" href="../img/apple-touch-icon.png?v=7">
<link rel="canonical" href="https://sculptforge.app/guide/interface.html">
<meta property="og:type" content="article">
<meta property="og:title" content="The interface - SculptForge User Guide">
<meta property="og:description" content="SculptForge's window has the 3D view (the canvas) in the middle, shelves of the most-used controls around it, menus along the top that hold every function, and trays at the sides where panels can stay open. It comes in two layouts: the SculptForge layout (the default), with menus by task, and the Cl">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/interface.html">
<link rel="stylesheet" href="../style.css?v=19">
<script src="../motion.js?v=12" defer></script>
<script data-goatcounter="https://sculptforge.goatcounter.com/count" async src="https://gc.zgo.at/count.js"></script>
<script src="search-index.js?v=52" defer></script>
</head>
<body class="guide-page" data-prev="installing.html" data-next="navigation.html">
<div class="scroll-progress" aria-hidden="true"></div>
<header class="nav">
<div class="wrap nav-inner">
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="44" height="44" alt=""><span>SculptForge</span></a>
<nav aria-label="Main">
<a href="../index.html#features">Features</a>
<a href="../index.html#demos">Demos</a>
<a href="../brushes.html">Brushes</a>
<a href="index.html" aria-current="page">Guide</a>
<a class="nav-dl" href="../index.html#download">Download</a>
<a class="gh" href="https://discord.gg/gWrYkEmQhH">Discord</a>
<a class="gh" href="https://github.com/islandmed/SculptForge">GitHub</a>
</nav>
</div>
</header>
<div class="wrap guide-layout">
<div class="guide-side">
<button class="toc-toggle" type="button" aria-expanded="false" aria-controls="guide-toc">
<span>Contents</span><span class="toc-current">The interface</span></button>
<div id="guide-toc" class="toc-panel">
<div class="guide-search" role="search">
<input type="search" id="guide-q" placeholder="Search the guide" aria-label="Search the guide" autocomplete="off">
<div class="search-results" id="guide-results" hidden></div>
</div>
<nav class="toc" aria-label="User guide"><a class="toc-home" href="index.html">Contents</a><p class="toc-group">Getting started</p><ul><li><a href="welcome.html">Welcome to SculptForge</a></li><li><a href="first-sculpt.html">Your first sculpt in 10 minutes</a></li><li><a href="whats-new.html">What's new</a></li><li><a href="quick-tour.html">Quick tour for experienced sculptors</a></li><li><a href="installing.html">Install SculptForge on Windows, macOS and Linux</a></li><li><a href="interface.html" class="current" aria-current="page">The interface</a><ul class="toc-sections"><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-classic-layout">The title strip (Classic layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></li><li><a href="navigation.html">Navigating the view</a></li></ul><p class="toc-group">Sculpting</p><ul><li><a href="sculpting.html">Sculpting and brushes</a></li><li><a href="brush-lab.html">Brush Lab and sharing brushes</a></li><li><a href="brush-packs.html">Brush packs</a></li><li><a href="masking.html">Masking</a></li><li><a href="face-groups.html">Face Groups and visibility</a></li><li><a href="selection-sets.html">Selection sets and morph targets</a></li><li><a href="parts.html">Parts</a></li><li><a href="linked-duplicates.html">Linked Duplicates</a></li><li><a href="forge-spheres.html">Forge Spheres</a></li><li><a href="tube.html">Tube: draw in 3D space</a></li><li><a href="vertex-paint.html">Vertex Paint and materials</a></li><li><a href="texture-painting.html">Texture painting</a></li><li><a href="uv-editor.html">UV Editor</a></li><li><a href="pbr-painting.html">Material painting (PBR)</a></li><li><a href="fill-layers.html">Fill layers, Mesh Maps and Material Recipes</a></li><li><a href="layers.html">Sculpt layers and blend shapes</a></li><li><a href="facial-shapes.html">Facial shapes and live face</a></li><li><a href="subdivision-levels.html">Subdivision levels</a></li><li><a href="micro-levels.html">Micro levels: hundreds of millions of polygons</a></li><li><a href="dynamic-topology.html">Dynamic topology</a></li><li><a href="timeline.html">Sculpt Timeline and timelapse</a></li><li><a href="gizmo.html">Moving, rotating and posing (Gizmo)</a></li><li><a href="geometry.html">Subdivide, remesh, decimate and LODs</a></li><li><a href="cut.html">Cut: line, lasso, rectangle and polyline</a></li><li><a href="retopology.html">Quad retopology and detail projection</a></li></ul><p class="toc-group">AI and capture</p><ul><li><a href="generate-3d.html">Image and text to 3D</a></li><li><a href="splats.html">Gaussian splats</a></li><li><a href="scan-to-splat.html">Scan an object into a splat</a></li><li><a href="scan-to-sculptable.html">From scan to sculptable mesh</a></li><li><a href="phone-capture.html">Phone capture and AR</a></li></ul><p class="toc-group">Files and pipelines</p><ul><li><a href="baking.html">Baking normal and displacement maps</a></li><li><a href="exporting.html">Exporting, Unreal and Bridge</a></li><li><a href="export-presets.html">Export presets</a></li><li><a href="blender.html">Working with Blender</a></li><li><a href="maya.html">Working with Maya</a></li><li><a href="projects.html">Projects, autosave and snapshots</a></li><li><a href="scripting.html">Scripting and automation</a></li><li><a href="packs-and-macros.html">Packs and macros</a></li><li><a href="studios.html">SculptForge for studios</a></li><li><a href="security.html">Security overview for IT reviews</a></li></ul><p class="toc-group">Reference</p><ul><li><a href="shortcuts.html">Keyboard and mouse</a></li><li><a href="performance.html">Performance and big meshes</a></li><li><a href="troubleshooting.html">Troubleshooting: tablets, display, crashes and FAQ</a></li><li><a href="glossary.html">Glossary</a></li><li><a href="discord.html">Show SculptForge on Discord</a></li></ul></nav>
</div>
</div>
<main class="guide-main" id="top">
<article class="guide-article">
<h1 id="the-interface">The interface</h1>
<p>SculptForge's window has the 3D view (the canvas) in the middle, shelves of the most-used controls around it, menus along the top that hold every function, and trays at the sides where panels can stay open. It comes in two layouts: the <strong>SculptForge layout</strong> (the default), with menus by task, and the <strong>Classic layout</strong>, with a bar of alphabetical palettes. Both hold the same controls; see <a href="#looks-and-layouts">Looks and layouts</a> to switch. This chapter walks through each region, the pop-up pickers, the Library, the built-in help, and how to rearrange the interface and keep your changes. The pictures show the default look and layout.</p>
<figure class="shot"><a href="images/interface-overview.jpg" class="zoom"><img src="images/interface-overview.jpg" alt="The SculptForge window with its main regions labelled" width="1280" height="768" loading="lazy" decoding="async"></a><figcaption>The SculptForge window with its main regions labelled</figcaption></figure>
<h2 id="the-regions-at-a-glance">The regions at a glance<a class="anchor" href="#the-regions-at-a-glance" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Region</th><th>Where</th><th>What it holds</th></tr></thead><tbody><tr><td>Menu bar</td><td>Top edge</td><td>The menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>; the status message; mode, brush, file name, triangles and frame rate; layout presets <strong>1 2 3</strong>; <strong>Search</strong></td></tr><tr><td>Top shelf</td><td>Under the menu bar</td><td>Sculpt/Paint, Draw/Move/Scale/Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry</td></tr><tr><td>Left shelf</td><td>Left of the canvas</td><td>Brush, Stroke, Alpha and Material tiles, the colour picker, Fill</td></tr><tr><td>Canvas</td><td>Centre</td><td>The 3D view, with the Sculpt Timeline along its top; strokes and navigation start only here</td></tr><tr><td>Right shelf</td><td>Right of the canvas</td><td>Undo and Redo, Frame, Move, Zoom and Rotate, display toggles, Solo</td></tr><tr><td>Right tray</td><td>Far right</td><td>The <strong>Tool</strong> panel: the active Part, Parts, Layers, Geometry, Masking and more</td></tr><tr><td>Bottom shelf</td><td>Below the canvas</td><td>Your quick brushes</td></tr></tbody></table></div>
<p>Press <kbd>Tab</kbd> to hide the shelves and trays for a bigger canvas, and again to bring them back. The menu bar stays, so every function is still one click away.</p>
<p>The <strong>Classic layout</strong> has a title strip and a bar of 16 alphabetical palettes instead of the menu bar, and a two-row top shelf; the rest is the same. See <a href="#the-title-strip-classic-layout">The title strip</a> and <a href="#menus-and-palettes">Palettes</a>.</p>
<h2 id="looks-and-layouts">Looks and layouts<a class="anchor" href="#looks-and-layouts" aria-label="Link to this section">#</a></h2>
<p><strong>Edit > Preferences > Interface > Look</strong> sets how the interface looks and how it is laid out. Neither changes your models, brushes or shortcuts.</p>
<aside class="callout callout-note"><p><strong>Classic layout:</strong> Preferences is not under <strong>Edit</strong> there but its own <strong>Preferences</strong> palette in the palette bar (<strong>Edit > Preferences...</strong> opens it too). In both layouts <kbd>Ctrl</kbd>+<kbd>,</kbd> (<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS) or <kbd>F3</kbd> > <strong>Preferences</strong> opens it.</p></aside>
<p><strong>Layout</strong>:</p>
<ul>
<li>
<strong>SculptForge</strong> (the default for new installs): a status bar along the top with the task menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render</strong> and <strong>Help</strong>, the document name and scene statistics; a one-row top shelf (Sculpt/Paint, Draw, Move, Scale, Rotate, Add/Sub, Rgb, Size, Intensity, Dynamic, symmetry). Every palette is a section of one menu: <strong>File</strong> (File, Script), <strong>Edit</strong> (Edit, Preferences), <strong>Sculpt</strong> (Brush, Draw & Tablet, Stroke, Alpha, Symmetry & Gizmo), <strong>Paint</strong> (Vertex Paint & Color), <strong>Mesh</strong> (Parts & Geometry, which is the Tool palette, and Generate 3D), <strong>View</strong> (Display), <strong>Render</strong> (Materials, Gaussian Splats) and <strong>Help</strong>. Pin a section to a tray as you would a palette. Brush Lab, Front and the pressure options are under <strong>Sculpt</strong>, the Library and the console under <strong>View > Display</strong>, and <kbd>F3</kbd> finds everything.
</li>
<li>
<strong>Classic</strong>: the alphabetical palette bar under a title strip, and a two-row top shelf (see <a href="#the-title-strip-classic-layout">The title strip</a> and <a href="#top-shelf">Top shelf</a>). Experienced sculptor? In the welcome shown at the first start, pick the <strong>Classic layout</strong> card or <strong>Coming from: Classic sculpting keys</strong> (which also sets the keys).
</li>
</ul>
<p>Switching the layout swaps the shelves for that layout's standard ones; the trays and what is in them stay.</p>
<p><strong>Look</strong> (the colours and style):</p>
<ul>
<li>
<strong>Forge Terminal</strong> (the default): tiles with small gaps and thin borders, JetBrains Mono for labels and numbers. <strong>Colours</strong> picks the scheme: <strong>Neutral</strong> (the default since 0.10.9: pure grey panels and the orange accent, so your model's colours read true), Tokyo Night (the default in 0.10.7 and 0.10.8), Catppuccin Mocha, Gruvbox Dark, Nord, Rosé Pine, Kanagawa or Everforest. <strong>Match my desktop theme</strong> uses your Omarchy theme's colours when Omarchy is installed (Linux; the option shows only then). SculptForge never changes the theme; toggle it again after switching themes.
</li>
<li>
<strong>Classic</strong>: the dark grey interface with the orange accent that SculptForge had before 0.10.7, now exactly neutral grey (red, green and blue equal in every background, panel and frame colour).
</li>
<li>
<strong>Phosphor</strong>: green or amber on black, monospace, with optional scanlines and glow on the interface (never on the 3D view).
</li>
<li>
<strong>Blueprint</strong>: deep blue with cyan and white line work.
</li>
</ul>
<p><strong>Outlines</strong> (Forge Terminal, Phosphor and Blueprint) sets the panels' borders: <strong>Subtle</strong> (the default: faint borders, and nothing lights up under the pointer), <strong>Off</strong> (no borders; the gaps alone separate the panels) or <strong>On</strong> (clear borders, the panel under the pointer a faint step lighter). <strong>Outline opacity</strong> (0-100%, default 100%) fades the borders further into the panels. Hovering a control only gives that control a faint fill, never a bright border.</p>
<p><strong>The first start</strong> shows three looks to pick from in the welcome: <strong>Neutral</strong>, <strong>Forge Terminal</strong> (Tokyo Night) and <strong>Classic layout</strong> (Classic with the palette bar). <strong>Coming from</strong> sets the keys and the layout together: Classic sculpting keys (the keys and the Classic layout), Blender, Maya or New to sculpting (their keys, the SculptForge layout). Help > Welcome shows it again.</p>
<p>Choosing Forge Terminal, Phosphor or Blueprint also switches to the SculptForge layout; you can pick the Classic layout again right after. The look and layout are remembered for the next start on their own, like every <a href="#saving-preferences-and-layouts">preference</a>.</p>
<p><strong>Updating from an older version</strong> keeps the look and layout you had. A card, <strong>SculptForge has a new look</strong>, shows once: <strong>Try it</strong> switches to Forge Terminal with the Neutral colours and the SculptForge layout; <strong>Keep my layout</strong> changes nothing. Either way, Edit > Preferences > Interface > Look changes it later.</p>
<p>In scripts: <code>ui_look look=forge scheme=neutral outlines=subtle layout=sculptforge</code> (or <code>look=classic layout=classic</code>).</p>
<h2 id="turning-ai-off">Turning AI off<a class="anchor" href="#turning-ai-off" aria-label="Link to this section">#</a></h2>
<p>Your art is never uploaded or used for training. AI features run only when you use them and can be turned off.</p>
<p><strong>Edit > Preferences > AI > Enable AI features</strong> turns off everything AI: <strong>AI Brush</strong> (Brush Lab, where you describe a brush in words) and <strong>Generate 3D</strong> (image or text to a model) leave the shelves, menus and the command palette, their commands leave scripts, <code>sculptforge-cli</code> and the MCP tool list, and SculptForge makes no AI network calls. The offline image tools (<strong>Relief</strong>, <strong>Inflate</strong>, <strong>Stamp</strong>) and the MCP server stay. The first-run welcome asks the same question. The choice is saved at once; turn it back on the same way, or search the command palette for "Enable AI".</p>
<p>Studios can turn it off for everyone with the environment variable <code>SF_AI=off</code> (or start with <code>--no-ai</code>); the setting is then locked. See <a href="studios.html#environment-variables">Studios</a>.</p>
<h2 id="the-menu-bar">The menu bar<a class="anchor" href="#the-menu-bar" aria-label="Link to this section">#</a></h2>
<p>From left to right:</p>
<ul>
<li>
<strong>SculptForge</strong> and the task menus <strong>File, Edit, Sculpt, Paint, Mesh, View, Render, Help</strong>. Click a menu to open it: its sections are listed down the left (for example <strong>Sculpt</strong> has Brush, Draw & Tablet, Stroke, Alpha and Symmetry & Gizmo) and the chosen one opens beside them. See <a href="#menus-and-palettes">Menus and palettes</a>.
</li>
<li>
<strong>The status message</strong>: the result of the last command or action. Errors show in red for a few seconds.
</li>
<li>
<strong>Mode</strong> (SCULPT, PAINT, MOVE...), the active <strong>brush</strong>, the <strong>file name</strong> (<code>*</code> after it means unsaved changes), the <strong>triangle</strong> count of the scene and the <strong>frame rate</strong>. On a narrow window the least important of these are left out.
</li>
<li>
<strong>1</strong>, <strong>2</strong>, <strong>3</strong>: the layout presets (see <a href="#layout-presets">Layout presets</a>).
</li>
<li>
<strong>Search</strong> (<kbd>F3</kbd>): opens the <a href="#the-command-palette">command palette</a>.
</li>
<li>
<strong>Minimize</strong> and <strong>Close</strong> at the far right. Close asks to save changes first, as <kbd>Ctrl</kbd>+<kbd>Q</kbd> does.
</li>
</ul>
<h2 id="the-title-strip-classic-layout">The title strip (Classic layout)<a class="anchor" href="#the-title-strip-classic-layout" aria-label="Link to this section">#</a></h2>
<p>In the Classic layout the top edge is a title strip instead, with the palette bar under it. From left to right:</p>
<ul>
<li>
<strong>SculptForge</strong> and the <strong>document name</strong> ("Untitled" until you save). A <code>*</code> after the name means there are unsaved changes; click the name to save (<kbd>Ctrl</kbd>+<kbd>S</kbd>).
</li>
<li>
<strong>Scene statistics</strong>: vertices and triangles across all Parts, the active Part and its position ("Part Body (2/5)"), the active sculpt layer ("Layer Base" when you sculpt the base mesh), the number of Gaussian splats when a capture is loaded, and the frame rate.
</li>
<li>
<strong>The status message</strong>: the result of the last command or action. Errors show in red for a few seconds. Point at a long message to read all of it.
</li>
<li>
<strong>Snapshot</strong>: saves a timestamped copy of the whole scene to your library without touching your project file (see <a href="projects.html">Projects, autosave and snapshots</a>).
</li>
<li>
<strong>1</strong>, <strong>2</strong>, <strong>3</strong>: the layout presets (see <a href="#layout-presets">Layout presets</a>).
</li>
<li>
<strong>Menus</strong>: shows or hides the palette bar.
</li>
<li>
<strong>Search</strong> (<kbd>F3</kbd>): opens the <a href="#the-command-palette">command palette</a>.
</li>
<li>
<strong>Minimize</strong> and <strong>Close</strong> at the far right. Close asks to save changes first, as <kbd>Ctrl</kbd>+<kbd>Q</kbd> does.
</li>
</ul>
<h2 id="menus-and-palettes">Menus and palettes<a class="anchor" href="#menus-and-palettes" aria-label="Link to this section">#</a></h2>
<p>Every function in SculptForge lives in one of 16 palettes. In the SculptForge layout each palette is a section of one task menu (the table below); in the Classic layout the palettes sit side by side in the palette bar. Either way, click the name and the palette drops down under it. Click another name to switch, or press <kbd>Esc</kbd> or click outside to close it.</p>
<figure class="shot"><a href="images/palette-dropdown.jpg" class="zoom"><img src="images/palette-dropdown.jpg" alt="The Sculpt menu open on its Stroke section" width="630" height="295" loading="lazy" decoding="async"></a><figcaption>The Sculpt menu open on its Stroke section</figcaption></figure>
<p>Menu paths in this guide name what you click in the SculptForge layout: <strong>Edit > Preferences > Input</strong> is the <strong>Edit</strong> menu, its <strong>Preferences</strong> section, then the <strong>Input</strong> sub-palette. <strong>File</strong> and <strong>Edit</strong> have a section of the same name, which paths leave out (<strong>File > Save</strong>). Paths starting with <strong>Tool</strong> are in the Tool panel in the right tray, in both layouts (it is also <strong>Mesh > Parts & Geometry</strong>). In the Classic layout, drop the menu: <strong>Edit > Preferences > Input</strong> is <strong>Input</strong> in the palette named <strong>Preferences</strong>, and <strong>Sculpt > Stroke</strong> is the palette named <strong>Stroke</strong>.</p>
<p>In the Classic layout, the palette bar lists <strong>File</strong> and <strong>Edit</strong> first and <strong>Help</strong> last, where other desktop applications put them, and the rest in alphabetical order. If you prefer strict A to Z order, turn on <strong>Edit > Preferences > Interface > Palettes strictly A-Z (strict order)</strong>.</p>
<div class="table-wrap"><table><thead><tr><th>Palette</th><th>In the SculptForge layout</th><th>What's in it</th></tr></thead><tbody><tr><td><strong>File</strong></td><td>File</td><td>New Sphere, New Plane, Open, Open Recent, Save, Save As, autosave interval, Import and every export (OBJ, GLB, LOD chain, USD/USDZ, FBX for Unreal, Send to Unreal, splats), Bridge, Quit</td></tr><tr><td><strong>Edit</strong></td><td>Edit</td><td>Undo and Redo (with the name of the step), Paste brush</td></tr><tr><td><strong>Alpha</strong></td><td>Sculpt > Alpha</td><td>The brush alphas: Round, Square, Noise and twelve patterns (Pores, Cracks, Scales...), images from your library, Load image, Invert loaded image</td></tr><tr><td><strong>Brush</strong></td><td>Sculpt > Brush</td><td>AI Brush (Brush Lab), Community brushes, Paste brush, your custom brushes, Front faces only, Invert (Alt), the recipe editor for a custom brush, and every brush as a thumbnail grid with a filter</td></tr><tr><td><strong>Color</strong></td><td>Paint</td><td>The Paint brush, RGB while sculpting, the paint colour and swatches, Fill, Fill masked, Cavity, Clear, Line Gradient, Show vertex paint</td></tr><tr><td><strong>Draw</strong></td><td>Sculpt > Draw & Tablet</td><td>Size, Intensity, Colour intensity, Falloff, Sculpt/Paint, Add/Sub, Rgb, Front, and the tablet options (Pressure > strength, Pressure > size) with a pen readout</td></tr><tr><td><strong>Generate</strong></td><td>Mesh > Generate 3D (Mesh > From Image while Edit > Preferences > AI is off)</td><td>Generate 3D (image or text to 3D), Relief, Inflate and Stamp from an image, and the AI brush provider settings; with AI off only Relief, Inflate and Stamp</td></tr><tr><td><strong>Material</strong></td><td>Render > Materials</td><td>The Lit Sphere materials (Soft Clay, the default, first), your own (<strong>Load Lit Sphere...</strong>) and Studio, Base colour, Smooth / Flat shading for the scene and the active Part</td></tr><tr><td><strong>Preferences</strong></td><td>Edit > Preferences</td><td>Config, Interface, Input, Hotkeys, Display, Library, Tablet, Performance, Updates and Autosave sub-palettes (see <a href="#customizing-the-interface">Customizing the interface</a>)</td></tr><tr><td><strong>Render</strong></td><td>View</td><td>Wireframe, Show Mesh, Show Vertex Paint, Show Mask, Show Face Groups, Floor grid, Show Splats, Background, Frame, Fullscreen</td></tr><tr><td><strong>Script</strong></td><td>File > Script</td><td>Console, Run script file, Copy session as script, Clear console</td></tr><tr><td><strong>Splats</strong></td><td>Render > Gaussian Splats</td><td>Gaussian splat tools: show, flip, turn, fit, clean floaters, Make sculptable, sculpt to splats, save, clear</td></tr><tr><td><strong>Stroke</strong></td><td>Sculpt > Stroke</td><td>The stroke types (Dots, Drag Stamp, Spray, Lazy Stroke) and their settings</td></tr><tr><td><strong>Tool</strong></td><td>Mesh > Parts & Geometry, and the right tray</td><td>The active Part with Open, Save and Import, and the Part, Layers, Paint Layers, Geometry, Remesh, Deformation, Masking, Face Groups, Visibility, Export and Display sub-palettes</td></tr><tr><td><strong>Transform</strong></td><td>Sculpt > Symmetry & Gizmo</td><td>Draw, Move, Scale and Rotate (the <a href="gizmo.html">Gizmo</a> with its pivot, axes, options and numeric entry), Symmetry X, Y and Z, Frame, Solo, Wire</td></tr><tr><td><strong>Help</strong></td><td>Help</td><td>Controls, User Guide, What's New, Command palette, Website & documentation, Report a problem, Support SculptForge..., About SculptForge</td></tr></tbody></table></div>
<h3 id="sub-palettes">Sub-palettes<a class="anchor" href="#sub-palettes" aria-label="Link to this section">#</a></h3>
<p>Large palettes are divided into <strong>sub-palettes</strong>: headers you click to open or close. The Tool palette is the main example (Part, Layers, Geometry and so on). By default opening one sub-palette closes the others in the same palette, which keeps the palette short. <strong>Shift</strong>+click a header to open it without closing the others, or turn off <strong>Edit > Preferences > Interface > One sub-palette open</strong>.</p>
<h2 id="trays">Trays<a class="anchor" href="#trays" aria-label="Link to this section">#</a></h2>
<p>The trays are columns at the far left and far right of the window where palettes stay open while you work. The right tray is open by default and holds the <strong>Tool</strong> palette; the left tray starts closed and empty.</p>
<ul>
<li>
<strong>Put a palette in a tray</strong>: open it from its menu (or the palette bar) and click the tray icon at the left of its header. It goes into the right tray; <strong>Shift</strong>+click the icon to put it in the left tray. You can also drag the icon onto a tray.
</li>
<li>
<strong>Take it out again</strong>: click the tray icon in its header inside the tray. The palette returns to its menu.
</li>
<li>
<strong>Collapse it in place</strong>: click its title (or the arrow at the right of the header).
</li>
<li>
<strong>Find it</strong>: a palette that is in a tray shows a tray icon beside its name in its menu (in the palette bar of the Classic layout, its name in the accent colour). Clicking the name scrolls the tray to the palette and flashes its header.
</li>
<li>
<strong>Open or close a tray</strong>: click its divider, the thin strip with a grip between the tray and the shelves. <strong>Drag</strong> the divider to make the tray wider or narrower (240 to 480 pixels).
</li>
</ul>
<figure class="shot"><a href="images/palette-tray.jpg" class="zoom"><img src="images/palette-tray.jpg" alt="The Stroke palette kept in the right tray, under the Tool panel" width="320" height="400" loading="lazy" decoding="async"></a><figcaption>The Stroke palette kept in the right tray, under the Tool panel</figcaption></figure>
<p>When a tray holds several palettes, <strong>Edit > Preferences > Interface > Auto collapse left tray</strong> (on by default) and <strong>Auto collapse right tray</strong> (off by default) collapse the other palettes when the one you open would not fit.</p>
<p>When you open a Gaussian splat capture, <strong>Render > Gaussian Splats</strong> moves into the right tray by itself.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> on a window narrower than 1280 pixels (at 100% UI scale) the right tray folds away and palettes open as drop-downs only. The left-shelf tiles get smaller and the bottom shelf scrolls sideways with the mouse wheel.</p></aside>
<h2 id="the-shelves">The shelves<a class="anchor" href="#the-shelves" aria-label="Link to this section">#</a></h2>
<p>Shelves surround the canvas and hold the controls you use all the time. Point at anything with <kbd>Ctrl</kbd> held to see what it does. Right-click an item for <strong>Remove from shelf</strong>; see <a href="#customizing-the-interface">Customizing the interface</a> to add items.</p>
<h3 id="top-shelf">Top shelf<a class="anchor" href="#top-shelf" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Sculpt</strong> / <strong>Paint</strong> (<kbd>P</kbd>): brushes change the shape, or paint colour without sculpting.
</li>
<li>
<strong>Draw</strong>, <strong>Move</strong>, <strong>Scale</strong>, <strong>Rotate</strong> (<kbd>Q</kbd> <kbd>W</kbd> <kbd>E</kbd> <kbd>R</kbd>): sculpt, or move, scale and rotate the Part with the <a href="gizmo.html">Gizmo</a>.
</li>
<li>
<strong>Add</strong> / <strong>Sub</strong>: brushes add to or subtract from the surface. Holding <kbd>Alt</kbd> flips it for one stroke.
</li>
<li>
<strong>Rgb</strong>: sculpt brushes paint the colour at the same time.
</li>
<li>
<strong>Size</strong>: the brush radius in screen pixels (2 to 800).
</li>
<li>
<strong>Intensity</strong>: how strongly each dab changes the surface (1 to 100). While <kbd>Shift</kbd> is held it shows Smooth's own value.
</li>
<li>
<strong>Dynamic</strong>: <a href="dynamic-topology.html">dynamic topology</a>, with its <strong>Detail</strong> slider while it is on.
</li>
<li>
<strong>X</strong>, <strong>Y</strong>, <strong>Z</strong>: symmetry across each axis (<kbd>X</kbd> toggles X); <strong>R</strong> is radial symmetry.
</li>
</ul>
<p>The Classic layout's top shelf has two rows: <strong>Library</strong> (<kbd>,</kbd>), Sculpt/Paint, Add/Sub, Rgb, Size and Intensity on the first; <strong>AI Brush</strong>, <strong>Front</strong>, symmetry, <strong>Pressure > Strength</strong> and <strong>Pressure > Size</strong>, and the <strong>ActiveTris / TotalTris</strong> count on the second. In the SculptForge layout these are in the <strong>Sculpt</strong> menu (AI Brush, Front, pressure) and <strong>View</strong> menu (Library).</p>
<p>Size and Intensity are sliders with the label inside: drag along them, or <kbd>Ctrl</kbd>+click to type a value.</p>
<h3 id="left-shelf">Left shelf<a class="anchor" href="#left-shelf" aria-label="Link to this section">#</a></h3>
<p>Four large tiles, each showing the current choice. Click one to open its <a href="#pop-up-pickers">pop-up picker</a>:</p>
<ul>
<li>
<strong>Brush</strong>: the active brush, with a rendered preview.
</li>
<li>
<strong>Stroke</strong>: Dots, Drag Stamp, Spray or Lazy Stroke.
</li>
<li>
<strong>Alpha</strong>: the brush's stamp shape.
</li>
<li>
<strong>Material</strong>: how the model is shaded in the view.
</li>
</ul>
<p>Under them is the <strong>colour picker</strong> for vertex paint (a saturation/value square and a hue strip), two swatches and <strong>Fill</strong>, which fills the unmasked area with the main colour.</p>
<h3 id="right-shelf">Right shelf<a class="anchor" href="#right-shelf" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Undo</strong> and <strong>Redo</strong> (<kbd>Ctrl</kbd>+<kbd>Z</kbd>, <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd>): greyed out when there is nothing to undo or redo. A layout you customised before they were added gets them at the top.
</li>
<li>
<strong>Frame</strong> (<kbd>F</kbd>): fits the model in the view.
</li>
<li>
<strong>Move</strong>, <strong>Zoom</strong>, <strong>Rotate</strong>: drag on these buttons to pan, zoom and orbit the view.
</li>
<li>
<strong>Wire</strong> (<kbd>Shift</kbd>+<kbd>F</kbd>): shows the mesh's polygons: quads as quads, triangles as triangles.
</li>
<li>
<strong>Groups</strong>: colours each face group.
</li>
<li>
<strong>Mask</strong> (<kbd>Ctrl</kbd>+<kbd>H</kbd>): shows or hides the mask's darkening (on by default). Hiding it keeps the mask, which still protects the surface.
</li>
<li>
<strong>Paint</strong>: shows vertex paint colours (on by default).
</li>
<li>
<strong>Solo</strong>: shows only the active Part (available with two or more Parts).
</li>
<li>
<strong>Splats</strong>: shows or hides a Gaussian splat capture (only shown while one is loaded).
</li>
</ul>
<p>Options that are on are highlighted; a filled button in the accent colour marks only the current tool or mode. See <a href="navigation.html">Navigating the view</a> for the camera.</p>
<h3 id="bottom-shelf">Bottom shelf<a class="anchor" href="#bottom-shelf" aria-label="Link to this section">#</a></h3>
<p>A row of quick brushes: Standard, Clay, Clay Block, Sharp Crease, Move, Smooth, Inflate, Pinch, Flatten, Crease, Trim, Tendril, Layer, Nudge and Paint. The small digit in a tile's corner is its shortcut (<kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> select the first ten built-in brushes, <kbd>P</kbd> is Paint). The active brush is outlined in the accent colour.</p>
<figure class="shot"><a href="images/bottom-shelf.jpg" class="zoom"><img src="images/bottom-shelf.jpg" alt="The bottom shelf of quick brushes" width="1100" height="82" loading="lazy" decoding="async"></a><figcaption>The bottom shelf of quick brushes</figcaption></figure>
<ul>
<li>
<strong>Add a brush</strong>: click <strong>+</strong> at the end of the shelf and pick any brush, built-in or one of your own. Or right-click a brush in the brush picker and choose <strong>Add to bottom shelf</strong>. Custom brushes show a small sparkle in the corner.
</li>
<li>
<strong>Remove a brush</strong>: right-click its tile and choose <strong>Remove from shelf</strong>.
</li>
<li>
<strong>Bigger or smaller tiles</strong>: right-click any brush on the shelf and choose <strong>Tile size</strong>: Small, Medium (the default) or Large. The same setting is in <strong>Edit > Preferences > Interface > Shelf tiles</strong>. Small leaves the most room for the model on a laptop screen.
</li>
<li>
<strong>A key for any brush on the shelf</strong>: hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd>, click its tile, then press the key. Custom and pack brushes show their key in the top-right corner.
</li>
<li>
<strong>Brush sets</strong>: keep the shelf as it is now, with the keys of its brushes, as a named set (Wood, Metal, Stone...): <strong>Sculpt > Brush > Brush set > Save</strong>, or right-click the shelf and choose <strong>Brush set > Save Shelf as Brush Set...</strong>. Pick a set from either menu, or type <strong>Brush Set</strong> in the command palette (<kbd>F3</kbd>), to swap the whole shelf and its keys in one step. The set you switched to comes back the next time you start SculptForge. Sets are saved in your brush library (a <code>sets</code> folder next to your brushes); deleting a set leaves the brushes and the shelf as they are.
</li>
</ul>
<h2 id="pop-up-pickers">Pop-up pickers<a class="anchor" href="#pop-up-pickers" aria-label="Link to this section">#</a></h2>
<p>Pickers are pop-up grids of thumbnails. They open beside the left-shelf tile you click, or under the mouse when you use a key. They close when you pick something, press <kbd>Esc</kbd> or click elsewhere. Pointing at a tile for a moment shows <strong>help box</strong>: a large preview and a description.</p>
<h3 id="brush-picker">Brush picker<a class="anchor" href="#brush-picker" aria-label="Link to this section">#</a></h3>
<p>Press <kbd>B</kbd> (or click the Brush tile). The picker shows a <strong>Recent</strong> row, then <strong>Built-in</strong>, <strong>Custom</strong> (your brushes and Brush Lab creations) and <strong>Library</strong> (<code>.sfbrush</code> files in your library that aren't loaded yet; picking one loads it).</p>
<figure class="shot"><a href="images/brush-picker.jpg" class="zoom"><img src="images/brush-picker.jpg" alt="The brush picker after pressing B and typing S" width="475" height="332" loading="lazy" decoding="async"></a><figcaption>The brush picker after pressing B and typing S</figcaption></figure>
<p>Choose a brush with the keyboard:</p>
<ol>
<li>
Press <kbd>B</kbd>.
</li>
<li>
Type the first letter of the brush. Only the brushes starting with that letter stay, and each shows an orange letter: the next key that tells it apart.
</li>
<li>
Press that orange letter to pick the brush. For example <kbd>B</kbd> <kbd>S</kbd> <kbd>T</kbd> picks Standard.
</li>
</ol>
<p><kbd>Backspace</kbd> takes back a letter and <kbd>Enter</kbd> picks the first match. If no name starts with what you typed, the picker falls back to names that contain it. The letter chips along the top (with a count for each letter) filter by a click as well.</p>
<p>Right-click a brush for <strong>Add to bottom shelf</strong> and, for custom brushes, <strong>Copy brush code</strong>, <strong>Rename...</strong>, <strong>Save as .sfbrush...</strong>, <strong>Delete...</strong> and <strong>Reveal in folder</strong> (see <a href="brush-lab.html">Brush Lab and sharing brushes</a>).</p>
<h3 id="stroke-alpha-and-material-pickers">Stroke, Alpha and Material pickers<a class="anchor" href="#stroke-alpha-and-material-pickers" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<strong>Stroke</strong> (click the Stroke tile): Dots, Drag Stamp, Spray and Lazy Stroke, with Scatter for Spray, Steady Stroke (and its radius) and Precision Intensity. See <a href="sculpting.html">Sculpting and brushes</a>.
</li>
<li>
<strong>Alpha</strong> (click the Alpha tile): Round, Square, Noise and the twelve built-in patterns (Pores, Cracks, Scales, Rivets, Stitches, Fabric Weave, Bark, Rock Strata, Wrinkles, Skin Folds, Hair Strands, Dot Grid), the image alpha you loaded, images in your library's Alphas folder, <strong>Load image...</strong> and <strong>Invert loaded image</strong>.
</li>
<li>
<strong>Material</strong> (<kbd>M</kbd>, or click the Material tile): the Lit Spheres and Studio. Point at a material to preview it on the model; click to keep it. Closing the picker without clicking puts the old material back. See <a href="vertex-paint.html">Vertex Paint and materials</a>.
</li>
</ul>
<h3 id="sliders-at-the-cursor-and-the-quick-menu">Sliders at the cursor and the Quick Menu<a class="anchor" href="#sliders-at-the-cursor-and-the-quick-menu" aria-label="Link to this section">#</a></h3>
<p>Press <kbd>S</kbd> for a Size slider under the mouse, <kbd>U</kbd> for Intensity, <kbd>I</kbd> for Colour intensity or <kbd>O</kbd> for Falloff. Drag the slider, or type a number and press <kbd>Enter</kbd> (<kbd>Esc</kbd> cancels). The pop-up closes when you release the slider. <kbd>[</kbd> and <kbd>]</kbd> make the brush 10% smaller or larger at any time. <kbd>Space</kbd> (or a right click on the canvas) opens the Quick Menu with all of them and the brush, stroke, alpha and material (see <a href="sculpting.html#the-quick-menu">The Quick Menu</a>).</p>
<h2 id="the-library">The Library<a class="anchor" href="#the-library" aria-label="Link to this section">#</a></h2>
<p>The Library is a strip of thumbnails across the top of the canvas for browsing everything you can load. Press <kbd>,</kbd> (comma) or click <strong>Library</strong> on the top shelf to show or hide it. It opens on its own at start-up (see <a href="#interface-preferences">Preferences</a>).</p>
<figure class="shot"><a href="images/library.jpg" class="zoom"><img src="images/library.jpg" alt="The Library on the Tool tab" width="930" height="145" loading="lazy" decoding="async"></a><figcaption>The Library on the Tool tab</figcaption></figure>
<div class="table-wrap"><table><thead><tr><th>Tab</th><th>Shows</th><th>Double-click (a click for brushes, alphas and materials)</th></tr></thead><tbody><tr><td><strong>Project</strong></td><td>Projects (<code>.sfproj</code>) in your library and recently opened projects</td><td>Open the project</td></tr><tr><td><strong>Tool</strong></td><td>Sphere, Plane and Cube, and model files in your library</td><td>Open (replaces the scene)</td></tr><tr><td><strong>Brush</strong></td><td>Every brush: built-in, custom and <code>.sfbrush</code> files, and the VDM brushes (built-in ones too)</td><td>Select or load the brush (one click)</td></tr><tr><td><strong>Alpha</strong></td><td>Round, Square, Noise, the twelve built-in patterns and images in your Alphas folder</td><td>Use as the brush alpha (one click)</td></tr><tr><td><strong>Material</strong></td><td>The Lit Spheres (your own included) and Studio</td><td>Use the material (one click)</td></tr><tr><td><strong>Image</strong></td><td>Reference images in your library</td><td>A menu: Generate 3D, relief, inflate, project onto the model, use as alpha</td></tr><tr><td><strong>Splats</strong></td><td>Gaussian splat captures (<code>.ply</code>, <code>.splat</code>)</td><td>Open the capture as a reference</td></tr><tr><td><strong>Snapshots</strong></td><td>The autosave and your snapshots, newest first</td><td>Open it</td></tr><tr><td><strong>Recent</strong></td><td>Recently opened files of every kind</td><td>Open it</td></tr></tbody></table></div>
<p>Working with the strip:</p>
<ul>
<li>
<strong>Shift+double-click</strong> a model, project or primitive to append it to the scene as a new Part instead of replacing the scene.
</li>
<li>
Drag sideways (or use the mouse wheel) to scroll through the strip. A drag of more than a few pixels scrubs, so a plain click still selects (and uses a brush, alpha or material).
</li>
<li>
Drag a tile down out of the Library onto the canvas to load it, like a double-click.
</li>
<li>
Folders open with a double-click; the first tile inside a folder goes back up. The arrows at the top go back and forward through tabs and folders, and the breadcrumb shows where you are.
</li>
<li>
Type in <strong>Filter</strong> to show only items whose names contain the text.
</li>
<li>
Choose <strong>1</strong> to <strong>4</strong> rows of thumbnails.
</li>
<li>
Drag the strip's edge toward the canvas to make the thumbnails bigger or smaller (48 to 128 px; 64 by default).
</li>
<li>
<strong>Open folder...</strong> adds a folder of your own to the root of every tab.
</li>
<li>
On the Snapshots tab, <strong>Save now</strong> takes a snapshot.
</li>
<li>
The <strong>x</strong> at the right end of the header, or <kbd>Esc</kbd>, closes the Library (while you type in Filter, <kbd>Esc</kbd> first leaves the field). The <strong>x</strong> stays on screen on small displays such as 1280x720.
</li>
<li>
Right-click a tile for <strong>Open</strong>, <strong>Append as Part</strong>, the image actions, <strong>Show in file manager</strong> and <strong>Refresh thumbnail</strong>.
</li>
</ul>
<p>At the root of the Tool and Image tabs is a <strong>Built-in</strong> folder (the models and images that ship with SculptForge, such as the demo lion head), and the Project, Tool, Brush, Alpha, Image and Splats tabs have a <strong>User</strong> folder, your library folder (<strong>Documents/SculptForge</strong> by default). To use a different library folder, choose it in <strong>Edit > Preferences > Library > Library folder</strong>.</p>
<h2 id="getting-help-on-anything">Getting help on anything<a class="anchor" href="#getting-help-on-anything" aria-label="Link to this section">#</a></h2>
<h3 id="ctrl-hover-help">Ctrl-hover help<a class="anchor" href="#ctrl-hover-help" aria-label="Link to this section">#</a></h3>
<p>Hold <kbd>Ctrl</kbd> and point at any button, slider, tile or shelf item. A box shows the item's name, its shortcut as keycaps, what it does, where it lives (for example "Tool > Geometry") and the script command it runs.</p>
<figure class="shot"><a href="images/ctrl-help.jpg" class="zoom"><img src="images/ctrl-help.jpg" alt="Ctrl-hover help on the Subdivide button" width="540" height="240" loading="lazy" decoding="async"></a><figcaption>Ctrl-hover help on the Subdivide button</figcaption></figure>
<p>Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> instead to see the <strong>scripting reference</strong> for items that run a command: the command's usage line and each parameter with its type and description. This is the same information the console, <code>sculptforge-cli</code> and AI agents use.</p>
<p>Without <kbd>Ctrl</kbd>, icon-only buttons and labels that don't fit show their name after a short delay (<strong>Edit > Preferences > Interface > Tooltip delay</strong>). Turn Ctrl-hover help off with <strong>Edit > Preferences > Interface > Ctrl+hover help</strong>, and make the box more or less see-through with <strong>Help box opacity</strong>.</p>
<h3 id="the-controls-sheet">The Controls sheet<a class="anchor" href="#the-controls-sheet" aria-label="Link to this section">#</a></h3>
<p>Press <kbd>F1</kbd> (or <strong>Help > Controls</strong>) for the <strong>Controls</strong> window. The <strong>Keyboard</strong> tab lists every action that has a shortcut, grouped by palette and generated from the actions themselves, so it always shows your current keys. The <strong>Mouse & pen</strong> tab lists the gestures. Type in the filter field to search both. Double-click a row on the Keyboard tab to give that action a new key.</p>
<h3 id="this-guide">This guide<a class="anchor" href="#this-guide" aria-label="Link to this section">#</a></h3>
<p><strong>Help > User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>) opens this guide in its own window: the contents on the left (the open chapter lists its sections), the chapter on the right, and links between chapters.</p>
<figure class="shot"><a href="images/user-guide.jpg" class="zoom"><img src="images/user-guide.jpg" alt="The User Guide window on the Masking chapter" width="1042" height="734" loading="lazy" decoding="async"></a><figcaption>The User Guide window on the Masking chapter</figcaption></figure>
<ul>
<li>
<strong>Search:</strong> type in the search box (<kbd>Ctrl</kbd>+<kbd>F</kbd>) to find every section that mentions all of your words. Click a result to jump there; the words are marked on the page. <kbd>Esc</kbd> clears it.
</li>
<li>
<strong>Back and forward:</strong> the arrow buttons, <kbd>Alt</kbd>+<kbd>Left</kbd> / <kbd>Alt</kbd>+<kbd>Right</kbd>, or the back and forward buttons of your mouse.
</li>
<li>
<strong>From any control:</strong> while Ctrl-hover help is showing, press <kbd>F1</kbd> (keep <kbd>Ctrl</kbd> held) to open the chapter about that control. The help box shows which chapter it is ("Learn more: ...").
</li>
<li>
<strong>Code blocks</strong> have a <strong>Copy</strong> button, and <strong>Open in browser</strong> shows the same page on the SculptForge website.
</li>
</ul>
<p>The guide is built into SculptForge, so it works offline and always matches your version.</p>
<h2 id="the-command-palette">The command palette<a class="anchor" href="#the-command-palette" aria-label="Link to this section">#</a></h2>
<p>Press <kbd>F3</kbd> (or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>, or click <strong>Search</strong> at the top right) to find any action or command by name and run it. It opens at the top centre of the canvas.</p>
<figure class="shot"><a href="images/command-palette.jpg" class="zoom"><img src="images/command-palette.jpg" alt="The command palette searching for subdivide" width="605" height="400" loading="lazy" decoding="async"></a><figcaption>The command palette searching for subdivide</figcaption></figure>
<ul>
<li>
Type part of a name, a palette or a word from the description. The search is forgiving: letters in order are enough ("sbdv" finds Subdivide), and every word you type must match somewhere.
</li>
<li>
Each row shows the action, its palette and its shortcut.
</li>
<li>
<kbd>Up</kbd> and <kbd>Down</kbd> (or <kbd>Page Up</kbd> and <kbd>Page Down</kbd>) choose a row, <kbd>Enter</kbd> runs it and <kbd>Esc</kbd> closes the palette.
</li>
<li>
With nothing typed, the palette lists the actions you used most recently.
</li>
<li>
Commands with a required parameter (for example <code>image_relief path=</code>) open in the console with the name already typed. Other commands run with their default values; <kbd>Shift</kbd>+<kbd>Enter</kbd> sends a command with parameters to the console instead, so you can set them first.
</li>
</ul>
<p>Everything scriptable is in the command palette, including commands that have no button in the interface.</p>
<h2 id="the-console">The console<a class="anchor" href="#the-console" aria-label="Link to this section">#</a></h2>
<p>Press <kbd>`</kbd> (the backtick key, left of <kbd>1</kbd> on US keyboards) to open the console, a strip between the canvas and the bottom shelf. It works:</p>
<ul>
<li>
Every command you run, from a button, a key, the command palette, a script or an AI agent, appears as a script line followed by its result. Errors show in red.
</li>
<li>
Type a command and press <kbd>Enter</kbd>: for example <code>remesh resolution=200</code> or <code>subdivide; decimate ratio=0.5</code>. <kbd>Tab</kbd> completes command and parameter names, <kbd>Up</kbd> and <kbd>Down</kbd> recall earlier lines, and <code>help</code> (or <code>help remesh</code>) explains commands.
</li>
<li>
Drag the console's top edge to make it taller or shorter.
</li>
<li>
<strong>File > Script</strong> has <strong>Run script file...</strong>, <strong>Copy session as script</strong> (every command you ran this session, ready to replay, which makes it a macro recorder) and <strong>Clear console</strong>.
</li>
</ul>
<figure class="shot"><a href="images/console.jpg" class="zoom"><img src="images/console.jpg" alt="The console after a few commands" width="1100" height="145" loading="lazy" decoding="async"></a><figcaption>The console after a few commands</figcaption></figure>
<p>See <a href="scripting.html">Scripting and automation</a> for the command language, scripts and headless use.</p>
<h2 id="customizing-the-interface">Customizing the interface<a class="anchor" href="#customizing-the-interface" aria-label="Link to this section">#</a></h2>
<p>Everything about the layout can change: which palettes sit in the trays, what's on each shelf, and which keys do what. <strong>Shortcuts and preferences save themselves</strong>; layout changes (shelves, trays) last until you quit unless you keep them with <strong>Save Layout</strong>.</p>
<h3 id="move-add-and-remove-shelf-items">Move, add and remove shelf items<a class="anchor" href="#move-add-and-remove-shelf-items" aria-label="Link to this section">#</a></h3>
<ol>
<li>
Open <strong>Edit > Preferences > Config</strong> and turn on <strong>Customize Shelves</strong>. The shelves get a dashed orange outline and the status line reads "Customize: Ctrl+Alt+drag to move or remove items".
</li>
<li>
Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and drag any button, slider or tile:
<ul>
<li>
onto a shelf to put it there (an orange line shows where it will go), which is how you <strong>add</strong> buttons from palettes to a shelf;
</li>
<li>
along its shelf, or to another shelf, to <strong>move</strong> it;
</li>
<li>
off the shelves (onto the canvas, for example) to <strong>remove</strong> it.
</li>
</ul>
</li>
</ol>
<ol start="3">
<li>
Turn <strong>Customize Shelves</strong> off when you're done, and click <strong>Save Layout</strong> (same palette) to keep the result.
</li>
</ol>
<p>Right-clicking a shelf item and choosing <strong>Remove from shelf</strong> works without Customize mode.</p>
<p>A shelf you empty is hidden when Customize Shelves is off, and the canvas takes its room. Turn Customize Shelves back on and the empty shelf returns, outlined, so you can drag buttons onto it again.</p>
<h3 id="assign-shortcuts">Assign shortcuts<a class="anchor" href="#assign-shortcuts" aria-label="Link to this section">#</a></h3>
<ul>
<li>
Hold <kbd>Ctrl</kbd>+<kbd>Alt</kbd> and <strong>click</strong> any button (with Customize off), then press the key you want. <kbd>Esc</kbd> cancels and <kbd>Backspace</kbd> removes the button's shortcut.
</li>
<li>
Or open <strong>Edit > Preferences > Hotkeys</strong>, find the action (there's a filter), click its key button and press the new key. Keys you changed show in orange. <strong>Default shortcuts</strong> undoes every change.
</li>
<li>
Or double-click a row in the Controls window (<kbd>F1</kbd>).
</li>
</ul>
<p>If the key already belongs to another action, it moves to the new one and the status line says which action lost it.</p>
<h3 id="saving-preferences-and-layouts">Saving preferences and layouts<a class="anchor" href="#saving-preferences-and-layouts" aria-label="Link to this section">#</a></h3>
<p>Every preference (key style, shortcuts, tablet, interface, performance, radial menus...) <strong>saves itself</strong> a moment after you change it; there is nothing to press. The layout is the one thing kept on purpose, with <strong>Save Layout</strong>. All in <strong>Edit > Preferences > Config</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Item</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Save Layout</strong></td><td>Keeps the current shelves, trays and open palettes for future sessions</td></tr><tr><td><strong>Revert to Saved Layout</strong></td><td>Goes back to the layout the last Save Layout kept</td></tr><tr><td><strong>Reset Layout and Shortcuts</strong></td><td>Goes back to the built-in layout, shortcuts and radial menus (Save Layout afterwards to keep the layout)</td></tr><tr><td><strong>Export Interface...</strong></td><td>Saves the layout, shortcuts and preferences to a <code>.json</code> file you can share</td></tr><tr><td><strong>Import Interface...</strong> (<kbd>Ctrl</kbd>+<kbd>L</kbd>)</td><td>Loads such a file (Save Layout afterwards to keep its layout)</td></tr></tbody></table></div>
<p>The command palette (<kbd>F3</kbd>) also has <strong>Save Preferences Now</strong>, which writes them at once; you never need it.</p>
<p>The first time you change the layout in a session, the status line reminds you once: "Layout changed - Edit > Preferences > Config > Save Layout keeps it". What a session changes by itself (the console and Library being open, the Library tab) doesn't count as a layout change.</p>
<h3 id="layout-presets">Layout presets<a class="anchor" href="#layout-presets" aria-label="Link to this section">#</a></h3>
<p>The <strong>1</strong>, <strong>2</strong> and <strong>3</strong> buttons at the top right (also in <strong>Edit > Preferences > Config</strong>) switch between three arrangements of the current layout:</p>
<ol>
<li>
<strong>Standard</strong>: the Tool panel in the right tray and shelves around the canvas.
</li>
<li>
<strong>Sculpt</strong>: both trays closed, for the largest canvas.
</li>
<li>
<strong>Wide</strong>: Brush, Stroke and Alpha in the left tray, Tool and Material in the right tray.
</li>
</ol>
<p>A preset changes the layout only (the console, Library and left-handed setting stay as they are). Save Layout keeps it.</p>
<h3 id="interface-preferences">Interface preferences<a class="anchor" href="#interface-preferences" aria-label="Link to this section">#</a></h3>
<aside class="callout callout-note"><p><strong>Classic layout:</strong> Preferences is not under <strong>Edit</strong> there but its own <strong>Preferences</strong> palette in the palette bar (<strong>Edit > Preferences...</strong> opens it too). In both layouts <kbd>Ctrl</kbd>+<kbd>,</kbd> (<kbd>Cmd</kbd>+<kbd>,</kbd> on macOS) or <kbd>F3</kbd> > <strong>Preferences</strong> opens it.</p></aside>
<p><strong>Edit > Preferences > Interface</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Look</strong>, <strong>Outlines</strong> and <strong>Layout</strong></td><td>Forge Terminal, Neutral, Subtle, SculptForge</td><td>See <a href="#looks-and-layouts">Looks and layouts</a></td></tr><tr><td><strong>Language</strong></td><td>English</td><td>The interface language: <strong>English</strong>, <strong>Español</strong>, Traditional Chinese or Simplified Chinese (see below)</td></tr><tr><td><strong>Ctrl+hover help</strong></td><td>On</td><td>Ctrl-hover help boxes</td></tr><tr><td><strong>Help box opacity</strong></td><td>0.97</td><td>How solid the help box is</td></tr><tr><td><strong>Tooltip delay</strong></td><td>0.5 s</td><td>How long to point at an icon-only button before its name appears</td></tr><tr><td><strong>Reduce motion</strong></td><td>Off</td><td>Hover and focus highlights change colour only: no easing, and tiles don't lift</td></tr><tr><td><strong>One sub-palette open</strong></td><td>On</td><td>Opening a sub-palette closes the others in that palette</td></tr><tr><td><strong>Auto collapse left tray</strong> / <strong>right tray</strong></td><td>On / Off</td><td>Collapse other palettes in the tray when one wouldn't fit</td></tr><tr><td><strong>Palettes strictly A-Z (strict order)</strong></td><td>Off</td><td>Classic layout: strict alphabetical palette bar instead of File and Edit first, Help last</td></tr><tr><td><strong>Left-handed layout</strong></td><td>Off</td><td>Mirrors the shelves and trays: tools on the right, navigation on the left</td></tr><tr><td><strong>UI scale</strong></td><td>Automatic</td><td>Size of text and controls (100% to 200%), applied at once; Automatic follows the monitor (see below)</td></tr><tr><td><strong>Camera notch</strong></td><td>Automatic</td><td>Keeps the interface below a laptop's camera notch in fullscreen (see below)</td></tr></tbody></table></div>
<p><strong>Language</strong> changes the interface at once, without a restart; saved automatically for the next start. In <strong>Español</strong> the menus, the palettes, the shelves, the Library, the command palette and the Ctrl-help titles are in Spanish, while the names of tools and brushes stay in English, as Spanish-speaking sculptors use them (Parts, Quad Remesh, Forge Spheres, Library, Lit Sphere, Clay Block, Add). The command palette finds a command by its Spanish or its English name. <strong>Traditional Chinese</strong> (the button with its Chinese name; contributed by yoyomaimai) works the same way, with Taiwan usage and the brush and tool names in English; <strong>Simplified Chinese</strong> (the fourth button) is the same translation in simplified characters with mainland terms, drawn with mainland glyph shapes. Anything not translated yet (most Ctrl-help descriptions, this guide) shows in English. Scripts and <code>sculptforge-cli</code> commands are the same in every language.</p>
<p><strong>UI scale</strong> also applies at once: text, buttons, shelves and trays resize on the next frame; saved automatically. <strong>Automatic</strong> uses the scale of the monitor the window is on (Windows: <strong>Settings > Display > Scale</strong>; macOS and Wayland: the display's scaling; X11: the desktop's font DPI). Drag the window to a monitor at another scale, or change the system setting, and the interface follows. A chosen size (100% to 200%) stays the same on every monitor.</p>
<p><strong>Edit > Preferences > Cursor</strong>:</p>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>Default</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Viewport cursor</strong></td><td>Crosshair</td><td>The pointer over the 3D view: a crosshair, or the arrow (#73). The crosshair stays while the view turns, pans or zooms. Panels, menus and popups always show the arrow</td></tr><tr><td><strong>Cursor follows surface</strong></td><td>On</td><td>The brush ring lies on the model: a true circle at the brush's real size, in the plane of the surface (averaged over the brush, so bumps don't bend it), with a short line along the surface's direction. Symmetry and radial copies show as dots where their dabs land. Off: a flat ring on the screen</td></tr><tr><td><strong>Hide ring while stroking</strong></td><td>Off</td><td>While a stroke runs, only the dot where the brush touches (and the symmetry dots) shows, not the ring</td></tr></tbody></table></div>
<p><strong>Edit > Preferences > Hints</strong>: <strong>Show hints in the viewport</strong> (on) and one box per hint (Strokes start off the model, Previewing an LOD, Face landmark steps). Each hint over the 3D view also has its own <strong>Don't show again</strong>; <strong>Show all hints again</strong> brings them all back. Saved automatically.</p>
<p><strong>Scrolling panels with a pen</strong>: on small screens a palette or tray that doesn't fit scrolls with the mouse wheel, and also with a <strong>left-drag on empty space</strong> in it (between and beside the controls) or a <strong>middle-drag anywhere</strong> on it, as you would scroll a list with a finger (#100).</p>
<p><strong>Edit > Preferences > Input</strong> sets the key <strong>Style</strong> (the first start sets it from your <strong>Coming from</strong> answer): <strong>SculptForge</strong> (the default for new installs): <kbd>1</kbd> to <kbd>9</kbd> and <kbd>0</kbd> pick the first ten brushes, <kbd>I</kbd> opens Intensity like <kbd>U</kbd>, and <kbd>Ctrl</kbd>+drag on the background zooms when nothing is masked; <strong>Classic</strong>: the Classic sculpting keys, with the number keys free (<kbd>9</kbd> is Save Snapshot), <kbd>I</kbd> for Colour intensity and <kbd>Ctrl</kbd>+drag on the background for a mask rectangle (see <a href="shortcuts.html#classic-sculpting-keys">the Classic sculpting keys</a>); <strong>Maya</strong>: Maya's view controls; or <strong>Blender</strong>: middle-drag navigation, the numpad views and Blender's sculpt-mode keys (see <a href="shortcuts.html#blender-keys">Blender keys</a>). In the Blender style, <strong>Emulate Numpad</strong> makes the number row work as the numpad, and <strong>Import Blender keymap...</strong> takes the keys from a keymap you exported in Blender. <strong>Right click opens the Quick Menu</strong> (on by default, in every style) opens the <a href="sculpting.html#the-quick-menu">Quick Menu</a> with a right click on the canvas; a right drag navigates either way. <strong>Hold Space and drag to move the camera</strong> (off by default) turns <kbd>Space</kbd> into a camera key: held, left-drag rotates, right- or middle-drag pans and <kbd>Ctrl</kbd>+drag zooms (see <a href="navigation.html#mouse-and-pen">Navigation</a>). <strong>Radial Menus</strong> edits your pie menus and their keys (see <a href="sculpting.html#radial-menus">Radial menus</a>). <strong>Cursor follows surface</strong> (on by default) lays the brush rings on the model under the pointer (see <a href="sculpting.html#size-intensity-colour-intensity-and-falloff">Size and Falloff</a>); off, they are flat circles on the screen. <strong>Rotation</strong> chooses free rotation or a turntable. See <a href="quick-tour.html">Quick tour for experienced sculptors</a>.</p>
<h3 id="the-background">The background<a class="anchor" href="#the-background" aria-label="Link to this section">#</a></h3>
<p><strong>Edit > Preferences > Display</strong> (and the <strong>View</strong> menu) sets the view's <strong>Background</strong>: <strong>Gradient</strong>, the charcoal radial gradient (the default), or <strong>Flat Colour</strong>, one solid colour without the gradient. Click the <strong>Background colour</strong> swatch to pick the colour; picking one switches to Flat Colour. The choice saves itself for the next session, and each project keeps the background it was saved with. From a script: <code>set_background mode=flat</code>, <code>set_background color=60,70,80</code> or <code>set_background mode=gradient</code>.</p>
<p><strong>Edit > Preferences > Library</strong> has <strong>Show at startup</strong> (on by default), the number of <strong>Rows</strong>, the <strong>Thumbnails</strong> size, <strong>Placement</strong> (along the top of the canvas, or at the bottom above the bottom shelf) and the <strong>Library folder</strong>. <strong>Edit > Preferences > Autosave</strong> sets how often a recovery copy is saved (see <a href="projects.html">Projects, autosave and snapshots</a>).</p>
<figure class="shot"><a href="images/preferences.jpg" class="zoom"><img src="images/preferences.jpg" alt="Edit > Preferences with the Config and Interface sub-palettes" width="535" height="960" loading="lazy" decoding="async"></a><figcaption>Edit > Preferences with the Config and Interface sub-palettes</figcaption></figure>
<h3 id="fullscreen-hiding-panels-and-the-camera-notch">Fullscreen, hiding panels and the camera notch<a class="anchor" href="#fullscreen-hiding-panels-and-the-camera-notch" aria-label="Link to this section">#</a></h3>
<ul>
<li>
<kbd>F11</kbd> (or <strong>View > Fullscreen</strong>) fills the screen with SculptForge; press it again to go back to a window. <code>sculptforge --fullscreen</code> starts that way. SculptForge reopens the way you left it; on macOS a window closed in full screen reopens maximised instead, so the menu bar and the window buttons stay reachable (press <kbd>F11</kbd> or the green button to go full screen again).
</li>
<li>
In the Classic layout, <strong>Menus</strong> in the title strip hides the palette bar; click it again to bring it back.
</li>
<li>
<kbd>Tab</kbd> hides the shelves and trays.
</li>
<li>
On MacBooks with a camera notch, SculptForge keeps the interface below the notch when it fills the screen and fills the band beside the notch with the shell colour. <strong>Automatic</strong> asks macOS for the safe area (on Linux it recognises a notched MacBook display); <strong>Always reserve</strong> always keeps a band free at the top, whatever the display; <strong>Off</strong> uses the full height.
</li>
</ul>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="navigation.html">Navigating the view</a>
</li>
<li>
<a href="shortcuts.html">Keyboard and mouse</a>
</li>
<li>
<a href="scripting.html">Scripting and automation</a>
</li>
<li>
<a href="troubleshooting.html">Troubleshooting and FAQ</a>
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="installing.html"><span>Previous</span>Install SculptForge on Windows, macOS and Linux</a><a class="next" rel="next" href="navigation.html"><span>Next</span>Navigating the view</a></nav>
<p class="guide-meta fine">Also in the app: <strong>Help > User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/interface.md">Edit this page on GitHub</a>.</p>
</main>
<aside class="on-page" aria-label="On this page"><p>On this page</p><ul><li><a href="#the-regions-at-a-glance">The regions at a glance</a></li><li><a href="#looks-and-layouts">Looks and layouts</a></li><li><a href="#turning-ai-off">Turning AI off</a></li><li><a href="#the-menu-bar">The menu bar</a></li><li><a href="#the-title-strip-classic-layout">The title strip (Classic layout)</a></li><li><a href="#menus-and-palettes">Menus and palettes</a></li><li><a href="#trays">Trays</a></li><li><a href="#the-shelves">The shelves</a></li><li><a href="#pop-up-pickers">Pop-up pickers</a></li><li><a href="#the-library">The Library</a></li><li><a href="#getting-help-on-anything">Getting help on anything</a></li><li><a href="#the-command-palette">The command palette</a></li><li><a href="#the-console">The console</a></li><li><a href="#customizing-the-interface">Customizing the interface</a></li><li><a href="#see-also">See also</a></li></ul></aside>
</div>
<footer class="footer">
<div class="wrap footer-grid">
<div>
<a class="brand" href="../index.html"><img class="brand-mark" src="../img/bust-mark-44.png" srcset="../img/bust-mark-88.png 2x, ../img/bust-mark-132.png 3x" width="32" height="32" alt=""><span>SculptForge</span></a>
<p class="fine">Copyright © 2026 The SculptForge contributors.<br>The SculptForge User Guide is part of
SculptForge, licensed under the <a href="https://github.com/islandmed/SculptForge/blob/main/LICENSE">GNU GPL v3.0 or later</a>.</p>
</div>
<div class="links">
<a href="../performance/">Performance</a>
<a href="index.html">User guide</a>
<a href="../supporters.html">Members</a>
<a href="https://github.com/islandmed/SculptForge">Source code</a>
<a href="https://discord.gg/gWrYkEmQhH">Community Discord</a>
<a href="https://github.com/islandmed/SculptForge/issues">Report a problem</a>
<a href="https://github.com/islandmed/SculptForge/blob/main/docs/ai-services.md">AI services & privacy</a>
</div>
<p class="fine trademarks">SculptForge is an independent project. Product names are trademarks of their respective owners.</p>
</div>
</footer>
</body>
</html>