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>Working with Maya - SculptForge User Guide</title>
<meta name="description" content="Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the SculptForge shelf for Maya sends the selected meshes to SculptForge, and File > Maya > Send to Maya sends them back, replacing each Maya object's mesh by name. It works through files in a shared folder, on Linux, Windows ">
<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/maya.html">
<meta property="og:type" content="article">
<meta property="og:title" content="Working with Maya - SculptForge User Guide">
<meta property="og:description" content="Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the SculptForge shelf for Maya sends the selected meshes to SculptForge, and File > Maya > Send to Maya sends them back, replacing each Maya object's mesh by name. It works through files in a shared folder, on Linux, Windows ">
<meta property="og:image" content="https://sculptforge.app/img/social-preview.png?v=5">
<meta property="og:url" content="https://sculptforge.app/guide/maya.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="blender.html" data-next="projects.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">Working with Maya</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">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" class="current" aria-current="page">Working with Maya</a><ul class="toc-sections"><li><a href="#install-the-shelf-in-maya">Install the shelf in Maya</a></li><li><a href="#choose-the-exchange-folder">Choose the exchange folder</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#live">Live</a></li><li><a href="#live-link">Live link</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#the-exchange-folder">The exchange folder</a></li><li><a href="#troubleshooting">Troubleshooting</a></li></ul></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="working-with-maya">Working with Maya</h1>
<p>Keep Maya for the scene, rigging and animation, and sculpt in SculptForge: the <strong>SculptForge shelf</strong> for Maya sends the selected meshes to SculptForge, and <strong>File > Maya > Send to Maya</strong> sends them back, replacing each Maya object's mesh by name. It works through files in a shared folder, on Linux, Windows and macOS.</p>
<p>The two apps exchange files through <strong>one folder that you choose in both</strong>, and nothing else: SculptForge opens no ports or connections for this, reads and writes only inside that folder, and never runs anything it finds there. The bridge is off until you choose the folder. <strong>Live</strong> keeps the two in step by themselves, still through the folder; the opt-in <strong><a href="#live-link">Live link</a></strong> lets Maya follow a stroke while you draw it.</p>
<h2 id="install-the-shelf-in-maya">Install the shelf in Maya<a class="anchor" href="#install-the-shelf-in-maya" aria-label="Link to this section">#</a></h2>
<ol>
<li>
Download <code>sculptforge_maya.zip</code> from the <a href="https://github.com/islandmed/SculptForge/releases/latest/download/sculptforge_maya.zip" rel="noopener">latest release</a> and unzip it.
</li>
<li>
Copy <code>sculptforge_maya.py</code> into your Maya scripts folder: <code>Documents\maya\scripts\</code> on Windows, <code>~/Library/Preferences/Autodesk/maya/scripts/</code> on macOS, <code>~/maya/scripts/</code> on Linux.
</li>
<li>
In Maya open the <strong>Script Editor</strong>, and in a <strong>Python</strong> tab run <code>import sculptforge_maya</code> and then <code>sculptforge_maya.install_shelf()</code>. A <strong>SculptForge</strong> shelf appears with <strong>Send</strong>, <strong>Get</strong>, <strong>Auto</strong>, <strong>Live</strong>, <strong>Link</strong> and <strong>Folder</strong>. (Updating from an older shelf: copy the new file and run <code>install_shelf()</code> again.)
</li>
</ol>
<p>The script uses plain <code>maya.cmds</code>, Maya's own OBJ exporter and, for Live, <code>maya.api.OpenMaya</code> (all from your own Maya: nothing of Maya's ships with SculptForge); it needs Maya 2022 or newer.</p>
<h2 id="choose-the-exchange-folder">Choose the exchange folder<a class="anchor" href="#choose-the-exchange-folder" aria-label="Link to this section">#</a></h2>
<ol>
<li>
In SculptForge choose <strong>File > Maya > Exchange folder...</strong> and pick a folder of your own, for example an empty <code>Documents/SculptForge Maya</code>.
</li>
<li>
In Maya click <strong>Folder</strong> on the SculptForge shelf and pick the same folder.
</li>
</ol>
<p><strong>File > Maya</strong> shows the folder; <strong>Turn the Maya bridge off</strong> forgets it (nothing in it is deleted). While the bridge is on, the top bar has a <strong>Send to Maya</strong> button.</p>
<h2 id="a-round-trip">A round trip<a class="anchor" href="#a-round-trip" aria-label="Link to this section">#</a></h2>
<ol>
<li>
In Maya select one or more meshes and click <strong>Send</strong> on the SculptForge shelf.
</li>
<li>
SculptForge loads them by itself. Each mesh becomes a Part with its Maya name; a Part with that name already there is replaced (one undo step on that Part).
</li>
<li>
Sculpt, paint, divide, remesh: anything SculptForge does.
</li>
<li>
Click <strong>Send to Maya</strong> in the top bar (or <strong>File > Maya > Send to Maya</strong>). Every visible Part goes.
</li>
<li>
Maya loads them by itself. Each object that came from Maya gets the new mesh and keeps its transform, parent and shading groups; a Part you added in SculptForge becomes a new object. The whole Get is one undo step in Maya.
</li>
</ol>
<p>Both sides pick up a send by checking the other side's manifest every 250 ms (its modification time and size only), and only for sends made after the bridge started: something sent earlier waits for a manual Get.</p>
<ul>
<li>
In SculptForge, <strong>File > Maya > Get automatically</strong> is on once you choose the folder; turn it off to load only with <strong>Get from Maya</strong>.
</li>
<li>
In Maya, <strong>Auto</strong> on the shelf is on by default and starts with the first Send, Get or Folder click in a Maya session; click it to switch to <strong>Manual</strong>, where only <strong>Get</strong> loads.
</li>
</ul>
<h2 id="live">Live<a class="anchor" href="#live" aria-label="Link to this section">#</a></h2>
<p>With <strong>Live</strong> on, you don't click Send at all: each app sends what you change by itself, and the other loads it.</p>
<ul>
<li>
In SculptForge, turn on <strong>File > Maya > Live</strong>. After each stroke (once you pause for 300 ms, never in the middle of one), the Parts that stroke, an undo or any other edit changed go to the folder. Parts you didn't touch stay put, so a big scene with one Part being sculpted sends only that Part. The files are written in the background while you keep sculpting.
</li>
<li>
In Maya, click <strong>Live</strong> on the shelf (it turns <strong>Auto</strong> on too). The meshes you sent or got, and the ones selected when you turned it on, are watched; 300 ms after you stop editing one, it goes to SculptForge.
</li>
</ul>
<p>Neither app sends back what it just loaded: a Get is never an edit to send, each manifest says which app session wrote it, and SculptForge skips an object that comes back exactly as it went out (no extra undo step). Live is off until you turn it on, on each side, and stays as you left it.</p>
<h2 id="live-link">Live link<a class="anchor" href="#live-link" aria-label="Link to this section">#</a></h2>
<p>The <strong>Live link</strong> goes further: Maya follows your stroke while you draw it. It's a connection between the two apps on this computer, so it is <strong>off until you turn it on, asks first every time, and is off again whenever SculptForge starts</strong>.</p>
<ol>
<li>
In SculptForge choose <strong>File > Maya > Live link...</strong>. A warning explains what it opens:
</li>
</ol>
<aside class="callout callout-note"><p><strong>It opens a connection on this computer.</strong> Anything running on this computer that knows the pairing code could send meshes into SculptForge. It carries meshes only: never commands, files or scripts. Other computers and web pages can't reach it. Turn it off when you're not using it: click "Live link on" in the top bar. It is off again every time SculptForge starts.</p></aside>
<p>Click <strong>Turn on</strong>. An ember <strong>Live link on</strong> chip appears in the top bar.</p>
<ol start="2">
<li>
Choose <strong>File > Maya > Copy pairing code</strong>.
</li>
<li>
In Maya click <strong>Link</strong> on the SculptForge shelf, paste, and click <strong>Link</strong>. The button says <strong>Linked</strong>, and SculptForge sends Maya every visible Part, so both start from the same mesh.
</li>
</ol>
<p>Now sculpt: about ten times a second, the vertices your stroke moves appear in Maya. When a stroke changes the faces (dynamic topology, remesh, divide), the whole Part goes when the stroke ends. Edit a mesh in Maya and SculptForge gets it as soon as you pause (one undo step there). Updates that arrive in Maya over the link aren't Maya undo steps: undo in SculptForge, and Maya follows.</p>
<p><strong>To turn it off</strong>, click <strong>Live link on</strong> in SculptForge's top bar (or <strong>File > Maya > Turn the Live link off</strong>), or click <strong>Linked</strong> in Maya. Quitting SculptForge turns it off too.</p>
<p>How it is kept safe:</p>
<ul>
<li>
<strong>No network port.</strong> It is a Unix domain socket in a folder only you can open (Linux, macOS) or a named pipe only your Windows account can open, remote clients refused. Web pages, other people on the machine and other computers can't reach it.
</li>
<li>
<strong>A pairing code</strong> (128 random bits, new each time you turn it on) must open every connection; one Maya at a time.
</li>
<li>
<strong>Meshes only.</strong> Object names, vertices, faces and UVs, checked strictly on arrival (sizes, ranges, finite numbers, Maya names). Nothing that arrives is run, and it never names a file.
</li>
<li>
Studios can forbid it with <code>"maya": {"link": "never"}</code> in the <a href="studios.html">studio policy</a>.
</li>
</ul>
<h2 id="what-comes-across">What comes across<a class="anchor" href="#what-comes-across" aria-label="Link to this section">#</a></h2>
<div class="table-wrap"><table><thead><tr><th></th><th>Maya</th><th>SculptForge</th></tr></thead><tbody><tr><td>Shape</td><td>The mesh, in world space</td><td>The Part, as placed in Maya's scene</td></tr><tr><td>Faces</td><td>Quads and triangles; n-gons as triangles</td><td>Triangles and quads (Wire shows the quads)</td></tr><tr><td>UVs</td><td>The current UV set</td><td>UVs</td></tr><tr><td>Name</td><td>The transform's name</td><td>Part name</td></tr><tr><td>Units</td><td>Maya's linear unit (cm by default)</td><td>Taken as they are: 1 cm in Maya is 1 unit here</td></tr></tbody></table></div>
<p>Face Groups, the mask and vertex paint stay in SculptForge. Normals, creases, construction history, deformers and skinning stay in Maya: <strong>Get</strong> replaces the mesh shape, so send a copy of a skinned or deformed mesh. A Part named "Body Hi" arrives in Maya as <code>Body_Hi</code> (Maya names allow letters, digits and <code>_</code>), and comes back to the same Part.</p>
<h2 id="the-exchange-folder">The exchange folder<a class="anchor" href="#the-exchange-folder" aria-label="Link to this section">#</a></h2>
<div class="code-block"><pre class="code"><code><folder>/maya_to_sculptforge/manifest.json + r<revision>_<k>.obj written by Maya
<folder>/sculptforge_to_maya/manifest.json + r<revision>_<k>.obj written by SculptForge</code></pre><button class="copy" type="button" aria-label="Copy">Copy</button></div>
<p>Each manifest is a small JSON file: <code>{"format": "sculptforge-maya", "version": 1, "revision": 3, "sender": "maya", "unit": "cm", "objects": [{"name": "pCube1", "file": "r3_000.obj"}]}</code>. Both sides check it strictly before reading anything: at most 256 KiB and 256 objects, every field of the right type, and each file must be a plain <code>.obj</code> name in the manifest's own folder (no folders, no <code>..</code>, no absolute paths, no links). Each send removes the files of the previous one; anything else in the folder is left alone.</p>
<p>The commands are <code>maya_send folder=<folder></code> and <code>maya_receive folder=<folder></code> (see <a href="scripting.html">Scripting and automation</a>).</p>
<h2 id="troubleshooting">Troubleshooting<a class="anchor" href="#troubleshooting" aria-label="Link to this section">#</a></h2>
<ul>
<li>
<strong>"Nothing has been sent from Maya yet"</strong>: check that both apps use the same folder (open <strong>File > Maya</strong> in SculptForge; click <strong>Folder</strong> in Maya to see or change it).
</li>
<li>
<strong>Get in Maya says nothing has been sent</strong>: choose <strong>File > Maya > Send to Maya</strong> in SculptForge first.
</li>
<li>
<strong>Maya doesn't load a send by itself</strong>: Auto starts with the first click on the shelf in a Maya session; click <strong>Get</strong> once (or <strong>Send</strong>), and check that the button says <strong>Auto</strong>, not <strong>Manual</strong>.
</li>
<li>
<strong>Live doesn't send from Maya</strong>: Live watches the meshes you sent or got and the ones selected when you turned it on; send a new mesh once with <strong>Send</strong>, and it is watched from then on.
</li>
<li>
<strong>Link says SculptForge refused the pairing code</strong>: the code is new each time the Live link is turned on; copy it again (<strong>File > Maya > Copy pairing code</strong>).
</li>
<li>
<strong>Link says SculptForge isn't offering it</strong>: turn on <strong>File > Maya > Live link...</strong> in SculptForge first (it is off at every start).
</li>
<li>
<strong>A mesh came in as a new object instead of replacing one</strong>: Get matches the transform's name; renaming the object in Maya or the Part's Maya name breaks the link.
</li>
</ul>
</article>
<nav class="pager" aria-label="Previous and next chapter"><a class="prev" rel="prev" href="blender.html"><span>Previous</span>Working with Blender</a><a class="next" rel="next" href="projects.html"><span>Next</span>Projects, autosave and snapshots</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/maya.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="#install-the-shelf-in-maya">Install the shelf in Maya</a></li><li><a href="#choose-the-exchange-folder">Choose the exchange folder</a></li><li><a href="#a-round-trip">A round trip</a></li><li><a href="#live">Live</a></li><li><a href="#live-link">Live link</a></li><li><a href="#what-comes-across">What comes across</a></li><li><a href="#the-exchange-folder">The exchange folder</a></li><li><a href="#troubleshooting">Troubleshooting</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>