letsgal-ai — AI 기반 LetsGal Studio 창작 툴체인

LetsGal Studio 프로젝트 포맷을 처음부터 리버스 엔지니어링하여, AI가 직접 창작할 수 있는 도구로 만듭니다: 한 줄 스토리 DSL → 완전한 실행 가능한 프로젝트(챕터/캐릭터/씬/분기/연출), CLI와 MCP 이중 채널, 제로 의존성.

• 포맷 참조(공식 템플릿 + 1.11.0 설치 패키지에서 리버스 엔지니어링): docs/letsgal-format.md

• 스토리 DSL 명세: docs/STORY-DSL.md

왜

LetsGal Studio는 데스크톱 GUI 편집기이며(MCP 없음, CLI 없음), 그 모든 것은 디스크에 있는 일반 JSON입니다. 이 프로젝트는 그 포맷을 완전히 프로그램화합니다:

• AI 시나리오 생성 → 한 줄 명령으로 프로젝트 컴파일 → Studio에서 열기만 하면 바로 플레이(연출/에셋은 더 다듬을 수 있음)

• 포맷이 공식과 완전히 일치(project.json / characters.json / scenes.json / chapters/*.json / assets/.manifest.json), Studio에서 열 때 오류 없음, 자동 수복·캐릭터 표정 합성·에셋 교체가 자연스러움

빠른 시작

# 安装（无需依赖，直接 clone 或 npm link）
npm link                    # 或 node bin/letsgal-ai.js …

# 1. 初始化工程骨架
letsgal-ai init my-game --name "时间的河流"

# 2. 写故事（见 examples/example.dsl）→ 编译
letsgal-ai build story.dsl -o my-game --name "时间的河流"

# 3. 校验
letsgal-ai validate my-game

# 4. 用 LetsGal Studio 打开 my-game → 播放

MCP(AI Agent 직접 호출)

letsgal-ai mcp     # stdio JSON-RPC 2.0，零依赖实现

제공하는 도구:

모든 MCP 클라이언트(Claude Code / DSH / 자체 개발)는 node bin/letsgal-ai.js mcp를 설정하면 됩니다.

CLI

letsgal-ai init <dir> [--name 标题]
letsgal-ai build <story.dsl> -o <dir> [--name 标题]
letsgal-ai validate <dir>
letsgal-ai list <dir>
letsgal-ai mcp

라이브러리로 사용

import { compileStory, initProject, validateProject, applyCharacterFlow, dialogue, narration, scene } from '@lilyco-42/letsgal-ai';

개발

npm test        # 冒烟测试：init → build → validate → MCP 握手

라이선스 및 감사의 글

• 이 도구는 MIT 라이선스이며, 에셋을 포함하지 않습니다. 생성된 프로젝트는 LetsGal Studio 공식 템플릿 에셋(엔진과 함께 제공)을 바로 사용할 수 있습니다.

• 리버스 엔지니어링 근거: LetsGal Studio 1.11.0(Windows) 설치 패키지 + 공식 템플릿 프로젝트

Roadmap

• 주변 / [ ] Ren'Py 스타일 코드 ↔ Block 양방향 변환(공식 코드 에디터 문법에 맞춤)

• 헤드리스 빌드(공식 build-worker 재사용해 web 버전 생성)

• lilyco(Rust) 네이티브 컴포넌트: lilyco-letsgal(docs/lyco-integration.md 참고)