블랙&화이트 게임 모듈

TV 프로그램 '더 지니어스'의 흑과백 룰을 기반으로 한 1대1 실시간 대전 카드게임 모듈입니다. 포인트를 걸고 실시간으로 상대와 심리전을 펼치는 전략적 커뮤니티 미니게임입니다.

---

게임 소개

각 플레이어는 0~8까지 9장의 카드를 보유하며, 짝수는 흑(黑), 홀수는 백(白) 카드입니다. 매 라운드마다 선공이 먼저 카드를 내면, 후공은 상대 카드의 색깔만 확인한 뒤 자신의 카드를 선택합니다. 숫자가 높은 쪽이 승리하며, 9라운드 중 더 많이 이긴 플레이어가 최종 승자가 됩니다.

(더 지니어스 흑과백 소개영상)

https://www.youtube.com/watch?v=F0X8JbX4Mjk

---

주요 기능

게임 시스템

• 1대1 실시간 대전 - 웹소켓 없이 폴링 기반으로 실시간 턴제 대전 구현

• 비대칭 정보 전략 - 후공은 상대 카드의 색깔(흑/백)만 보고 판단하는 심리전

• 9라운드 세트제 - 기본 9라운드 진행, 동점 시 연장전 자동 진행

• 턴 타임아웃 - 제한 시간 내 미제출 시 랜덤 카드 자동 제출 (기본 30초)

• vs CPU 모드 - 상대 없이 혼자서도 즉시 플레이 가능

베팅 & 포인트

• 포인트 베팅 - 방 생성 시 베팅액 설정, 상대방도 동일 금액 자동 차감

• 친선전 모드 - 포인트 없이 순수하게 즐기는 모드

• 수수료 시스템 - 승리 시 관리자 설정 비율만큼 수수료 차감 (사이트 수익)

• CPU 별도 베팅 한도 - CPU 대전 최대 베팅액을 따로 설정 가능

• 무승부 환불 - 무승부 시 양측 베팅 포인트 전액 환불

사용자 페이지

• 로비 - 대기 중인 방 목록, 방 생성, vs CPU, 내 진행 중 게임 표시

• 게임 방 - 카드 선택/제출, 라운드 그리드, 실시간 타이머

• 전적 페이지 - 총 게임수/승/패/무/승률 통계 카드, 상세 게임 기록 목록

• 랭킹 페이지 - 전체 PvP 랭킹 (승수/승률/수익 기준, CPU전 제외)

• 자동 로비 갱신 - 3초마다 방 목록/포인트 자동 갱신

• 실시간 카운트다운 - 남은 턴 시간 표시, 5초 이하 긴급 경고

몰수패 & 이탈 방지

• 페이지 이동 시 몰수패 - 로비/전적/랭킹 등 링크 클릭 시 자동 몰수패 처리

• 브라우저 닫기 대응 - beforeunload + Beacon API로 브라우저 종료 시에도 처리

• 포인트 정산 - 몰수패 시에도 베팅 포인트 정상 정산 (패자 차감, 승자 지급)

관리자 페이지

• 게임 설정 - 턴 타임아웃, 수수료율, 최소/최대 베팅액, CPU 최대 베팅액, 최대 방수

• 대시보드 - 총 게임수, 총 베팅 포인트, 총 수수료(사이트 수익) 통계

 

---

게임 규칙 요약

항목내용카드0~8 총 9장 (짝수=흑, 홀수=백)라운드9라운드 (동점 시 연장전)선공 결정1라운드 주사위, 이후 승자가 선공후공 힌트상대 카드의 색깔(흑/백)만 확인 가능승리 조건높은 숫자가 이김, 같으면 무승부최종 승리9라운드 중 더 많이 이긴 쪽 승리

---

기본 설정값

항목기본값턴 타임아웃30초수수료율10%최소 베팅액100P최대 베팅액50,000PCPU 최대 베팅액제한 없음최대 동시 방수50개

모든 설정은 관리자 페이지에서 자유롭게 변경 가능합니다.

---

설치 방법

1. qblackwhite 폴더를 Rhymix의 modules/ 디렉토리에 업로드

2. 관리자 페이지 →대시보드에서 DB설정 후 설치된 모듈에서 블랙&화이트 확인

3. 사이트맵에서 블랙&화이트 모듈로 메뉴 생성

4. 관리자 설정에서 수수료율/베팅 설정 조정

5. 완료!

---

요구 사항

• Rhymix 2.1 이상

• PHP 7.4 이상

• MySQL 5.7 / MariaDB 10.2 이상