설치 방법

본문 바로가기
로그인 구매 신청

MINIGAME HUB

설치 방법

게임 하나가 폴더 하나입니다. 폴더를 올리고 → 관리자에서 [설치] → 게임을 켜고 → 메뉴에 연결하면 끝납니다. 21종 모두 방법이 같으니 한 게임을 기준으로 보시면 됩니다. 아래 화면은 스위트 스톰(mh_game_slot) 입니다.

  1. 1내려받기마이페이지
  2. 2폴더 올리기FTP · SSH
  3. 3[설치]관리자
  4. 4게임 켜기설정
  5. 5메뉴 연결메뉴설정

1준비할 것

  • 그누보드 5.6.x 가 설치된 사이트 (영카트 없어도 됩니다)
  • PHP 8.0 이상 · mysqli(mysqlnd) · mbstring · json
    황금 사자 · 바이킹 뇌신 · 대마법사 · 2048 큐브 · 머지 젬은 64비트 PHP 필요, 세 슬롯은 PHP 8.3 이상 권장
  • MySQL 5.7 / 8.0 또는 MariaDB 10.x
  • 그누보드 환경설정 › 포인트 사용 켜짐 — 게임은 그누보드 포인트로 참가 · 베팅하고 당첨을 받습니다
  • 서버에 파일을 올릴 수단 (FTP 프로그램 또는 SSH)
  • 최고관리자 계정
라이선스는 게임마다 따로입니다. 구매 신청 후 입금이 확인되면 게임마다 키가 발급되고, 받은 폴더 안에 그 게임 전용 mh_game_license.lic 파일이 이미 들어 있습니다. 따로 키를 입력할 필요는 없습니다. 구매 신청

2마이페이지에서 내려받기

로그인 후 마이페이지에 들어가면 구매한 게임마다 라이선스 카드가 있습니다. [다운로드 만들기]를 누르면 최신 버전으로 묶인 zip 이 만들어지고, 화면이 다시 열리면서 [다운로드] 버튼이 생깁니다.

마이페이지 라이선스 카드
① [다운로드 만들기] → 다시 열린 화면의 [다운로드] 로 받기. 받은 주소는 7일 · 10회까지 쓸 수 있고, 지나면 [다시 묶기] 로 새로 만듭니다.

zip 을 풀면 아래처럼 게임 폴더와 안내 파일이 나옵니다. 게임 폴더 안의 mh_game_license.lic 은 지우거나 고치지 마세요(고치면 서명이 깨져 게임이 열리지 않습니다).

gamehub/ 받은 zip 을 푼 모습
  • mh_game_slot/ ← 이 폴더를 통째로 올립니다
    • mh_game_adm/ 설정 · 설치 화면
    • mh_game_assets/ 그림 · 소리 · 스크립트
    • mh_game_lib/ 게임 엔진 · 라이선스 검사(암호화)
    • index.php · mh_game_api.php · mh_game_cron.php · mh_game_hook.php …
    • mh_game_license.lic ← 게임 전용 키 (지우지 마세요)
    • mh_game_README.md · mh_game_NOTICE.md
  • mh_game_license_key_slot.txt 키 · 등급 · 허용 IP 안내 (파일 이름에 게임이 들어가 다른 묶음과 겹치지 않음)

3그누보드 루트에 폴더 올리기

mh_game_slot/ 폴더를 그누보드 루트(common.php 가 있는 폴더)에 그대로 올립니다. 폴더 이름을 바꾸지 마세요. 여러 게임을 쓰려면 같은 자리에 mh_game_게임 폴더를 나란히 올리면 됩니다 — 게임끼리 표 · 설정 · 파일이 모두 따로라 서로 간섭하지 않습니다.

그누보드 루트 예: /var/www/html
  • adm/
  • bbs/
  • data/ [설치] 때 data/mh_game_slot/ 이 생깁니다
  • extend/ [설치] 때 mh_game_slot.extend.php 가 생깁니다
  • theme/
  • mh_game_slot/ ← 올린 폴더
  • mh_game_baccarat/ ← 다른 게임도 나란히
  • common.php · config.php · index.php …

FTP 프로그램으로

  1. FileZilla 등으로 서버에 접속합니다.
  2. 오른쪽(서버)에서 common.php 가 보이는 폴더로 갑니다.
  3. 왼쪽(내 PC)의 mh_game_slot 폴더를 오른쪽으로 끌어다 놓습니다.

SSH 로

cd /var/www/html          # 그누보드 루트
unzip ~/gamehub-*.zip -d /tmp/gh   # 받은 zip
cp -r /tmp/gh/gamehub/mh_game_slot ./
chown -R www-data: mh_game_slot  # 웹 서버 계정

4관리자에서 [설치]

최고관리자로 로그인한 뒤 https://내사이트/mh_game_slot/mh_game_adm/mh_game_install.php 를 엽니다. 상태 표에서 PHP · DB · 포인트 사용 같은 항목이 모두 정상인지 보고, 아래의 [설치] 버튼을 누릅니다 (이미 설치돼 있으면 버튼 이름이 [업그레이드 / 다시 설치] 로 보입니다. 여러 번 눌러도 안전합니다).

설치 / 삭제 화면
설치 화면 — 게임 표 · 기본 설정 · data/mh_game_slot 폴더를 만들고, 관리자 메뉴 로더(extend/mh_game_slot.extend.php)를 복사합니다.
라이선스 확인도 이때 이뤄집니다. [설치]를 누르면 게임이 발급 사이트에 온라인으로 활성화를 요청하고, 키가 정상이고 허용 IP 안이면 설치가 진행됩니다. mh_game_license.lic 이 없거나 키가 잠겨 있으면 "설치할 수 없습니다" 안내가 나옵니다(아래 문제 해결 참고).

SSH 를 쓸 수 있으면 같은 일을 명령으로 해도 됩니다.

php /var/www/html/mh_game_slot/mh_game_adm/mh_game_install.php --install

5게임 켜기 · 금액 정하기

설치가 끝나면 관리자 왼쪽에 게임패드 아이콘(미니게임) 메뉴가 생깁니다. ① 위의 선택 칸에서 게임을 고르면 그 게임의 설정 · 플레이 기록 · 시뮬레이션 · 설치/삭제 메뉴가 보입니다. 게임은 처음에 꺼진 상태로 설치되니 아래 두 곳을 모두 켜고 [저장] 하세요.

설정 화면 위쪽 — 게임 선택 · 게임존 사용
① 게임 선택  ② 게임존 운영 › 게임존 사용(회원에게 공개)
기본 설정 › 사용 여부
③ 기본 설정 › 사용 여부 — 두 가지가 모두 켜져 있어야 회원에게 열립니다.

같은 화면에서 베팅 금액 · 하루 한도 · 참여 가능 등급 · 환수율 · 최대 당첨 같은 값을 정합니다. 처음에는 기본값 그대로 두고 [시뮬레이션] 으로 환수율을 확인한 뒤 바꾸는 것을 권합니다. '연습 모드'를 켜 두면 회원이 포인트 없이 연습 크레딧으로 먼저 해 볼 수 있습니다.

6사이트 메뉴에 연결

설정 화면의 게임 주소 칸에 이 게임의 주소가 나와 있습니다. 이 주소를 사이트 메뉴에 넣으면 회원이 들어갈 수 있습니다.

설정 화면의 게임 주소
설정 › 게임존 운영 › 게임 주소 (예: https://내사이트/mh_game_slot/)

관리자 › 환경설정 › 메뉴설정 에서 ① [메뉴추가] → ② 메뉴 이름(예: 스위트 스톰)과 링크 /mh_game_slot/ 를 넣고 → 오른쪽 위 [확인] 을 눌러 저장합니다.

메뉴설정 화면
메뉴설정 — 새 줄에 게임 이름과 /mh_game_slot/ 을 넣고 [확인]. 게시판 메뉴 아래에 넣으려면 그 줄의 [추가] 를 누르면 됩니다.
게임 화면
회원이 메뉴로 들어간 게임 화면 — 포인트가 그누보드 회원 포인트 그대로 보입니다.

7cron 등록 (회차 게임 · 퍼즐만)

대부분의 게임은 cron 이 필요 없습니다. 아래 게임만 서버 crontab 에 한 줄을 넣어 주세요. 설정 화면 아래 cron 칸에 그 사이트의 실제 경로로 채운 줄이 나오니 그대로 복사하면 됩니다.

게임주기하는 일
로얄 바카라 · 파워볼매분 (필수)마감된 회차 정산, 매일 23:30 이후 다음날 회차 만들기, 오래된 빈 회차 정리
2048 큐브 · 머지 젬매시 (권장)창을 닫고 24시간 넘게 끝나지 않은 판을 마지막 점수로 정산
그 밖의 슬롯 · 뽑기 · 룰렛필요 없음—
회차 게임 설정의 cron 칸
로얄 바카라 설정 › cron — ① crontab 줄을 웹 서버 사용자로 등록. 상태가 "정상 (CLI cron 이 돌고 있음)" 이면 됩니다.
# crontab -u www-data -e  (웹 서버 계정으로, 절대 경로)
* * * * * /usr/bin/php /var/www/html/mh_game_baccarat/mh_game_cron.php --quiet >> /var/www/html/data/mh_game_baccarat/cron.log 2>&1
* * * * * /usr/bin/php /var/www/html/mh_game_powerball/mh_game_cron.php --quiet >> /var/www/html/data/mh_game_powerball/cron.log 2>&1
7 * * * * /usr/bin/php /var/www/html/mh_game_g2048/mh_game_cron.php --quiet >> /var/www/html/data/mh_game_g2048/cron.log 2>&1
17 * * * * /usr/bin/php /var/www/html/mh_game_merge/mh_game_cron.php --quiet >> /var/www/html/data/mh_game_merge/cron.log 2>&1
cron 을 못 쓰는 호스팅이면 설정 화면의 웹 cron 주소(비밀 키 포함)를 외부 웹크론 서비스에 등록하세요. 등록하지 않아도 회원이 게임을 보는 동안에는 정산 · 회차 생성이 돌지만, 아무도 없는 시간에는 멈춥니다.

웹크론 등록 — cron-job.org (무료 · 1분 간격 지원)

  1. cron-job.org 에 가입하고 로그인합니다(이메일 인증).
  2. Dashboard › CREATE CRONJOB 을 누릅니다.
  3. Title 에 알아보기 쉬운 이름(예: 로얄 바카라 회차), URL 에 설정 화면의 웹 cron 주소를 그대로 붙여 넣습니다.
  4. Execution schedule 에서 Every minute(바카라 · 파워볼) 또는 Every hour(2048 · 머지)을 고릅니다.
  5. CREATE 로 저장하고, 몇 분 뒤 목록의 History 에서 결과가 200 OK 인지 봅니다. 게임 설정 화면 cron 칸의 마지막 실행 에도 시각이 찍힙니다.

다른 서비스도 같은 방식입니다: EasyCron · Cronitor · SetCronJob (무료 요금제의 최소 간격을 확인하세요). 웹 cron 주소의 키는 비밀번호처럼 다루고, 새어 나갔다면 설정 화면의 [주소 새로 만들기] 로 바꾸세요.

8라이선스 활성화 확인

내 사이트게임 설치 · 실행
mh_game_license.lic암호화 · 서명된 키
발급 사이트키 · 설치 IP 확인
열림결과 6시간 저장
  • 설치할 때와 게임을 쓸 때 게임이 발급 사이트에 자동으로 확인을 요청합니다. 따로 할 일은 없습니다.
  • 설치 서버 IP — 하프 라이선스 2곳, 풀 라이선스 3곳입니다(구매할 때 옵션으로 늘릴 수 있음). 허용 수를 넘는 새 서버에서 설치하면 그 서버의 설치가 막히고 아래 안내가 뜹니다. 이미 쓰고 있는 서버는 그대로 돌아갑니다.
    아이피 허용 갯수가 넘었습니다. 풀 라이선스는 3개의 아이피에서만 설치가 가능합니다. 만약 서버 아이피 정보가 변경되었다면 미니게임허브 마이페이지에서 해당 게임의 허용 아이피를 수정하세요.
  • 서버를 옮겼을 때 — 마이페이지의 그 게임 라이선스 카드에서 쓰지 않는 IP 를 [지우기] 한 뒤 새 서버에서 설치하면 새 IP 가 자동으로 등록됩니다. 새 서버 IP 를 미리 [등록] 해 둘 수도 있습니다.
  • 확인 결과는 6시간 동안 저장되고, 발급 사이트에 잠깐 연결이 안 돼도 최대 7일까지는 그대로 동작합니다.
  • 마이페이지 라이선스 카드의 설치된 IP 에서 지금 쓰고 있는 서버를 확인할 수 있습니다.

9업그레이드 · 삭제

업그레이드

  1. 마이페이지에서 [다시 묶기] → 새 버전 zip 받기
  2. 새 mh_game_게임/ 폴더로 덮어쓰기 (data/ 의 기록 · 설정은 그대로 남습니다)
  3. 설치 화면에서 [업그레이드 / 다시 설치]

삭제

  1. 설치 화면 맨 아래 삭제 칸에 '삭제' 를 입력하고 [삭제]
  2. 진행 중인 판을 먼저 정산 · 환불한 뒤 그 게임의 표 · data 폴더 · 메뉴만 지웁니다
  3. 회원 포인트 내역은 지우지 않습니다(회원 잔액이 그 합계이기 때문)
  4. 마지막으로 mh_game_게임/ 폴더를 FTP 로 지웁니다

10문제 해결

"게임을 열 수 없습니다" / "설치할 수 없습니다" 가 나와요

안내 문구에 이유가 함께 나옵니다.
· mh_game_license.lic 이 없거나 올바르지 않음 — 받은 폴더를 그대로 다시 올려 주세요(FTP 가 파일을 빼먹었거나 내용이 바뀐 경우).
· 아이피 허용 갯수가 넘었습니다 — 허용 IP 가 모두 찬 상태에서 새 서버에 설치한 경우입니다. 마이페이지에서 쓰지 않는 IP 를 지우고 다시 [설치] 하세요.
· 잠긴 키 — 관리자가 키를 멈춘 경우입니다. 질문답변 게시판으로 문의해 주세요.
· 서버에 연결할 수 없음 — 서버에서 외부 https(443) 연결이 막혀 있는지 확인하세요.

관리자에 미니게임 메뉴가 안 보여요

웹 서버가 extend/ 폴더에 쓸 수 없으면 메뉴 로더가 복사되지 않습니다. 설치 화면의 [로더 내려받기] 로 받은 mh_game_게임.extend.php 를 FTP 로 extend/ 에 올려 주세요. 메뉴가 없어도 /mh_game_게임/mh_game_adm/ 주소로 바로 들어갈 수 있습니다.

회원에게 게임이 안 보여요

설정의 게임존 사용과 기본 설정 › 사용 여부가 둘 다 켜져 있는지, 참여 가능 등급이 회원 등급보다 높지 않은지, 그누보드 포인트 사용이 켜져 있는지 확인하세요.

설치 화면에 64비트 · PHP 버전 경고가 떠요

황금 사자 · 바이킹 뇌신 · 대마법사 · 2048 큐브 · 머지 젬은 64비트 PHP 가 필요합니다. 호스팅에 PHP 버전 · 64비트 여부를 확인해 주세요.

회차 게임 결과가 안 넘어가요

cron 이 등록되지 않았거나 다른 계정으로 돌고 있을 수 있습니다. 설정 화면 cron 칸의 상태와 마지막 실행 시각을 확인하고, [지금 실행] 으로 바로 돌려 볼 수 있습니다.

그 밖의 질문은 질문답변 게시판에 남겨 주세요.