1. 플러그인 개요
| 항목 | 내용 |
| 플러그인 ID | dx-rps |
| 플러그인명 | DX RPS (가위바위보 포인트 게임) |
| 버전 | 1.0.0 |
| 제작사 | DesignOneX |
| PHP 호환 | PHP 5.6 이상 |
| 필수 의존 | DXCMS, DxPoint (포인트 시스템) |
DX RPS는 DXCMS 기반 사이트에서 회원이 포인트를 베팅하여 컴퓨터와 가위바위보 3판 대결을 즐길 수 있는 포인트 게임 플러그인입니다. 관리자는 베팅 한도, 일일 게임 횟수 제한, 활성화 여부 등을 자유롭게 설정할 수 있습니다.
2. 주요 기능
2.1 회원 기능
• 가위(✌️) · 바위(✊) · 보(🖐) 선택
• 3판 중 2판 승리 시 베팅 포인트 획득, 패배 시 차감
• 무승부 시 포인트 반환
• 오늘의 전적 및 누적 전적(승/무/패) 확인
• 최근 게임 기록 10건 조회
• 가위/바위/보 픽 선호도 통계 확인
• 일일 게임 횟수 제한 도달 시 자동 비활성화
2.2 관리자 기능
• 최소·최대 베팅 포인트 설정
• 하루 최대 게임 횟수 설정 (0 = 무제한)
• 전체 게임 통계 대시보드 (총 게임 수, 승/무/패, 포인트 증감)
• 오늘 게임 수 실시간 확인
• 회원별 상세 전적 조회
• 픽 선호도 분석 (전체/회원별)
• 게임 로그 전체 조회 및 삭제
3. 설치 방법
3.1 파일 업로드
2. 아래 두 경로에 파일을 업로드합니다.
| 업로드 경로 | 내용 |
| plugins/dx-rps/ | 플러그인 본체 |
| extend/top/00_rps_router.php | 프론트 라우터 파일 |
ℹ️ extend/top/ 폴더가 없으면 직접 생성하세요.
3.2 플러그인 활성화
2. DX RPS 플러그인을 찾아 [활성화] 버튼을 클릭합니다.
3. 활성화 시 DB 테이블(rps_logs, rps_settings)이 자동 생성됩니다.
3.3 설치 확인
4. 관리자 설정
4.1 설정 항목
| 설정 항목 | 설명 |
| 활성화 (is_active) | 1 = 게임 켜짐, 0 = 게임 꺼짐 |
| 최소 베팅 (bet_min) | 회원이 베팅할 수 있는 최소 포인트 (기본값: 10) |
| 최대 베팅 (bet_max) | 회원이 베팅할 수 있는 최대 포인트 (기본값: 1000) |
| 일일 게임 횟수 (daily_limit) | 하루 최대 게임 수, 0 입력 시 무제한 (기본값: 30) |
⚠️ 베팅 최솟값은 반드시 1 이상으로 설정하세요. 0 이하로 설정 시 게임이 정상 동작하지 않을 수 있습니다.
5. 관리자 대시보드
5.1 통계 탭
• 전체 승 · 무 · 패 횟수
• 전체 포인트 증감 합계 (플러스: 회원 순이익, 마이너스: 회원 순손실)
• 가위 · 바위 · 보 픽 선호도 비율
5.2 회원 탭
• 회원별 총 게임 수, 승/무/패, 순포인트, 총 베팅액
• 회원 이름 클릭 시 상세 전적 조회
5.3 로그 탭
• 날짜 · 회원 · 결과 · 베팅액 · 포인트 증감 확인
• 로그 전체 삭제 기능 (복구 불가 — 신중히 사용)
6. 게임 진행 방식
6.1 접속 URL
ℹ️ 로그인한 회원만 게임 페이지에 접속할 수 있습니다. 비로그인 시 로그인 페이지로 자동 이동합니다.
6.2 게임 규칙
• 컴퓨터가 랜덤으로 선택하며 3판을 진행합니다.
• 3판 중 2판 이상 이기면 승리 → 베팅 포인트 획득
• 3판 중 2판 이상 지면 패배 → 베팅 포인트 차감
• 동점(1승 1패 1무 등)이면 무승부 → 포인트 변동 없음
6.3 포인트 처리
| 결과 | 포인트 처리 |
| 승리 | 베팅 포인트 그대로 획득 (+bet) |
| 패배 | 베팅 포인트 차감 (-bet) |
| 무승부 | 포인트 변동 없음 (0) |
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_rps_router.php | 프론트 URL 라우터 |
8. 데이터베이스 구조
8.1 rps_logs (게임 로그)
| 컬럼 | 설명 |
| id | 자동 증가 PK |
| member_id | 회원 ID |
| bet | 베팅 포인트 |
| user_pick | 유저 선택 (scissors/rock/paper) |
| com_pick | 컴퓨터 선택 |
| result | 결과 (win/lose/draw) |
| point_delta | 포인트 증감량 |
| created_at | 게임 일시 |
8.2 rps_settings (설정)
| 컬럼 | 설명 |
| key | 설정 키 |
| value | 설정 값 |
9. 트러블슈팅
| 증상 | 해결 방법 |
| 게임 페이지 404 오류 | extend/top/00_rps_router.php 파일이 올바른 위치에 있는지 확인 |
| 포인트가 차감/지급되지 않음 | DxPoint 클래스가 설치되어 있는지 확인 |
| DB 오류 발생 | 플러그인 비활성화 후 재활성화하여 테이블 재생성 |
| 게임 메뉴가 사이드바에 없음 | 플러그인 활성화 여부 및 plugin.php 훅 등록 확인 |
| 일일 제한 초과 후에도 게임 가능 | daily_limit 설정값 확인, 0이면 무제한 |
라이선스
| 항목 | 내용 |
| 재배포·판매 | ❌ 금지 (원천 소스 90% 이상 수정 시 재배포 및 판매 가능) |
| 플러그인 원천 시스템 | DesignOneX 소유 |
| 상업적 사용 | ✅ 상업적 제작에만 허용, 학습용 |
| 라이선스 | 디자인원엑스 라이선스 |
⚠️ 플러그인 코어(plugin.php, core/, admin/) 자체의 재배포 및 판매는 금지됩니다.
