PXLtools — Tool guide

MU Bridge — Maya → Unreal bridge

Select one or more transforms in Maya, pick an output folder and an asset name, and click EXPORT SELECTED. MU Bridge writes a .fbx plus a .pxlbridge.json sidecar that carries texture colour space tags (ACEScg pipeline) and normal-map convention data for the Unreal Engine side to pick up on import.

Maya v0.2.0 Prototype
MU Bridge interface preview

The interface

01

Overview

Early prototype — under active development. MU Bridge v0.2.0-alpha is an early prototype. The UI shown here may change. The Unreal Engine side (which reads the .pxlbridge.json sidecar) is a separate, still-incomplete component. Do not rely on this tool for production work without testing your pipeline end-to-end.

MU Bridge is a Maya → Unreal Engine 5 asset bridge. It walks the selected transforms, exports an FBX, and writes a .pxlbridge.json sidecar alongside it. The sidecar carries texture colour space tags for the ACEScg pipeline and normal-map convention data so the Unreal Engine import side knows how to handle them without manual intervention.

The current version (v0.2.0-alpha) covers Maya-side export only. It shares the same UI kit as the rest of PXLtools.

02

Requirements

  • Autodesk Maya 2025
  • Python 3.11 (included with Maya 2025)
  • Meshes carrying aiStandardSurface materials

Maya 2025 already includes PySide6. You do not install it, you do not pip anything, you do not touch your Python environment.

The Unreal Engine receiver component (which reads .pxlbridge.json) is a separate, still-incomplete part of this pipeline and is not covered in this guide.

03

Availability

MU Bridge is part of Cristian's PXLtools production toolkit and isn't publicly downloadable yet. The TurnTable tool is the first public PXLtools release; the rest of the suite is rolling out gradually. Want early access, or to be notified when it ships? Get in touch.

04

Using MU Bridge

Select your transforms, set the output folder and asset name, and export.

MU Bridge interface: INSTRUCTIONS section collapsed at top, OUTPUT FOLDER section with a path field and Select Folder button, ASSET NAME section with a name field and hint about invalid characters, and a large EXPORT SELECTED button with a Show Last Report button alongside it
MU Bridge — the full interface

INSTRUCTIONS

The collapsible INSTRUCTIONS section at the top of the tool lists the full export steps verbatim from the tool itself. Expand it for a quick reference at any time.

OUTPUT FOLDER

Press Select Folder and pick the destination directory. Both the .fbx and the .pxlbridge.json sidecar are written here, named after the asset name you set below.

ASSET NAME

Type the asset name (no extension) in the field. The tool creates <name>.fbx and <name>.pxlbridge.json. Characters that are invalid in filenames (< > : " / \ | ? *) are rejected at export time with a clear error message.

  1. Select transforms in Maya. Pick one or more transforms whose meshes carry aiStandardSurface materials.
  2. Choose an output folder. Press Select Folder and pick the destination. The path appears in the field.
  3. Set an asset name. Type a name without extension — e.g. hero_prop_A — which becomes hero_prop_A.fbx and hero_prop_A.pxlbridge.json.
  4. Export. Click EXPORT SELECTED. An export report dialog opens showing warnings and any dropped Arnold attributes (subsurface, coat, transmission, sheen are not mapped in v0.1). The Show Last Report button re-opens it.

Tip: Texture colour spaces are tagged for ACEScg automatically. Review the export report for any attributes that could not be mapped — these are listed per object in the report dialog.

05

Troubleshooting

"X Pick an output folder first."

Press Select Folder and choose a destination before clicking EXPORT SELECTED.

"X Enter an asset name." / "X Asset name contains invalid characters."

The asset name field cannot be empty, and characters < > : " / \ | ? * are not permitted in filenames. Enter a plain name such as hero_prop_A and try again.

Nothing is selected in Maya when I click Export.

Select one or more transforms in Maya before running the export. The tool exports the meshes under the selected transforms.

The Unreal Engine side does not pick up the sidecar.

The Unreal Engine receiver component is a separate, still-incomplete part of the MU Bridge pipeline and is not yet available. The Maya-side export (FBX + .pxlbridge.json) is complete; watch for a future update covering the Unreal side.