Local game preview and browser launch. Automatically starts a local server and opens the game in the browser. Triggers on "run game", "preview", "launch game", "open in browser", "test game", "게임 실행", "미리보기", "실행해줘"
게임 프로젝트의 로컬 서버를 시작하고 브라우저에서 바로 확인할 수 있게 합니다. 비개발자도 한 마디로 게임을 실행할 수 있도록 자동화합니다.
프로젝트 루트에서 게임 파일 위치를 찾는다:
탐색 우선순위:
1. playforge.config.json → gameDir 필드에서 경로 확인
2. game/index.html → game/ 디렉토리
3. index.html → 현재 디렉토리
4. dist/index.html → 빌드 출력 디렉토리
index.html을 찾지 못하면 사용자에게 위치를 물어본다.
아래 순서로 사용 가능한 도구를 찾고, 첫 번째로 발견된 도구를 사용한다:
npx --version # npm/npx 설치 확인
사용 가능하면:
npx serve <gameDir> -p 3000 --no-clipboard &
python3 --version || python --version # Python 설치 확인
사용 가능하면:
cd <gameDir> && python3 -m http.server 3000 &
# 또는
cd <gameDir> && python -m http.server 3000 &
Node.js와 Python이 모두 없으면 VSCode Live Server 확장 설치를 안내한다:
로컬 서버 도구를 찾을 수 없습니다.
가장 쉬운 방법: VSCode Live Server 확장 설치
1. VSCode 왼쪽 사이드바에서 확장(Extensions) 아이콘 클릭
2. "Live Server" 검색 → Ritwick Dey 제작 확장 설치
3. index.html 파일을 우클릭 → "Open with Live Server" 클릭
설치 후 에이전트에게 다시 "게임 실행해줘"라고 요청하세요.
서버가 시작된 후 접속 가능 여부를 확인한다:
# 서버 응답 확인 (최대 5초 대기)
curl -s -o /dev/null -w "%{http_code}" http://localhost:3000
200 응답이 오면 성공. 실패하면 포트 충돌 확인:
# 포트 사용 중이면 다른 포트 시도 (3001, 3002, ...)
서버 시작 후, 반드시 로컬 IP를 확인한다. 이 단계를 생략하지 않는다:
# Windows
ipconfig | grep -A5 "Wi-Fi" | grep "IPv4"
# 또는
ipconfig | grep "IPv4"
# Mac/Linux
ifconfig | grep "inet " | grep -v 127.0.0.1
서버가 시작되면 localhost와 로컬 IP 주소를 모두 사용자에게 안내한다:
게임이 실행 중입니다!
🌐 PC 브라우저: http://localhost:<PORT>
📱 모바일 (같은 Wi-Fi): http://<로컬IP>:<PORT>
서버를 중지하려면 터미널에서 Ctrl+C를 누르세요.
중요: 모바일 테스트를 위해 로컬 IP 주소를 반드시 함께 안내한다. localhost만 안내하지 않는다.
사용자가 "모바일에서 어떻게 보여?" 라고 물으면:
# game-eye로 모바일 뷰포트 스크린샷
game-eye screenshot http://localhost:3000 --viewport 390x844 -o mobile-preview.png
사용자가 특정 포트를 요청하면 해당 포트 사용:
/game-preview 8080 → 포트 8080 사용