Turn layered PSDs into editable Live2D models — automatic rigging, mesh/deformer generation, physics, animation, and .cmo3/ .moc3 export.

PSD2Live – 오픈소스 2D 캐릭터 리깅 및 애니메이션 스위트

기능 개요 (쉬운 언어로)

레이어가 있는 Photoshop 파일(PSD)을 애니메이션 2D 캐릭터로 변환 – 도구가 레이어 계층을 읽고 메시를 만들고 본, 물리 및 기본 모션 세트(대기, 깜빡임, 끄덕임, 머리카락 흔들림 등)를 생성합니다.
이 모든 작업은 데스크톱 편집기에서 이루어지며 메시를 미세 조정하고, 본을 편집하고, 페인트하고, 물리를 설정하고, 타임라인에서 애니메이션을 만들 수 있습니다.
만족하면 프로젝트를 내보낼 수 있습니다:
- Live2D Cubism 파일(.moc3/.cmo3) – Cubism Editor, VTube Studio, 게임 등에서 사용.
- 오픈소스 Rust 런타임(p2lrt) – C/C++, .NET, Unity, Godot, Android에서 호출하거나 WebAssembly를 통해 브라우저에서 직접 실행.
- 비디오 또는 이미지 시퀀스, Spine/DragonBones/glTF(실험적), 일반 PSD 스냅샷.

대상 사용자

사용자 유형	PSD2Live가 제공하는 것
완전 초보자	PSD 레이어의 명명 규칙을 따르고 가져오기 → 사전 설정을 클릭하면 몇 분 안에 대기, 깜빡임, 끄덕임 및 머리카락 물리를 갖춘 캐릭터가 완성됩니다 – VTube Studio 또는 웹 페이지에 바로 사용 가능.
AI 지원 워크플로 팬	로컬 MCP 서비스는 AI 에이전트(Claude, Codex 등)가 프로젝트를 읽거나 수정하기 위해 호출할 수 있는 180개 이상의 명령을 노출하며 전체 실행 취소 기록을 제공합니다.
경험 많은 리거	자동 메시, 본 체인, 얼굴 매개변수 및 물리가 생성된 후 수동으로 편집할 수 있습니다. 모든 편집은 재생 가능한 명령으로 저장되므로 재생성 시 작업이 손실되지 않습니다.
오픈소스 전용 사용자	편집기와 Rust 런타임 모두 GPL-3.0 / MIT 라이선스이며 편집 또는 미리보기에 Live2D의 독점 SDK에 의존하지 않습니다.
Cubism 이상의 기능이 필요한 사용자	내장 2D 천 및 머리카락 시뮬레이션, IK, 자동 골격 생성 – 내보낼 때 Cubism 호환 파일에 베이크됩니다.
자체 앱에 통합	`p2lrt` 런타임(C ABI, .NET, Android, WebAssembly, Godot 4 노드)을 사용하여 내보낸 `.p2lrt` 모델을 직접 로드합니다.

주요 구성 요소

모듈	주요 기능
자동 생성	중국어/영어/일본어/한국어 레이어 이름을 감지하고 적응형 메시, 머리-몸 변형 체인, 얼굴 매개변수, 기본 동작, 머리카락/천 물리를 생성합니다.
캔버스 편집기	7가지 상호 작용 모드(선택, 변형, 편집, 시뮬레이션, 본, 페인트, 미리보기). 도구에는 워프/회전 브러시, 메시 토폴로지 편집, 레이어 분할/병합, 접착이 포함됩니다.
골격 및 시뮬레이션	FK/IK가 있는 자동 생성 골격, XPBD 천 및 머리카락 시뮬레이션. 내보낼 때 모두 네이티브 Cubism 구조로 베이크됩니다.
애니메이션 및 물리	타임라인, 키프레임, 곡선, 시각적 진자 편집기. 평가는 Cubism Native Framework와 일치합니다.
텍스처 처리	텍스처 아틀라스 패킹, 레이어별 밀도, 선택적 2×/4× 업스케일링.
컴파일 및 내보내기	하나의 중립 IR이 모든 대상으로 컴파일됩니다. 손실 보고서는 무엇을 베이크하거나 버려야 했는지 보여줍니다.
p2lrt 런타임	오픈소스 Rust 엔진: C ABI, 소프트웨어 렌더러, WebAssembly 플레이어, Godot 4 노드, .NET/Android 바인딩. 편집기와 동일한 포즈별 평가를 보장합니다.
에이전트(MCP) 서비스	로컬 HTTP 서비스(`http://127.0.0.1:23871/mcp`)는 에이전트가 작업 공간을 쿼리하고 작업을 나열하고 원자적 편집을 적용할 수 있는 풍부한 API를 노출합니다.

Live2D Cubism과의 호환성

의존성 없음 – 편집기는 Cubism SDK 없이 작동합니다.
호환성 수준:
1. 무손실 – Cubism이 이미 지원하는 기능(메시, 매개변수, 물리, 동작).
2. 베이크 – Cubism에 없는 기능(IK, 천 시뮬레이션, 스윙 생성)은 키셰이프 또는 매개변수로 베이크됩니다.
3. 런타임 전용 – 향후 기능(동적 조명, 스타일화된 렌더링)은 오픈소스 런타임만 사용할 수 있습니다.
내보낸 .moc3/.cmo3 파일에는 베이크된 데이터가 포함되어 결과 모델이 Cubism Editor, VTube Studio 등에서 작동합니다.

빠른 시작 (빠른 단계)

가져오기 PSD를 파일 → 가져오기 → PSD에서 (또는 드래그 앤 드롭)로 가져옵니다. 사전 설정(최소 / 기본 / 전체)을 선택하고 필요에 따라 그리드를 공유하는 레이어를 분할합니다.
확인 표에서 자동 감지된 레이어 유형을 확인하고 오류를 수정합니다.
미리보기 생성된 동작과 물리를 미리 봅니다. 다른 작업 공간으로 전환하여 메시, 본, 애니메이션 또는 텍스처를 미세 조정합니다.
저장 프로젝트를 .psd2live로 저장합니다(원본 PSD, 설정 및 전체 편집 기록 캡처).
내보내기 Ctrl+G로 Cubism(.moc3/.cmo3)에 내보내거나 파일 → 다른 이름으로 내보내기로 다른 형식(Web, Godot, 비디오 등)으로 내보냅니다.

플랫폼 및 설치

Windows 10/11(x64 및 ARM64) – 휴대용 ZIP 또는 설치 프로그램. Java 런타임 및 선택적 ffmpeg 번들.
Linux(x86_64 및 arm64) – .deb 또는 tar.gz. X11/GLX 필요(XWayland 작동). macOS용 네이티브 패키지는 아직 없음 – JDK 21을 설치한 후 소스에서 실행.
런타임 – 최신 Rust 툴체인이 있으면 Rust p2lrt 라이브러리가 자동으로 빌드됩니다. 그렇지 않으면 사전 빌드된 바이너리가 다운로드됩니다.

소스에서 빌드

# GUI 실행 (Gradle wrapper)
./gradlew run
# CLI: PSD에서 직접 모델 생성
./gradlew run --args="--input examples/tml/psd-input/tml.psd --output build/example-output"
# 다른 형식으로 내보내기 (예: GIF)
./gradlew run --args="export model.psd2live --target gif --set clip=Nod"
# 테스트 및 패키징
./gradlew test
./gradlew packageDistributionForCurrentOS

JDK 21 필요. Rust는 선택 사항이지만 네이티브 런타임을 빌드하려면 필요합니다.

라이선스

애플리케이션 및 Cubism 관련 내보내기 코드 – GPL-3.0.
중립 IR, 컴파일 프레임워크 및 Rust 런타임 – MIT. 독립적으로 재사용할 수 있습니다.

PSD2Live는 독립 프로젝트이며 Live2D Inc.와 제휴하지 않습니다.

tsunehimatoi/psd2live