Nodes/ComfyUI Nox Prompter/Nox Prompt Lighting Master
ComfyUI Node

Nox Prompt Lighting Master

The light setup you can read like a lighting plan

By jamesk9526·Created 11 months ago·Updated 11 months ago· 0
Nox Prompt Lighting Master
    • lighting_prompt
    • mood_notes
    • technical_notes
    • preset_status
    blueprintThree-Point
    key_styleSoftbox Key
    light_sourceDaylight
    light_qualitySoft Light
    time_of_dayDusk
    fill_styleSoft Fill
    backlightRim Strip
    practicalLantern Cluster
    atmosphereHaze
    color_gelTeal & Orange
    camera_settingsNone
    special_techniqueShutter Drag
    energy_levelDynamic
    safety_profileNone
    subject_description
    environment_description
    accent_notes
    intensity_bias0.60
    blueprint_custom
    key_style_custom
    light_source_custom
    light_quality_custom
    time_of_day_custom
    fill_style_custom
    backlight_custom
    practical_custom
    atmosphere_custom
    color_gel_custom
    camera_settings_custom
    special_technique_custom
    energy_level_custom
    safety_profile_custom
    preset_actionnone
    preset_name

    Lighting is where generated images fall apart first - flat light, wrong mood, colors that fight each other. Nox Prompt Lighting Master is the pack's dedicated answer: one node that consolidates light source, quality, time of day, fill, backlight, practicals, atmosphere, and color gel into a single lighting prompt, plus mood notes and technical rigging notes. The README positions it as the "centralized lighting control" companion to the Builder, and the source backs that up - its vocabulary is enormous.

    How it works

    The constants.py dictionary for light sources alone is worth a look: something like fifty options from Daylight and Soft Light up to Aurora Curtain, Arc Welder, and Supernova Remnant, each mapping to a prompt clause and a summary. That's the whole mechanism in miniature - blueprint and key_style (the two required fields) plus the optional dropdowns resolve to curated prompt fragments, which assemble into lighting_prompt. mood_notes gives you the readable version of the look, and technical_notes collects the rigging language (fill, backlight, gels, practicals, special techniques) that you'd hand to a crew but keep out of the encode.

    Two inputs are more interesting than the rest. intensity_bias nudges how strong the lighting reads, and safety_profile carries the pack's habit of safety/comfort guidance into lighting - the constants file even has notes about keeping light intensity softer for all-ages scenes. Every dropdown has a Custom Input option and matching *_custom field.

    Inputs and outputs that matter

    Required: blueprint and key_style. After that, light_source and time_of_day are the two that change a scene the most, so start there. Outputs: lighting_prompt (feed to Nox Prompt Builder's lighting_prompt input or straight to positive conditioning), mood_notes, technical_notes, and preset_status. Save your favorite setups with preset_action/preset_name - lighting looks are the most reusable thing in this pack.

    Installing it

    Pack install, once. ComfyUI Manager: search "Nox Prompter", install, restart. Or:

    cd ComfyUI/custom_nodes
    git clone https://github.com/jamesk9526/NoxPrompter-ComfyUI-CustomNode
    

    Restart, find the NoxPrompter category. Pure Python, no dependencies.

    Gotchas

    The classic pack-level stale README URL applies. Two practical notes: don't dump technical_notes into the encode - that's production documentation, and models don't understand "Kicker Highlights, featured edge accents" as well as they understand the plain lighting_prompt. And if you're building one master prompt by hand, use this node rather than the Builder's built-in lighting dropdowns - the README's whole point is that centralized lighting means one node owns the light so narrative, palette, and camera fragments don't contradict it. Contradiction detection between lighting and time-of-day is something the Pipeline Combiner actually checks for, which tells you the author expects you to keep it consistent.

    CategoryNoxPrompter/Lighting

    Inputs (34)

    NameTypeDefaultDescription
    blueprintCOMBOThree-Point12 options: None, Three-Point, Rembrandt, Split, Clamshell, High Key, +6
    key_styleCOMBOSoftbox Key12 options: None, Softbox Key, Hard Spot, Fresnel, Sunbeam, Lantern, +6
    light_sourceoptCOMBODaylight49 options: None, Daylight, Artificial Light, Moonlight, Practical Light, Firelight, +43
    light_qualityoptCOMBOSoft Light31 options: None, Soft Light, Hard Light, Top Light, Side Light, Backlight, +25
    time_of_dayoptCOMBODusk25 options: None, Daytime, Nighttime, Dusk, Sunset, Dawn, +19
    fill_styleoptCOMBOSoft Fill12 options: None, Negative Fill, Soft Fill, Bounce Wall, RGB Ambient, Prism Scatter, +6
    backlightoptCOMBORim Strip12 options: None, Rim Strip, Hair Light, Halo Arc, Laser Back, Bioluminescent, +6
    practicaloptCOMBOLantern Cluster12 options: None, Lantern Cluster, Holo Billboards, Candle Field, Arc Reactors, Fiber Nebula, +6
    atmosphereoptCOMBOHaze12 options: None, Haze, Fog Bank, Snowfall, Sand Drift, Ash Fall, +6
    color_geloptCOMBOTeal & Orange12 options: None, Teal & Orange, Magenta Cyan, Royal Purple, Emerald, Amber Glow, +6
    camera_settingsoptCOMBONone12 options: None, Cinematic, Noir, Documentary, Hyperreal, Dreamscape, +6
    special_techniqueoptCOMBOShutter Drag12 options: None, Shutter Drag, Light Painting, Projection Mapping, Gobo Patterns, Lens Flares, +6
    energy_leveloptCOMBODynamic12 options: None, Serene, Romantic, Dynamic, Sinister, Triumphant, +6
    safety_profileoptCOMBONone12 options: None, Pyro, Laser, Water, Crowded Set, Strobe, +6
    subject_descriptionoptSTRING
    environment_descriptionoptSTRING
    accent_notesoptSTRING
    intensity_biasoptFLOAT0.600–1
    blueprint_customoptSTRING
    key_style_customoptSTRING
    light_source_customoptSTRING
    light_quality_customoptSTRING
    time_of_day_customoptSTRING
    fill_style_customoptSTRING
    backlight_customoptSTRING
    practical_customoptSTRING
    atmosphere_customoptSTRING
    color_gel_customoptSTRING
    camera_settings_customoptSTRING
    special_technique_customoptSTRING
    energy_level_customoptSTRING
    safety_profile_customoptSTRING
    preset_actionoptCOMBOnone4 options: none, save, load, list
    preset_nameoptSTRING

    Outputs (4)

    NameTypeDescription
    lighting_promptSTRING
    mood_notesSTRING
    technical_notesSTRING
    preset_statusSTRING