major-ai-skills/skills/zbrush/gpt.md

Installable agentic skills / AI agent skills (SKILL.md) for Claude Code, Cursor, Codex CLI, Gemini CLI & Antigravity - 402+ professional app, token-efficiency, and common-sense skills. SEO/GEO ready.

---

title: "Maxon ZBrush AI Skill Guide (GPT & Codex)"
description: "Comprehensive operational skill specification for OpenAI GPT and Codex to automate, script, troubleshoot, and optimize Maxon ZBrush pipelines, ZScript macros, Multi-Map Exporter, and GoZ bridges."
category: "Digital Sculpting & High-Poly Modeling"
tags: ["zbrush", "zscript", "multi-map-exporter", "goz", "gpt-codex", "3d-pipeline"]
---


# Maxon ZBrush AI Skill Guide (GPT & Codex)

## Overview & Engine Architecture
Maxon ZBrush is the definitive digital sculpting software for visual effects, game asset creation, and 3D concept design. GPT/Codex acts as a Principal Tools Developer and Pipeline TD, delivering **ZScript macros and plugins**, **Multi-Map Exporter (MME) configuration generators**, **automated SubTool processing scripts**, and **GoZ inter-application bridge handlers**.

### Pipeline Architecture & Tooling Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 ZBrush Pipeline Architecture                │
│                                                             │
│  Sculpting Engine                                           │
│  ├── Multi-Resolution Mesh Representation (SDiv 1..7)       │
│  ├── DynaMesh & Sculptris Pro Adaptive Geometry Modifiers   │
│  └── Decimation Master (Edge-Collapse Polygon Reduction)    │
│                                                             │
│  Pipeline & Bridge Framework                                │
│  ├── ZScript Command Syntax (`[IPress]`, `[ISet]`, `[Loop]`)│
│  ├── Multi-Map Exporter (Batch 32-bit EXR & Normal Maps)    │
│  └── GoZ Object Interchange Specification (Binary File I/O) │
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **ZScript Plugin & Button Development**: Develop automated ZScript utilities (`.txt` source compiled to `.zsc`), configuring UI menus, button triggers, variable arrays, and loop iterations across SubTools.
2. **Multi-Map Exporter (MME) Automation**: Configure automated texture baking for displacement, normal, ambient occlusion, cavity, and vector displacement maps across multiple UV tiles (UDIMs).
3. **Decimation Master Batch Processing**: Author batch decimation routines to pre-process, calculate, and export lightweight mesh proxies with preserved PolyGroups and UV coordinates.
4. **GoZ Bridge Configuration**: Remediate GoZ configuration files, fixing broken application paths and resolving socket connection errors between ZBrush and Maya/Blender/C4D.

---


## Production ZScript Automation: Multi-Map Exporter UDIM Batch Baker

Execute this ZScript macro to configure and launch Multi-Map Exporter for 32-bit Displacement and Tangent Normal maps across all UDIM tiles:

```zscript
// ZScript: Multi-Map Exporter UDIM Batch Configuration
[IButton, "ZPlugin:Pipeline:BakeUDIMMaps", "Configures and exports 4K 32-bit Displacement and Normal maps",
    [IFreeze,
        // 1. Enable Displacement and Normal Map Exports in MME
        [ISet, "ZPlugin:Multi Map Exporter:Displacement", 1]
        [ISet, "ZPlugin:Multi Map Exporter:Normal", 1]
        [ISet, "ZPlugin:Multi Map Exporter:Vector Displacement", 0]
        [ISet, "ZPlugin:Multi Map Exporter:Ambient Occlusion", 0]
        
        // 2. Set Map Resolution to 4096 (4K)
        [ISet, "ZPlugin:Multi Map Exporter:Map size", 4096]
        
        // 3. Configure Displacement: 32-bit Floating Point, Smooth UVs, SubDiv Level 1
        [ISet, "ZPlugin:Multi Map Exporter:SubPix", 2]
        [ISet, "ZPlugin:Multi Map Exporter:SmoothUV", 1]
        [ISet, "ZPlugin:Multi Map Exporter:3Channel", 0]
        [ISet, "ZPlugin:Multi Map Exporter:32Bit", 1]
        
        // 4. Configure Normal Map: Tangent Space, Flip Green Channel (DirectX/Unreal standard)
        [ISet, "ZPlugin:Multi Map Exporter:Tangent", 1]
        [ISet, "ZPlugin:Multi Map Exporter:FlipG", 1]
        
        // 5. Trigger Multi-Map Export
        [FileNameSetNext, "C:/Bakes/Hero_Asset"]
        [IPress, "ZPlugin:Multi Map Exporter:Create All Maps"]
    ]
    [Note, "Multi-Map Exporter UDIM baking process triggered successfully!", , 2]
]
```

---


## Technical Troubleshooting Matrix

| Issue & Failure Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **`ZScript Error: Command not recognized: [XYZ]`** | Syntax error in ZScript macro (e.g. missing brackets, unquoted string paths, or misspelled API name). | 1. Check matching brackets `[` and `]` across all commands.<br>2. Verify exact case-sensitive path using *Preferences $\rightarrow$ Custom UI $\rightarrow$ Ctrl+Alt Click* on target UI button to view path. |
| **Multi-Map Exporter Skips Certain UDIM Tiles** | UV coordinates contain faces outside the 0-1 or standard UDIM coordinate bounding box. | 1. In 3D DCC, verify UV islands are snapped cleanly within UDIM tile bounds (`1001`, `1002`, etc.).<br>2. Check for overlapping zero-area UV polygons using *Tool $\rightarrow$ UV Map $\rightarrow$ Morph UV*. |
| **Decimation Master Out-of-Memory Crash** | Pre-processing dense 80M polygon mesh exceeded system RAM buffer. | 1. Split tool into 2-4 SubTools before running pre-processing.<br>2. In *Preferences $\rightarrow$ Mem*, increase **Compact Mem** allocation to 80% of physical RAM.<br>3. Enable *Pre-process Current* instead of *Pre-process All*. |
| **SubTool Renaming Fails via ZScript** | SubTool rename command invoked while renaming prompt dialog was already active. | Use `[IPress, "Tool:SubTool:Rename"]` followed immediately by `[FileNameSetNext, "NewName"]` to pass name directly without blocking GUI prompt. |

---


## Command Line Syntax & Batch Processing

```bash
# Windows CLI: Launch ZBrush with Initial Model
"C:\Program Files\Maxon ZBrush 2025\ZBrush.exe" "C:\Models\Base_Mesh.zpr"

# Auto-compile and execute ZScript
"C:\Program Files\Maxon ZBrush 2025\ZBrush.exe" "C:\Scripts\BakeUDIMMaps.txt"
```

### Essential File Locations
- **Windows ZScript Plugins**: `C:\Program Files\Maxon ZBrush 2025\ZStartup\ZPlugs64`
- **Windows User Hotkeys**: `%APPDATA%\Maxon\ZBrush 2025\ZStartup\CustomUserHotkeys.txt`
- **Windows User UI Config**: `%APPDATA%\Maxon\ZBrush 2025\ZStartup\CustomUserInterface.cfg`
- **macOS User Preferences**: `~/Library/Application Support/Maxon/ZBrush 2025`

---


## Agent Operational Directive
> **MANDATORY**: When authoring ZScript macros, verify all UI paths against ZBrush button definitions and wrap execution in `[IFreeze, ...]` to avoid UI redraw bottlenecks. Always use Multi-Map Exporter (MME) for multi-tile UDIM displacement extractions.