🃏

HTML·CSS·JavaScript로 만든 블로샤퍼

Tags
Blosharper
GameDev
WebDev
Electron
Description
카드 게임에 익숙한 웹 기술을 선택한 이유와 DOM, CSS, SVG, Electron을 활용한 과정을 정리했습니다. 2026년 7월 itch.io 개발기를 다듬어 옮긴 글입니다.
Published
2026년 7월 3일 발행
On this page
2026년 7월 3일 itch.io에 쓴 개발기를 다듬어 옮겼습니다.
블로샤퍼는 상용 게임 엔진 대신 HTML, CSS, JavaScript와 TypeScript로 만든 카드 게임입니다. 오랫동안 프런트엔드 개발을 해 왔기 때문에, 게임을 시작할 때도 제가 익숙하게 다룰 수 있는 도구부터 생각했습니다. 머릿속에 있는 화면을 빠르게 만들어 보고 수정하는 데 웹 기술이 잘 맞았습니다.

카드 게임과 웹 인터페이스

블로샤퍼에서는 다음 수를 계산하고, 덱을 구성하고, 카드를 조작하는 일이 플레이의 중심입니다. 화면에 놓인 카드와 정보를 어떻게 보여주고 반응하게 만들지가 중요했습니다.
카드 배치에는 flexbox와 grid를, 움직임과 스킬 연출에는 CSS 애니메이션을 활용했습니다. 웹 인터페이스를 만들 때 쓰던 방법을 게임에도 적용할 수 있었습니다. 제가 익숙한 기술을 선택한 이유이기도 하지만, 카드와 UI의 비중이 큰 게임의 구성에도 맞는 선택이었습니다.

DOM과 CSS로 만든 움직임

웹 기술로 게임을 만들면 성능은 괜찮으냐는 질문을 받곤 했습니다. DOM 요소가 많고 화면에서 계속 움직이면 성능 부담이 생깁니다. 익숙한 도구라고 해서 그 부분을 건너뛸 수는 없었습니다.
카드 애니메이션과 효과를 만들 때는 transform과 opacity를 중심으로 구성하고, 브라우저의 하드웨어 가속을 활용하는 방향으로 작업했습니다. 다만 이 속성을 썼다는 사실만으로 모든 장면에서 일정한 프레임 속도가 보장되는 것은 아닙니다.
카드를 고르고 내는 동작에 점수와 배수 연출이 이어집니다.

SVG 필터와 화면 분위기

어둡고 거친 느와르 분위기를 만드는 데는 SVG 필터와 CSS의 backdrop-filter를 사용했습니다. 글리치, 피가 튀는 효과, 화면 흔들림도 Web API와 CSS를 조합해 구현했습니다.
카드와 인터페이스를 DOM으로 구성한 상태에서 이런 효과를 더했습니다. 익숙한 웹 화면에 질감과 움직임을 입혀 게임의 분위기를 만드는 과정이었습니다.
보스가 등장하면 화면 전환과 색감으로 판의 분위기를 바꿉니다.

TypeScript와 Electron

렌더링 코어는 React나 Vue 없이 TypeScript로 구성했습니다. 기존 웹 프레임워크를 적용하는 대신 게임에 맞는 코어를 만드는 방식을 택했습니다.
데스크톱 배포에는 Electron을 사용했습니다. HTML·CSS·JavaScript로 만든 화면을 독립 실행형 앱으로 묶어 Windows, macOS, 스팀덱에서 실행하는 구성이었습니다. 이후에는 같은 코드를 Capacitor로 감싸 모바일 앱으로도 내보냈습니다. 게임의 주요 화면과 로직을 재사용하면서, 화면 배치와 입력 방식은 플랫폼에 맞게 조정했습니다.
그렇다고 패키징만 하면 게임에 필요한 일이 모두 끝나지는 않았습니다. 컨트롤러 입력, 저장 데이터 암호화, 오디오 컨텍스트 처리처럼 별도로 해결해야 할 작업도 있었습니다. 이런 부분을 하나씩 붙여 가며 데모를 만들었습니다.

꼭 필요한 곳에만 쓴 WebGL

블로샤퍼의 화면은 대부분 DOM과 CSS로 그립니다. 그렇다고 GPU 그래픽을 전혀 쓰지 않는 것은 아닙니다. 주사위를 굴리는 장면과 캐릭터 초상에 입체감을 주는 효과는 WebGL로 만들었습니다.
주사위는 처음에 three.js와 물리 엔진 cannon-es로 구현했습니다. 그런데 실제로 쓰는 기능은 두 라이브러리의 아주 일부였고, 처음 주사위를 굴릴 때 라이브러리를 불러오느라 잠깐 멈칫하는 문제도 있었습니다. 그래서 가벼운 WebGL 라이브러리인 OGL과 직접 짠 물리 계산으로 바꿨습니다. 주사위 연출에 들던 코드가 약 2.5MB에서 54KB 정도로 줄었고, 게임 전체 JavaScript도 약 7.7MB에서 5.5MB로 28% 가벼워졌습니다.
기본은 DOM으로 두고, DOM으로 표현하기 어려운 장면에만 WebGL을 쓰는 방식입니다.
두목 격파 후 세 가지 보상 중 ‘고귀한 봉투’를 고르는 장면입니다. 선택을 확인하면 색종이가 흩날리는 가운데 봉투 세 개가 나타납니다.

성능에서 배운 것들

처음 글에서는 transform과 opacity를 중심으로 움직임을 만들었다고 적었습니다. 실제로 오래 돌려 보니 그것만으로는 부족한 장면이 있었고, 몇 가지를 더 배웠습니다.
계속 도는 애니메이션은 조심해야 했습니다. 스팀덱에서 게임을 하루 종일 켜 두는 테스트를 하다가 기기가 뜨거워지고 팬이 최대로 도는 일이 있었습니다. 원인은 화면에 계속 떠 있는 UI에 걸린 무한 반복 애니메이션이었습니다. 큰 text-shadow나 filter: blur() 같은 속성은 매 프레임 다시 그려야 해서, 눈에 잘 띄지 않는 요소라도 오래 돌면 부담이 쌓였습니다. 이런 효과는 한 번만 그려 두고 transform으로 움직이는 방식으로 바꿨습니다.
모바일은 처음부터 가벼운 모드로 시작합니다. 데스크톱에서는 선택 사항인 저사양 모드를 모바일에서는 기본으로 켭니다. 장식용 반짝임이나 빛 번짐 같은 층만 끄고, 카드와 버튼의 등장 연출은 그대로 둡니다.
카드 화면에서 마스터 숍으로 전환되면 주인의 초상과 서비스 목록이 나타납니다. ‘뇌세척’ 항목이 강조되면서 말풍선에 새 대사가 한 글자씩 표시됩니다.
전체 화면이 느린 이유는 효과가 아니라 해상도였습니다. 4K 모니터에서 전체 화면으로 플레이하면 프레임이 크게 떨어졌습니다. 효과를 줄여 봤지만 큰 차이가 없었고, 화면을 그리는 해상도 배율을 낮추자 한 프레임에 걸리는 시간이 평균 약 53ms에서 20ms로 줄었습니다. 효과는 그대로 둔 채였습니다.
SVG 필터는 순서가 비용을 바꿉니다. 보너스 화면의 브라운관 왜곡 필터가 고해상도에서 무거웠습니다. 처음에는 필터 단계 수를 줄여야 한다고 생각했지만, 같은 단계를 순서만 바꿔 화면을 휘게 하는 왜곡 단계를 뒤쪽으로 옮기자 프레임 시간이 약 118ms에서 85ms 안팎으로 줄었습니다. 눈으로는 구별되지 않을 만큼 화면 차이도 작았습니다. 왜곡 단계 뒤에 붙는 효과가 많을수록, 왜곡된 큰 화면을 그만큼 여러 번 다시 처리하기 때문입니다.

밸런스 시뮬레이터도 같은 언어로

카드 게임은 숫자 하나만 바꿔도 판 전체의 흐름이 달라집니다. 블로샤퍼에는 게임 AI가 사람 대신 수많은 판을 플레이하며 밸런스를 재는 시뮬레이터가 있습니다.
이 시뮬레이터도 게임과 같은 TypeScript로 만들었습니다. 게임 안에서 AI가 수를 계산하는 부분은 Web Worker에서 돌리기 때문에, 계산이 길어져도 화면이 멈추지 않습니다. 게임을 만드는 도구까지 같은 언어로 다룰 수 있다는 점이 웹 기술의 또 다른 장점이었습니다.
점수 정산 창에서 기본 점수와 보너스가 차례로 더해집니다. 고 보너스가 4고까지 반영되면서 최종 점수가 1,055,821점으로 올라갑니다.

컨트롤러와 진동

처음 글에서는 컨트롤러 입력을 별도로 해결해야 했다고만 적었습니다. 블로샤퍼는 브라우저의 Gamepad API로 Xbox 패드와 스팀덱 입력을 받고, 카드를 고르고 내는 모든 동작을 컨트롤러만으로 할 수 있게 화면 곳곳의 포커스 이동을 다시 짰습니다.
PlayStation 5의 DualSense는 한 걸음 더 나갔습니다. 브라우저에서 기기와 직접 통신하는 WebHID로 DualSense를 연결해, 점수가 터지거나 화면이 깨지는 순간에 맞춘 열두 가지 진동 패턴을 넣었습니다. 일반 패드에서는 기본 진동으로 대신합니다. 웹 기술로도 콘솔 컨트롤러의 손맛까지 다룰 수 있다는 점이 개인적으로 가장 반가웠던 부분입니다.

일곱 개 언어

블로샤퍼는 한국어, 영어, 일본어, 중국어(간체·번체), 독일어, 러시아어로 플레이할 수 있습니다. 화면이 HTML이기 때문에 언어마다 길이가 다른 문장도 레이아웃이 알아서 받아 줍니다. 카드 이름과 설명이 길어지는 독일어나 러시아어에서도 같은 화면 구성을 그대로 쓸 수 있었습니다. 언어별로 글꼴이나 줄 간격이 달라야 하는 부분만 따로 조정했습니다.
웹 기술로 만든 게임은 테스트도 웹 개발 도구로 합니다. 점수 계산이나 규칙 같은 로직은 단위 테스트로 확인하고, 화면에 제대로 보이고 눌리는지는 실제 브라우저를 띄우는 Playwright로 확인합니다. 여기에 더해 스팀덱에서 게임을 며칠씩 자동으로 플레이하게 두고 메모리와 안정성을 지켜보는 장시간 테스트를 계속 돌리고 있습니다. 가장 길게는 열흘 넘게 쉬지 않고 플레이했습니다.
일본어판 마스터 숍 화면입니다. 서비스 목록과 주인의 대사가 일본어로 표시되고, 말풍선의 문장은 줄바꿈되며 한 글자씩 나타납니다.

이후의 렌더링 실험

이 글은 블로샤퍼가 처음 어떤 기술로 화면을 구성했는지에 대한 기록입니다. 이후에는 기존 HTML 레이아웃을 유지하면서 렌더링 경로를 바꾸는 HTML-in-Canvas도 시험했습니다. 그 과정에서 확인한 화면 차이와 문제는 🖼️블로샤퍼의 HTML-in-Canvas 렌더링 실험에 따로 정리했습니다.

익숙한 기술, AI와의 협업

처음에는 제가 익숙하게 다룰 수 있어서 웹 기술을 골랐습니다. 만들다 보니 AI 에이전트가 작업에 참여하기에도 좋은 구조라는 것을 알게 됐습니다.
화면을 구성하는 HTML·CSS부터 TypeScript로 작성한 게임 로직과 테스트까지 텍스트 코드로 남아 있어, 에이전트가 읽고 수정하고 Git diff로 변경 내용을 확인할 수 있었습니다. 기능이나 문제를 이슈로 나누어 맡기고, 풀 리퀘스트(PR)로 모아 서로 검토하는 방식도 잘 맞았습니다. 혼자 개발하면서도 여러 작업을 나누어 진행할 수 있었던 데는 이 구조의 도움이 컸습니다.
카드와 글자가 중심인 화면에는 브라우저의 레이아웃 기능이 잘 맞았고, 같은 게임 로직을 시뮬레이터와 테스트에서도 재사용할 수 있었습니다. 배포 대상에 따라 화면 배치와 입력 방식은 따로 다듬어야 했지만, 공통 코드를 유지한 채 작업할 수 있었습니다. 필요한 라이브러리를 골라 코드 크기를 줄이고, 수정한 결과를 바로 확인하며 실행 조건을 바꿔 보는 방식도 작은 단위로 자주 고치는 개발에 잘 맞았습니다.
물론 직접 통제하기 어려운 부분도 있었습니다. 같은 코드라도 브라우저 런타임의 버전이나 운영체제에 따라 동작이 달라질 수 있어, 문제가 생기면 게임 코드와 실행 환경을 함께 살펴봐야 했습니다. DOM과 CSS의 렌더링은 브라우저가 관리하므로 GPU 작업을 세밀하게 조절하는 데도 제약이 있었습니다. 고해상도 화면이나 필터의 비용은 실제 기기에서 측정하고 조정해야 했습니다.
JavaScript 코드 보호에는 별도의 작업이 필요했습니다. 또 게임 코드의 크기를 줄여도 브라우저 런타임을 함께 배포하는 Electron 앱의 설치 용량과 기본 메모리 사용량에는 여전히 부담이 있었습니다.
블로샤퍼에서는 익숙한 도구로 화면을 빠르게 만들고, 그 작업을 AI 에이전트와 나누어 이어 갈 수 있다는 이점이 컸습니다. 웹 기술을 선택한 출발점은 익숙함이었지만, 계속 만들어 가는 과정에서는 협업하기 쉬운 코드와 빠른 반복도 그만큼 중요해졌습니다.