patch-gg/pixelfx
244개 픽셀 아트 이펙트 라이브러리, Claude Code 스킬로 직접 만들기
원제 patch-gg/pixelfx
스타 5,947JavaScript
Key Point
게임 개발자라면 직접 이펙트를 만드는 노가다 없이 즉시 써먹을 244개 효과를 얻고, AI 스킬로 원하는 연출을 직접 생성할 수 있는 실용적 도구다.
핵심 요약
- pixelfx는 불, 폭발, 마법, 날씨, UI, 픽업 등 244개의 픽셀 아트 이펙트와 애니메이션을 담은 라이브러리다.
- 모든 이펙트는 작은 코드 조각이며, 브라우저에서 재생·색칠·미러링하거나 게임 엔진으로 내보낼 수 있다.
- 캐릭터가 등장하는 61개 이펙트와 12개 무브는 '액팅' 시스템으로 작동한다: 캐릭터가 준비 동작을 한 후 공격을 날리고, 대상이 충격을 받으며, 회복 동작까지 연결된다.
- draw(p, t, o) 함수로 임의 시점의 프레임을 계산하는 순수 이펙트와, create(o)로 파티클·파편·조명을 120Hz로 시뮬레이션하는 시뮬 이펙트 두 종류가 있다.
- 색상 버퍼와 가산 합성 조명 버퍼를 분리하여, 불타는 이펙트가 광채로 뜨겁게 보이도록 구현했다.
- 모든 난수가 이펙트의 시드로부터 생성되므로 특정 프레임은 매번 동일하며, 로컬 좌표계에서 그려진 후 배치·미러·회전된다.
- 24×38 픽셀의 3D 스켈레톤 더미 캐릭터(Dead Cells 스타일)가 상태 이펙트, 오라, 타격 이펙트 테스트 용으로 쓰인다.
- npm이나 수동 복사로 설치하며, sprite sheet로 내보내 Godot·Unity·GameMaker 등 모든 엔진에서 사용 가능하다.
- Claude Code 플러그인 스킬로 '이펙트 추가', '여러 버전 생성 및 평가', '스프라이트 시트 내보내기', '효과 조정' 같은 작업을 자연어로 지시할 수 있다.
- 도구로 효과를 생성하고 렌더링한 후 contact sheet를 보며 개선하는 라운드를 반복하며, GIF나 MP4로 모션을 확인할 수 있다.
- 문서 AUTHORING.md에서 그리기 API와 품질 기준을 확인할 수 있고, serve.mjs로 로컬 갤러리에서 직접 만든 이펙트를 확인할 수 있다.
- MIT 라이선스이며 상업 이용도 가능하고, Hugo Duprez의 Sprite Fusion 방법론을 기반으로 하며 그의 오픈소스 이펙트 코드를 일부 사용했다.
저장소 보기 ↗github.com