마법사가 지팡이를 내리찍자 바닥에서 푸른 얼음 결정이 세 겹으로 솟고, 허수아비가 움찔하며 0.1초 멈춥니다. 이 3.4초짜리 장면에는 PNG가 한 장도 없어요. pixelfx는 Patch(patch.gg)가 2026년 10월 30일 GitHub에 공개한 픽셀 아트 이펙트 라이브러리로, 불·폭발·마법·날씨·UI 이펙트 244개를 전부 작은 자바스크립트 파일로 담고 새 이펙트를 만드는 클로드 코드 스킬까지 MIT 라이선스로 내놓았어요.
이미지 대신 코드라는 점이 이 도구의 전부예요. 그림 파일은 사 오면 고치기 어렵지만, 코드는 AI 코딩 도구에게 “색 바꿔 줘”, “더 세게 터지게 해 줘”라고 시킬 수 있거든요.
244개 이펙트가 전부 코드인 이유
README 설명대로라면 이펙트 하나는 파일 하나(src/fx/분류/이름.js)이고, src/core 말고는 의존하는 게 없어요. 파일은 두 종류로 나뉩니다. 시간 t에 따라서만 그려지는 순수 이펙트는 반복 재생해도 이음매가 생기지 않고, 파티클·연기·파편이 나오는 시뮬레이션 이펙트는 120Hz로 계산돼요. 난수는 모두 시드에서 나오니 같은 프레임은 언제 그려도 똑같죠. AI가 고친 결과를 사람이 비교해 보기 좋은 구조인 셈이에요.
화제가 된 속도도 빨랐어요. GitHub 트렌드 집계 사이트 Trendshift에 따르면 2026년 10월 29일부터 11월 4일까지 별이 4,510개 늘었고, 가장 많이 늘어난 11월 1일 하루에만 1,149개가 붙어 그날 전체 7위, 자바스크립트 2위에 올랐어요. 2026년 11월 4일 기준 저장소에 표시된 별은 4.5k, 포크는 601개예요.
만든 방식에는 출처가 분명히 적혀 있어요. NOTICE.md는 시뮬레이션 핵심(sim.js)과 일부 이펙트가 Sprite Fusion의 오픈소스 픽셀 아트 VFX(Hugo Duprez, MIT)를 고쳐 쓴 것이고, 캐릭터 연출(act.js)은 Hollow Crown이라는 MIT 프로젝트의 12fps 포즈·히트스톱 방식을 가져왔다고 밝히고 있어요.

갤러리 첫 화면. 분류 탭마다 이펙트 개수가, 카드마다 재생 길이가 붙어 있어요.
pixelfx는 언제 쓰면 좋을까
잘 맞는 경우는 이래요.
- 브라우저에서 도는 2D 게임을 만들고 있을 때. README는 canvas, Phaser, PixiJS, Kaplay, three.js처럼 캔버스 위에 그리는 게임에서 쓸 수 있다고 적고 있어요. 코드를 그대로 붙여 쓰는 길이 가장 짧은 경우예요.
- 고도·유니티 게임인데 이펙트 소스가 없을 때. 엔진 안에서 코드로 돌지는 않지만, 투명 PNG 격자와 Aseprite 형식 JSON으로 내보내면 고도·유니티의 Aseprite 임포터가 읽는다고 해요.
- 이펙트를 여러 벌 뽑아 비교하고 싶을 때. 팔레트와 시드만 바꿔도 다른 버전이 나오니, AI에게 “코인 반짝임 다섯 개 만들어서 두 개 골라 줘” 같은 요청이 통해요(README가 직접 드는 예시이기도 해요).
- 클로드 코드를 이미 쓰고 있을 때. 전용 스킬이 초안, 렌더, 눈으로 확인, 다듬기를 되풀이하도록 짜여 있어요.
반대로 안 맞는 경우도 분명해요. 내 캐릭터 몸에 붙는 이펙트를 바로 쓰려는 사람이라면 기대를 낮추는 게 맞아요. 몸 위에 그리는 이펙트는 기본 회색 더미(24×38 픽셀)에 맞춰져 있어서, README도 출시 전에 내 캐릭터에 맞게 다시 만들라고 적고 있거든요. 코드를 전혀 만지지 않고 슬라이더로만 이펙트를 만들고 싶은 사람에게도 다음 절의 상용 도구가 더 가까워요.

Frost nova 상세 창. 오른쪽에 길이·프레임·캔버스 크기와 배경·팔레트·반전 버튼, 가져다 쓸 코드가 함께 나와요.
갤러리에서 먼저 골라 보기
설치 전에 들를 곳은 공식 웹 갤러리예요. 로그인 없이 열리고, 5초쯤 지나면 카드들이 일제히 움직이기 시작해요. 분류 탭은 moves, fire, explosions, ice, weather, pickups, critters 등 20개가 넘고, 맨 앞 moves에는 화살 쏘기·돌진 베기·땅 내려찍기처럼 준비 동작부터 회복까지 이어진 기술 12개가 모여 있어요. 카드마다 1.9s나 loop가 붙어 있어서 한 번 재생용인지 반복용인지 목록에서 바로 갈려요.
Frost nova 카드를 열어 보면 정보 칸에 103프레임·30fps, 0.34초 준비 동작과 0.42초 지점의 100ms 멈춤까지 적혀 있어요. 0.3.0에서 들어온 연기(acting) 기능이죠. 재생 속도(0.25×부터), 배경, 팔레트, 새 시드, 좌우 반전을 누를 때마다 바로 바뀌고, 아래 use it 칸의 코드를 복사해 가면 돼요.
sprite sheet 버튼은 생각보다 쓸모가 커요. 누르면 투명 체크무늬 위에 프레임이 9열로 쭉 펼쳐져서, 작은 불빛이 빛기둥이 되고 얼음 원판으로 번졌다가 사라지는 흐름을 내보내기 전에 눈으로 따라갈 수 있거든요. 다만 이건 화면 보기일 뿐이고, 실제 PNG·JSON 파일은 README의 명령으로 만드는 구조예요.

sprite sheet 버튼으로 펼친 프레임 격자. 작은 빛에서 얼음 원판까지 이어지는 흐름을 미리 볼 수 있어요.
아쉬운 점도 있었어요. 상세 창을 열면 뒤 목록이 어둡게 겹쳐 보여 조금 어수선하고, 스프라이트 시트는 창 아래로 한참 내려야 나와요. use it 코드 칸은 좁아서 긴 줄의 오른쪽이 잘리고, 화면은 전부 영어예요.
pixelfx 쓰는 법: 준비물과 AI에게 할 말
준비물은 단출해요. Node.js 18 이상이 있으면 되고, 런타임 의존성은 없어요. API 키나 유료 요소는 README에 적혀 있지 않고, 스킬을 쓰려면 클로드 코드를 쓸 수 있어야 해요. 아래 명령은 이지티켓이 직접 돌려 본 게 아니라 README에 적힌 그대로예요.
내 프로젝트에 넣을 때는 이렇게 받거나, src/core와 필요한 이펙트 파일만 복사해도 된다고 해요.
npm i github:patch-gg/pixelfx
엔진용 스프라이트 시트는 이 명령으로 만들어요. --gif, --mp4, --all 옵션이 있고, node tools/sheets.mjs는 라이브러리 전체를 내보내요.
node tools/render.mjs ice/frost-nova --sheet
클로드 코드 스킬은 클로드 코드 안에서 두 줄로 설치해요.
/plugin marketplace add patch-gg/pixelfx
/plugin install pixelfx@pixelfx
새 이펙트를 만들 때는 node tools/new.mjs arcane/my-spell로 뼈대를 만들고, node tools/check.mjs <id>로 영역 밖으로 번진 픽셀·이음매·시드 없는 난수·느린 프레임을 잡아요. 이 검사기가 있다는 게 AI에게 맡기기 좋은 이유예요. AI가 만든 결과가 맞는지 사람이 일일이 보지 않아도 기준이 하나 생기거든요.

새 이펙트를 만드는 규칙을 적은 AUTHORING.md. AI에게 먼저 읽힐 문서예요.
AI에게 요청할 때는 규칙 문서와 참고 파일을 먼저 읽히는 게 핵심이에요. docs/AUTHORING.md는 품질 기준과 함께 먼저 읽을 파일로 sword-slash.js, frost-nova.js, small-explosion.js를 꼽고 있어요.
요청은 두 덩어리로 나누면 깔끔해요. 새 이펙트라면 AUTHORING.md와 src/fx/ice/frost-nova.js를 먼저 읽게 한 뒤, 만들고 싶은 장면(예: 보라색 번개가 땅에 꽂히는 한 번 재생용)과 넣을 위치(arcane/purple-strike)를 알려 주고, check.mjs를 통과할 때까지 고치라고 덧붙이면 돼요. 이미 있는 이펙트를 엔진으로 옮길 때는 내보낼 분류(fire, explosions 등)와 쓸 엔진(고도 등), 맞출 팔레트 색 코드 몇 개만 적어 주면 충분해요.
비슷한 도구와 무엇이 다른가
비교할 만한 건 두 개예요. pixelfx가 방법을 빌려 온 Sprite Fusion의 Pixel Art VFX, 그리고 2018년부터 팔린 데스크톱 도구 Pixel FX Designer예요.
| pixelfx | Sprite Fusion Pixel Art VFX | Pixel FX Designer | |
|---|---|---|---|
| 형태 | 코드 라이브러리 + 클로드 코드 스킬 | 이펙트 모음 + MCP 서버 | 데스크톱 프로그램 |
| 이펙트 수 | 244개 | 25개 | 직접 만듦 |
| 가격·라이선스 | 무료, MIT | 무료, MIT | 유료(스팀 ₩11,000) |
| 만드는 방식 | AI에게 코드 수정·생성 요청 | AI 에이전트에 연결하거나 ZIP으로 넘김 | 슬라이더와 버튼 |
| 내보내기 | 스프라이트 시트, GIF, MP4 | 에이전트가 쓰는 코드 | 스프라이트 시트, 프레임 이미지, GIF |
(2026년 11월 4일 기준)

두 오픈소스 픽셀 이펙트 라이브러리에 든 이펙트 개수 비교.
그래프가 보여 주듯 양으로는 pixelfx가 열 배 가까이 많아요. 대신 Sprite Fusion은 pixelfx 스스로 품질 기준으로 삼는 원조이고, claude mcp add로 서버를 붙이는 방식이라 저장소를 받지 않아도 돼요. 고를 이유는 이렇게 갈려요. 이펙트 종류가 많이 필요하고 결과물을 파일로 뽑고 싶으면 pixelfx, 몇 개만 고급스럽게 쓰면 되면 Sprite Fusion, 코드를 아예 거치고 싶지 않으면 Pixel FX Designer예요.
공개 일주일 남짓, 알고 쓸 것
가장 먼저 볼 건 성숙도예요. 커밋 기록상 첫 커밋이 2026년 10월 30일, 마지막 커밋이 10월 31일이고 main 브랜치 커밋은 8개뿐이에요. GitHub Releases엔 올라온 버전이 없고, 버전은 package.json에 적힌 0.3.0이 전부죠. 이름만 같은 포크도 여럿 돌아다니니 받을 때는 patch-gg 계정의 저장소인지 보고 받는 게 안전해요.

저장소 첫 화면. 별 4.5k, MIT 라이선스, 오른쪽 Releases 칸엔 아직 아무것도 없어요.
라이선스는 코드와 이펙트 모두 MIT이고, LICENSE 파일에 Patch와 Hugo Duprez가 함께 저작권자로 올라 있어요. 예외가 하나 있는데, 갤러리에 쓰인 Patch Pixel 폰트는 이 MIT에 들어가지 않고 조건이 따로예요. 갤러리 폴더를 통째로 내 사이트에 옮기려는 경우라면 폰트만은 빼 두는 게 맞아요.
성능 수치와 필요한 하드웨어는 README에도 갤러리에도 없어요. 이펙트를 한 화면에 여러 개 띄우는 게임이라면 실제 기기에서 프레임이 버티는지는 직접 재 봐야 하는 몫이에요.
자주 묻는 질문
pixelfx는 무료인가요?
네. 코드와 이펙트 모두 MIT 라이선스라 상업 게임에도 저작권 표시를 남기고 쓸 수 있어요. 갤러리의 Patch Pixel 폰트만 조건이 따로예요.
클로드 코드가 없어도 쓸 수 있나요?
쓸 수 있어요. 갤러리에서 코드를 복사하거나 npm으로 받아 쓰는 데는 클로드 코드가 필요 없어요. 스킬은 새 이펙트를 만들거나 고칠 때 손을 덜어 주는 쪽이고, 커서나 코덱스에도 AUTHORING.md를 읽히면 같은 규칙으로 작업을 시킬 수 있어요.
유니티나 고도 게임에도 넣을 수 있나요?
스프라이트 시트로는 가능해요. README는 고도·유니티의 Aseprite 임포터와 Phaser의 atlas 로더가 결과물을 읽는다고 적고 있어요. 엔진 안에서 코드로 돌아가는 건 아니어서 색을 바꾸려면 다시 내보내야 해요.
갤러리에서 내 게임 분위기에 맞는 이펙트를 하나 골라 두고, 그 파일 이름과 함께 AI에게 첫 요청을 넣어 보는 데서 시작하면 돼요.
참고한 자료 6
이 글은 AI가 자료 조사와 초안 작성을 돕고, 운영자가 직접 써 보고 확인해 고친 뒤 발행했어요. 틀린 내용을 발견하면 알려 주세요.