Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-RPG-Characters > RPG Character Selector

ComfyUI Node: RPG Character Selector

Class Name

RPGCharacterSelector

Category
RPG
Author
lord-lethris (Account age: 5298days)
Extension
ComfyUI-RPG-Characters
Latest Updated
2026-10-02
Github Stars
0.01K

How to Install ComfyUI-RPG-Characters

Install this extension via the ComfyUI Manager by searching for ComfyUI-RPG-Characters
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-RPG-Characters in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

RPG Character Selector Description

Builds reproducible RPG portrait prompts from character and scene choices, with DNA summaries.

RPG Character Selector:

RPGCharacterSelector builds a descriptive RPG character portrait from a set of character and scene choices. It combines the selected data into text suitable for an image-generation workflow, including a portrait description and a separate list of details to avoid. When a data entry contains alternatives, the node resolves them using a seed and records the choices in a readable character “DNA” summary. It also gives explicit race descriptions priority over conflicting ethnicity descriptions of skin or eyes while retaining the ethnicity label and other nonconflicting traits. This helps you create detailed portraits, repeat a particular combination of traits, and understand which variations contributed to the result.

RPG Character Selector Input Parameters:

race

Required combo selection. Chooses a key from RACE_DATA and contributes that entry’s portrait and avoidance descriptions when present. Its description can also take priority over conflicting skin or eye details in the selected ethnicity entry. The available options are the keys in RACE_DATA; their names, default selection, and complete list are not included in the provided source. Minimum and maximum values do not apply to this menu.

ethnicity

Required combo selection. Chooses a key from ETHNICITY_DATA and contributes its descriptions when present. If the selected race explicitly describes skin or eyes, the node removes conflicting clauses from the ethnicity’s portrait description while retaining its ethnicity label and other nonconflicting details. Available options are the keys in ETHNICITY_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

gender

Required combo selection. Adds the selected GENDER_DATA entry’s portrait and avoidance descriptions when present. Choose the option that matches the character you intend to depict. Available options are the keys in GENDER_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

age

Required combo selection. Adds the selected AGE_DATA entry’s descriptions when present, affecting how the character is described. Available options are the keys in AGE_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

character_class

Required combo selection. Adds descriptions from the selected CLASS_DATA entry, which may help convey the character’s role in the portrait. It appears as “Class” in the selection summary. Available options are the keys in CLASS_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

hair_style

Required combo selection. Adds the selected HAIR_STYLE_DATA entry’s descriptions when present. Available options are the keys in HAIR_STYLE_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

hair_colour

Required combo selection. Adds the selected HAIR_COLOUR_DATA entry’s descriptions when present. Available options are the keys in HAIR_COLOUR_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

beard_style

Required combo selection. Adds the selected BEARD_STYLE_DATA entry’s descriptions when present. The effect of a particular choice depends on its data entry; the provided source does not show those entries. Available options are the keys in BEARD_STYLE_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

beard_colour

Required combo selection. Adds the selected BEARD_COLOUR_DATA entry’s descriptions when present. Available options are the keys in BEARD_COLOUR_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

clothes_style

Required combo selection. Adds the selected CLOTHES_STYLE_DATA entry’s descriptions when present, helping describe the character’s clothing. Available options are the keys in CLOTHES_STYLE_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

Augmentations

Required combo selection, with a capital “A” in its exact input name. Adds the selected AUGMENT_DATA entry’s descriptions when present. The available augmentation choices and their effects depend on the data entries, which are not provided. Options are the keys in AUGMENT_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

emotion

Required combo selection. Adds the selected EMOTION_DATA entry’s descriptions when present, influencing how the portrait is described. Available options are the keys in EMOTION_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

scene

Required combo selection. Adds the selected SCENE_DATA entry’s descriptions when present and appears in the selection summary. For summary labels beginning with “plain” or containing “chroma key” or “solid,” the node describes a solid background with no objects or distractions; this special wording applies to the summary, not as a separate replacement for the data entry’s prompt text. Available options are the keys in SCENE_DATA; their names and default selection are not shown. Minimum and maximum values do not apply.

dna_seed

Required integer. Controls reproducible selection among alternatives written in the data as {A|B|C}. Set a nonnegative value to reuse the same seed with the same selections and DNA state; set -1 to generate a new 32-bit seed when the node executes. Default: -1. Minimum: -1. Maximum: 4294967295. Step: 1. The seed actually used is reported in the summary.

dna_revision

Required integer used to invalidate ComfyUI’s execution cache after DNA Locker interface edits without changing dna_seed. It does not itself select a character trait or appear in the generated description. Default: 0. Minimum: 0. Maximum: 2147483647. Step: 1. Normally, you can leave this at its default unless a connected interface manages revisions.

dna_locks

Optional single-line string containing DNA state as a JSON object. Default: {}. Minimum and maximum values are not specified. The node parses it for compatibility with older workflows and can read an embedded __dna_rerolls object as a fallback when dna_rerolls is empty. Despite the name, the supplied variant resolver does not apply lock values to its choices, so entering a lock here should not be treated as a way to freeze a trait.

dna_weights

Optional single-line string containing a JSON object of custom weights for variant groups. Default: {}. Minimum and maximum values are not specified. Its keys identify individual DNA groups, and each applicable value is a weight mapping for that group. When valid custom weights are supplied, the node can render a weighted combination of options and mark that group “sculpted” in the summary. The exact weighting helper implementations are not provided, so no particular weight syntax beyond the JSON-object structure or normalization behavior should be assumed.

dna_rerolls

Optional single-line string containing a JSON object of reroll state for individual DNA groups. Default: {}. Minimum and maximum values are not specified. For a matching group, state can include a reroll count, a value to avoid, or a previewed choice. A valid preview is used directly; otherwise, reroll state helps determine the choice from the seed. If this input does not provide a usable object, the node can fall back to reroll state embedded in dna_locks.

RPG Character Selector Output Parameters:

positive_prompt

The first string output is the portrait description. It begins with “Create an extreme close-up portrait of” and joins the available positive descriptions for the selected entries. Alternatives in those descriptions are resolved using the DNA state. Use this text where your image-generation workflow expects a positive prompt. A scene contributes here through its data entry’s description when that description is present.

negative_prompt

The second string output joins the selected entries’ available negative_prompt descriptions. It identifies details the data asks the image-generation workflow to avoid; it can be empty when the selected entries provide no negative descriptions. Connect it to a negative-prompt input when your workflow supports one.

Ollama_Generate_V2_Textbox_2

The third string output repeats the assembled portrait description and appends “Include Art Style.” Its name identifies a particular downstream text connection, but the node only produces a string; it does not call Ollama or generate an image by itself. Use it when another node or text workflow needs that additional instruction.

selection_summary

The fourth string output is a readable record of the chosen menu values and the DNA seed actually used. It also reports the specially worded scene label, any race-priority skin or eye overrides, resolved randomized choices, and, when variant groups exist, a per-group DNA record showing their source and selection mode. This is useful for checking a result or recording the settings needed to revisit it.

RPG Character Selector Usage Tips:

  • Set dna_seed to a nonnegative number when you want to revisit a character. A value of -1 creates a new seed on execution; record the seed shown in selection_summary if you want to use it again.
  • Change one character menu choice at a time while refining a portrait. The summary makes it easier to see which selections and resolved alternatives produced the current description.
  • Use positive_prompt and negative_prompt in their corresponding downstream prompt inputs. Choose Ollama_Generate_V2_Textbox_2 when you specifically need the portrait text followed by “Include Art Style.”
  • Check selection_summary after choosing a race and ethnicity with explicit visual traits. Its “Race Priority” line tells you when the node removed conflicting ethnicity skin or eye wording from the portrait description.
  • Leave dna_locks, dna_weights, and dna_rerolls as {} unless you are using a compatible DNA editing workflow or supplying correctly structured JSON state. Do not rely on dna_locks to freeze a choice in this implementation.
  • If you use a plain, solid, or chroma-key scene, check both the prompt and the summary: the summary applies special background wording, while the prompt uses the selected scene’s data description.

RPG Character Selector Common Errors and Solutions:

KeyError: '<selected value>'

  • Explanation: The node looks up each menu selection by its exact key in the corresponding data collection. This error can occur if a saved workflow supplies a value that is no longer in that collection.
  • Solution: Reopen the affected menu and select a currently available option. If the workflow uses older data, update the selection before running it again.

TypeError or ValueError while converting dna_seed

  • Explanation: The function converts dna_seed to an integer. An invalid value supplied outside the normal integer widget can prevent execution.
  • Solution: Enter a whole number from -1 through 4294967295 in the node’s integer input.

Invalid JSON in a DNA state input

  • Explanation: An invalid value in dna_locks, dna_weights, or dna_rerolls does not necessarily produce an error message. The supplied parser treats JSON it cannot read, or JSON that is not an object, as an empty object, so your requested DNA edits may have no effect.
  • Solution: Use a valid JSON object such as {}, and check that the intended DNA changes appear in selection_summary after execution.

A locked DNA choice changes unexpectedly

  • Explanation: In the supplied variant resolver, lock values are retained for compatibility but are not applied to variant selection. A value placed in dna_locks therefore does not guarantee a fixed choice.
  • Solution: Use a fixed dna_seed for repeatability, or use a compatible preview or weighting workflow for the specific variant. Check the reported choice in selection_summary.

A reroll does not produce the expected choice

  • Explanation: Reroll state applies to a specific variant group. If its group identifier no longer matches, or a preview value is not one of that group’s options, the node follows another available selection path.
  • Solution: Regenerate the reroll state from the current DNA interface, run the node again, and inspect the “DNA Loci” entries in selection_summary.

A weighted choice appears as percentages instead of one trait

  • Explanation: When custom weights are active, the resolver renders a weighted description such as option names with percentages and labels the group “sculpted.” This differs from its ordinary single-choice mode.
  • Solution: Clear the applicable custom weight state to return to ordinary selection, or keep the sculpted result if your downstream prompt workflow is intended to use weighted wording.

The portrait contains less ethnicity detail than expected

  • Explanation: If the race description explicitly controls skin or eyes, the node removes conflicting clauses about those traits from the ethnicity portrait description. It retains the ethnicity label and other nonconflicting details.
  • Solution: Check the “Race Priority” line in selection_summary. Choose a different available race or ethnicity combination if the resulting description does not match your intended character.

negative_prompt is empty

  • Explanation: The node only joins negative descriptions present in the selected data entries. An empty result can be valid when those entries provide none.
  • Solution: Check the selected options. If your workflow needs additional exclusions, supply them in an appropriate downstream prompt input.

RPG Character Selector Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-RPG-Characters
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

RPG Character Selector