Communitygithub.com

block-town

아이디어 하나로 Roblox 스타일 3D 마을에서 '이 마을에서 / 이 세상에서' 형식의 세로 규칙 스토리 영화를 제작합니다. 규칙, 대본, 특색 있는 나레이터 목소리, 코드로 제작된 월드와 캐릭터, Three.js 렌더링, 생동감 레이어, 폰 화면, 소품, 가라오케 자막, ElevenLabs 또는 스톡 효과음까지 완성된 1080×1920 MP4를 만듭니다.

block-town란 무엇인가요?

Block-town은 사용자가 '이 마을에서' 또는 '이 세상에서' 같은 Roblox 스타일의 세로 스토리 영상을 만들고 싶을 때, 아이디어 하나만으로 완성된 MP4 파일을 생성하는 AI 에이전트 스킬입니다. Blender와 Three.js를 결합하여 3D 마을과 캐릭터를 코드로 제작하고, 어안 카메라 움직임, 생동감 레이어(호흡, 시선 이동), 가라오케 자막, ElevenLabs 효과음, 안정적인 음성 믹스까지 모두 자동화합니다. 이 스킬은 총 7단계 게이트(규칙, 대본, 음성, 디자인, 스틸샷, 후크, 전체 영상)로 구성되며, 각 단계마다 사용자에게 결과를 보여주고 승인을 받습니다. 모든 에셋은 라이선스 프리로 코드 기반 제작되며, 유료 API 호출(음성, 효과음) 전에는 비용을 먼저 알리고 사용자의 동의를 구합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chihabMe/block-town/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Block town

이 폴더는 이 키트의 전부입니다: 마을, 출연진, 움직임, 렌더러, 음성, 사운드, 음악 설정, 그리고 아이디어에서 완성된 세로 영상에 이르는 모든 단계. 스킬 폴더는 이 파일이 들어 있는 디렉토리이며, 아래에서는 SKILL이라고 부릅니다. 에피소드는 그 밖에 (사용자가 폴더 이름을 지어) 있으며, 아래에서는 EPISODE라고 부릅니다. 절대 경로를 사용하세요.

제작 전에 읽어야 할 문서: docs/ROBLOX_LOOK.md (월드, 출연진, 소품, 촬영 방법), docs/RENDER.md (Three.js 렌더러, 생동감 레이어, 태그, 폰 화면 및 인쇄 소품), docs/SCRIPT.md (스토리 작성법), docs/VOICE.md (음성 및 음악), docs/SOUND.md (사운드 효과, ElevenLabs, 안정적인 음성 믹스). docs/PROMPTS.md에는 각 단계별 프롬프트가 있습니다. docs/GUIDE.md는 원래 블록 룩 매뉴얼입니다: 지도, pose(), 움직임 및 카메라 규칙은 여전히 적용됩니다.

영상 제작 방법 (ep05부터)

Blender가 에피소드의 Python 코드로 모든 것을 빌드하고 포즈를 취합니다; Three.js가 최종 프레임을 그립니다. Blender 자체 렌더러는 디자인 시트와 셔츠 스틸샷에만 사용합니다.

episode.py ──(Blender: 마을 제작, 모든 프레임 포즈, 생동감 레이어)──> bake: scene.glb + anim.bin + materials.json
           ──(headless Chrome의 Three.js)──> EPISODE/frames/f_####.jpg  (~0.1-0.15 초/프레임)
           ──(finish.py: 자막, 레벨링된 음성, 사운드 효과, 음악)──> EPISODE/<name>.mp4 및 <name>_music.mp4

66초 분량의 에피소드가 프레임에서 완성 MP4까지 약 10-12분이 걸립니다 (Blender EEVEE는 약 3시간 걸렸습니다).

절대 금지

  • Roblox 카탈로그 아이템, 다운로드한 모델, 영상, 다른 제작자의 스토리나 오디오는 사용하지 않습니다. 화면의 모든 것은 코드로 제작되거나 blockworld/pictures.py로 그려집니다. 바이럴 영상은 제작 기법 연구용으로만 참고할 수 있으며, 절대 재사용하지 않습니다.
  • 사용자의 동의 없이 유료 API 호출을 하지 않습니다. Fish Audio (음성)와 ElevenLabs (사운드 효과)는 비용이 듭니다: 실행 전에 비용을 먼저 알립니다. sfx_gen.py는 남은 크레딧을 확인하고 예비분 이전에 중단합니다. 예비분을 늘리거나

관련 스킬