MB Gomoku — 1:1 오목 플러그인 매뉴얼
DesignOneX · designonex.com DXCMS v8.8.3+
개요
MB Gomoku 는 DXCMS 회원 간 1:1 실시간 오목 플러그인입니다. DX Socket 을 시그널링 서버로 활용하며, MB Profile Extend 의 더보기 버튼에 자동 등록됩니다.
필수 조건
| 조건 |
설명 |
| DXCMS |
v8.8.3 이상 |
| dx-socket |
활성화 + API 키 발급 필수 |
| mb-profile-extend |
더보기 버튼 연동 |
설치
1. 파일 업로드
plugins/
└── mb-gomoku/
├── plugin.json
└── plugin.php
2. 플러그인 활성화
관리자 → 플러그인 → MB Gomoku → 활성화
더보기 모달 위치
프로필 모달 → [더보기 ...] 클릭
┌─────────────────────────┐
│ 더보기 — 홍길동 │
│─────────────────────────│
│ 📹 MB 화상채팅 │
│ 📞 MB 전화통화 │
│ 🖥 MB 화면공유 │
│ ⚫ MB 오목 │ ← MB Gomoku
└─────────────────────────┘
사용 방법
대국 신청
1. 프로필 모달 → [더보기 ...] 클릭
2. [⚫ MB 오목] 클릭
3. 시간 제한 선택 (15초 / 30초 / 60초 / 무제한)
4. [신청] 버튼 클릭
5. 상대방 수락 대기 (30초 타임아웃)
대국 수락
1. 수신 모달 자동 표시
2. [수락] 또는 [거절] 선택
3. 수락 시 → 대국 시작 (흑 선공)
규칙
| 항목 |
내용 |
| 바둑판 |
15×15 |
| 선공 |
흑 (신청자) |
| 후공 |
백 (수락자) |
| 승리 조건 |
가로·세로·대각선 5목 |
| 금수 |
흑에만 적용 (33, 44, 장목) |
금수 규칙 (흑만 적용)
| 금수 |
설명 |
| 33 |
열린 3 이 두 방향 이상 동시 생성 |
| 44 |
4목 이 두 방향 이상 동시 생성 |
| 장목 |
6목 이상 |
금수 위치 클릭 시 ⚠️ 금수 위치입니다. 메시지 표시 후 착수 불가
화면 구성
대국 신청 모달
┌──────────────────────────────┐
│ 수당 시간 제한 │
│ [15초] [30초] [60초] [무제한]│
│ [취소] [신청] │
└──────────────────────────────┘
메인 대국 화면 (데스크톱)
┌─────────────────────────────┬──────────────┐
│ │ ⚫ 홍길동 │
│ │ 00:30 │
│ 바둑판 │──────────────│
│ (전통 나무색 15×15) │ ⚪ 김철수 │
│ │ --:-- │
│ │──────────────│
│ │ 기보 │
│ │──────────────│
│ │ [↩ 무르기] │
│ │──────────────│
│ │ 채팅 │
└─────────────────────────────┴──────────────┘
모바일 화면
┌─────────────────────────────┐
│ ⚫ MB 오목 [내 차례(흑)] │
├─────────────────────────────┤
│ │
│ 바둑판 (터치 착수) │
│ │
├──────────────┬──────────────┤
│ ⚫홍길동 00:30│ ⚪김철수 --:-│
├──────┬───────┬──────┬───────┤
│↩무르기│💾기보 │💬채팅│🏳기권 │
└──────┴───────┴──────┴───────┘
바둑판 표시
| 요소 |
설명 |
| 나무색 배경 |
전통 바둑판 느낌 |
| 화점 (별점) |
9개 표시 |
| 좌표 |
가로 AO, 세로 115 |
| 마지막 수 |
십자 표시 |
| 호버 미리보기 |
착수 전 반투명 돌 표시 |
| 이동 힌트 |
없음 (오목 특성상 자유 착수) |
컨트롤 기능
| 기능 |
설명 |
| ↩ 무르기 |
상대방 동의 후 양쪽 1수씩 취소 |
| 💾 기보 저장 |
SGF 파일 다운로드 |
| 🏳 기권 |
확인 후 기권 → 패배 처리 |
| 💬 채팅 |
대국 중 실시간 채팅 |
| 👁 관전 |
진행 중인 대국 관전 |
무르기
[↩ 무르기 요청] 클릭
→ 상대방에게 무르기 요청 알림
→ 상대방: [거절] 또는 [허용] 선택
→ 허용 시: 양쪽 모두 1수씩 되돌림
→ 거절 시: "상대방이 무르기를 거절했습니다" 채팅 표시
- 내 차례일 때는 무르기 요청 불가
- 요청 대기 중 중복 요청 불가
타이머
- 수당 제한 시간 설정 (신청 시 선택)
- 착수 완료 시 타이머 초기화
- 시간 초과 시 자동 패배
- 10초 이하 시 타이머 빨간색 표시
기보 저장
저장 형식: SGF (Smart Game Format)
파일명: MB_Gomoku_2026-08-21_00-00-00.sgf
SGF 파일은 바둑/오목 기보 뷰어 프로그램에서 열람 가능합니다.
게임 종료 조건
| 조건 |
결과 |
| 5목 완성 |
해당 플레이어 승리 |
| 기권 |
기권한 플레이어 패배 |
| 시간 초과 |
시간 초과 플레이어 패배 |
| 상대방 연결 끊김 |
자동 승리 |
승리 시 5목 돌에 금색 테두리 강조 표시
소켓 이벤트
| 이벤트 |
방향 |
설명 |
gomoku_invite |
발신 → 수신 |
대국 신청 |
gomoku_invite_accept |
수신 → 발신 |
수락 |
gomoku_invite_reject |
수신 → 발신 |
거절 |
gomoku_move |
양방향 |
착수 |
gomoku_undo_req |
양방향 |
무르기 요청 |
gomoku_undo_accept |
양방향 |
무르기 수락 |
gomoku_undo_reject |
양방향 |
무르기 거절 |
gomoku_resign |
양방향 |
기권 |
gomoku_timeout |
양방향 |
시간 초과 |
gomoku_chat |
양방향 |
채팅 |
gomoku_watch |
관전자 → 플레이어 |
관전 참여 |
gomoku_end |
양방향 |
종료 |
트러블슈팅
| 증상 |
원인 |
해결 |
| 더보기에 오목 안 보임 |
MB Gomoku 미활성화 |
플러그인 활성화 확인 |
| 소켓 미연결 |
DX Socket 키 없음 |
API 키 발급 |
| 30초 후 자동 취소 |
상대방 미응답 |
상대방 접속 확인 |
| 모바일 착수 안 됨 |
터치 이벤트 문제 |
브라우저 새로고침 |
| 기보 저장 안 됨 |
착수 기록 없음 |
착수 후 시도 |
브라우저 지원
| 브라우저 |
지원 |
| Chrome (PC/Android) |
✅ |
| Firefox |
✅ |
| Safari (iOS/Mac) |
✅ |
| Samsung Internet |
✅ |
| Edge |
✅ |
파일 구성
plugins/mb-gomoku/
├── plugin.json ← 플러그인 메타정보
└── plugin.php ← 메인 (UI + 게임 로직 + 소켓)
예정 기능
| 기능 |
설명 |
| 관전 채팅 |
관전자 전용 채팅 |
| 대국 이력 |
승/패/무 통계 |
| 렌주 룰 |
정식 렌주 규칙 적용 |
라이선스
| 항목 |
내용 |
| 라이선스명 |
DesignOneX License (디자인원엑스 라이선스) |
| 원천 소유 |
DesignOneX — designonex.com |
| 재배포·판매 |
❌ 금지 (원천 소스 90% 이상 수정 시 재배포·판매 가능) |
| 상업적 사용 |
✅ 상업적 프로젝트 제작에만 허용 (학습·개인 포트폴리오 포함) |
| 플러그인 원천 |
plugin.php, core/, admin/ 자체의 재배포 및 판매 금지 |
| 보증 |
본 플러그인은 현재 상태 그대로 제공되며 어떠한 명시적·묵시적 보증도 없습니다. |
🚫 plugin.php, core/, admin/ 디렉터리의 코드를 그대로 또는 일부 수정하여 재배포하거나 판매하는 행위는 엄격히 금지됩니다.
✅ 상업적 프로젝트 제작 및 사용은 허용됩니다. (학습·개인 포트폴리오 포함)
✅ 원천 소스를 90% 이상 수정한 경우 재배포·판매가 가능합니다.
DesignOneX · designonex.com MB Gomoku v1.0.0
