Nodes/2D Character pose transform/Pose Batch From Library
ComfyUI Node

Pose Batch From Library

Many Skeletons, Zero Fuss

By Spit8·Created 2 months ago·Updated 2 months ago· 1
Pose Batch From Library
    • skeletons
    • labels
    pose_namesidle,walk_01,walk_02,attack
    width1024
    height1024

    Sometimes you don't want the full 14-pose RPG set - you want your three poses: idle, walk_01, and attack. CP_PoseBatchFromLibrary is the lightweight cousin of CP_GenerateRPGSheet that loads exactly the library poses you name, as a batch of skeleton images plus labels.

    It's one of those "it's literally a wrapper" nodes: under the hood it calls the same generator that powers GenerateRPGSheet, so the two behave identically except for defaults and intent. This one defaults to a small custom list (idle,walk_01,walk_02,attack), where the sheet generator defaults to the curated RPG sequence.

    How it works

    Feed it a comma-separated list of pose names (newlines are also accepted, conveniently). Each name is resolved against the pack's built-in poses/ directory, scaled to your width/height, and drawn as an OpenPose skeleton. Missing files become labeled placeholder frames - <name>(missing) - so the batch count stays stable and you can spot the gap at a glance.

    The inputs that matter

    • pose_names - the only interesting one. Comma- or newline-separated, default idle,walk_01,walk_02,attack. The library has walk_01..04, run_01..04, idle (plus _se/_ne/_side variants), jump (plus _se/_ne), fight_se/ne_01/02, work_se/ne_01/02, and the legacy attack, death, hurt.
    • width / height - canvas size, 1024 square default.

    Outputs: skeletons (an IMAGE batch, one per pose, in your listed order) and labels (pose names, newline-joined). Wire the batch into a render loop, a preview, or CP_ExportSpriteSheet for a quick sheet.

    Installing

    Part of Spit8/_ComfyUI_CharacterPose:

    cd ComfyUI/custom_nodes
    git clone https://github.com/Spit8/_ComfyUI_CharacterPose
    pip install -r _ComfyUI_CharacterPose/requirements.txt
    

    Restart ComfyUI; it's under CharacterPose/Sheet.

    Gotchas

    • Labels come back as one newline-joined string, not a list - split on \n if you need them individually.
    • Pose names are matched by file stem, so walk_01 and walk_01.pose both work; walk-01 won't. Typos produce placeholder frames, not errors, so check your labels.
    • If you just want a single pose as a POSE object (not a batch of images), use CP_PoseLibraryLoad instead - that one hands you the actual pose object rather than a drawn skeleton.

    Same job as the RPG sheet node, fewer poses, fewer decisions. When you know exactly which three poses you need, this is the clean route.

    CategoryCharacterPose/Sheet

    Inputs (3)

    NameTypeDefaultDescription
    pose_namesSTRINGidle,walk_01,walk_02,attack
    widthINT102464–4096
    heightINT102464–4096

    Outputs (2)

    NameTypeDescription
    skeletonsIMAGE
    labelsSTRING