MINIGAME TREE
설치 방법
게임 하나가 폴더 하나입니다. 폴더를 올리고 → 관리자에서 [설치] → 게임을 켜고 → 메뉴에 연결하면 끝납니다. 모든 게임이 방법이 같으니 한 게임을 기준으로 보시면 됩니다. 아래 화면은 스위트 스톰(mh_game_slot) 입니다.
- 1내려받기마이페이지
- 2폴더 올리기FTP · SSH
- 3[설치]관리자
- 4게임 켜기설정
- 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 이 만들어지고, 화면이 다시 열리면서 [다운로드] 버튼이 생깁니다.

zip 을 풀면 아래처럼 게임 폴더와 안내 파일이 나옵니다. 게임 폴더 안의 mh_game_license.lic 은 지우거나 고치지 마세요(고치면 서명이 깨져 게임이 열리지 않습니다).
- 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_게임 폴더를 나란히 올리면 됩니다 — 게임끼리 표 · 설정 · 파일이 모두 따로라 서로 간섭하지 않습니다.
- 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 프로그램으로
- FileZilla 등으로 서버에 접속합니다.
- 오른쪽(서버)에서
common.php가 보이는 폴더로 갑니다. - 왼쪽(내 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 · 포인트 사용 같은 항목이 모두 정상인지 보고, 아래의 [설치] 버튼을 누릅니다
(이미 설치돼 있으면 버튼 이름이 [업그레이드 / 다시 설치] 로 보입니다. 여러 번 눌러도 안전합니다).

mh_game_license.lic 이 없거나 키가 잠겨 있으면 "설치할 수 없습니다" 안내가 나옵니다(아래 문제 해결 참고).SSH 를 쓸 수 있으면 같은 일을 명령으로 해도 됩니다.
php /var/www/html/mh_game_slot/mh_game_adm/mh_game_install.php --install
5게임 켜기 · 금액 정하기
설치가 끝나면 관리자 왼쪽에 게임패드 아이콘(미니게임) 메뉴가 생깁니다. ① 위의 선택 칸에서 게임을 고르면 그 게임의 설정 · 플레이 기록 · 시뮬레이션 · 설치/삭제 메뉴가 보입니다. 게임은 처음에 꺼진 상태로 설치되니 아래 두 곳을 모두 켜고 [저장] 하세요.


같은 화면에서 베팅 금액 · 하루 한도 · 참여 가능 등급 · 환수율 · 최대 당첨 같은 값을 정합니다. 처음에는 기본값 그대로 두고 [시뮬레이션] 으로 환수율을 확인한 뒤 바꾸는 것을 권합니다. '연습 모드'를 켜 두면 회원이 포인트 없이 연습 크레딧으로 먼저 해 볼 수 있습니다.
7cron 등록 (회차 게임 · 퍼즐만)
대부분의 게임은 cron 이 필요 없습니다. 아래 게임만 서버 crontab 에 한 줄을 넣어 주세요. 설정 화면 아래 cron 칸에 그 사이트의 실제 경로로 채운 줄이 나오니 그대로 복사하면 됩니다.
| 게임 | 주기 | 하는 일 |
|---|---|---|
| 로얄 바카라 · 파워볼 | 매분 (필수) | 마감된 회차 정산, 매일 23:30 이후 다음날 회차 만들기, 오래된 빈 회차 정리 |
| 2048 큐브 · 머지 젬 | 매시 (권장) | 창을 닫고 24시간 넘게 끝나지 않은 판을 마지막 점수로 정산 |
| 그 밖의 슬롯 · 뽑기 · 룰렛 | 필요 없음 | — |

# 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-job.org (무료 · 1분 간격 지원)
- cron-job.org 에 가입하고 로그인합니다(이메일 인증).
- Dashboard › CREATE CRONJOB 을 누릅니다.
- Title 에 알아보기 쉬운 이름(예: 로얄 바카라 회차), URL 에 설정 화면의 웹 cron 주소를 그대로 붙여 넣습니다.
- Execution schedule 에서 Every minute(바카라 · 파워볼) 또는 Every hour(2048 · 머지)을 고릅니다.
- CREATE 로 저장하고, 몇 분 뒤 목록의 History 에서 결과가 200 OK 인지 봅니다. 게임 설정 화면 cron 칸의 마지막 실행 에도 시각이 찍힙니다.
다른 서비스도 같은 방식입니다: EasyCron · Cronitor · SetCronJob (무료 요금제의 최소 간격을 확인하세요). 웹 cron 주소의 키는 비밀번호처럼 다루고, 새어 나갔다면 설정 화면의 [주소 새로 만들기] 로 바꾸세요.
8라이선스 활성화 확인
- 설치할 때와 게임을 쓸 때 게임이 발급 사이트에 자동으로 확인을 요청합니다. 따로 할 일은 없습니다.
- 설치 서버 IP — 하프 라이선스 1곳, 풀 라이선스 3곳입니다(구매할 때 옵션으로 늘릴 수 있음).
허용 수를 넘는 새 서버에서 설치하면 그 서버의 설치가 막히고 아래 안내가 뜹니다. 이미 쓰고 있는 서버는 그대로 돌아갑니다.
아이피 허용 갯수가 넘었습니다. 풀 라이선스는 3개의 아이피에서만 설치가 가능합니다. 만약 서버 아이피 정보가 변경되었다면 미니게임트리 마이페이지에서 해당 게임의 허용 아이피를 수정하세요.
- 서버를 옮겼을 때 — 마이페이지의 그 게임 라이선스 카드에서 쓰지 않는 IP 를 [지우기] 한 뒤 새 서버에서 설치하면 새 IP 가 자동으로 등록됩니다. 새 서버 IP 를 미리 [등록] 해 둘 수도 있습니다.
- 확인 결과는 6시간 동안 저장되고, 발급 사이트에 잠깐 연결이 안 돼도 최대 7일까지는 그대로 동작합니다.
- 마이페이지 라이선스 카드의 설치된 IP 에서 지금 쓰고 있는 서버를 확인할 수 있습니다.
9업그레이드 · 삭제
업그레이드
- 마이페이지에서 [다시 묶기] → 새 버전 zip 받기
- 새
mh_game_게임/폴더로 덮어쓰기 (data/의 기록 · 설정은 그대로 남습니다) - 설치 화면에서 [업그레이드 / 다시 설치]
삭제
- 설치 화면 맨 아래 삭제 칸에 '삭제' 를 입력하고 [삭제]
- 진행 중인 판을 먼저 정산 · 환불한 뒤 그 게임의 표 · data 폴더 · 메뉴만 지웁니다
- 회원 포인트 내역은 지우지 않습니다(회원 잔액이 그 합계이기 때문)
- 마지막으로
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 칸의 상태와 마지막 실행 시각을 확인하고, [지금 실행] 으로 바로 돌려 볼 수 있습니다.
그 밖의 질문은 질문답변 게시판에 남겨 주세요.


