MB 장기 설치·사용 매뉴얼

회원 프로필에서 버튼 한 번으로 1:1 실시간 장기 대국을 신청할 수 있는 플러그인입니다. 포진 선택, 시간 제한, 무르기, 한 수 쉼, 장군·외통 알림, 기보 저장, 관전, 대국 중 채팅을 쓸 수 있습니다.

0. 먼저 알아 두세요

필요한 파일

이미 MB 화상채팅·전화통화·오목 등 다른 MB 플러그인을 설치했다면 mb-profile-extend와 mb-log-gate는 이미 올라가 있는 것입니다. 다시 올릴 필요 없이 mb-janggi만 올리면 됩니다.

설치 전에 확인할 것

1. 사이트 주소가 https://로 시작해야 합니다. https:// 사이트를 권장합니다. (MB 플러그인들은 https://를 기준으로 안내합니다.)
2. DXCMS 관리자 > 소켓 설정에 이 사이트의 소켓 키가 있어야 합니다. 키가 없으면 장기가 켜지지 않습니다. (키 발급과 설정은 DXCMS 소켓 안내를 따르세요.)
3. FTP 접속 정보(주소, 아이디, 비밀번호)를 알고 있어야 합니다. 호스팅 업체의 안내 메일이나 관리 화면에서 확인할 수 있습니다.

1. 설치하기

1-1. 압축 풀기

1. 내려받은 압축 파일을 컴퓨터의 한 폴더(예: 바탕화면의 mb-install)에 모읍니다.
2. 압축 파일을 하나씩 마우스 오른쪽 클릭 > 압축 풀기(또는 "여기에 압축 풀기")로 풉니다.
   • 파일 이름과 같은 폴더가 새로 생깁니다. 예: mb-janggi_v2.0.1 폴더
3. 풀린 폴더를 열어서 안을 확인합니다. 폴더 구조가 파일마다 다릅니다.

주의 mb-log-gate만 plugins 폴더 안에 들어 있습니다. plugins 폴더째 올리지 말고, 그 안의 mb-log-gate 폴더만 올리세요. plugins 안에 또 plugins가 생기면 플러그인 목록에 나타나지 않습니다.

최종적으로 올릴 폴더는 아래와 같습니다.

mb-profile-extend   (이미 올렸다면 생략)
mb-janggi
mb-log-gate         (선택, 이미 올렸다면 생략)

각 폴더를 열었을 때 manifest.php와 plugin.php 파일이 바로 보이면 올바른 폴더입니다.

1-2. FTP로 접속하기

FTP 프로그램은 FileZilla(무료)를 기준으로 설명합니다.

1. FileZilla를 실행합니다.
2. 화면 위쪽 입력칸에 호스트(FTP 주소), 사용자명, 비밀번호를 넣고 빠른 연결을 누릅니다. 포트는 비워 두면 됩니다.
3. 연결되면 화면이 둘로 나뉩니다.
   • 왼쪽: 내 컴퓨터
   • 오른쪽: 내 사이트가 있는 서버

1-3. 사이트 폴더 찾기

오른쪽(서버)에서 사이트가 설치된 폴더를 찾아 들어갑니다.

• 보통 이름이 public_html, www, html, htdocs 중 하나입니다.
• 그 안에 plugins, themes, data, admin 폴더와 index.php 파일이 같이 보이면 제대로 찾은 것입니다.
• 사이트를 하위 폴더에 설치했다면(예: www/community) 그 폴더 안까지 들어가세요.

그 안의 plugins 폴더를 더블클릭해서 엽니다. 이미 설치된 다른 플러그인 폴더들이 보입니다.

1-4. 폴더 올리기

1. 왼쪽(내 컴퓨터)에서 압축을 푼 폴더로 이동합니다.
2. 올릴 폴더를 마우스로 끌어서 오른쪽의 plugins 폴더 안에 놓습니다. (폴더를 우클릭해서 업로드를 눌러도 됩니다.)
3. 하단의 "전송 완료" 탭에서 실패한 파일이 없는지 확인합니다.
   • "실패한 전송" 탭에 항목이 보이면 해당 폴더를 한 번 더 올리세요.
4. 올릴 폴더를 모두 같은 방법으로 올립니다. 순서는 상관없습니다.

올린 뒤 서버의 plugins 폴더 안이 이렇게 보여야 합니다.

plugins/
├── mb-profile-extend/
│   ├── manifest.php
│   ├── plugin.php
│   └── assets/ ...
├── mb-janggi/
│   ├── manifest.php
│   ├── plugin.php
│   └── assets/ ...
└── mb-log-gate/
    ├── manifest.php
    └── plugin.php

이미 이전 버전이 올라가 있으면, 같은 이름의 폴더에 덮어쓰기로 올리면 됩니다. FileZilla가 "대상 파일이 이미 존재합니다"라고 물으면 덮어쓰기를 고르고 "항상 이 동작을 사용"에 체크하면 한 번에 끝납니다.

1-5. 플러그인 켜기 (활성화)

1. 사이트에 관리자로 로그인합니다.
2. 관리자 > 플러그인으로 들어갑니다.
3. 목록에서 아래 순서로 활성화 버튼을 누릅니다. (이미 활성인 것은 건너뜁니다.)
   1. MB Profile Extend
   2. MB Janggi (1:1 장기)
   3. MB 로그 게이트 (올렸다면)
4. 카드에 "활성" 표시가 보이면 완료입니다.

목록에 플러그인이 보이지 않으면 폴더 위치가 잘못된 것입니다. 서버의 plugins 폴더 안에 mb-janggi처럼 플러그인 이름 폴더가 바로 있고, 그 안에 manifest.php가 있는지 다시 확인하세요.

1-6. 설정 확인하기

1. 관리자 > 플러그인에서 MB Janggi 카드의 설정 버튼을 누릅니다.
2. 처음에는 아무것도 바꾸지 않아도 됩니다. 기본값으로 동작합니다.

2. 설치가 잘 되었는지 확인하기

1. 관리자 계정이 아닌 다른 회원 계정 2개를 준비합니다. (컴퓨터 한 대에서는 브라우저 두 개, 또는 컴퓨터와 스마트폰으로 각각 로그인하면 됩니다.)
2. 한 계정에서 상대 회원의 프로필을 엽니다.
3. 프로필 모달에 더보기 버튼이 보이면 1단계는 성공입니다.
4. 더보기를 눌러 MB 장기가 보이면 2단계도 성공입니다.
5. 눌러서 대국을 신청하고, 상대 쪽에서 수신 창이 뜨는지 확인합니다.

3. 사용하기

대국 신청하기

1. 대국할 회원의 프로필을 엽니다.
2. 더보기를 누릅니다.
3. MB 장기를 누릅니다.
4. 수당 시간 제한을 고릅니다: 1분 / 2분 / 3분 / 무제한 (처음에는 2분이 선택되어 있습니다.)
5. 신청을 누릅니다. 취소하려면 취소를 누르세요.
6. 상대가 받을 때까지 기다립니다. 30초 안에 응답이 없으면 "응답하지 않습니다"라고 알려 줍니다.

**신청한 사람이 초(楚, 선수), 수락한 사람이 한(漢, 후수)**입니다. 본인 프로필과 로그인하지 않은 상태에서는 더보기 버튼이 나오지 않으며, 자신에게는 신청할 수 없습니다.

신청 받기

• 사이트를 열어 둔 상태에서 신청이 오면 수신 창이 뜹니다.
• 수락을 누르면 대국 준비로 넘어가고, 거절을 누르면 상대에게 거절했다고 알려 줍니다.
• 30초 동안 응답하지 않으면 자동으로 거절됩니다.
• 이미 다른 대국 중이면 상대에게 받을 수 없다고 전달됩니다.
• 같은 계정으로 여러 탭을 열어 두었다면 모두 수신 창이 뜹니다. 한 곳에서 수락하거나 거절하면 나머지는 자동으로 닫힙니다.

포진 고르기 (대국 시작 전)

장기는 시작할 때 마·상의 배치(상차림)를 고릅니다. 두 사람이 각자 동시에 고릅니다.

1. "포진 선택" 창에서 귀마 / 원앙마 / 양귀마 / 면상 중 하나를 누릅니다. (처음에는 귀마가 선택되어 있습니다.)
2. 준비 완료를 누릅니다.
3. 상대도 준비 완료를 누르면 대국이 시작됩니다.

• 포진 선택은 90초 안에 해야 합니다. 시간이 지나면 대국이 자동으로 취소됩니다.
• 마음이 바뀌면 대국 취소를 누르면 됩니다.

말 움직이기

• 내 차례에 움직일 말을 누르고, 갈 자리를 누릅니다.
• 말의 이동 규칙은 일반 장기와 같습니다. (차·포·마·상·사·장·졸/병, 궁성 안 사선 이동)
• 말이 움직이는 모습이 슬라이드 애니메이션으로 보입니다. 내 수와 상대 수 모두 같습니다.
• 규칙에 어긋나는 자리는 놓을 수 없습니다.
• 두 장(왕)이 서로 마주 보게 되는 수는 둘 수 없습니다.
• 기보 목록의 수 번호는 초나라가 파란색, 한나라가 빨간색으로 표시됩니다.

장군과 외통

• 상대 장을 잡을 수 있는 상태가 되면 **"장군!"**이 표시됩니다.
• 장군을 받으면 반드시 피해야 합니다.
• 피할 방법이 없으면 **"외통수!"**가 표시되고 대국이 끝납니다. 외통을 만든 쪽이 승리합니다.

한 수 쉼

• 둘 수 있는 수가 없을 때 한 수 쉼 버튼으로 차례를 넘깁니다.
• 장군을 받은 상태에서는 쉴 수 없습니다.
• 둘 수 있는 수가 없고 장군도 아니라면 "둘 수 있는 수가 없습니다. 한 수 쉼을 누르세요"라고 알려 줍니다.

시간 제한

• 수당 시간 제한 안에 두지 않으면 시간 초과로 패배합니다. (무제한을 고르면 없습니다.)

무르기

1. 무르기 요청 버튼을 누르면 상대에게 요청이 갑니다.
2. 상대가 허용하면 내가 둔 마지막 한 수가 취소되고, 잡혔던 말도 되살아납니다. 거절하면 그대로 진행됩니다.

• 무르기는 내가 둔 직후에만 요청할 수 있고, 마지막 한 수만 됩니다.
• 상대의 허용이 꼭 필요합니다.

기권, 나가기

• 기권을 누르고 확인하면 패배로 끝납니다.
• 나가기를 누르면 대국 화면을 나갑니다.
• 상대가 대국을 떠나면 "상대가 대국을 떠났습니다"라고 알려 주고 내가 승리합니다.

대국 중 채팅

• 화면의 채팅 입력칸에 글을 쓰고 전송을 누르면 상대와 관전자에게 보입니다.

기보 저장

• 기보 저장 버튼을 누르면 둔 순서가 담긴 텍스트(TXT) 파일이 내 컴퓨터에 저장됩니다.
• 대국 결과 창에서도 기보 저장과 닫기를 누를 수 있습니다.
• 저장 위치는 브라우저의 다운로드 폴더입니다. 서버에는 저장되지 않습니다.

관전

• 대국 중인 사람의 프로필에서 더보기 > MB 장기를 누르면 "관전하시겠습니까?"가 나옵니다.
• 예를 누르면 관전이 시작되고, 아니오를 누르면 닫힙니다.
• 관전 중에는 말을 움직일 수 없습니다.
• 이미 끝난 대국은 관전할 수 없습니다.

이렇게 끝납니다

대국은 아래 경우에만 끝납니다.

• 외통(상대 장을 피할 수 없게 만듦)
• 기권
• 시간 초과
• 상대가 대국을 떠남

점수 계산으로 끝내기, 같은 수가 반복될 때의 무승부, 빅장 합의 무승부는 지원하지 않습니다. 승부가 나지 않는 경우에는 한쪽이 기권하거나 시간 제한으로 끝내야 합니다.

연결이 끊겼을 때

• 잠시 끊겼다가 다시 연결되면 상대와 기보를 자동으로 맞춥니다. 말 위치가 어긋나 보이면 잠시 기다려 보세요.
• 창을 닫지 않고 오래 자리를 비우면 상대가 시간 초과나 기권으로 대국을 끝낼 수 있습니다.

4. 이런 증상이 있을 때

5. 업데이트하기

1. 새 버전 압축 파일을 풀어 1-1과 같이 올릴 폴더를 찾습니다.
2. FTP에서 같은 이름의 폴더에 덮어쓰기로 올립니다.
3. 관리자 > 플러그인에서 해당 플러그인을 한 번 비활성화 후 다시 활성화합니다.
4. 회원들에게는 Ctrl+F5로 새로고침하도록 안내합니다.

6. 삭제하기

1. 관리자 > 플러그인에서 MB Janggi를 비활성화합니다.
2. FTP에서 plugins 폴더 안의 mb-janggi 폴더를 삭제합니다.

mb-profile-extend와 mb-log-gate는 MB 화상채팅·전화통화·오목 등 다른 MB 플러그인도 함께 쓰는 것입니다. 다른 MB 플러그인을 쓰고 있다면 삭제하지 마세요.

7. 문의할 때 알려 주세요

• 플러그인이 활성 상태인지
• 어느 단계에서 막혔는지 (더보기 버튼이 없음 / 신청이 안 감 / 말 위치가 어긋남 등)
• 사용한 브라우저와 기기 (예: 크롬, 갤럭시)
• 화면이 있다면 캡처

관리자는 대국 흐름이 기록된 data/logs/mb-janggi.log 파일을 FTP로 내려받아 보내 주시면 원인을 찾는 데 도움이 됩니다.

Copyright © DesignOneX — designonex.com · All Rights Reserved. DesignOneX License 1.0 — https://designonex.com/notice/view/1787577858493247