블랙&화이트 게임 모듈

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 이상

---

이용 약관 및 면책 조항

본 모듈을 구매함으로써 아래 조항에 동의한 것으로 간주합니다.

1. 용도 제한: 본 모듈은 커뮤니티 사이트 내 비환전성, 비현금성 포인트 소모형 미니게임 전용입니다. 반드시 해당 용도로만 이용하여야 합니다.

2. 현금성 운영 금지: 포인트의 현금 환전, 현금성 재화 교환, 실물 상품 교환 등 금전적 가치를 부여하는 일체의 행위와 연동하여 운영하는 것을 엄격히 금지합니다.

3. 법적 책임: 본 모듈을 이용하여 발생하는 모든 법적 문제(사행행위 등 규제 및 처벌특례법 위반 포함)에 대한 책임은 전적으로 운영자(구매자) 에게 있으며, 제작자는 이에 대한 어떠한 법적 책임도 부담하지 않습니다.

4. 관련 법률 준수: 구매자는 본 모듈 운영 시 대한민국 관련 법률(게임산업진흥에 관한 법률, 사행행위 등 규제 및 처벌특례법 등)을 준수할 의무가 있습니다.

5. 약관 위반 시: 위 조항을 위반하여 발생하는 모든 민형사상 책임은 운영자(구매자) 본인에게 있으며, 제작자에게 어떠한 손해배상도 청구할 수 없습니다.

6. 재배포 금지: 본 모듈의 무단 재배포, 복제, 2차 판매를 금지합니다.

7. 환불 정책: 디지털 상품의 특성상 구매 후 환불은 불가합니다. 단, 모듈 자체의 결함으로 인한 경우 제작자와 협의할 수 있습니다.