원문: 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에서 이어서 볼 수 있다.