ComfyUI Node

OC Generator / Settings

Where this pack's character dice actually live

By nade-eaf4fc·Created 5 months ago·Updated 4 months ago· 1
OC Generator / Settings
    • settings
    • settings_json
    base_prompt
    include_base_prompttrue
    presetUser settings
    fixed_hair_style(not fixed)
    fixed_hair_color(not fixed)
    fixed_eye_color(not fixed)
    fixed_accessory(not fixed)
    fixed_bust_size(not fixed)
    weight_flat0.18
    weight_small0.28
    weight_medium0.26
    weight_large0.18
    weight_xlarge0.10
    accessory_probability0.58
    production_modetrue

    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 boilerplate masterpiece, best quality, 1girl, solo, anime style) and include_base_prompt (set false to 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, plus accessory_probability. These are raw 0.00–1.00 values that get normalized internally into a weighted roll. Want a petite-leaning cast? Crank weight_flat and weight_small and drop weight_xlarge.
    • The mode: preset (one of Balanced, Petite, Curvy, Statement, or User settings for your hand-tuned weights) and production_mode (hides entries flagged developmentOnly).

    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 - the OC_GENERATOR_SETTINGS object. Feed it to Generate Character, Generate Character List, or Show 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 the Save Settings JSON and Load Settings Preset nodes use to persist presets to user_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.

    CategoryOC Generator

    Inputs (15)

    NameTypeDefaultDescription
    base_promptSTRING
    include_base_promptBOOLEANtrue
    presetCOMBOUser settings5 options: User settings, Balanced, Petite, Curvy, Statement
    fixed_hair_styleCOMBO(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_colorCOMBO(not fixed)33 options: (not fixed), black hair, dark brown hair, brown hair, light brown hair, blonde hair, +27
    fixed_eye_colorCOMBO(not fixed)33 options: (not fixed), blue eyes, deep blue eyes, light blue eyes, icy blue eyes, green eyes, +27
    fixed_accessoryCOMBO(not fixed)73 options: (not fixed), small hair ribbon, hair clip, hair pin, flower hairpin, simple headband, +67
    fixed_bust_sizeCOMBO(not fixed)6 options: (not fixed), flat, small, medium, large, xlarge
    weight_flatFLOAT0.180–1
    weight_smallFLOAT0.280–1
    weight_mediumFLOAT0.260–1
    weight_largeFLOAT0.180–1
    weight_xlargeFLOAT0.100–1
    accessory_probabilityFLOAT0.580–1
    production_modeBOOLEANtrue

    Outputs (2)

    NameTypeDescription
    settingsOC_GENERATOR_SETTINGS
    settings_jsonSTRING