숫자 야구 ⚾

서로 다른 숫자를 맞히는 숫자 야구 게임 모바일 웹앱. 혼자 하기, 친구와 대결, KBO 구단 팬 랭킹까지.

▶ 라이브: https://homerun-bb.vercel.app (구 주소 number-baseball-chi.vercel.app로 들어와도 이쪽으로 자동 이동)

규칙

• 컴퓨터가 서로 다른 숫자(각 자리 0~9, 중복 없음, 맨 앞자리 0 제외)를 정합니다. 자릿수는 3자리 또는 4자리(설정에서 선택).
• 추측을 입력하면 판정합니다:
  • 스트라이크(S): 숫자와 위치가 모두 일치
  • 볼(B): 숫자는 있으나 위치가 다름
  • 아웃(O): 하나도 없음
• 모든 자리가 스트라이크면 승리. 시도 횟수는 설정에서 5·10·15회 또는 직접 입력(기본 15회).
• 키패드 메모(O·B·S 표시)와 칸별 후보 메모, 선택형 힌트(전부 아웃·전부 있음이면 자동 메모)를 쓸 수 있습니다.

모드

• 솔로: 혼자 풀기. 응원 구단을 고르면 랭킹전(시도 15회 고정, 점수 = 16 − 시도 횟수, 4자리는 2배, 실패 0점)으로 기록됩니다.
• 멀티: 온라인(방 코드) 또는 한 기기에서 번갈아 하는 오프라인.
  • 스피드: 같은 숫자를 2~6명이 동시에 풀어 추측 횟수 + 걸린 시간으로 순위.
  • 주고받기: 1:1로 서로 숫자를 정하고 번갈아 추측. 선공이 맞히면 후공에게 마지막 기회.
• KBO: KBO 10개 구단 팬 대항전 — 구단별 솔로 랭킹, 구단 간 대결 전적, 개인 평균 점수 순위(10판 배치 후 등급).

스택

• Vite + React + TypeScript
• PWA (홈 화면 추가 + 오프라인)
• 패키지 매니저: pnpm (Vite 8의 rolldown 네이티브 바이너리 이슈로 npm 대신 사용)

개발

pnpm install
pnpm dev       # 개발 서버
pnpm test      # 단위 테스트 (게임 로직)
pnpm build     # 프로덕션 빌드

구조

• src/game/logic.ts — 정답 생성·판정(순수 함수) + 테스트
• src/game/useGame.ts — 상태 관리 reducer/훅 + 테스트
• src/components/ — GuessPad(공용 입력 보드) · Keypad · History · ResultBanner · KboBoard 등
• src/versus/ — 멀티 모드(로컬·온라인 스피드/주고받기)
• src/net/ — 온라인 대전 소켓·프로토콜
• server/ — 온라인 대전·랭킹 서버(Node + Socket.IO, Postgres)
• scripts/gen-icons.mjs — PWA 아이콘 생성기

라이선스

PolyForm Noncommercial 1.0.0 · Copyright (c) 2026 dlwhsk0

• 개인 학습·연구·취미 등 비상업적 목적의 사용, 수정, 공유는 자유롭다. 공유할 때는 이 라이선스와 저작권 표시를 함께 전달해야 한다.
• 상업적 이용은 허락하지 않는다. 유료 서비스·광고 수익·사내 상용 제품 등에 쓰거나, 이 게임(코드·디자인·이름)을 복제해 수익을 내는 서비스로 운영하려면 저작권자에게 사전에 서면 허락을 받아야 한다. 문의: GitHub @dlwhsk0
• 위반 시 라이선스는 종료되며, 저작권 침해에 대해 법적 조치를 취할 수 있다.
• 이 레포에 기여한 코드도 같은 라이선스로 배포된다.

제3자 자료

public/teams/*의 KBO 구단 엠블럼과 public/kbo-logo.png는 각 구단·KBO의 상표·저작물로, 이 라이선스의 대상이 아니다. 팬 콘텐츠 표시 목적으로만 쓰며 권리는 각 소유자에게 있다. 재사용하려면 해당 권리자의 정책을 따라야 한다. 이 프로젝트는 KBO 및 각 구단과 관련이 없는 비공식 팬 게임이다.