Skip to content

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.

17.1 KB
Raw Blame
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Export presets - SculptForge User Guide</title>
  <meta name="description" content="Export Maps writes a texture&#x27;s channels (Material painting) as the image files a game engine or DCC expects: which files, what they are called and how channels are packed into them come from an export preset. SculptForge has presets for the common targets, and you can write your own as a small JSON ">
  <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/export-presets.html">
  <meta property="og:type" content="article">
  <meta property="og:title" content="Export presets - SculptForge User Guide">
  <meta property="og:description" content="Export Maps writes a texture&#x27;s channels (Material painting) as the image files a game engine or DCC expects: which files, what they are called and how channels are packed into them come from an export preset. SculptForge has presets for the common targets, and you can write your own as a small JSON ">
  <meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
  <meta property="og:url" content="https://sculptforge.app/guide/export-presets.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="exporting.html" data-next="blender.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">Export presets</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&#x27;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">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" class="current" aria-current="page">Export presets</a><ul class="toc-sections"><li><a href="#export-maps">Export maps</a></li><li><a href="#built-in-presets">Built-in presets</a></li><li><a href="#material-slots-in-model-files">Material slots in model files</a></li><li><a href="#your-own-presets">Your own presets</a></li></ul></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="export-presets">Export presets</h1>
<p><strong>Export Maps</strong> writes a texture&#x27;s channels (<a href="pbr-painting.html">Material painting</a>) as the image files a game engine or DCC expects: which files, what they are called and how channels are packed into them come from an <strong>export preset</strong>. SculptForge has presets for the common targets, and you can write your own as a small JSON file.</p>
<h2 id="export-maps">Export maps<a class="anchor" href="#export-maps" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Open <strong>Tool &gt; Texture Map</strong>. Under <strong>Material Channels</strong>, choose a preset in the list next to <strong>Export Maps...</strong> (hover a preset for what it writes).
</li>
<li>
Click <strong>Export Maps...</strong> and pick a folder. The files are named after the Part.
</li>
</ol>
<p>From a script or the console: <code>export_maps preset=unreal folder=/path/to/maps name=Rock</code>. <code>export_maps list=true</code> lists the presets and their maps.</p>
<p>Channels you haven&#x27;t turned on export their default value (roughness 0.65, metallic 0, flat normal, AO 1), so a preset always writes a complete set. Maps marked optional below are written only when one of their channels is on.</p>
<h2 id="built-in-presets">Built-in presets<a class="anchor" href="#built-in-presets" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th>Preset</th><th>Files (for a Part called Rock)</th><th>Normal</th></tr></thead><tbody><tr><td><code>unreal</code></td><td><code>T_Rock_BC</code> (base colour; opacity in alpha when painted), <code>T_Rock_N</code>, <code>T_Rock_ORM</code> (R occlusion, G roughness, B metallic); optional <code>T_Rock_E</code> (emissive), <code>T_Rock_H</code> (16-bit height)</td><td>DirectX</td></tr><tr><td><code>unity_urp</code></td><td><code>Rock_BaseMap</code>, <code>Rock_Normal</code>, <code>Rock_MetallicSmoothness</code> (R metallic, A smoothness = 1 - roughness); optional <code>Rock_Occlusion</code>, <code>Rock_Emission</code>, <code>Rock_Height</code></td><td>OpenGL</td></tr><tr><td><code>unity_hdrp</code></td><td><code>Rock_BaseMap</code>, <code>Rock_Normal</code>, <code>Rock_MaskMap</code> (R metallic, G occlusion, B detail mask = white, A smoothness); optional <code>Rock_Emission</code>, <code>Rock_Height</code></td><td>OpenGL</td></tr><tr><td><code>gltf</code></td><td><code>Rock_baseColor</code>, <code>Rock_normal</code>, <code>Rock_occlusionRoughnessMetallic</code> (R, G, B as glTF expects); optional <code>Rock_emissive</code></td><td>OpenGL</td></tr><tr><td><code>godot</code></td><td><code>Rock_albedo</code>, <code>Rock_normal</code>, <code>Rock_orm</code>; optional <code>Rock_emission</code>, <code>Rock_height</code></td><td>OpenGL</td></tr><tr><td><code>blender</code></td><td>One file per channel: <code>Rock_BaseColor</code>, <code>Rock_Roughness</code>, <code>Rock_Metallic</code>, <code>Rock_Normal</code>; optional <code>Rock_Height</code> (16-bit), <code>Rock_AO</code>, <code>Rock_Emission</code>, <code>Rock_Alpha</code></td><td>OpenGL</td></tr><tr><td><code>usd</code></td><td>One file per UsdPreviewSurface input: <code>Rock_diffuseColor</code>, <code>Rock_roughness</code>, <code>Rock_metallic</code>, <code>Rock_normal</code>; optional <code>Rock_occlusion</code>, <code>Rock_emissiveColor</code>, <code>Rock_opacity</code>, <code>Rock_displacement</code></td><td>OpenGL</td></tr></tbody></table></div>
<p>All files are PNG at the texture&#x27;s size: 8-bit, except height maps, which are 16-bit greyscale. The normal map is the effective normal: the Normal channel with the height&#x27;s normal combined in. DirectX presets flip green.</p>
<p><strong>Send to Unreal</strong> (<a href="exporting.html#send-to-unreal">Exporting</a>) uses the <code>unreal</code> preset and then builds a material <code>M_&lt;Name&gt;</code> in Unreal from the maps: BC to Base Color, ORM&#x27;s R / G / B to Ambient Occlusion, Roughness and Metallic, N to Normal, E to Emissive. It is an ordinary Unreal material you can edit.</p>
<h2 id="material-slots-in-model-files">Material slots in model files<a class="anchor" href="#material-slots-in-model-files" aria-label="Link to this section">#</a></h2>
<p>You don&#x27;t need Export Maps to get the material into a model file: when the texture has material channels, exporting a model writes the maps beside it (or inside it) and wires them into its material.</p>
<div class="table-wrap"><table><thead><tr><th>Format</th><th>What the material gets</th></tr></thead><tbody><tr><td>glTF / GLB</td><td>Base colour (alpha from opacity, <code>alphaMode</code> BLEND), <code>metallicRoughnessTexture</code> and <code>occlusionTexture</code> from one packed map, <code>normalTexture</code>, <code>emissiveTexture</code></td></tr><tr><td>USD / USDZ</td><td>A UsdPreviewSurface whose <code>roughness</code>, <code>metallic</code>, <code>normal</code>, <code>occlusion</code>, <code>emissiveColor</code> and <code>opacity</code> inputs each read their own map (raw colour space; the normal with scale 2, bias -1)</td></tr><tr><td>OBJ</td><td>The MTL&#x27;s PBR keys: <code>map_Pr</code> (roughness), <code>map_Pm</code> (metallic), <code>norm</code> / <code>map_Bump</code> (normal), <code>map_Ke</code> (emission), <code>map_d</code> (opacity)</td></tr><tr><td>FBX</td><td>Textures on the material&#x27;s NormalMap, ShininessExponent (roughness), ReflectionFactor (metallic), EmissiveColor and TransparencyFactor, as Blender reads them</td></tr></tbody></table></div>
<p>A texture without material channels exports exactly as before: just the colour.</p>
<h2 id="your-own-presets">Your own presets<a class="anchor" href="#your-own-presets" aria-label="Link to this section">#</a></h2>
<p>A preset is a JSON file. Point <code>export_maps preset=</code> at it:</p>
<div class="code-block"><pre class="code"><code class="language-json">{
  &quot;label&quot;: &quot;Studio packed&quot;,
  &quot;file&quot;: &quot;{name}_{map}&quot;,
  &quot;normal&quot;: &quot;directx&quot;,
  &quot;maps&quot;: [
    {&quot;map&quot;: &quot;albedo&quot;, &quot;channels&quot;: [&quot;base_color.r&quot;, &quot;base_color.g&quot;, &quot;base_color.b&quot;, &quot;opacity?&quot;]},
    {&quot;map&quot;: &quot;rma&quot;, &quot;channels&quot;: [&quot;roughness&quot;, &quot;metallic&quot;, &quot;ao&quot;]},
    {&quot;map&quot;: &quot;nrm&quot;, &quot;channels&quot;: [&quot;normal.r&quot;, &quot;normal.g&quot;, &quot;normal.b&quot;]},
    {&quot;map&quot;: &quot;disp&quot;, &quot;channels&quot;: [&quot;height&quot;], &quot;bits&quot;: 16, &quot;optional&quot;: true}
  ]
}</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<ul>
<li>
<strong>file</strong>: the file name pattern; <code>{name}</code> is the object name, <code>{map}</code> the map&#x27;s name (required). <code>.png</code> is added.
</li>
<li>
<strong>normal</strong>: <code>opengl</code> (green up, the default) or <code>directx</code> (green down).
</li>
<li>
<strong>maps</strong>: 1 to 32 maps. Each has a <strong>map</strong> name (letters, digits, <code>-</code> and <code>_</code>) and 1 (grey), 3 (RGB) or 4 (RGBA) <strong>channels</strong>.
</li>
<li>
A channel source is a channel name (<code>roughness</code>, <code>metallic</code>, <code>ao</code>, <code>height</code>, <code>opacity</code>), a component (<code>base_color.r</code>, <code>normal.g</code>, <code>emissive.b</code>), <code>smoothness</code> (1 - roughness), a constant (<code>0</code>, <code>1</code>, <code>0.5</code>) or <code>1-</code> in front of any of them to invert it.
</li>
<li>
A <code>?</code> after a source drops that component when its channel isn&#x27;t on (an RGBA map becomes RGB).
</li>
<li>
<strong>optional</strong>: write the map only when one of its channels is on. <strong>bits</strong>: 8 (default) or 16.
</li>
</ul>
<p>A preset with a mistake is refused with a message saying what is wrong.</p>
      </article>
      <nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="exporting.html"><span>Previous</span>Exporting, Unreal and Bridge</a><a class="next" rel="next" href="blender.html"><span>Next</span>Working with Blender</a></nav>
      <p class="guide-meta fine">Also in the app: <strong>Help &gt; User Guide</strong> (<kbd>Shift</kbd>+<kbd>F1</kbd>).
        Found a mistake? <a href="https://github.com/islandmed/SculptForge/edit/main/docs/guide/export-presets.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="#export-maps">Export maps</a></li><li><a href="#built-in-presets">Built-in presets</a></li><li><a href="#material-slots-in-model-files">Material slots in model files</a></li><li><a href="#your-own-presets">Your own presets</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 &amp; 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>