goodchuck 블로그
📚 연재Roamlings 개발기1/2전체 보기 →

Roamlings 개발기 ① — Shimeji 같은 데스크탑 펫 게임, Godot 대신 Electron으로 시작한 이유

Roamlings 개발기 1편 · 프로토타입 단계 (2026-11-14~15 작업)

Shimeji처럼 바탕화면을 걸어 다니는 데스크탑 펫 게임을 Electron으로 만들기 시작했습니다. 이름은 Roamlings이고, 목표는 나중에 스팀에 올리는 것입니다. 첫 편에서는 이 장르를 고른 이유, 게임 엔진으로 Godot 대신 Electron을 고른 과정, 그리고 첫 프로토타입에서 캐릭터를 바탕화면 위에 띄운 구조를 정리합니다.

메모 창 두 개를 띄운 바탕화면에서 유령은 왼쪽 메모 창 제목 줄 위에, 네모는 오른쪽 메모 창 위에 올라서 있고 말랑이와 동글이는 바닥을 걷는 Roamlings 실행 화면
메모 창 두 개를 띄운 바탕화면에서 유령은 왼쪽 메모 창 제목 줄 위에, 네모는 오른쪽 메모 창 위에 올라서 있고 말랑이와 동글이는 바닥을 걷는 Roamlings 실행 화면

글의 스크린샷에는 코드로 그린 도형 친구(말랑이 · 네모 · 동글이 · 별 · 유령)만 띄웠습니다.

Roamlings는 어떤 게임인가

  • 캐릭터가 작업표시줄 위와 열어 둔 창의 제목 줄 위를 걷고, 화면 끝이나 창 옆면을 오릅니다.
  • 마우스로 집어 흔들고 던질 수 있습니다. 서 있던 창이 움직이면 떨어집니다.
  • 친구를 여러 명 꺼내 두고, 친구마다 다닐 곳과 할 일(말 걸기 · 바로가기 메뉴 · 시간 알림)을 정합니다.

데스크탑 펫 게임은 지금도 팔리는 장르인가

처음 출발점은 "작업하면서 화면에 띄워 두는 게임이 지금도 팔린다"는 판단이었습니다. 2024~2025년에 이런 게임이 크게 유행했습니다. 그런데 비슷한 게임을 늘어놓고 보니, 같은 장르 안에서도 노는 방식이 꽤 달랐습니다.

게임화면에서 하는 일사용자가 하는 일
Shimeji바탕화면 · 창 위를 걷고, 매달리고, 떨어짐집어서 던지기, 구경
꼬미Shimeji 계열(Java 기반) 바탕화면 캐릭터캐릭터 구경 · 상호작용
Rusty's Retirement화면 아래 띠에서 돌아가는 방치형 농장가끔 들여다보고 관리
Bongo Cat화면 구석에서 입력에 맞춰 두드리는 고양이평소처럼 키보드 · 마우스 쓰기

공통점은 게임이 화면 전체를 차지하지 않는다는 것입니다. 일하는 화면 위에 얹혀 있고, 사용자는 가끔만 신경 씁니다.

저는 그중 Shimeji · 꼬미 쪽을 골랐습니다. 캐릭터가 바탕화면과 열어 둔 창 위를 자유롭게 돌아다니는 방식입니다. 여기에 캐릭터를 여러 명 꺼내 두고, 각자 다닐 곳과 할 일을 정해 주는 방향을 더하기로 했습니다.

Godot vs Electron — 데스크탑 펫 엔진 고르기

처음엔 Godot를 생각했습니다

게임이니 게임 엔진이 맞을 거라고 생각했습니다. 그래서 Godot를 먼저 떠올렸습니다. 그런데 이 장르에서 가장 어려운 부분을 하나씩 따져 보니, 엔진 차이가 거의 없었습니다.

  • 다른 창 인식 — 열린 창의 위치를 알아야 그 위를 걸을 수 있습니다. Godot든 Electron이든 OS API(Windows면 Win32)를 직접 불러야 합니다.
  • 전역 키 감지 — Bongo Cat처럼 다른 프로그램에서 누른 키에 반응하려면 이것도 OS 기능입니다.
  • 투명 · 클릭 통과 창 — 둘 다 됩니다.

어려운 부분이 같다면, 손에 익은 쪽으로

어려운 부분이 어차피 OS API라면, 이미 손에 익은 쪽이 빠릅니다. 저는 Electron으로 화면 전체를 덮는 투명 캔버스 앱을 만들어 봤고, artdesk 같은 데스크탑 앱을 배포해 본 경험도 있었습니다.

걱정은 하나였습니다. Electron은 무겁다는 평판입니다. 바탕화면에 하루 종일 떠 있는 게임이 CPU를 잡아먹으면 안 됩니다. 그래서 탈출구를 정해 두고 시작했습니다.

프로토타입으로 CPU · 메모리를 재 보고, 너무 무거우면 그때 Godot로 옮깁니다.

이 조건을 숫자로 확인한 결과는 3편에서 다룹니다.

리포를 나누다 — 게임은 my-games로

그동안 사이드 프로젝트를 한 모노레포에 모아 두었습니다. 그런데 게임은 성격이 달라 my-games라는 리포로 따로 뺐습니다. 반대로 브라우저에서 바로 하는 웹게임 포털은 기존 서비스들과 같은 웹 앱이라 원래 리포에 남겼습니다.

나눈 기준은 배포 방식과 의존성이었습니다. Electron 앱은 버전이 고정되고 설치본으로 나가는데, 웹 앱은 그렇지 않습니다. 둘이 한 리포에 있으면 서로의 의존성에 끌려다니기 쉽습니다.

첫 프로토타입 — 모니터마다 투명 창, 그림 대신 네모

첫 버전엔 그림이 없었습니다. 캐릭터 대신 코드로 그린 네모를 띄웠습니다. 이번 단계의 목적은 예쁜 캐릭터가 아니라, Electron으로 이 장르가 돌아가는지 확인하는 것이었기 때문입니다.

그림 없이 코드로 그린 네모 캐릭터 하나가 작업표시줄 바로 위 바닥을 오른쪽으로 걸어가는 약 5초 화면 녹화
그림 없이 코드로 그린 네모 캐릭터 하나가 작업표시줄 바로 위 바닥을 오른쪽으로 걸어가는 약 5초 화면 녹화

위 녹화는 지금 앱에서 네모 하나만 꺼내 첫 프로토타입처럼 바닥만 걷게 해서 다시 찍은 것입니다.

프로토타입에서 확인하려던 건 세 가지였습니다.

  1. 바탕화면을 가리지 않고 캐릭터를 띄울 수 있나 — 클릭이 아래 창으로 그대로 가야 합니다.
  2. 열어 둔 창 위를 걸을 수 있나 — 이 장르의 핵심 재미입니다(2편).
  3. 여러 마리가 돌아도 가벼운가 — Electron을 고른 대가를 숫자로 확인합니다(3편).

그림은 이 셋이 된 다음의 일로 미뤘습니다(4편).

Electron 투명 창 클릭 통과 — 바탕화면을 가리지 않는 오버레이

핵심은 모니터마다 투명한 창을 하나씩 덮는 것입니다. 앞서 만든 투명 캔버스 앱의 구조를 그대로 가져왔습니다. 모니터 하나에 오버레이 창 하나를 이렇게 만듭니다(실제 코드에서 옵션 일부만 추렸습니다).

const win = new BrowserWindow({
  x: b.x, y: b.y, width: b.width, height: b.height, // 모니터 하나를 통째로
  transparent: true, frame: false,                  // 투명 · 테두리 없음
  skipTaskbar: true, hasShadow: false,              // 작업표시줄에 안 보임
  focusable: false,                                 // 포커스를 뺏지 않음
  backgroundColor: '#00000000',
})
win.setAlwaysOnTop(true, 'screen-saver')            // 다른 창보다 항상 위
win.setIgnoreMouseEvents(true, { forward: true })   // 클릭은 아래 창으로 통과
  • alwaysOnTop 옵션 대신 setAlwaysOnTop(true, 'screen-saver')로 더 높은 층에 올립니다.
  • setIgnoreMouseEvents(true, { forward: true })가 클릭 통과의 핵심입니다. 클릭은 아래 창으로 가지만, forward 덕분에 마우스 움직임은 계속 받습니다.
  • 그래서 커서가 캐릭터 위에 올 때만 setIgnoreMouseEvents(false, { forward: true })로 바꿔 그 모니터의 창이 클릭을 받게 합니다.
Electron 투명 창 클릭 통과 구조를 층으로 그린 그림 — 위층은 모니터마다 하나씩 덮인 투명 오버레이 창, 아래층은 바탕화면과 다른 창. 빈 곳을 누르면 클릭이 오버레이를 지나 아래 창으로 가고, 말랑이 위를 누르면 오버레이가 클릭을 받는다
Electron 투명 창 클릭 통과 구조를 층으로 그린 그림 — 위층은 모니터마다 하나씩 덮인 투명 오버레이 창, 아래층은 바탕화면과 다른 창. 빈 곳을 누르면 클릭이 오버레이를 지나 아래 창으로 가고, 말랑이 위를 누르면 오버레이가 클릭을 받는다

이렇게 하면 사용자는 평소처럼 바탕화면과 창을 쓰고, 캐릭터를 누를 때만 게임이 반응합니다. 화면을 덮고 있는데도 일을 방해하지 않는 것, 이 장르의 기본 조건입니다.

상태는 main 프로세스 한 곳에

처음 고민한 건 "캐릭터를 누가 움직이나"였습니다. 모니터마다 창이 따로 있으니, 창마다 캐릭터를 움직이면 모니터를 넘어갈 때 상태가 갈라집니다.

그래서 물리와 상태는 전부 Electron의 main 프로세스 한 곳에서 돌리기로 했습니다. 창 위치 · 커서 · 모니터 정보가 다 main에 있으니, 캐릭터가 모니터를 넘나들어도 상태가 하나로 유지됩니다. 오버레이 창은 받은 좌표로 그리기만 합니다.

 main 프로세스 (상태 정본)                  오버레이 창 (모니터마다)
 ┌────────────────────────────┐   좌표    ┌──────────────────────┐
 │ 창 사각형 읽기 (10Hz)       │ ───────▶ │ 받을 때만 다시 그리기 │
 │ 지형: 발판 · 벽 선분        │          │ 집기 / 놓기 이벤트    │
 │ 상태 기계 · 물리 · 여러 마리 │ ◀─────── │                      │
 └────────────────────────────┘          └──────────────────────┘

이 구조는 나중에 CPU를 아낄 때도 도움이 됐습니다. 그리는 쪽이 스스로 돌지 않으니, 움직임이 없으면 아무 일도 하지 않기 때문입니다.

지금은 이 네모가 도형 친구 다섯 명이 됐고, 다른 창 위를 걷고 벽을 오릅니다. Windows에서만 확인했다는 한계도 있습니다. Electron 앱을 맥과 Windows에서 같이 다루며 겪은 일은 이전 글에 정리해 두었습니다.

이번 편 정리

  • 이번에 한 것 — 데스크탑 펫 장르를 고르고, Godot 대신 Electron으로 정했습니다. 게임은 my-games 리포로 나눴고, 모니터마다 투명 창을 띄워 네모 캐릭터를 바탕화면 위에 올렸습니다.
  • 막힌 것 — Electron이 무거울 수 있다는 걱정은 아직 숫자로 풀지 못했습니다. 그래서 "무거우면 Godot"라는 탈출구를 남겨 두었습니다.
  • 다음 편 예고 — 바닥만 걷던 네모가 열어 둔 창 위로 올라가기까지를 다룹니다. koffi로 Win32 창 위치를 읽어 창을 땅으로 쓰는 이야기입니다.
Roamlings 개발기 ② — 데스크탑 펫이 창 위를 걷기까지, koffi로 Win32 창 위치 읽기 대표 이미지

다음 편 · Roamlings 개발기 ②

Roamlings 개발기 ② — 데스크탑 펫이 창 위를 걷기까지, koffi로 Win32 창 위치 읽기

Electron 데스크탑 펫이 열어 둔 창 위를 걷도록 koffi로 EnumWindows·DwmGetWindowAttribute를 불러 창 위치를 읽고, 최대화 창·가려진 창·모니터 경계 문제를 푼 과정입니다.

2편 이어 읽기 →