OC Generator / Settings
Where this pack's character dice actually live
- settings
- settings_json
OC Generator / Generate Character looks like the star of this pack, but it's a dim-witted button that takes one settings input and does exactly what it's told. Every interesting decision - what kind of characters you want, how much variety, how spicy the accessories get - is made in this node, OC Generator / Settings. Think of it as the pack's control panel: it bundles all your preferences into a single reusable OC_GENERATOR_SETTINGS object that travels down one wire to the generator.
That bundle-in-a-wire design is worth knowing. Instead of dragging a dozen loose values from a settings node into every generator, you get one opaque object - the same "context object" pattern the plumbing layer of ComfyUI leans on heavily. One wire in, one wire out, and any node in the pack that wants to consume or inspect the settings plugs into it. The downside is the usual one for context bundles: the object hides what's inside, which is exactly why the pack also ships a Show Settings node to peek at it.
The inputs that matter
The node has a wall of widgets, but you can group them mentally into four clusters:
- The base:
base_prompt(multiline, this prepends every generated prompt and defaults to the anime tag boilerplatemasterpiece, best quality, 1girl, solo, anime style) andinclude_base_prompt(setfalseto omit it entirely). - The fixed traits:
fixed_hair_style,fixed_hair_color,fixed_eye_color,fixed_accessory,fixed_bust_size. Each is a dropdown with(not fixed)plus a long list of options - 137 hair styles, 33 hair colors, 73 accessories. Leave them(not fixed)to roll that trait randomly, or pin one down to always get e.g.long wavy hair. - The dice weights:
weight_flat,weight_small,weight_medium,weight_large,weight_xlarge, plusaccessory_probability. These are raw 0.00–1.00 values that get normalized internally into a weighted roll. Want a petite-leaning cast? Crankweight_flatandweight_smalland dropweight_xlarge. - The mode:
preset(one ofBalanced,Petite,Curvy,Statement, orUser settingsfor your hand-tuned weights) andproduction_mode(hides entries flaggeddevelopmentOnly).
A useful behavior: if every bust weight is 0, generation falls back to the Balanced distribution instead of erroring - safe, but a sign you zeroed out all your dice. And preset only sets defaults; the weights you dial in on the node always win.
The outputs
settings- theOC_GENERATOR_SETTINGSobject. Feed it toGenerate Character,Generate Character List, orShow Settings.settings_json- the same thing serialized as a JSON string. This is the escape hatch: you can save it, email it to yourself, or paste it into the pack's companion web app. It's also the format theSave Settings JSONandLoad Settings Presetnodes use to persist presets touser_presets/*.json.
Install and gotchas
No dependencies, no model downloads - it's pure stdlib Python reading JSON data files. Via ComfyUI Manager, search comfyui-original-character-generator; or:
cd ComfyUI/custom_nodes
git clone https://github.com/nade-eaf4fc/comfyui-original-character-generator.git
Restart, then find OC Generator / Settings under the OC Generator category. If you edit the JSON data files under data/ to add your own hair styles or presets, restart ComfyUI to reload them.
Two honest warnings. First, the README notes that recent updates have broken existing workflows - if a workflow stops connecting, the fix is usually reconnecting the settings wire, not a reinstall. Second, don't forget production_mode: options you're sure exist will look missing when it's hiding developmentOnly entries. It's true by default; flip it off when you want to test-drive the full catalog.
Inputs (15)
| Name | Type | Default | Description |
|---|---|---|---|
| base_prompt | STRING | — | |
| include_base_prompt | BOOLEAN | true | — |
| preset | COMBO | User settings | 5 options: User settings, Balanced, Petite, Curvy, Statement |
| fixed_hair_style | COMBO | (not fixed) | 137 options: (not fixed), long straight hair, long wavy hair, long curly hair, long flowing hair, long hair with blunt bangs, +131 |
| fixed_hair_color | COMBO | (not fixed) | 33 options: (not fixed), black hair, dark brown hair, brown hair, light brown hair, blonde hair, +27 |
| fixed_eye_color | COMBO | (not fixed) | 33 options: (not fixed), blue eyes, deep blue eyes, light blue eyes, icy blue eyes, green eyes, +27 |
| fixed_accessory | COMBO | (not fixed) | 73 options: (not fixed), small hair ribbon, hair clip, hair pin, flower hairpin, simple headband, +67 |
| fixed_bust_size | COMBO | (not fixed) | 6 options: (not fixed), flat, small, medium, large, xlarge |
| weight_flat | FLOAT | 0.180–1 | — |
| weight_small | FLOAT | 0.280–1 | — |
| weight_medium | FLOAT | 0.260–1 | — |
| weight_large | FLOAT | 0.180–1 | — |
| weight_xlarge | FLOAT | 0.100–1 | — |
| accessory_probability | FLOAT | 0.580–1 | — |
| production_mode | BOOLEAN | true | — |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| settings | OC_GENERATOR_SETTINGS | — |
| settings_json | STRING | — |