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>Parts - SculptForge User Guide</title>
<meta name="description" content="A scene in SculptForge can hold several separate meshes, called Parts (experienced sculptors: Parts): a body, eyes, teeth, a helmet and a sword can each live in their own Part. This chapter covers the Parts list, selecting, adding, hiding, reordering, merging and splitting Parts, and how they travel">
<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/parts.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Parts - SculptForge User Guide">
<meta property="og:description" content="A scene in SculptForge can hold several separate meshes, called Parts (experienced sculptors: Parts): a body, eyes, teeth, a helmet and a sword can each live in their own Part. This chapter covers the Parts list, selecting, adding, hiding, reordering, merging and splitting Parts, and how they travel">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/parts.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="selection-sets.html" data-next="linked-duplicates.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">Parts</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">The interface</a></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" class="current" aria-current="page">Parts</a><ul class="toc-sections"><li><a href="#how-parts-work">How Parts work</a></li><li><a href="#the-parts-list">The Parts list</a></li><li><a href="#add-a-part">Add a Part</a></li><li><a href="#show-hide-and-solo">Show, hide and solo</a></li><li><a href="#folders">Folders</a></li><li><a href="#reorder-parts">Reorder Parts</a></li><li><a href="#merge-parts">Merge Parts</a></li><li><a href="#split-a-part">Split a Part</a></li><li><a href="#extract-a-shell">Extract a shell</a></li><li><a href="#delete-a-part">Delete a Part</a></li><li><a href="#parts-in-files">Parts in files</a></li><li><a href="#scripting">Scripting</a></li><li><a href="#see-also">See also</a></li></ul></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="parts">Parts</h1>
<p>A scene in SculptForge can hold several separate meshes, called Parts (experienced sculptors: Parts): a body, eyes, teeth, a helmet and a sword can each live in their own Part. This chapter covers the Parts list, selecting, adding, hiding, reordering, merging and splitting Parts, and how they travel through files.</p>
<h2 id="how-parts-work">How Parts work<a class="anchor" href="#how-parts-work" aria-label="Link to this section">#</a></h2>
<ul>
<li>
Only the <strong>active</strong> Part is sculpted, painted, masked or changed by a command. The others are drawn slightly darker and greyer so you can see which one you are working on.
</li>
<li>
Each Part keeps its own mesh, mask, vertex paint, face groups, hidden faces, UVs and <a href="layers.html">sculpt layers</a>.
</li>
<li>
Each Part has its own undo history. <kbd>Ctrl</kbd>+<kbd>Z</kbd> undoes the last change in the active Part, and switching Parts doesn't lose the history of the others.
</li>
<li>
Adding, deleting, reordering, merging and splitting Parts are <strong>not undoable</strong>, except <strong>Split hidden</strong>, <strong>Split masked</strong> and <strong>Split unmasked</strong> (one undo step each). Merges and deletes ask for confirmation first.
</li>
<li>
The Parts list highlights the active Part. In the Classic layout the title strip also shows it and its place in the list, for example <code>Part Helmet (2/5)</code>.
</li>
</ul>
<h2 id="the-parts-list">The Parts list<a class="anchor" href="#the-parts-list" aria-label="Link to this section">#</a></h2>
<p>The list is in <strong>Tool > Parts</strong>, which is open in the right tray by default.</p>
<figure class="shot"><a href="images/parts.jpg" class="zoom"><img src="images/parts.jpg" alt="The Parts sub-palette with several Parts, the active one highlighted" width="960" height="672" loading="lazy" decoding="async"></a><figcaption>The Parts sub-palette with several Parts, the active one highlighted</figcaption></figure>
<p>Each row shows a small picture of the Part, its name, its triangle count, its shading and an eye. The pictures are drawn from the model the viewport already has on the graphics card, so they cost almost nothing even on very dense Parts, and they catch up a moment after you stop changing a Part (not during a stroke).</p>
<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Select a Part</td><td>Click its row, or <kbd>Alt</kbd>+click it in the viewport; triple-click another Part in the viewport to select it and frame it</td></tr><tr><td>Sculpt the Part under the cursor</td><td>Point at it and press <kbd>Alt</kbd>+<kbd>Q</kbd> (every input style, as in Blender): it becomes the active Part, the view stays put and each Part keeps its mask</td></tr><tr><td>Rename it</td><td>Double-click the row (or right-click > <strong>Rename</strong>), type, press <kbd>Enter</kbd></td></tr><tr><td>Hide or show it</td><td>Click the eye at the end of the row</td></tr><tr><td>Shade it smooth or flat</td><td>Click the mark left of the eye: it goes from <strong>as the scene</strong> (dim) to <strong>Smooth</strong> (a disc) to <strong>Flat</strong> (a faceted hexagon) and back. Only this Part changes; the scene's own setting is <strong>Render > Materials > Shading</strong></td></tr><tr><td>Duplicate or delete it</td><td>Right-click the row > <strong>Duplicate</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd>) or <strong>Delete...</strong></td></tr><tr><td>Make a copy that shares the mesh</td><td>Right-click the row > <strong>Linked Duplicate</strong>, or the <strong>Linked Duplicate</strong> button; see <a href="linked-duplicates.html">Linked Duplicates</a></td></tr><tr><td>See its vertex and triangle counts</td><td>Point at the row for a moment</td></tr></tbody></table></div>
<p>The list shows six rows and scrolls when there are more. Names are kept unique: renaming a Part to a name that is already taken adds a number.</p>
<p>Selecting a hidden Part shows it again, because you can't sculpt what you can't see.</p>
<h3 id="select-a-part-in-the-viewport">Select a Part in the viewport<a class="anchor" href="#select-a-part-in-the-viewport" aria-label="Link to this section">#</a></h3>
<p>Hold <kbd>Alt</kbd> and click another Part on the canvas. It becomes the active one and the list scrolls to it.</p>
<p><kbd>Alt</kbd>+click only selects when you click a Part other than the active one and release without moving. If you drag instead, <kbd>Alt</kbd> keeps its usual meaning: an inverted stroke on the active Part, or a pan when you start off the model.</p>
<h2 id="add-a-part">Add a Part<a class="anchor" href="#add-a-part" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Append</strong> and choose:</p>
<ul>
<li>
<strong>Sphere</strong>, <strong>Cube</strong> or <strong>Plane</strong>: a new primitive placed beside the visible model (to the right, on +X), sized to about a third of the largest visible Part.
</li>
<li>
<strong>Insert on the model</strong>: choose a shape, then drag on the active Part's surface to add it there as a new face group (the drag sets its size and turns it). With <strong>Symmetry</strong> X, Y or Z on, a mirrored copy goes on the other side too, in the same undo step; a shape inserted right on a mirror plane isn't doubled. To insert your own mesh, choose <strong>Active Part's copy...</strong> and pick another Part (it stays as it is), or <strong>From file...</strong> and pick an <code>.obj</code>, <code>.ply</code> or <code>.glb</code> file; then drag as with the shapes. The mesh is centred, scaled so its largest side matches the drag, and stood on the surface along its own up (+Y) axis. Esc stops inserting. (Command: <code>insert_mesh part=<name></code> or <code>insert_mesh file=<path></code>.) To insert from a <strong>kitbash set</strong>, choose <strong>Insert set from file...</strong> (one <code>.obj</code> or <code>.glb</code> with several objects) or <strong>Insert set from folder...</strong> (its <code>.obj</code>, <code>.ply</code> and <code>.glb</code> files, by name; not its subfolders). The <strong>Insert set</strong> window shows a thumbnail of each item: click one, then drag on the model as above. While inserting, <code>]</code> steps to the next item and <code>[</code> to the previous one (around the set; brush size keys come back once you stop). Esc or the window's close button stops. (Commands: <code>insert_set_items set=<path></code> lists them; <code>insert_mesh set=<path> index=<n></code> inserts item <code>n</code>, 0 being the first.) <strong>Creature bones</strong>, at the end of the same menu, is a set that comes with SculptForge: no file to pick (see below).
</li>
<li>
<strong>From file...</strong>: a model (<code>.obj</code>, <code>.fbx</code>, <code>.glb</code>, <code>.gltf</code>, <code>.ply</code>, <code>.stl</code>, Bridge files, <code>.usda</code>, <code>.usd</code>, <code>.usdz</code>) or a project (<code>.sfproj</code>). A file with several objects adds one Part per object.
</li>
</ul>
<p>The new Part becomes the active one.</p>
<h3 id="creature-bones">Creature bones<a class="anchor" href="#creature-bones" aria-label="Link to this section">#</a></h3>
<p><strong>Append > Insert on the model > Creature bones</strong> opens a built-in insert set of original fantasy creature bones to start from: Skull, Jaw, Fang, Blade tooth, Swept horn, Spiral horn, Claw, Vertebra, Tail vertebrae, Rib, Limb bone, Wing bone and Wing finger. Click one in the <strong>Insert set</strong> window and drag on the model, as with any set; horns, claws and teeth grow from where you drag. With <strong>Symmetry</strong> X on, a horn or a claw gets its mirrored twin.</p>
<p>Each piece is a clean, closed quad mesh of 500 to 4,200 faces, so it takes <strong>Add Level</strong> and sculpting well: insert, then sculpt the joins smooth, or <strong>Voxel Remesh</strong> to fuse the piece into the model. Drag pieces onto an empty <strong>Plane</strong> or <strong>Sphere</strong> Part to build a skeleton of their own Part. The pieces were designed for SculptForge (tools/creature-bones in the source) and come under the app's licence, GPL-3.0. (Commands: <code>insert_set_items set=builtin:creature-bones</code>; <code>insert_mesh set=builtin:creature-bones index=<n></code>.)</p>
<p>You can also add files as Parts from elsewhere:</p>
<ul>
<li>
<strong>Import</strong> in the Tool palette header (or <strong>File > Import</strong>) adds a model file as a new Part.
</li>
<li>
In the <a href="interface.html">Library</a> <strong>Tool</strong> tab, <kbd>Shift</kbd>+double-click a model, or right-click it and choose <strong>Append as Part</strong>.
</li>
</ul>
<aside class="callout callout-tip"><p><strong>Tip:</strong> <strong>Duplicate</strong> (<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd>, also in the command palette as <strong>Duplicate Part</strong>) copies the active Part with its layers and attributes, names it <code><name> copy</code> and puts it right under the original. Use it to keep a safe copy before a destructive step such as a remesh. <strong>Linked Duplicate</strong> instead makes a copy that shares the mesh and changes with it (rivets, legs, columns); see <a href="linked-duplicates.html">Linked Duplicates</a>.</p></aside>
<h2 id="show-hide-and-solo">Show, hide and solo<a class="anchor" href="#show-hide-and-solo" aria-label="Link to this section">#</a></h2>
<ul>
<li>
The eye on each row shows or hides that Part.
</li>
<li>
<strong>Solo</strong> shows only the active Part. Click it again to bring the others back. The <strong>Solo</strong> button on the right shelf does the same.
</li>
<li>
<strong>X-Ray</strong>, next to <strong>Solo</strong>, shows the active Part through the others: the other Parts turn see-through and only their nearest surface shows. When only the active Part is shown, it is see-through itself. Click <strong>X-Ray</strong> again to make them solid. <strong>View > X-Ray</strong> does the same.
</li>
<li>
<strong>Unhide all</strong> shows every Part.
</li>
</ul>
<p>Hidden Parts aren't drawn, can't be selected with <kbd>Alt</kbd>+click, and are left out of exports.</p>
<aside class="callout callout-note"><p><strong>Note:</strong> Part visibility is different from hiding part of a mesh with face groups or a rectangle. That hides faces inside one Part; see <a href="face-groups.html">Face Groups and visibility</a>.</p></aside>
<h2 id="folders">Folders<a class="anchor" href="#folders" aria-label="Link to this section">#</a></h2>
<p>Folders group Parts in the list, for example the eyes and teeth of a head, so you can hide, show and move them together.</p>
<div class="table-wrap"><table><thead><tr><th>To</th><th>Do this</th></tr></thead><tbody><tr><td>Make a folder</td><td>Click the folder button under the list: a new folder holds the active Part; type its name and press <kbd>Enter</kbd></td></tr><tr><td>Put a Part in a folder</td><td>Drag its row onto the folder's header (or onto a Part already in it), or right-click the row > <strong>Folder</strong> > the folder's name</td></tr><tr><td>Take a Part out</td><td>Drag it onto a Part outside folders, or right-click it > <strong>Folder</strong> > <strong>Out of the folder</strong></td></tr><tr><td>Fold or open a folder</td><td>Click its header</td></tr><tr><td>Rename it</td><td>Double-click the header (or right-click > <strong>Rename</strong>)</td></tr><tr><td>Hide or show all its Parts</td><td>Click the eye on the header</td></tr><tr><td>Move, turn or scale it</td><td>Right-click the header > <strong>Move with the gizmo</strong></td></tr><tr><td>Remove it</td><td>Right-click the header > <strong>Remove folder (keep its Parts)</strong></td></tr></tbody></table></div>
<p>A Part that joins a folder moves to just below the folder's last Part, so a folder's Parts stay together. When the folder holding the active Part is folded, its header shows the accent bar. <strong>Move with the gizmo</strong> makes one of the folder's Parts active and turns on the gizmo's <strong>Folder</strong> option, so every visible Part in the folder moves together; see <a href="gizmo.html#all-parts">All Parts and Folder</a>. Duplicates and the pieces of a split stay in their Part's folder. Folders are saved in the project; older versions of SculptForge open the file and simply show no folders.</p>
<h2 id="reorder-parts">Reorder Parts<a class="anchor" href="#reorder-parts" aria-label="Link to this section">#</a></h2>
<p>The up and down arrow buttons under the list move the active Part one place up or down. The order matters for <strong>Merge down</strong> and is the order objects are written to files.</p>
<h2 id="merge-parts">Merge Parts<a class="anchor" href="#merge-parts" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Merge down...</strong> merges the active Part with the one below it.
</li>
<li>
<strong>Merge visible...</strong> merges every visible Part into one new Part called <code>Merged</code>. Hidden Parts stay as they are.
</li>
</ul>
<p>Merging keeps every attribute, gives each original mesh its own face groups (so you can split them again later) and matches sculpt layers by name. The merged Part starts with an empty undo history. A Part with <a href="subdivision-levels.html">subdivision levels</a> is merged (or split) at the level it is on, which becomes the base of the result; the status line names the Parts that lost their levels.</p>
<p>Painted textures are kept too: the merged Part gets new Auto UVs and one texture, the size of the largest, holding each part's paint exactly (texture layers are flattened; parts without a texture are white). On big meshes the Auto UV takes a while. Scripts can skip it with <code>keep_texture=false</code>, which drops the textures.</p>
<aside class="callout callout-tip"><p><strong>Tip:</strong> Merge first when you want one <a href="geometry.html#voxel-remesh">voxel remesh</a> to fuse several pieces into a single watertight surface.</p></aside>
<h2 id="split-a-part">Split a Part<a class="anchor" href="#split-a-part" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>Split groups</strong> makes one Part per face group. It is available when the active Part has more than one face group.
</li>
<li>
<strong>Split parts</strong> makes one Part per disconnected piece, largest first.
</li>
</ul>
<p>Both replace the active Part with the pieces. Because a merge keeps each original mesh in its own face group, <strong>Split groups</strong> undoes a merge.</p>
<h3 id="split-hidden-masked-or-unmasked">Split hidden, masked or unmasked<a class="anchor" href="#split-hidden-masked-or-unmasked" aria-label="Link to this section">#</a></h3>
<p>The <strong>Split</strong> row (<strong>Hidden</strong>, <strong>Masked</strong>, <strong>Unmasked</strong>) takes part of the active Part out into a <strong>new Part just below it</strong>, in the same folder, shown as the source is and shaded the same way. Each is <strong>one undo step</strong>: <kbd>Ctrl</kbd>+<kbd>Z</kbd> puts the triangles back and removes the new Part.</p>
<div class="table-wrap"><table><thead><tr><th>Button</th><th>Moves into the new Part</th><th>Command</th></tr></thead><tbody><tr><td><strong>Split > Hidden</strong></td><td>the hidden triangles; they are shown in the new Part</td><td><code>part_split_hidden</code></td></tr><tr><td><strong>Split > Masked</strong></td><td>the masked triangles; the new Part starts unmasked</td><td><code>part_split_masked</code></td></tr><tr><td><strong>Split > Unmasked</strong></td><td>the triangles that are not masked; the masked ones stay</td><td><code>part_split_unmasked</code></td></tr><tr><td><strong>Keep original</strong> (checkbox below)</td><td>a <strong>copy</strong> of those triangles; the source Part stays as it is, levels and all, and undo just removes the copy</td><td><code>keep=true</code> on any of the three</td></tr></tbody></table></div>
<p>A triangle counts as <strong>masked when the average mask of its three corners is above 50%</strong>, so a soft mask edge splits along its middle and a single masked corner doesn't take its neighbours. UVs, face groups, vertex paint and sculpt layers carry over to both sides. <a href="subdivision-levels.html">Subdivision levels</a> can't be cut: the split is made at the level the Part is on, which becomes its base (undo brings the levels back). To delete instead of split, use <strong>Remove Hidden</strong> or <strong>Delete masked</strong> in <strong>Tool > Visibility</strong>.</p>
<h2 id="extract-a-shell">Extract a shell<a class="anchor" href="#extract-a-shell" aria-label="Link to this section">#</a></h2>
<p><strong>Extract</strong>, in <strong>Tool > Parts</strong>, makes a new Part from the masked part of the active one: a helmet from the top of a head, a strap, a sleeve, a piece of armour that fits the surface exactly. It works:</p>
<ol>
<li>
Mask the part (hold <kbd>Ctrl</kbd> and paint, or use <strong>Rectangle Mask</strong> / <strong>Lasso Mask</strong>; see <a href="masking.html">Masking</a>).
</li>
<li>
Click <strong>Extract</strong>. The shell appears as a preview, a Part just below the active one.
</li>
<li>
Change <strong>Thickness</strong>, <strong>Edge Smooth</strong>, <strong>Both Sides</strong>, <strong>Corners</strong> or <strong>Border</strong> and the preview follows. Click <strong>Accept</strong> to keep it.
</li>
</ol>
<div class="table-wrap"><table><thead><tr><th>Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Thickness</strong></td><td>The shell's thickness as a share of the Part's size: 0.015 (the default) is 1.5%. Negative grows it inward; 0 makes a single-sided surface</td></tr><tr><td><strong>Edge Smooth</strong></td><td>Smooths the extracted edge, which otherwise follows the mask's triangles in steps. 0 keeps it as masked</td></tr><tr><td><strong>Both Sides</strong></td><td>Grows the shell both inward and outward from the surface</td></tr><tr><td><strong>Corners</strong></td><td>Triangles instead of quads in the rim where the edge turns sharply (over 50 degrees), so tight corners don't get twisted quads</td></tr><tr><td><strong>Border</strong></td><td>The whole rim is triangles instead of quads</td></tr></tbody></table></div>
<figure class="shot"><a href="images/extract.jpg" class="zoom"><img src="images/extract.jpg" alt="A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim" width="620" height="600" loading="lazy" decoding="async"></a><figcaption>A cap extracted from the masked top of a sphere, shown with its face groups: outer, inner and rim</figcaption></figure>
<p>The new Part has three face groups, the outer surface, the inner one and the rim between them (a band of quads), so you can mask, hide or <a href="#split-a-part">split</a> them apart. Vertex Paint comes with it; hidden faces are left out. Accept is one undo step: <kbd>Ctrl</kbd>+<kbd>Z</kbd> on the source Part takes the extracted one away again, and redo brings it back. A preview you don't accept goes away as soon as you change the source Part or pick another one, and it is never saved.</p>
<h2 id="delete-a-part">Delete a Part<a class="anchor" href="#delete-a-part" aria-label="Link to this section">#</a></h2>
<p>Click <strong>Delete...</strong> (or right-click a row > <strong>Delete...</strong>) and confirm. The last Part can't be deleted, and a delete can't be undone.</p>
<h2 id="parts-in-files">Parts in files<a class="anchor" href="#parts-in-files" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Format</th><th>What happens to Parts</th></tr></thead><tbody><tr><td>Project (<code>.sfproj</code>)</td><td>Every Part is saved with its name, visibility, folder, attributes, layers and active layer; <a href="linked-duplicates.html">linked copies</a> keep their link</td></tr><tr><td>OBJ</td><td>Each visible Part is an <code>o</code> object; on import, <code>o</code> objects become Parts and <code>g</code> groups become face groups</td></tr><tr><td>glTF / GLB</td><td>One node and mesh per visible Part, both ways</td></tr><tr><td>FBX</td><td>One model per visible Part (with LODs, an LOD group each), both ways</td></tr><tr><td>USD</td><td>One Mesh prim per visible Part, both ways</td></tr><tr><td>Bridge</td><td>Each visible Part is sent as its own object</td></tr><tr><td>PLY, STL, splat conversion</td><td>The visible Parts are merged into one mesh</td></tr></tbody></table></div>
<p>Opening a multi-object file replaces the scene with one Part per object. See <a href="exporting.html">Exporting</a> for the details of each format.</p>
<h2 id="scripting">Scripting<a class="anchor" href="#scripting" aria-label="Link to this section">#</a></h2>
<p>Every Part action is a command, so you can use them in the <a href="scripting.html">console</a>, scripts, Python and MCP agents. Parts are addressed by <code>index</code> (0 is the top of the list) or <code>name</code>; without either, the active one is used.</p>
<div class="table-wrap"><table><thead><tr><th>Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>part_list</code></td><td>List the Parts</td></tr><tr><td><code>part_select index=1</code></td><td>Make a Part active</td></tr><tr><td><code>part_append type=cube</code></td><td>Add a primitive (<code>sphere</code>, <code>cube</code>, <code>plane</code>); <code>path=</code> adds a file; <code>size=</code> (0.05-2, default 0.35)</td></tr><tr><td><code>part_duplicate</code></td><td>Copy a Part</td></tr><tr><td><code>part_duplicate_linked</code> / <code>part_make_unique</code></td><td>A <a href="linked-duplicates.html">linked copy</a> sharing the mesh / break the link</td></tr><tr><td><code>part_delete name=Helmet</code></td><td>Delete a Part</td></tr><tr><td><code>part_rename to=Body</code></td><td>Rename a Part</td></tr><tr><td><code>part_visibility visible=false</code></td><td>Show or hide (toggles when <code>visible</code> is left out)</td></tr><tr><td><code>part_solo</code> / <code>part_show_all</code></td><td>Solo the active Part / show every Part</td></tr><tr><td><code>part_move direction=up</code></td><td>Move a Part up or down the list</td></tr><tr><td><code>part_folder_new folder=Eyes</code></td><td>Make a folder holding a Part (<code>empty=true</code>: an empty one)</td></tr><tr><td><code>part_set_folder name=EyeL folder=Eyes</code></td><td>Put a Part into a folder (<code>folder=</code> empty: out of its folder)</td></tr><tr><td><code>part_folder_visibility folder=Eyes</code></td><td>Hide or show a folder's Parts (toggles when <code>visible</code> is left out)</td></tr><tr><td><code>part_folder_collapse</code> / <code>part_folder_rename</code> / <code>part_folder_delete</code></td><td>Fold or open, rename, remove a folder (<code>folder=</code>)</td></tr><tr><td><code>transform translate=0,0.1,0 folder=true</code></td><td>Transform the visible Parts in the active Part's folder</td></tr><tr><td><code>part_merge_down</code> / <code>part_merge_visible</code></td><td>Merge</td></tr><tr><td><code>part_split_groups</code> / <code>part_split_parts</code></td><td>Split</td></tr><tr><td><code>part_split_hidden</code> / <code>part_split_masked</code> / <code>part_split_unmasked</code></td><td>Split off into a new Part (undoable; <code>keep=true</code> copies and leaves the source as it is)</td></tr><tr><td><code>part_shading mode=flat</code></td><td>Shade a Part <code>default</code> (as the scene), <code>smooth</code> or <code>flat</code></td></tr><tr><td><code>extract thickness=0.02 smooth=5 double=false</code></td><td>Preview an Extract shell from the mask; <code>triangle_corners</code> / <code>triangle_border</code> for a triangle rim; <code>accept=true</code> keeps it at once</td></tr><tr><td><code>extract_accept</code> / <code>extract_cancel</code></td><td>Keep or remove the Extract preview</td></tr></tbody></table></div>
<div class="code-block"><pre class="code"><code class="language-text">part_append type=sphere name=EyeL size=0.12; part_duplicate; part_rename to=EyeR</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<h2 id="see-also">See also<a class="anchor" href="#see-also" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<a href="linked-duplicates.html">Linked Duplicates</a>: copies that share one mesh
</li>
<li>
<a href="face-groups.html">Face Groups and visibility</a>: hide parts of one Part
</li>
<li>
<a href="layers.html">Sculpt layers and blend shapes</a>: layers belong to each Part
</li>
<li>
<a href="exporting.html">Exporting</a>: how Parts reach other applications
</li>
<li>
<a href="projects.html">Projects, autosave and snapshots</a>
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="selection-sets.html"><span>Previous</span>Selection sets and morph targets</a><a class="next" rel="next" href="linked-duplicates.html"><span>Next</span>Linked Duplicates</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/parts.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="#how-parts-work">How Parts work</a></li><li><a href="#the-parts-list">The Parts list</a></li><li><a href="#add-a-part">Add a Part</a></li><li><a href="#show-hide-and-solo">Show, hide and solo</a></li><li><a href="#folders">Folders</a></li><li><a href="#reorder-parts">Reorder Parts</a></li><li><a href="#merge-parts">Merge Parts</a></li><li><a href="#split-a-part">Split a Part</a></li><li><a href="#extract-a-shell">Extract a shell</a></li><li><a href="#delete-a-part">Delete a Part</a></li><li><a href="#parts-in-files">Parts in files</a></li><li><a href="#scripting">Scripting</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>