2026년 11월 11일 확인 · nipplejs 최신 v1.0.4(2026-05-26) · MIT 라이선스 · 깃허브 별 1,953 · 걸린 시간은 우리가 직접 1회 잰 값

바이브코딩으로 웹 게임을 만들어 친구에게 링크를 보냈는데, 친구가 폰으로 열고 "아무것도 안 움직여"라고 답하는 경우가 많습니다. 키보드로만 조작하게 만든 게임이라서 그렇습니다. 이 글에서는 클로드 코드에 프롬프트 한 줄을 보내 폰 화면에 가상 조이스틱과 점프 버튼을 붙인 과정을, 직접 만든 작은 게임으로 해 본 그대로 정리했습니다.
왜 폰에서는 게임이 안 움직이나요?
게임 코드가 키보드 입력만 듣고 있기 때문입니다. 우리가 만든 '젬 점프'는 방향키(또는 A · D)로 움직이고 스페이스로 점프하는 작은 캔버스 게임인데, 폰에는 화살표 키가 없으니 화면을 아무리 눌러도 캐릭터가 그대로입니다.


그래서 폰에서 하려면 터치를 받아서 '왼쪽 · 오른쪽 · 점프'로 바꿔 주는 조작 장치를 따로 붙여야 합니다. 직접 만들 수도 있지만, 여러 손가락 처리 · 방향 계산 같은 부분이 은근히 까다롭습니다. 이미 검증된 가상 조이스틱 라이브러리를 쓰면 이 부분을 맡길 수 있습니다.
nipplejs는 무엇인가요?
nipplejs는 터치 화면용 가상 조이스틱을 만들어 주는 자바스크립트 라이브러리입니다. 저장소 설명은 "A virtual joystick for touch capable interfaces"이고, MIT 라이선스라 개인 · 상업 프로젝트 모두 무료로 쓸 수 있습니다. 11월 11일 깃허브 API로 확인한 값은 별 1,953개, 최신 릴리스 v1.0.4(2026년 5월 26일)입니다.

조이스틱을 밀면 방향(각도)과 얼마나 밀었는지(거리 · 세기) 값을 이벤트로 넘겨 줍니다. 그래서 '살짝 밀면 천천히, 끝까지 밀면 빠르게' 같은 아날로그 조작을 만들기 쉽습니다.
클로드 코드에는 뭐라고 보내면 되나요?
아래 한 줄을 게임 폴더에서 클로드 코드에 그대로 보내면 됩니다.

nipplejs로 왼쪽 아래에 가상 조이스틱(미는 세기만큼 속도), 오른쪽 아래에 점프 버튼 붙여 줘. 폰에서 화면이 확대·스크롤되지 않게 touch-action: none, PC에선 키보드 그대로.
순서는 이렇습니다.
- 게임 파일(
index.html등)이 있는 폴더에서 클로드 코드를 엽니다. - 위 프롬프트를 보냅니다. 버튼 위치(왼쪽 아래 · 오른쪽 아래)와 'PC에선 키보드 그대로'를 같이 적는 게 포인트입니다.
- 끝나면 폰으로 열어 보거나, 크롬 개발자 도구의 기기 모드(터치 에뮬레이션)로 확인합니다.
- 조이스틱이 화면 일부를 가리면 "조이스틱 크기 줄여 줘"처럼 한 줄 더 보내 다듬습니다.
우리 시험에서는 약 3분(187초) 만에 조이스틱과 점프 버튼이 붙었습니다. 살짝 밀면 천천히 걷고, 끝까지 밀면 최고 속도로 달리며, 조이스틱을 민 채로 점프 버튼을 함께 누를 수 있었습니다.

클로드가 넣은 핵심 코드는 짧습니다. 조이스틱을 만들고, 민 거리를 0~1 값으로 바꿔 가로 속도에 곱하는 구조입니다.
const stick = nipplejs.create({
zone: document.getElementById("stick"),
mode: "static",
position: { left: "50%", top: "50%" },
size: 140,
});
stick.on("move", (_, d) => {
const push = Math.min(1, d.distance / 70); // 얼마나 밀었나(0~1)
const x = Math.cos(d.angle.radian) * push; // 그중 가로 성분
touchIn.axis = x; // (실제 코드는 가운데 12%를 무시하는 처리 포함)
});
stick.on("end", () => { touchIn.axis = 0; });
같이 막히는 건 없나요?
폰 브라우저의 기본 동작이 하나 더 걸립니다. 화면을 끌거나 두 번 누르면 브라우저가 페이지를 스크롤하거나 확대하려고 해서, 조이스틱을 끌 때 화면이 같이 움직일 수 있습니다. CSS touch-action: none은 그 요소에서 브라우저의 스크롤 · 확대 동작을 끄는 설정입니다(MDN Web Docs).

그래서 프롬프트에 touch-action: none을 함께 적었습니다. 이번 결과물에서 클로드는 이것 말고도 당겨서 새로고침 막기(overscroll-behavior: none), 길게 눌렀을 때 뜨는 메뉴 막기, 아이폰 노치 · 홈 바 여백(safe-area)까지 알아서 넣었습니다.
"폰에서 되게 해 줘"만 보내면 어떻게 되나요?
같은 게임으로 "이 게임 폰에서도 되게 해 줘."만 보내 봤습니다. 85초 만에 왼쪽 아래 ◀ ▶ 버튼과 오른쪽 아래 점프 버튼이 생겼고, 확대 막기도 들어갔습니다. 폰에서 할 수 있게 된다는 점은 같습니다.

차이는 조작감입니다. 화살표 버튼은 누르거나 떼거나 둘 중 하나라 속도가 늘 같습니다. 미는 만큼 속도가 달라지는 조이스틱을 원하면 라이브러리 이름(nipplejs)과 '미는 세기만큼 속도'를 콕 집어 말하는 게 확실했습니다. 실제로 이름만 넣고 세기 조건을 빼고 보냈을 때(177초)는 조이스틱이 붙긴 했지만 '켜짐 · 꺼짐'으로만 처리돼 속도가 일정했습니다.

| 요청 | 걸린 시간 | 생긴 조작 | 속도 |
|---|---|---|---|
| "이 게임 폰에서도 되게 해 줘." | 85초 | ◀ ▶ 버튼 + 점프 | 늘 같음 |
| nipplejs 이름만 지정 | 177초 | 조이스틱 + 점프 | 늘 같음(켜짐 · 꺼짐) |
| nipplejs + "미는 세기만큼 속도" | 187초 | 조이스틱 + 점프 | 미는 만큼 달라짐 |
주의할 점은 무엇인가요?
- 걸린 시간은 1회 측정입니다. 2026년 11월 11일 클로드 코드(2.1.322)로 한 번씩 잰 값이며, 모델 · 게임 크기에 따라 달라집니다.
- 버전을 확인하세요. 이번에 클로드는 최신 1.0.4 대신 0.10.2를 CDN으로 불러왔습니다. 1.x 문서를 확인하지 못해 사용법이 확실한 버전으로 고정했다고 답했습니다. 최신 버전을 쓰고 싶다면 "nipplejs 1.0.4 기준으로"라고 적어 주세요.
- CDN 의존. 인터넷이 없는 곳에서는 조이스틱이 뜨지 않습니다. 오프라인에서도 돌려야 하면 파일을 내려받아 같이 넣어 달라고 하세요.
- 라이선스. nipplejs는 MIT입니다. 배포할 때 라이선스 문구를 남겨 두면 됩니다.
한 번에 정리하면?
- 키보드 전용 웹 게임은 폰에서 안 움직인다 → 터치 조작을 따로 붙여야 한다.
- 클로드 코드에 "nipplejs로 왼쪽 아래 조이스틱(미는 세기만큼 속도), 오른쪽 아래 점프 버튼, touch-action: none, PC에선 키보드 그대로" 한 줄이면 약 3분.
- 막연하게 "폰에서 되게 해 줘"만 해도 버튼은 생기지만, 아날로그 조작을 원하면 라이브러리 이름과 조건을 콕 집는다.
다음 편에서는 이 게임을 3D로 바꾸는 무료 도구 다섯 개를 다룹니다.
출처
- nipplejs 저장소: https://github.com/yoannmoinet/nipplejs (2026-11-11 깃허브 API 확인: 별 1,953 · MIT · v1.0.4 2026-05-26)
- MDN Web Docs, touch-action: https://developer.mozilla.org/en-US/docs/Web/CSS/touch-action
- 게임 · 녹화 · 시간 측정: AItoZ 직접 시험(2026-11-11, 크롬 폰 터치 에뮬레이션)
- 영상: AItoZ 유튜브 쇼츠 '클로드 코드로 만든 게임, 폰에서 하게 만드는 한 줄'
