# nitroxnova/humanizer architecture

> Architecture diagram of the GitHub repository nitroxnova/humanizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nitroxnova/humanizer
- Repository: https://github.com/nitroxnova/humanizer

## Overview

Humanizer is a Godot 4.3 plugin for creating 3D characters. The tree shows authoring, character construction, asset customization, and rigging/animation subsystems; the README does not describe their runtime call sequence. With no source excerpts, the graph avoids inferred component-to-component flows and includes only the documented user-facing relationship.

Main entry points: [`addons/humanizer/plugin.gd`](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/plugin.gd) (Editor Plugin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring"]
  node_plugin["Editor Plugin<br/>[plugin.gd]"]
  node_api["Humanizer API<br/>[API.gd]"]
  node_config["Human Configuration<br/>[human_config.gd]"]
end

subgraph group_character["Character Modeling"]
  node_body["Body Service<br/>[body.gd]"]
  node_morphs["Morph System<br/>[morphs.gd]"]
  node_mesh["Mesh Service<br/>[mesh.gd]"]
  node_human_mesh["Human Mesh Instance"]
end

subgraph group_customization["Customization"]
  node_target["Target Service<br/>[target.gd]"]
  node_target_data["Target Data<br/>[target_data.gd]"]
  node_overlay["Overlay System<br/>[overlay.gd]"]
  node_overlay_stack["Overlay Stack<br/>[stack.gd]"]
  node_material["Material Service<br/>[material.gd]"]
  node_equipment["Equipment Service<br/>[equipment.gd]"]
  node_mhclo["Equipment Definition<br/>[mhclo.gd]"]
end

subgraph group_rigging["Rigging and Animation"]
  node_rig["Rig Service<br/>[rig.gd]"]
  node_skeleton["Physical Skeleton"]
  node_live["Live Humanizer<br/>[live_humanizer.gd]"]
  node_facial["Facial Mocap<br/>[facial_mocap.gd]"]
  node_animation["Animation Assets"]
end

subgraph group_runtime["Runtime Utilities"]
  node_job_queue["Job Queue<br/>[job_queue.gd]"]
  node_registry["Resource Registry<br/>[registry.gd]"]
end

node_creator(("Godot User"))

node_creator -->|"uses"| node_plugin

click node_plugin "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/plugin.gd"
click node_api "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/API.gd"
click node_config "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/human_config.gd"
click node_body "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/body.gd"
click node_morphs "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/morphs.gd"
click node_mesh "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/mesh.gd"
click node_human_mesh "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/humanizer_mesh_instance.gd"
click node_target "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/target.gd"
click node_target_data "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/target_data.gd"
click node_overlay "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/overlay/overlay.gd"
click node_overlay_stack "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/overlay/stack.gd"
click node_material "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/material.gd"
click node_equipment "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/equipment.gd"
click node_mhclo "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/mhclo.gd"
click node_rig "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/rig.gd"
click node_skeleton "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/physical_skeleton.gd"
click node_live "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/live_humanizer.gd"
click node_facial "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/facial_mocap.gd"
click node_animation "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/data/animations/animation_tree.tscn"
click node_job_queue "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/job_queue.gd"
click node_registry "https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/registry.gd"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_api,node_config,node_creator toneBlue
class node_body,node_morphs,node_mesh,node_human_mesh toneAmber
class node_target,node_target_data,node_overlay,node_overlay_stack,node_material,node_equipment,node_mhclo toneMint
class node_rig,node_skeleton,node_live,node_facial,node_animation toneRose
class node_job_queue,node_registry toneIndigo
```

## Components

### Authoring

- [Editor Plugin](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/plugin.gd): `addons/humanizer/plugin.gd`
- [Humanizer API](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/API.gd): `addons/humanizer/scripts/services/API.gd`
- [Human Configuration](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/human_config.gd): `addons/humanizer/scripts/resources/human_config.gd`

### Character Modeling

- [Body Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/body.gd): `addons/humanizer/scripts/services/body.gd`
- [Morph System](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/morphs.gd): `addons/humanizer/scripts/core/morphs.gd`
- [Mesh Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/mesh.gd): `addons/humanizer/scripts/services/mesh.gd`
- [Human Mesh Instance](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/humanizer_mesh_instance.gd): `addons/humanizer/scripts/core/humanizer_mesh_instance.gd`

### Customization

- [Target Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/target.gd): `addons/humanizer/scripts/services/target.gd`
- [Target Data](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/target_data.gd): `addons/humanizer/scripts/resources/target_data.gd`
- [Overlay System](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/overlay/overlay.gd): `addons/humanizer/scripts/overlay/overlay.gd`
- [Overlay Stack](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/overlay/stack.gd): `addons/humanizer/scripts/overlay/stack.gd`
- [Material Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/material.gd): `addons/humanizer/scripts/services/material.gd`
- [Equipment Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/equipment.gd): `addons/humanizer/scripts/services/equipment.gd`
- [Equipment Definition](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/resources/mhclo.gd): `addons/humanizer/scripts/resources/mhclo.gd`

### Rigging and Animation

- [Rig Service](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/rig.gd): `addons/humanizer/scripts/services/rig.gd`
- [Physical Skeleton](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/physical_skeleton.gd): `addons/humanizer/scripts/core/physical_skeleton.gd`
- [Live Humanizer](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/live_humanizer.gd): `addons/humanizer/scripts/core/live_humanizer.gd`
- [Facial Mocap](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/core/facial_mocap.gd): `addons/humanizer/scripts/core/facial_mocap.gd`
- [Animation Assets](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/data/animations/animation_tree.tscn): `addons/humanizer/data/animations/animation_tree.tscn`

### Runtime Utilities

- [Job Queue](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/job_queue.gd): `addons/humanizer/scripts/services/job_queue.gd`
- [Resource Registry](https://github.com/nitroxnova/humanizer/blob/master/addons/humanizer/scripts/services/registry.gd): `addons/humanizer/scripts/services/registry.gd`

### Other components

- **Godot User**

## Connections

- Godot User → Editor Plugin: uses (evidence: `README.md`)
