Young Tries AI

pixelfx로 픽셀 이펙트 스프라이트 시트 뽑고 색까지 바꾸기

게임 이펙트가 필요한 크리에이터와 개발자를 위한 중급 가이드입니다. pixelfx 이펙트를 스프라이트 시트로 내보내고 색을 바꾸는 과정을 따라 합니다.

영상·이미지대상: 크리에이터, 개발자

시작하기 전에

  • Node.js 설치 (도구를 node로 실행합니다)
  • pixelfx 저장소 로컬 사본 (중국어판 bayshier/pixelfx-zh, 원본 patch-gg/pixelfx)을 열어 둔 터미널
  • 선택: 에이전트로 새 이펙트를 만들 때 쓸 Claude Code 또는 Codex
  1. 라이브 갤러리를 열어 불, 폭발, 마법, 날씨, UI, 아이템 획득, 동물 등 244개 이펙트를 확인하고 쓸 것을 고르세요. 이펙트는 모두 src/fx/<category>/<name>.js 파일이며, 전체 목록은 docs/CATALOG.md에 있습니다.

  2. 저장소 루트에서 render 도구에 category/name 형식의 이펙트 경로를 넣어 실행하세요. 모든 프레임을 격자로 배열한 투명 PNG와 Aseprite 방식 JSON이 만들어집니다. JSON에는 프레임 영역, 지속 시간, 그리고 fps, loop, columns, 피벗이 담긴 meta.pixelfx가 들어 있습니다. Phaser의 atlas 로더와 Godot, Unity용 Aseprite 임포터가 이 JSON을 읽습니다.

    터미널에서 실행
    node tools/render.mjs ice/frost-nova --sheet
  3. 모든 이펙트는 어두운 색에서 밝은 색 순서로 나열한 hex 색상 목록인 팔레트를 받습니다. 아래 명령은 횃불을 푸른 보라색 불꽃의 GIF로 만듭니다.

    터미널에서 실행
    node tools/render.mjs fire/torch --gif --opts '{"palette": ["#102","#215","#43a","#8cf","#cff","#fff"]}'
  4. 모든 이펙트의 스프라이트 시트가 필요하면 sheets 도구를 실행하세요. 결과물은 sheets/ 폴더에 저장됩니다.

    터미널에서 실행
    node tools/sheets.mjs
  5. canvas, Phaser, PixiJS, Kaplay, three.js 게임에는 의존성 없이 이펙트 코드를 그대로 쓸 수 있습니다. GitHub에서 설치하거나 src/core와 필요한 이펙트를 프로젝트로 복사하세요.

    터미널에서 실행
    npm i github:patch-gg/pixelfx
  6. 프로젝트가 따르는 방식은 이렇습니다. 아트 디렉션을 담아 이펙트를 느슨하게 설명하면, 에이전트가 첫 초안 5~10개를 짧은 영상으로 /records 폴더에 렌더링합니다. 하나를 골라 세부를 다듬고, 구상과 맞을 때까지 반복하세요. 에이전트에는 기존 이펙트 몇 개를 참고 자료로 주세요.

    Claude Code·Codex에 붙여넣기
    Using the effects in this pixelfx repo as references, write 5-10 first drafts of a new pixel art effect: <describe your effect and art direction>. Render each as a short video in a /records directory so I can inspect them.

    뜻: pixelfx 저장소의 기존 이펙트를 참고해 새 픽셀 아트 이펙트 초안 5~10개를 쓰고, 각각 /records 폴더에 짧은 영상으로 렌더링해 달라는 요청입니다.

주의할 점

  • 한 번에 완성되길 기대하지 마세요. 제작자는 좋은 픽셀 이펙트에 반복 작업, 움직임과 타이밍의 까다로운 검토, 좋은 참고 자료가 필요하다고 말합니다.
  • node 도구는 저장소 루트에서 실행하세요. 그래야 tools/ 경로를 찾습니다.

자주 묻는 질문

스프라이트 시트는 어떤 엔진에서 쓸 수 있나요?
README는 Godot, Unity, GameMaker, Defold, LÖVE, Bevy를 언급하며 어떤 엔진에서도 쓸 수 있다고 합니다. JSON은 Phaser의 atlas 로더와 Godot, Unity용 Aseprite 임포터가 읽습니다.
이펙트를 상업적으로 써도 되나요?
중국어판 설명에는 MIT 라이선스이며 상업적 사용이 가능하다고 적혀 있습니다.
새 이펙트를 만들려면 유료 서비스가 필요한가요?
제작자에 따르면 필요하지 않습니다. Claude Code나 Codex 같은 최신 코딩 에이전트 외에 추가 도구나 유료 서비스는 필요 없다고 합니다.

출처

바탕이 된 소식