pixelfx는 GitHub에 공개된 오픈소스 프로젝트예요. 픽셀 아트 이펙트 244종이 들어 있고, 새 이펙트를 만들게 해 주는 Claude Code 스킬도 함께 들어 있어요. 11월 4일 기준 GitHub 별이 4,400개를 넘었어요.

이 글은 소개 글이 아니라 사용기예요. QuestBrief 운영자가 개발 중인 2D 도트 던전 RPG에 pixelfx를 직접 넣어 본 기록이에요. 작업은 운영자가 방향을 정하고 Claude Code가 코드를 쓰는 방식으로 10월 31일부터 11월 3일까지 진행했어요. 글에 실린 게임 화면은 모두 그 작업 중에 찍은 실제 캡처예요. QuestBrief는 pixelfx 제작자와 아무 관계가 없어요.

pixelfx는 어떤 도구인가

README와 스킬 설명에 적힌 내용을 정리하면 이래요.

  • 이펙트 하나가 코드 파일 하나예요. 이미지 파일 없이 코드로 매 프레임을 도트로 그려요. 불, 폭발, 얼음, 번개, 신성, 암흑, 날씨, UI, 화면 전환까지 21개 분류로 나뉘어 있어요.
  • 색을 코드 수정 없이 바꿔요. palette 옵션에 어두운 색부터 밝은 색까지 색 목록을 넣으면 같은 불이 파란 불이 돼요.
  • 빛을 따로 계산해요. 색 버퍼와 더하기 합성용 빛 버퍼를 나눠 써서, 빛까지 도트 격자에 맞춰 찍혀요.
  • 난수에 시드를 써요. 같은 프레임은 항상 똑같이 그려져요.
  • 어떤 엔진에도 넣을 수 있어요. 브라우저 게임은 코드를 그대로 쓰고, Godot나 Unity 같은 엔진은 스프라이트 시트(PNG와 JSON)로 뽑아서 써요.
  • Claude Code 스킬은 만드는 방법을 가르쳐요. 초안을 쓰고, 렌더링해서 눈으로 보고, 가장 나쁜 점을 고치는 과정을 반복하게 해요. 이 방법은 Sprite Fusion의 Hugo Duprez가 정리한 것을 바탕으로 했다고 밝혀요.

라이선스는 MIT라 상업적으로도 쓸 수 있어요. 다만 고지 사항(NOTICE.md)에 따라 Hugo Duprez와 Hollow Crown의 코드를 각색한 부분은 출처를 함께 적어야 해요. 갤러리에 쓰인 Patch Pixel 글꼴은 MIT에 포함되지 않아요.

1단계: 지금 게임 이펙트와 나란히 놓아 보기

처음에는 바로 넣지 않고, 게임의 실제 몬스터 그림 옆에 지금 이펙트와 pixelfx 이펙트를 나란히 띄워 비교했어요.

화염 창 이펙트 비교. 위 줄은 기존의 가는 선과 둥근 빛으로 된 불, 아래 줄은 pixelfx의 불덩이가 날아가 큰 폭발 덩어리와 불꽃으로 터지는 모습이다.

위: 기존 화염 창 / 아래: pixelfx 불덩이와 폭발. 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

차이는 바로 보였어요. 운영자의 첫 반응도 “그래픽 엄청 좋아지네”였어요. 화염 창은 기존의 가는 선과 둥근 빛보다 불덩이와 폭발 덩어리에 훨씬 무게감이 있었어요.

도트 크기가 맞는다는 점이 컸어요. 이 게임은 몬스터 도트 한 칸을 화면에서 2.6배로 그려요. 기존에 쓰던 무료 이펙트 묶음은 약 3.4배로 그려져서 몬스터보다 도트가 굵어 보였어요. pixelfx 시트는 한 칸을 2.6배로 그리면 몬스터와 도트 크기가 정확히 맞았어요.

그대로는 못 쓴 이유 세 가지

좋아 보였지만 시트를 그대로 넣을 수는 없었어요.

  1. 너무 길었어요. 이 게임의 스킬은 0.5~0.75초 안에 끝나요. 그런데 작은 폭발(small-explosion)은 연기까지 5.4초, 서리 폭발(frost-nova)은 3.4초였어요. 낙뢰는 번개가 떨어지기 전 바닥 표식만 약 0.9초였고요. 2배속, 4배속 전투가 있는 게임에서는 더 큰 문제예요. 결국 타격 순간부터 앞부분만 잘라 쓰기로 했어요. 폭발은 앞 0.6초만 쓰고 끝에서 흐려지게 했어요.

    pixelfx 작은 폭발 이펙트의 원본 전체 5.4초와 게임에 쓴 앞 0.6초를 나란히 재생하는 움직이는 이미지. 왼쪽은 불덩이가 터진 뒤 연기가 오래 피어오르고, 오른쪽은 폭발 직후에서 끝난다.

    왼쪽: 원본 전체 5.4초 / 오른쪽: 게임에 쓴 앞 0.6초. 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

  2. 기준 크기가 달랐어요. pixelfx는 24×38 도트 캐릭터를 기준으로 그려져 있는데, 이 게임 몬스터는 64도트예요. 그래서 폭발과 서리 고리는 화면을 넘쳤고, 눈송이 이펙트는 머리 위에서 터졌어요.

  3. 색이 달랐어요. pixelfx 낙뢰는 파란색인데 게임의 번개는 노란색이에요. 이건 palette 옵션으로 게임 색을 넣어 다시 뽑으면 해결돼요. 코드는 한 줄도 고치지 않아도 돼요.

    같은 pixelfx 불 이펙트를 원래 색, 파랑, 초록 세 가지 팔레트로 나란히 재생하는 움직이는 이미지. 모양과 움직임은 같고 색만 다르다.

    같은 불 이펙트를 팔레트만 바꿔 뽑은 모습. 이미지: pixelfx(MIT) 이펙트를 운영자 PC에서 렌더링

2단계: 게임에 넣었더니 생긴 문제

일반 공격과 화염 창 두 가지에 먼저 pixelfx 이펙트를 넣었어요.

넣고 보니 폭발이 슬라임 같은 작은 몬스터보다 훨씬 컸어요. 일반 공격 섬광은 슬라임 머리 위 허공에 떴고요. 이건 pixelfx 문제가 아니라 게임 쪽 구조 문제였어요. 모든 이펙트를 스켈레톤 크기 기준으로 같은 자리에 그리고 있었거든요.

몬스터마다 실제 몸 높이를 재 보니 차이가 컸어요. 스켈레톤 150, 골렘 133, 슬라임 73, 박쥐 68, 큰 군주 226이었어요. 그래서 엔진이 몬스터마다 도트 그림의 실제 몸 테두리를 재서, 이펙트 위치와 크기를 맞추도록 고쳤어요.

슬라임에게 화염 창을 쓴 장면을 0.5배속으로 나란히 재생하는 움직이는 이미지. 왼쪽 맞춤 전에는 큰 금빛 고리와 폭발이 슬라임을 통째로 덮고, 오른쪽 맞춤 후에는 폭발이 슬라임 크기로 작아져 발밑에서 터진다.

왼쪽: 몸 크기 맞춤 전 / 오른쪽: 맞춤 후 (0.5배속). 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

여기서 하나 배운 점이 있어요. 처음에는 몸 크기에 정비례로 이펙트를 줄였는데, 그러자 슬라임에서는 이펙트가 너무 작아져 타격감이 사라졌어요. 그래서 완만하게 따라가도록 바꿨어요. 키가 절반인 몬스터면 이펙트는 0.65배가 되는 식이에요. 이 처리를 한 곳에서 하니 26개 스킬 전체에 한꺼번에 적용됐어요.

3단계: 있는 걸 쓰는 데서, 직접 만드는 데로

여기까지는 pixelfx에 이미 있는 이펙트를 가져다 쓴 거예요. 운영자는 여기서 질문을 하나 던졌어요. “기존에 만들어진 것 말고 새로 독창적인 건 못 만드는 거야?”

답은 “만들 수 있다”였어요. pixelfx는 완성품 모음이기보다 이펙트를 만드는 도구 묶음에 가까워요. 이번 작업에서는 Claude Code가 pixelfx 저장소를 받아 작성 안내서(docs/AUTHORING.md)와 도구를 그대로 썼어요. 스킬이 가르치는 방법과 같은 흐름이에요.

  1. 이펙트 파일을 새로 쓴다.
  2. 렌더링해서 프레임 묶음 이미지를 본다.
  3. 가장 거슬리는 점을 고치고 다시 렌더링한다.
  4. 품질 검사 도구(check.mjs)로 캔버스 밖 넘침, 시드 없는 난수 같은 문제를 확인한다.
  5. 시트로 뽑아 게임 아틀라스에 넣는다.

첫 시험작은 얼음 스킬 ’서리 쐐기’의 타격 이펙트였어요.

쐐기가 박히는 순간 흰 섬광이 터지고, 크고 작은 얼음 바늘 17개가 송이처럼 퍼진 뒤 부서지는 이펙트예요. 그려서 보고 고치기를 세 번 했어요. 첫 시안은 바늘이 가는 흰 막대처럼 보여서 굵게 하고 면 명암을 넣었어요. 회색 연기 얼룩은 지저분해 보여서 뺐고, 타격감을 위해 길이를 1초로 줄였어요.

얼음 바늘 송이 이펙트의 시안과 완성본을 나란히 재생하는 움직이는 이미지. 왼쪽 시안은 바늘이 흩어진 뒤 회색 연기 얼룩이 남고 길게 이어지며, 오른쪽 완성본은 연기 없이 더 짧게 끝난다.

왼쪽: 시안 / 오른쪽: 완성. 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

게임에 넣으면 이렇게 보여요. 기존 이펙트는 흰 빛이 번지는 정도였는데, 얼음 바늘이 퍼졌다가 부서지는 장면이 생겼어요.

서리 쐐기를 스켈레톤에게 쓴 장면을 확대해 느린 속도로 나란히 재생하는 움직이는 이미지. 왼쪽 기존 이펙트는 흰 빛 덩어리가 번지고, 오른쪽 새 이펙트는 얼음 바늘이 송이처럼 퍼졌다가 부서진다.

왼쪽: 기존 / 오른쪽: 직접 만든 이펙트 (확대, 절반 속도). 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

이후로는 운영자가 “다음 묶음 진행”이라고 할 때마다 3~6개씩 만들었어요. 11월 3일 하루에 남은 스킬을 모두 바꿨고, 최종적으로 스킬 23개가 직접 만든 이펙트를 쓰게 됐어요.

가드 브레이크를 골렘에게 쓴 장면을 확대해 느린 속도로 나란히 재생하는 움직이는 이미지. 왼쪽 기존 이펙트는 조준 고리만 나오고, 오른쪽 새 이펙트는 금빛 육각 방패가 나타났다가 깨져 조각이 흩어진다.

마지막 묶음의 ‘가드 브레이크’. 왼쪽: 기존 / 오른쪽: 직접 만든 이펙트 (확대, 절반 속도). 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

직접 만들면서 반복된 문제

여러 개를 만들다 보니 같은 종류의 문제가 되풀이됐어요. pixelfx로 이펙트를 만들 사람에게 참고가 될 만한 것들이에요.

  • 반투명하게 사라지면 바둑판무늬가 돼요. pixelfx는 반투명을 디더(점을 번갈아 찍는 방식)로 표현해요. 그래서 크게 흐려지는 면은 바둑판처럼 보였어요. 얼음 조각, 금빛 칼날, 프리즘 판에서 모두 같은 문제가 나왔어요. 흐려지는 대신 단색 면으로 그리고 짧아지며 사라지게 해서 해결했어요.

    프리즘 조각 이펙트의 첫 시안과 완성본을 나란히 재생하는 움직이는 이미지. 왼쪽 시안은 육각 결정 안이 바둑판무늬로 채워져 있고, 오른쪽 완성본은 매끈한 단색 면으로 그려진 뒤 조각으로 깨진다.

    왼쪽: 첫 시안의 바둑판무늬 / 오른쪽: 단색 면으로 고친 완성본. 이미지: QuestBrief 운영자 개발 화면, 이펙트는 pixelfx(MIT)

  • 첫 크기가 자주 어긋나요. 무덤 인장 이펙트는 처음에 게임 원진보다 2.5배 컸어요. 반대로 독 이펙트는 실제 화면에서 넷 중 가장 작고 약해 보였어요. 렌더링한 시트만 보지 말고 실제 게임 화면에서 확인하는 단계가 꼭 필요했어요.

  • 용량이 계속 늘어요. 이 게임은 HTML 파일 하나로 돌아가서, 이펙트 그림을 한 장의 아틀라스로 모아 파일 안에 넣어요. 아틀라스는 처음 228KB에서 최종 616KB까지 늘었어요. 테스트 한도도 320KB, 448KB, 640KB로 두 번 올렸어요. 대신하게 된 옛 이펙트를 그때그때 빼서 늘어나는 폭을 줄였어요.

  • 색 수 제한도 있어요. 아틀라스 전체를 256색으로 줄여 저장하는 구조라, 색이 많은 pixelfx 이펙트를 넣으면 다른 이펙트 색이 미세하게 바뀔 수 있어요. 이번에는 화면상 차이가 보이지 않았지만, 이펙트를 더 늘리면 저장 방식을 바꿔야 할 수도 있어요.

써 보고 내린 평가

좋았던 점

  • 결과물의 질이 확실히 한 단계 올라갔어요. 같은 게임 화면에서 비교하니 차이가 컸어요.
  • 이펙트가 코드라서 색, 개수, 속도를 숫자로 바로 고칠 수 있어요. AI 에이전트가 “그려 보고, 보고, 고치는” 반복을 하기에 잘 맞는 형식이에요.
  • 시트 출력이 표준적인 형식이라 기존 아틀라스 빌드 과정에 출처 하나를 추가하는 정도로 들어갔어요.
  • 품질 검사 도구가 있어서 사람이 놓치기 쉬운 문제를 먼저 걸러 줘요.

아쉬웠던 점

  • 기존 이펙트는 길이와 크기가 게임마다 안 맞을 수 있어요. 타격 0.5초 안팎의 빠른 전투라면 잘라 쓰는 작업이 거의 필수예요.
  • 디더 기반 반투명 때문에 크게 흐려지는 연출은 따로 신경 써야 해요.
  • 무엇보다 게임 쪽 구조가 받쳐 줘야 해요. 이번 작업에서 가장 손이 많이 간 건 pixelfx가 아니라, 몬스터 크기에 맞춰 이펙트 위치를 잡는 게임 코드였어요.

이런 사람에게 추천해요

  • 브라우저나 2D 엔진으로 도트 게임을 만들고 있고, 스킬·타격 이펙트의 질을 올리고 싶은 사람
  • Claude Code 같은 AI 코딩 도구로 그래픽 작업까지 해 보고 싶은 사람
  • 이미 있는 이펙트를 쓰는 데서 그치지 않고, 자기 게임에 맞는 이펙트를 직접 만들 생각이 있는 사람

이번 작업은 결국 “가져다 쓰기”보다 “만드는 방법을 배워 오기”에 가까웠어요. 244종을 그대로 쓰는 것도 가능하지만, pixelfx의 진짜 가치는 자기 게임 크기와 속도에 맞는 이펙트를 계속 만들어 낼 수 있게 해 주는 작업 방식에 있다고 봐요.