comfyui-game-sd-character-pack

Game SD Character Pack

ComfyUI에서 게임용 SD/치비 캐릭터 에셋을 만들 때 반복되는 프롬프트 조립, 참조 이미지 배치, 캔버스 정규화를 줄여주는 커스텀 노드 팩입니다.

이 노드 팩은 체크포인트, LoRA, IPAdapter, 배경제거 모델을 포함하지 않습니다. 생성과 후처리에 필요한 무거운 모델 처리는 사용자의 기존 ComfyUI 워크플로우에 있는 노드와 모델을 그대로 사용합니다.

제공 노드

Game SD Emotion Prompt

감정 프리셋을 선택해서 positive prompt, negative prompt, 파일명 prefix를 생성합니다.

입력:

• character_name: 파일명에 사용할 캐릭터 이름
• character_core: 머리, 눈, 의상, 장식처럼 유지할 외형 프롬프트
• emotion: 감정 프리셋
• emotion_strength: 감정 프롬프트 가중치
• extra_positive: 추가 positive prompt
• extra_negative: 추가 negative prompt
• filename_prefix: 저장 파일명 앞부분

출력:

• positive
• negative
• filename_prefix
• emotion_tag

권장 연결:

Game SD Emotion Prompt positive -> Efficient Loader positive
Game SD Emotion Prompt negative -> Efficient Loader negative

Game SD Reference Batch

IPAdapter 등에 넣을 참조 이미지를 하나의 batch로 묶습니다.

입력:

• sd_reference: 기본 SD/치비 참조 이미지
• original_reference: 원본 스탠딩 이미지 등 보조 참조
• style_reference: 스타일 보조 참조
• include_original: 원본 참조 포함 여부
• include_style: 스타일 참조 포함 여부

출력:

• reference_images

권장 연결:

Load Image -> Game SD Reference Batch sd_reference
Game SD Reference Batch reference_images -> IPAdapter image

Game SD Asset Finalize

생성된 캐릭터 이미지를 게임 에셋용 캔버스에 맞춰 정렬합니다.

하는 일:

• 알파가 있는 이미지의 투명 영역 기준 크롭
• 지정 캔버스 크기로 배치
• 중앙 정렬
• 하단 기준 정렬
• padding과 bottom margin 적용

하지 않는 일:

• 배경제거
• 흰 배경 투명화
• RMBG, SAM, BiRefNet 같은 외부 모델 호출

배경제거가 필요하면 별도의 RMBG/segmentation 노드를 Game SD Asset Finalize 앞에 직접 연결하세요.

권장 연결:

Generated Image
-> optional background removal node
-> Game SD Asset Finalize image
-> Save Image

설치

이 폴더를 ComfyUI의 custom_nodes 아래에 복사합니다.

ComfyUI/custom_nodes/game_sd_character_pack

그 다음 ComfyUI를 재시작합니다.

노드 검색에서 Game SD를 입력하면 노드가 표시됩니다.

기본 워크플로우 예시

Game SD Emotion Prompt
-> Checkpoint/LoRA Loader
-> IPAdapter
-> KSampler
-> optional FaceDetailer
-> optional background removal
-> Game SD Asset Finalize
-> Save Image

캐릭터 일관성 팁

• 같은 sd_reference 이미지를 계속 사용하세요.
• character_core는 감정마다 바꾸지 않는 것이 좋습니다.
• 체크포인트, LoRA, 해상도, sampler, CFG를 고정하세요.
• 감정 변화는 emotion과 emotion_strength 위주로 조절하세요.
• 포즈와 실루엣까지 고정해야 하면 ControlNet, Lineart, OpenPose 같은 별도 노드를 함께 쓰는 것이 좋습니다.

감정 프리셋

기본 포함 프리셋:

• default
• smile
• laugh
• sad
• crying
• angry
• embarrassed
• surprised
• pouting
• worried
• sleepy

프리셋은 nodes.py의 EMOTION_PRESETS에서 수정하거나 추가할 수 있습니다.

라이선스 및 주의

이 저장소에는 모델 파일, 체크포인트, LoRA, 이미지 에셋을 포함하지 않는 것을 권장합니다.

GitHub에 올릴 때는 다음 파일을 포함하지 마세요.

• 생성 이미지
• 개인 캐릭터 원본 이미지
• 모델 파일: .safetensors, .ckpt, .pt, .pth, .onnx
• ComfyUI 실행 캐시: __pycache__
• 개인 워크플로우나 메타데이터가 들어간 PNG/JSON

이 노드 팩은 ComfyUI와 PyTorch가 이미 설치된 환경에서 동작하는 것을 전제로 합니다.