pixelfx 공개 — 이미지 없이 코드로 그리는 픽셀 아트 효과 244개와 Claude Code 스킬

2026년 11월 1일 · GitHub · ax-trend #3704

pixelfx 타이틀카드 — 이미지 없이 JavaScript 코드로 그리는 픽셀 아트 효과 244개

게임 효과를 만들 때는 보통 이미지 에셋을 먼저 준비합니다. patch-gg의 pixelfx는 순서를 뒤집은 라이브러리입니다. 이미지 파일 대신 작은 JavaScript 코드가 효과를 그리고, 개발자는 팔레트와 타이밍을 바꿔 자기 게임에 맞게 다듬습니다.

규모는 공개 직후부터 빠르게 커졌습니다. 효과는 244개이고, 저장소는 2026년 10월 30일에 만들어졌으며 라이선스는 MIT입니다. 확인 시점 기준 스타는 2,395개입니다. Trendar는 하루 약 1,315개 증가로 추정했지만, 이 수치는 GitHub 공식 집계가 아니라 스냅샷 비교 추정치입니다.

효과를 이미지가 아니라 코드로 두면 색을 바꿔 재활용하기 쉽고, 변경 이력을 diff로 관리할 수 있다는 점이 이 라이브러리의 핵심입니다.

이미지 파일 없는 효과 구조

효과마다 이미지 파일이 아니라 JavaScript 파일 1개가 들어 있습니다. 경로는 src/fx/<category>/<name>.js 형식입니다. README 첫 줄은 이 구조를 “244 pixel art effects and animations, every one a small piece of code”로 설명합니다.

출발점은 Hugo Duprez가 공개한 글입니다. 픽셀 아트 효과를 Claude로 만드는 방법과 오픈소스 효과가 먼저 나왔고, pixelfx는 이를 라이브러리 규모로 키운 버전으로 README에 적혀 있습니다. 효과 개수는 공개 직후 232개에서 244개로 늘었습니다.

아래 몽타주는 코드로 그린 효과의 실제 모습입니다. 불꽃과 폭포, 소용돌이와 포털처럼 게임에서 자주 쓰는 연출이 한 화면에 모여 있습니다.

pixelfx 효과 몽타주 — 불, 물, 소용돌이 등 코드로 그린 픽셀 아트 효과 모음
pixelfx 효과 몽타주 — 불·물·소용돌이 등 코드로 그린 픽셀 아트 효과 모음 (사진: GitHub patch-gg/pixelfx)

카테고리와 연기 데이터 구성

카테고리는 21개입니다. README 카탈로그 표에는 moves 12개, projectiles 13개, status 13개, nature 13개처럼 카테고리별 개수가 함께 적혀 있습니다. 한 장르에만 몰리지 않고 이동, 투사체, 상태 효과, 자연 연출까지 넓게 나뉜 구성입니다.

pixelfx 카테고리별 효과 수 차트 — moves 12개, projectiles 13개, status 13개, nature 13개

캐릭터가 들어가는 효과 61개와 moves 12개에는 연기 정보가 붙습니다. 준비 동작과 접촉 순간의 정지, 흔들림 같은 타이밍을 데이터로 적는 방식입니다. 예시 코드의 정지 시간은 0.14초입니다. 그림만 바꾸는 라이브러리가 아니라, 타격감에 닿는 타이밍까지 함께 넘기려는 설계로 읽힙니다.

스프라이트 시트 내보내기와 엔진 연동

pixelfx 사용 흐름 — 효과 파일 선택, 팔레트와 연기 조정, 시트 내보내기, 엔진 적용, Claude Code 스킬 제작

코드로 그린 효과는 스프라이트 시트로 내보낼 수 있습니다. 투명 PNG와 Aseprite 형식 JSON을 만들고, Phaser의 아틀라스 로더와 Godot, Unity용 Aseprite 임포터가 이를 읽습니다. 코드 단계에서 끝나지 않고 기존 게임 파이프라인으로 들어가는 출구까지 마련된 셈입니다.

설치 방식은 npm 레지스트리 패키지가 아니라 GitHub에서 직접 받는 방식입니다. 그래서 버전 고정 없이 쓰면 원본 저장소의 변경을 그대로 받는 점은 주의가 필요합니다. 프로젝트에 넣을 때는 특정 커밋으로 고정해 두는 편이 안전합니다.

Claude Code 스킬을 통한 새 효과 제작

라이브러리 안에는 제작용 Claude Code 스킬도 함께 들어 있습니다. 설치 명령은 아래와 같습니다.

/plugin marketplace add patch-gg/pixelfx

이 구조에서는 에이전트에게 새 효과를 시키고, 렌더링 결과를 눈으로 확인하면서 고치는 루프가 라이브러리 안에 들어갑니다. 기존 효과를 골라 쓰는 저장소이면서, 동시에 새 효과를 만드는 작업 방식까지 배포하는 형태입니다. 비슷한 흐름은 게임 모딩 스킬을 다룬 #3499와, Claude Code를 게임 개발 스튜디오로 구성한 #3649에서도 확인됩니다.

확인되지 않은 지점

실무 판단

pixelfx는 픽셀 아트 게임을 빠르게 시험하는 팀에게 먼저 맞습니다. 효과를 코드로 두면 팔레트 교체와 버전 관리가 쉬워지고, 프로토타입 단계에서 연출을 대량으로 바꿔 볼 수 있습니다.

다만 도입 전에 성능 측정과 버전 고정은 먼저 챙기는 편이 좋습니다. 프레임 비용 공개가 없고 설치가 GitHub 직접 방식인 만큼, 필요한 효과 몇 개를 골라 실제 게임 루프에 넣어 본 뒤에 범위를 넓히는 순서가 안전합니다.

출처

AI 코딩 AX Trend