1. 플러그인 개요
| 항목 | 내용 |
| 플러그인 ID | dx-dice |
| 플러그인명 | DX Dice (쌍주사위 포인트 게임) |
| 버전 | 1.0.0 |
| 제작사 | DesignOneX |
| PHP 호환 | PHP 5.6 이상 |
| 필수 의존 | DXCMS, DxPoint (포인트 시스템) |
DX Dice는 DXCMS 기반 사이트에서 회원이 포인트를 베팅하여 컴퓨터와 쌍주사위 대결을 즐기는 포인트 게임 플러그인입니다. 두 개의 주사위를 굴려 합산 점수를 비교하며, 관리자가 승률 확률 등을 직접 조정할 수 있습니다.
2. 주요 기능
2.1 회원 기능
• 주사위 2개 합산 점수 비교 (최소 2점 ~ 최대 12점)
• 유저 점수 > 컴퓨터 점수이면 승리 → 베팅 포인트 획득
• 유저 점수 < 컴퓨터 점수이면 패배 → 베팅 포인트 차감
• 동점이면 무승부 → 포인트 변동 없음
• 누적 전적 (승/패) 확인
• 최근 게임 기록 10건 조회
• 일일 게임 횟수 제한 도달 시 자동 비활성화
2.2 관리자 기능
• 최소·최대 베팅 포인트 설정
• 유저 승리 확률 설정 (1~99%, 기본값 45%)
• 하루 최대 게임 횟수 설정 (0 = 무제한)
• 전체 게임 통계 대시보드
• 회원별 상세 전적 조회
• 게임 로그 전체 조회 및 삭제
3. 설치 방법
3.1 파일 업로드
2. 아래 두 경로에 파일을 업로드합니다.
| 업로드 경로 | 내용 |
| plugins/dx-dice/ | 플러그인 본체 |
| extend/top/00_dice_router.php | 프론트 라우터 파일 |
ℹ️ extend/top/ 폴더가 없으면 직접 생성하세요.
3.2 플러그인 활성화
2. DX Dice 플러그인을 찾아 [활성화] 버튼을 클릭합니다.
3. 활성화 시 DB 테이블(dice_logs, dice_settings)이 자동 생성됩니다.
3.3 설치 확인
4. 관리자 설정
4.1 설정 항목
| 설정 항목 | 설명 |
| 활성화 (is_active) | 1 = 게임 켜짐, 0 = 게임 꺼짐 |
| 최소 베팅 (bet_min) | 회원이 베팅할 수 있는 최소 포인트 (기본값: 10) |
| 최대 베팅 (bet_max) | 회원이 베팅할 수 있는 최대 포인트 (기본값: 1000) |
| 승리 확률 (win_rate) | 유저가 이길 확률 % (1~99, 기본값: 45) |
| 일일 게임 횟수 (daily_limit) | 하루 최대 게임 수, 0 입력 시 무제한 (기본값: 20) |
⚠️ 승리 확률(win_rate)은 1~99 사이로 설정하세요. 50 이상이면 회원에게 유리, 50 미만이면 운영자에게 유리합니다.
5. 관리자 대시보드
5.1 통계 탭
• 전체 승 · 패 횟수 및 승률
• 전체 포인트 증감 합계
5.2 회원 탭
• 회원별 총 게임 수, 승/패, 순포인트, 총 베팅액
• 회원 이름 클릭 시 상세 전적 조회
5.3 로그 탭
• 날짜 · 회원 · 유저 주사위 · 컴퓨터 주사위 · 결과 · 포인트 증감 확인
• 로그 전체 삭제 기능 (복구 불가 — 신중히 사용)
6. 게임 진행 방식
6.1 접속 URL
ℹ️ 로그인한 회원만 게임 페이지에 접속할 수 있습니다. 비로그인 시 로그인 페이지로 자동 이동합니다.
6.2 게임 규칙
• 유저와 컴퓨터 각각 주사위 2개(1~6)를 굴려 합산 점수를 비교합니다.
• 합산 점수: 최소 2점(1+1) ~ 최대 12점(6+6)
• 유저 합산 > 컴퓨터 합산 → 승리
• 유저 합산 < 컴퓨터 합산 → 패배
• 유저 합산 = 컴퓨터 합산 → 무승부
6.3 포인트 처리
| 결과 | 포인트 처리 |
| 승리 | 베팅 포인트 획득 (+bet) |
| 패배 | 베팅 포인트 차감 (-bet) |
| 무승부 | 포인트 변동 없음 (0) |
6.4 승률 조정 원리
| win_rate 설정 | 의미 |
| 45 (기본값) | 유저가 45% 확률로 승리 → 운영자 약간 유리 |
| 50 | 유저와 컴퓨터 동등한 확률 |
| 30 | 유저 30% 승리 → 운영자 많이 유리 |
| 60 | 유저 60% 승리 → 회원 유리 |
7. 파일 구조
| 파일/폴더 | 설명 |
| plugin.php | 플러그인 진입점, 훅 등록 |
| manifest.php | 플러그인 메타 정보 |
| core/install.php | DB 설치 및 설정 헬퍼 함수 |
| admin/index.php | 관리자 페이지 (통계, 설정, 로그) |
| admin/layout.php | 관리자 레이아웃 헤더 |
| admin/layout_end.php | 관리자 레이아웃 푸터 |
| admin/partials/log_table.php | 게임 로그 테이블 컴포넌트 |
| views/index.php | 프론트 게임 화면 |
| extend/top/00_dice_router.php | 프론트 URL 라우터 |
8. 데이터베이스 구조
8.1 dice_logs (게임 로그)
| 컬럼 | 설명 |
| id | 자동 증가 PK |
| member_id | 회원 ID |
| bet | 베팅 포인트 |
| user_dice1 | 유저 주사위 1 (1~6) |
| user_dice2 | 유저 주사위 2 (1~6) |
| com_dice1 | 컴퓨터 주사위 1 (1~6) |
| com_dice2 | 컴퓨터 주사위 2 (1~6) |
| result | 결과 (win/lose/draw) |
| point_delta | 포인트 증감량 |
| created_at | 게임 일시 |
8.2 dice_settings (설정)
| 컬럼 | 설명 |
| key | 설정 키 |
| value | 설정 값 |
9. 트러블슈팅
| 증상 | 해결 방법 |
| 게임 페이지 404 오류 | extend/top/00_dice_router.php 파일이 올바른 위치에 있는지 확인 |
| 포인트가 차감/지급되지 않음 | DxPoint 클래스가 설치되어 있는지 확인 |
| DB 오류 발생 | 플러그인 비활성화 후 재활성화하여 테이블 재생성 |
| 게임 메뉴가 사이드바에 없음 | 플러그인 활성화 여부 및 plugin.php 훅 등록 확인 |
| 승률이 설정과 다르게 느껴짐 | 단기 표본의 편차로 장기적으로는 설정값에 수렴 |
| 일일 제한 초과 후에도 게임 가능 | daily_limit 설정값 확인, 0이면 무제한 |
라이선스
| 항목 | 내용 |
| 재배포·판매 | ❌ 금지 (원천 소스 90% 이상 수정 시 재배포 및 판매 가능) |
| 플러그인 원천 시스템 | DesignOneX 소유 |
| 상업적 사용 | ✅ 상업적 제작에만 허용, 학습용 |
| 라이선스 | 디자인원엑스 라이선스 |
⚠️ 플러그인 코어(plugin.php, core/, admin/) 자체의 재배포 및 판매는 금지됩니다.
