원문: jaydendavisnc/inkwave · 수집일: 2026-10-02 · Stars 363 · Forks 128 · JavaScript · MIT · 저장소 생성 2026-09-26(최근 푸시 09-29) · 플레이

개요

INKWAVE는 브라우저에서 돌아가는 Splatoon풍 4v4 터프 워(바닥 칠하기) 슈터다. 번들러 없이 three.js r186을 ES 모듈로 직접 불러오고, 캐릭터·애니메이션·무기·텍스처·소품·효과음·음악을 전부 코드로 생성한다(README: 내려받은 자산은 폰트 2개뿐). 저장소는 생성 후 사흘 만에 3개 모드(Turf War·Zone Control·Boss Battle), 무기 12종, 스테이지 7종, 최대 8인 온라인 대전까지 갖췄다. README는 Splatoon 상표가 닌텐도 것이며 프로젝트는 독립작이라고 밝힌다.

이 위키에서 눈여겨볼 지점은 두 가지다. 하나는 커밋 메시지 다수가 Co-Authored-By: Claude Opus 5.5로 끝나는, AI 코딩 도구로 만든 대형 게임 프로젝트의 사례라는 점이다. 다른 하나는 온라인 대전이 서버 시뮬레이션 없이 Cloudflare Durable Object를 “메시지 중계기”로만 쓰는 구조라는 점이다.

게임 구성

영역내용
모드Turf War(가장 많이 칠한 팀 승), Zone Control(존 점령으로 100에서 카운트다운, 회전 존·페널티·연장), Boss Battle(협동, 초기 단계, 컨테이너 속 소라게 HULLBREAKER)
무기메인 12종, 서브 15종, 스페셜 19종 — 어떤 메인이든 서브·스페셜과 자유 조합
스테이지7종(낮/황혼). 레이아웃은 절반만 정의하고 180° 회전해 양 팀 필드를 동일하게 만든다
플레이봇 3단계 난이도, 잉크 속 스퀴드 폼(고속 이동·벽 오르기), Tab 맵 디오라마와 Super Jump, 락커(외형 선택)
실행웹(npm run serve) 또는 Electron 데스크톱 앱, macOS 패키징(arm64·x64)

기술 구조

  • 텍스처 공간 잉크. 칠 가능한 모든 면이 하나의 4K 아틀라스 영역을 갖고, GPU가 스플랫을 그리는 동안 거친 CPU 그리드가 점수와 게임플레이 질의를 맞춘다. 같은 잉크를 렌더링과 게임 로직이 서로 다른 해상도로 공유하는 설계다.
  • 데이터로서의 스테이지. 박스·경사로 목록만 정의하면 대칭 필드가 만들어지고, AO는 오프라인으로 굽는다.
  • 이벤트 버스. 무기·액터·매치가 타입 이벤트를 내보내고 이펙트·HUD·오디오가 구독한다. docs/EVENTS.md·docs/CONTRACTS.md에 계약이 문서화돼 있어, 모듈 경계를 문서로 고정해 둔 점이 눈에 띈다.
  • 결정론적 도구. freeze/step 디버그 인터페이스로 필름스트립 캡처·핸들링 측정·봇 시뮬레이션을 프레임 단위로 재현한다.
  • 코드 스타일 규칙. 핫 패스에서 프레임당 할당 금지, 주석은 “왜”를 설명, 새 스테이지는 양쪽 동일성 유지.

온라인 대전 구조 (docs/NET.md)

  • Relay는 얇다. 방 코드마다 Durable Object 하나가 멤버십·host 선출·입장 거부(없는 방·만원·경기 중)와 페이로드의 blind fan-out만 맡는다. 게임 규칙은 서버가 모른다. 이 점은 2026-07-25-aisparkup-post-14738-cloudflare-durable-objects가 다루는 Durable Object의 “방 하나당 객체 하나” 패턴의 실사용 사례다.
  • 소유권 기반 시뮬레이션. 플레이어는 자기 squidkid를 풀 프레임률로 로컬 시뮬레이션하고 20Hz 틱으로 전송한다. host 브라우저가 봇·매치 시계·최종 판정을 맡는다. 타인의 발사체는 시각 전용 ghost이며, 명중은 사격자 화면에서 판정하고 피해자 소유자가 적용한다.
  • 지연 은닉. 수신 측은 송신자별 재생 시계를 “지금”보다 85–300ms 뒤에 두고(틱 1개 + 측정 지터의 2.5배), 3차 Hermite 보간과 최대 180ms 탄도 외삽을 쓴다. 새 데이터가 이미 표시한 순간을 덮으면 임계감쇠 곡선(ω = 13)으로 오차를 풀어 튐을 없앤다.
  • 이탈 처리. 플레이어가 나가면 host가 그 자리를 봇으로 입양하고, host가 나가면 가장 오래된 플레이어가 host·봇·시계·심판을 인수한다.
  • 측정 도구. tools/net-test.mjs가 헤드리스 클라이언트로 실제 대전을 돌려 원격 squidkid의 프레임별 kink·경로 오차를 수치화하고, --net "netlag=40&netjitter=30&netspike=0.01"로 불량 회선을 흉내 낸다.

host 권한 모델이므로 host 브라우저를 신뢰한다는 전제가 깔려 있다. 비공개 방·친구 대전이라는 용도에 맞춘 절충으로 읽힌다(문서가 치팅 방어를 다루지 않는다).

개발 방식과 검증 도구

  • 개발 흐름은 “측정하고 튜닝”에 가깝다. tools/botlab은 실제 게임을 Electron 오프스크린·무음으로 돌려 봇 매치를 시뮬레이션 시간으로 실행하고, 무기별 피해·사망 상황·막힘 비율을 JSON으로 낸다. TUNE='mitts.punchInterval=0.12,...'로 저장소를 바꾸지 않고 밸런스를 시험한다.
  • CONTRIBUTING은 게임플레이 튜닝 PR에 “무엇을 어떻게 측정했는지”를 적도록 요구한다. 에이전트가 만든 변경을 사람이 검증 가능한 수치로 받아들이려는 장치로 볼 수 있다.
  • npm run smoke(8초 오토파일럿, 콘솔 오류 시 실패)와 npm run check-maps(스테이지 레이아웃 점검)가 기본 회귀 검사다.
  • 커밋 이력은 1.0(무기 7종·스테이지 3종) → 1.1(온라인·Boss Battle) → 1.1(Zone Control·신규 스테이지·Electron) 순으로 하루 이틀 간격의 큰 단위 병합이다. 작성자는 최근 30개 커밋 중 LilDannyy 20, Jayden Davis 계열 4이고, 상류 변경을 합치는 병합 커밋(Merge upstream 1.1)과 포크 PR(#8) 병합이 보인다.

한계와 확인되지 않은 점

  • AI 개입 정도는 불명. 근거는 커밋 트레일러의 Co-Authored-By: Claude Opus 5.5뿐이다. README·CONTRIBUTING은 AI 사용을 언급하지 않으며, 어느 부분을 에이전트가 썼고 사람이 얼마나 검토했는지는 알 수 없다.
  • 성능 수치 없음. 수집한 문서에는 지연·프레임률·동시 접속 한계의 실측 결과가 없다. Safari가 느리다는 문구, 16 GB Mac에서 Zone Control 8개 동시 실행이 GPU 프로세스를 죽였다는 botlab 메모가 있는 정도다.
  • 초기 단계 기능. Boss Battle은 커밋 메시지에서 “early”로 표기된다.
  • 자산 주장은 README 인용. “폰트 2개 외 내려받은 자산 없음”은 README 주장이다. 위 기술 설명도 README와 docs/에 근거하며 소스 코드(src/, server/)는 직접 확인하지 않았다.
  • 상표. Splatoon 모방 게임이므로 닌텐도 권리 문제는 저장소가 부인(독립 프로젝트)하고 있을 뿐 법적으로 확인된 사항이 아니다.

위키 관점의 시사점

  • 2026-07-16-pytorchkr-topic-11241-world-of-claudecraft-mmo는 “코어 하나, 호스트 여럿”으로 게임을 에이전트 환경에 쓰는 사례였다면, INKWAVE는 게임 자체를 에이전트 코딩의 결과물로 보이고 그 튜닝 루프(botlab·net-test·smoke)를 사람이 읽는 수치로 남기는 사례다.
  • 빌드 단계 없음·단일 문서 계약·결정론적 재현 도구라는 조합은, 에이전트가 반복 수정하는 코드베이스에서 검증 가능성을 확보하는 한 방식으로 참고할 만하다. 관련 지도는 moc-ai-coding, 실시간 relay 패턴은 moc-cloudflare-open-source에서 이어서 볼 수 있다.