토너먼트 맞고 (Tournament Go-Stop)

이 프로젝트는 클래식 한국 고스톱 게임을 웹 브라우저에서 즐길 수 있도록 구현한 싱글 플레이어 게임입니다. 플레이어는 16인 토너먼트에 참가하여 개성 넘치는 AI 상대들을 차례로 꺾고 최종 우승을 목표로 합니다.

호스팅 이력: 본 프로젝트는 Vercel에서 운영되었으나 2026-08에 GitHub Pages로 전환했습니다. 공식 라이브 데모는 위 Pages URL입니다.

✨ 주요 기능

• 토너먼트 모드: 15명의 독특한 AI 상대와 16인 단판 토너먼트 방식으로 경쟁합니다. 라운드가 진행될수록 상대는 더 강해집니다.
• 전략적 AI: 단순한 랜덤 플레이가 아닌, 공격(족보 완성)과 수비(상대 족보 방해)를 모두 고려하는 휴리스틱 기반의 AI 로직이 탑재되어 있습니다.
• 클래식 고스톱 규칙: '고/스톱', '뻑', '쪽', '따닥' 등 기본적인 규칙과 다양한 족보(광, 띠, 열끗, 피)를 충실히 구현했습니다.
• 특수 규칙(박): '고박', '광박', '피박' 등 점수를 두 배로 만드는 박 규칙이 적용되어 게임의 긴장감을 더합니다.
• 시각적 피드백: 부드러운 카드 애니메이션과 족보 완성 시 빛나는 하이라이트 효과로 게임의 몰입감을 높였습니다.
• 반응형 UI: 데스크톱과 모바일 환경 모두에서 편안하게 플레이할 수 있도록 UI가 최적화되어 있습니다.
• 게임 상태 저장: 토너먼트 진행 상황이 브라우저의 로컬 스토리지에 자동으로 저장되어, 언제든지 게임을 중단하고 다시 이어할 수 있습니다.
• AI 자동 플레이: 플레이어가 원할 때 자신의 차례를 AI에게 맡겨 자동으로 플레이하게 할 수 있습니다.

🛠️ 기술 스택

• 프론트엔드: React (Hooks), TypeScript
• 스타일링: Tailwind CSS, Custom CSS (애니메이션)
• AI 로직: 순수 TypeScript로 구현된 휴리스틱 알고리즘
• 개발 환경: 빌드 과정 없이 importmap을 사용하여 브라우저에서 직접 ES 모듈을 로드합니다.

룰 설명

• 목표: 라운드에서 7점 이상을 먼저 획득하여 승리하고, 상대의 자본금을 모두 빼앗아 토너먼트에서 승리하는 것입니다.
• 진행: 자신의 손 패에서 바닥에 깔린 패와 같은 월(month)의 패를 내고, 덱에서 한 장을 뒤집어 패를 가져옵니다.
• 주요 족보:
  • 광(光): 3장(비광 제외 시 3점, 포함 시 2점), 4장(4점), 5장(15점)
  • 띠(帶): 5장(1점)부터 1장마다 +1점, 홍단/청단/초단(각 3점)
  • 열끗(끗): 5장(1점)부터 1장마다 +1점, 고도리(새 3마리, 5점)
  • 피(皮): 10장(1점)부터 1장마다 +1점 (쌍피는 2장으로 계산)
• 고/스톱: 7점 이상 획득 시, 라운드를 끝내는 '스톱' 또는 더 높은 점수를 위해 계속하는 '고'를 선택할 수 있습니다. '고'를 할 때마다 점수 배율이 올라가지만, 상대가 승리할 경우 '고박'을 당할 수 있습니다.

🚀 프로젝트 실행 방법

이 프로젝트는 별도의 빌드 과정이 필요 없습니다. 로컬 웹 서버만 있으면 바로 실행할 수 있습니다.

1. 저장소 복제(Clone)

   git clone https://github.com/your-username/tournament-gostop.git
   cd tournament-gostop

2. 로컬 웹 서버 실행 Python이 설치되어 있다면, 다음 명령어로 간단히 웹 서버를 실행할 수 있습니다.

   # Python 3.x
   python -m http.server
   
   # Python 2.x
   python -m SimpleHTTPServer

   또는 Node.js 환경이라면 http-server 패키지를 사용할 수 있습니다.

   npx http-server

3. 브라우저에서 열기 웹 브라우저를 열고 http://localhost:8000 (또는 서버가 실행된 주소)로 접속합니다.

📂 코드 구조

.
├── components/           # 재사용 가능한 리액트 컴포넌트
│   ├── Card.tsx          # 화투패 컴포넌트
│   ├── GameBoard.tsx     # 게임 보드 (바닥 패, 덱)
│   ├── PlayerArea.tsx    # 플레이어 정보 및 손 패, 획득한 패 영역
│   ├── ScoreBreakdownModal.tsx # 라운드 종료 시 점수 계산 내역 모달
│   └── TournamentModal.tsx   # 토너먼트 관련 모달 (인트로, 대진표 등)
├── services/             # 비즈니스 로직 및 서비스
│   └── aiLogic.ts        # AI의 전략적 의사결정 로직
├── types.ts              # 프로젝트에서 사용하는 TypeScript 타입 및 인터페이스
├── constants.ts          # 카드 데이터, 상대 프로필 등 게임 상수
├── App.tsx               # 메인 애플리케이션 컴포넌트 (게임 로직, 상태 관리)
├── index.html            # HTML 진입점, importmap, CSS 애니메이션
└── index.tsx             # React 애플리케이션 마운트

🌱 향후 개선 및 기여 방안

• 사운드 이펙트 추가: 카드 효과음, '고/스톱' 음성, 배경 음악 등을 추가하여 생동감을 높입니다.
• 고급 규칙 구현: '흔들기', '총통', '나가리' 등 더 다양한 고스톱 규칙을 추가합니다.
• AI 성능 고도화: 더 정교한 가치 평가 함수나 간단한 트리 탐색을 도입하여 AI의 전략 수준을 높입니다.
• 애니메이션 강화: 족보 완성 시 더 화려하고 인터랙티브한 애니메이션을 추가합니다. (예: 고도리 완성 시 새들이 날아가는 효과)
• 설정 메뉴: 사운드 on/off, 애니메이션 속도 조절 등 게임 설정을 변경할 수 있는 기능을 추가합니다.