♟ MB 모아체스 플러그인 매뉴얼
MB 모아체스는 DXCMS 프로필 더보기에서 회원끼리 1:1 실시간 체스 대국을 즐길 수 있는 플러그인입니다.
1. 설치
mb-chess.zip 압축 해제plugins/mb-chess/ 폴더를 DXCMS plugins/ 디렉토리에 업로드- 관리자 → 플러그인 메뉴에서 MB 모아체스 활성화
2. 시작 방법
- 상대방 프로필 → 더보기 클릭
- ♟ MB 체스 버튼 클릭
- 시간 제한 선택 후 신청 클릭
- 상대방이 수락하면 대국 시작
| 시간 옵션 |
설명 |
| 3분 |
빠른 대국 |
| 5분 |
기본 (권장) |
| 10분 |
여유 있는 대국 |
| 무제한 |
시간 제한 없음 |
3. 게임 화면 구성
┌─────────────────────────────────────────┐
│ ♟ MB Chess ⬜ 백 차례 기권 │ ← 헤더
├───────────────────────────┬─────────────┤
│ │ 상대방 │
│ │ ────── │
│ 체스판 │ 나 (나) │
│ 8×8 격자 │ ────── │
│ │ 기보 │
│ │ 채팅 │
└───────────────────────────┴─────────────┘
- 상단 뱃지: 현재 차례 (⬜ 백 / ⬛ 흑)
- 패널 상단: 상대방 (위), 나 (아래)
- 패널 하단: 기보 기록, 채팅
4. 기물 이동 방법
- 이동할 기물 클릭 → 초록 힌트 표시
- 이동할 위치 클릭 → 이동 완료
| 기물 |
백 |
흑 |
이동 방식 |
| 킹 |
♔ |
♚ |
상하좌우 대각 1칸 |
| 퀸 |
♕ |
♛ |
모든 방향 무제한 |
| 룩 |
♖ |
♜ |
상하좌우 무제한 |
| 비숍 |
♗ |
♝ |
대각선 무제한 |
| 나이트 |
♘ |
♞ |
L자형 이동 |
| 폰 |
♙ |
♟ |
앞으로 1칸 (첫 수 2칸) |
5. 특수 규칙
폰 승급
- 폰이 상대방 끝 줄에 도달하면 승급 팝업 표시
- 퀸 / 룩 / 비숍 / 나이트 중 선택
체크 / 체크메이트
- 킹이 공격받으면 ⚠ 체크 표시 (킹 칸이 빨간색)
- 도망갈 곳이 없으면 체크메이트 → 게임 종료
스테일메이트
- 이동 가능한 수가 없으나 체크가 아닌 경우 무승부
6. 게임 중 기능
| 버튼 |
기능 |
| ↩ 무르기 |
직전 수 취소 요청 (상대방 승인 필요) |
| ½ 무승부 |
무승부 제안 (상대방 승인 필요) |
| 기권 |
패배 인정 후 게임 종료 |
| 💾 PGN 저장 |
기보를 .pgn 파일로 다운로드 |
7. 흑/백 구분
- 신청자 → 백(White) — 먼저 시작
- 수락자 → 흑(Black) — 나중 시작
- 흑 플레이어는 보드가 자동으로 뒤집혀 내 기물이 아래에 표시
8. 타이머
- 수당 시간이 0이 되면 시간 초과 패배
- 남은 시간이 10초 이하이면 빨간색으로 표시
9. 소켓 이벤트 (개발자용)
| 이벤트 |
설명 |
chess_invite |
대국 신청 |
chess_invite_accept |
신청 수락 |
chess_invite_reject |
신청 거절 |
chess_move |
기물 이동 |
chess_undo_req |
무르기 요청 |
chess_undo_accept |
무르기 수락 |
chess_undo_reject |
무르기 거절 |
chess_draw_offer |
무승부 제안 |
chess_draw_accept |
무승부 수락 |
chess_draw_reject |
무승부 거절 |
chess_resign |
기권 |
chess_timeout |
시간 초과 |
chess_chat |
채팅 |
chess_end |
게임 종료 |
10. 시스템 요구사항
- DXCMS v8.8.3 이상
- DX Socket 연결 필요 (
dxk_... API 키)
- PHP 5.6 ~ 8.x 호환
라이선스
| 항목 |
내용 |
| 라이선스명 |
DesignOneX License (디자인원엑스 라이선스) |
| 원천 소유 |
DesignOneX — designonex.com |
| 재배포·판매 |
❌ 금지 (원천 소스 90% 이상 수정 시 재배포·판매 가능) |
| 상업적 사용 |
✅ 상업적 프로젝트 제작에만 허용 (학습·개인 포트폴리오 포함) |
| 플러그인 원천 |
plugin.php, core/, admin/ 자체의 재배포 및 판매 금지 |
| 보증 |
본 플러그인은 현재 상태 그대로 제공되며 어떠한 명시적·묵시적 보증도 없습니다. |
🚫 plugin.php, core/, admin/ 디렉터리의 코드를 그대로 또는 일부 수정하여 재배포하거나 판매하는 행위는 엄격히 금지됩니다.
✅ 상업적 프로젝트 제작 및 사용은 허용됩니다. (학습·개인 포트폴리오 포함)
✅ 원천 소스를 90% 이상 수정한 경우 재배포·판매가 가능합니다.
