♟ 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 호환
라이선스
디자인원엑스 라이선스 참고
https://designonex.com/notice/view/1787577858493247
