# Export humans to game engines

> Human Generator for Blender documentation. Web version: https://humgen3d.com/docs/process

> **Early access**
> The process system is new and only in the early access version of Human Generator. It replaces the process tab of version 4.0, which is deprecated. Details can still change; if something doesn't work or looks wrong, [let us know](https://humgen3d.com/feedback/process).

The **Process** tab turns a Human Generator human into a game-ready character file: an FBX or glTF with baked textures, hair cards, a clean skeleton with the bone names Unity, Unreal Engine, Godot or Mixamo expect, and the face as blend shapes. It can also make a frozen, lightweight copy of the human inside your Blender file, for rendering crowds. You pick a *recipe* for the program you use, check the folder and press one button. Everything else, like baking the materials, converting the particle hair to cards and building the skeleton, happens in Blender.

> **HG Export pack missing?**
> The recipes and engine data the Process tab runs on come as a separate content pack, **HG_Export.hgpack**, which is included with your license. Until it is installed, the tab is greyed out and says *HG_Export.hgpack missing*. Getting it takes two steps:
>
> 1. **Download** `HG_Export.hgpack` from your [Superhive account](https://superhivemarket.com/account/orders): log in, go to *Orders* and find it in the downloads of your Human Generator order. The **Download from Superhive** button in the Process tab opens that page. Superhive is the new name of BlenderMarket; if you bought Human Generator there, log in with the same account.
> 2. **Install** it: press **Install HG_Export.hgpack** in the Process tab and pick the file you downloaded.
>
> That's a one-time step. The pack is also listed, and can be removed, under *Content Packs* in the add-on preferences, like the other packs. When an update of Human Generator needs a newer pack, the tab says *HG_Export.hgpack outdated*; download and install it again the same way.

## Quickstart

1. Select your human (click any part of it) and open the **Process** tab at the top of the Human Generator panel.
2. Choose a **Recipe**: *Unity*, *Unreal*, *Godot*, *Mixamo*, *Generic game* or *Blender render copy*. The recipe fills in every option below it.
3. Set the **Folder** at the bottom, for example a folder inside your game project. When left empty, the files go to the `export_results` folder inside your Human Generator content folder.
4. Press **Export to FBX** (the button is named after the output you chose). A progress bar appears in Blender's status bar; press `Esc` to cancel.
   ![process_progress](https://humgen3d.com/docs-media/process_progress.webp)
5. When it's done, a popup tells how many files were written, where, and the triangle count. **Open folder** takes you there.
   ![process_result_popup](https://humgen3d.com/docs-media/process_result_popup.webp)

That is all most people need. The engine pages below list the few things to set on the other side, and the section pages explain the options when you want to change something.

> **Your human stays as it is**
> Processing works on a copy; the human you select is not changed. The result is a **processed copy**: a file on disk, or a copy in your scene that you can delete at any time. Keep editing the original, and process it again whenever you like.

> **Processing a human from Python**
> The whole Process tab is one call. Load a recipe, change what you want, and run it:
> ```python
> from HumGen3D import ExportSettings, Human
> 
> human = Human.from_existing(bpy.context.object)
> settings = ExportSettings.from_recipe("unity")
> settings.output.folder = "/path/to/MyGame/Assets/Characters"
> result = human.process.run(settings)
> print(result.files)
> ```
> See [Processing humans from Python](https://humgen3d.com/docs/process/python-api) for the full tour, and [ProcessSettings](https://humgen3d.com/docs/api/processsettings) and [ExportSettings](https://humgen3d.com/docs/api/exportsettings) for the reference.

## Guides per program

- [Unity](https://humgen3d.com/docs/process/export-to-unity): FBX with a Humanoid skeleton and textures packed for the Standard and URP Lit shaders. The free [Unity Companion](https://humgen3d.com/docs/process/unity-companion) sets the character up on import.
- [Unreal Engine](https://humgen3d.com/docs/process/export-to-unreal-engine): FBX in centimeters with the Mannequin bone names, ORM textures and the `SK_`, `M_`, `T_` prefixes. The [Unreal Engine Companion](https://humgen3d.com/docs/process/unreal-engine-companion) builds the materials.
- [Godot](https://humgen3d.com/docs/process/export-to-godot): One `.glb` with the humanoid skeleton, blend shapes and textures inside. The [Godot Companion](https://humgen3d.com/docs/process/godot-companion) adds the hair shader and bone map.
- [Mixamo](https://humgen3d.com/docs/process/export-to-mixamo): FBX with the Mixamo skeleton, so the animations of the Mixamo library play on your character.
- [Python API](https://humgen3d.com/docs/process/python-api): Process humans from your own scripts, in a batch or from the command line.
- [Recipes](https://humgen3d.com/docs/process/recipes): What the built-in recipes set, and how to save and share recipes of your own.

## The Process tab

![process_tab](https://humgen3d.com/docs-media/process_tab.webp)

1. **Recipe**. The saved state of the whole tab, tuned for one program. Changing any option below marks the recipe as *(modified)*; the two icons next to it reset the changes or save them as a recipe of your own. See [Recipes](https://humgen3d.com/docs/process/recipes).
2. **Output**. What you get: a file format, or *In this file* for a processed copy in your scene. See [Output](https://humgen3d.com/docs/process/output).
3. **LOD levels**. How many levels of detail to make, 1 to 4. Each level is a complete, smaller copy of the character. See [Optimize Meshes](https://humgen3d.com/docs/process/optimize-meshes).
4. **Sections**. Each section is one step of the process. The checkbox in its header turns the step on or off, the grey text on the right summarizes what it is set to. Open a section to change its options.
5. **Name and Folder**. The name of the files and the prefix of every object, material and texture (`{name}` is the name of the human), and where the files go. See [Output](https://humgen3d.com/docs/process/output).
6. **Process button**. Processes every selected human. Above it you see how many humans are selected, below it the checks that found something.

- [Optimize Meshes](https://humgen3d.com/docs/process/optimize-meshes): Reduce the body, clothing, eyes and teeth, remove the skin under clothing, and make LOD levels.
- [Haircards](https://humgen3d.com/docs/process/haircards): Replace the particle hair by textured hair cards, which files can carry.
- [Skeleton](https://humgen3d.com/docs/process/skeleton): Turn the rig into a clean game skeleton with the bone names and rest pose the engine expects.
- [Shape Keys](https://humgen3d.com/docs/process/shape-keys): Choose which shape keys stay as blend shapes, and which are baked in or removed.
- [Bake Textures](https://humgen3d.com/docs/process/bake-textures): Bake the skin, eye, hair and clothing materials to texture maps, packed the way the engine expects.
- [Scripts](https://humgen3d.com/docs/process/scripts): Run your own Python scripts at any point of the process.

> **Checks before it runs**
> The tab checks your settings against the selected human while you work. A **red** line is an error that stops the process, for example a folder that can't be written. A **grey** line with a warning icon is something to be aware of, for example *"The hair is particle hair, which no file format carries"*; the process still runs. The warnings are repeated in the popup afterwards.
> ![process_preflight](https://humgen3d.com/docs-media/process_preflight.webp)

## What happens when you press the button

Each selected human is processed one after the other, with the same settings. For every LOD level the add-on makes a fresh copy of the human and runs the sections on it:

1. **Shape keys**: The face rig, expressions and sliders are kept, baked into the mesh or removed
2. **Hair cards**: The particle hair becomes textured cards with a haircap
3. **Eyes and teeth**: The layered eyes become game eyes, the teeth are reduced
4. **Bake textures**: Every material is baked to image maps and replaced by a simple material
5. **Optimize meshes**: The body and clothing are reduced, the skin under clothing removed
6. **Skeleton**: Control bones, constraints and drivers go, the bones are renamed, a root bone is added
7. **Names**: Objects, materials and textures get their final names
8. **Write**: The levels are joined under one skeleton and the file is written

The copy is removed again afterwards, unless the output is *In this file* or you asked to keep it.

> **How long does it take?**
> Texture baking is the slow part: every material is baked pass by pass. A human with an outfit, a hairstyle and a beard takes about one and a half minutes at the default 2k textures on an Apple M1 Max, one minute at 1k and three minutes at 4k; more LOD levels add less, as the levels share most textures. Lower the resolution in [Bake Textures](https://humgen3d.com/docs/process/bake-textures) for quick test exports, and raise it again for the final one.

## Several humans at once

Select more than one human and the button changes to *Export 3 humans to FBX*. Each human gets its own files, named after it, in the same folder. Open the *humans selected* list above the button to see which ones are included.

## Processed copies in your file

With the *In this file* output (the *Blender render copy* recipe) the result stays in your scene, two meters behind the original, in a collection called *Processing Results*. A processed copy is frozen: the Human Generator panel doesn't edit it, but shows buttons to jump to the original, process it again, or load the settings it was made with. See [Output › Processed copies](https://humgen3d.com/docs/process/output#processed-copies).

![process_processed_human](https://humgen3d.com/docs-media/process_processed_human.webp)

> **Before you start**
> - The Process tab needs the **HG_Export** content pack, see [HG Export pack missing?](https://humgen3d.com/docs/process#hg-export-pack-missing). It is not available in the **trial version**.
> - **Humans made before version 4** can't be processed.
> - **Rigify** humans can't get a game skeleton. The skeleton section is skipped and their Rigify rig is exported as it is; the other sections run.
> - Human Generator needs **Blender 4.0 or newer**; the process system is tested with Blender 5.1.
>
> More in [Known Limitations](https://humgen3d.com/docs/process/known-limitations).

## Frequently asked questions

### Can Human Generator export characters to Unity, Unreal Engine and Godot?

Yes. The Process tab has a recipe for each: an FBX with a Humanoid skeleton for Unity, an FBX with the Mannequin bone names for Unreal Engine and a glTF with a humanoid skeleton for Godot, each with the textures packed the way that engine's shaders read them. Free, open source Companion plugins for the three engines set the character up on import. Any other program that reads FBX, glTF, OBJ or Alembic works with the *Generic game* recipe.

### Does the hair export?

Particle hair can't be stored in any file format, so the [Haircards](https://humgen3d.com/docs/process/haircards) section converts every hairstyle, beard, eyebrows and eyelashes to textured hair cards generated from the strands, with a haircap on the scalp. The cards are skinned to the head and come with baked color, alpha, normal and flow maps.

### Is the exported character rigged and animatable?

Yes. The character has a plain deforming skeleton with a root bone, in a T-pose or A-pose, named for the engine, so Unity's Humanoid avatar, Godot's humanoid bone map and Unreal's IK Retargeter map it without manual work, and Mixamo animations play on the Mixamo export directly. The face rig and the 1-click expressions are exported as blend shapes, which face capture tools and animation clips drive.

### Can I use exported characters in a commercial game?

With the commercial licence of Human Generator you can ship exported characters in commercial games and software, as long as players can't take the character out and reuse it. See [Output › Licence of exported characters](https://humgen3d.com/docs/process/output#licence-of-exported-characters).

### Does processing change my human?

No. The process runs on a copy and the original keeps its procedural skin, particle hair and full rig. Process it again whenever you change it.

## Reference

- [Recipe Format](https://humgen3d.com/docs/process/recipe-format): every option of a recipe file.
- [Known Limitations](https://humgen3d.com/docs/process/known-limitations): what the process system can't do yet.
- [Troubleshooting](https://humgen3d.com/docs/process/troubleshooting): the red lines in the tab, missing recipes, and Companions that do nothing.