주의

- 해당 플러그인은 미니게임을 포함하고 있지 않습니다. 미니게임은 따로 다운로드 해서 플레이 할 수 있습니다

MiniGameWorld 소개

MiniGameWorld는 플레이어가 미니게임을 플레이할 수 있는 공간이자, 개발자에게 미니게임 제작을 도와주는 프레임워크 역할을 합니다

특징

가장 큰 특징은 서버와 플레이어의 상태를 보존하면서, 다른 플러그인들과 독립적으로 동작하기 때문에 서버의 장르에 상관없이 적용가능합니다 (로비도 필요없음)

1. 기본 미니게임 틀 제공

• 미니게임의 공통적인 요소인 게임 설정, 시작, 종료, 플레이어 점수, 목숨, 이벤트 등을 관리해줍니다
• 기본적으로 1인, 개인전, 팀전, 팀배틀을 지원합니다

2. 스코어보드

플레이들의 점수와 목숨, 남은 플레이 시간을 스코어보드로 실시간으로 알려줍니다

3. GUI 메뉴

간단한 조작을 위해 인벤토리 GUI를 제공합니다

4. 컨피그 컨트롤

• 서버 어드민이 미니게임의 세팅을 수정해서 여러가지 플레이가 가능합니다
• 미니게임 개발자가 Map<String, Object>타입으로 쉽게 커스텀 데이터(custom-data)를 관리 가능합니다

Center:
  title: Center
  min-players: 2
  max-players: 5
  waiting-time: 20
  play-time: 120
  active: true
  icon: END_ROD
  view: true
  scoreboard: true
  location:
    ==: org.bukkit.Location
    world: world
    x: 0.0
    y: 4.0
    z: 0.0
    pitch: 0.0
    yaw: 0.0
  tutorial:
  - §c웅크지면 탈락!
  - §c떨어져도 탈락!
  custom-data:
    chat: true
    score-notifying: false
    block-break: false
    block-place: false
    pvp: false
    pve: true
    inventory-save: true
    minigame-respawn: true
    live-gamemode: SURVIVAL
    dead-gamemode: SPECTATOR
    color: BLUE
    food-level-change: true
    player-hurt: true

5. API

미니게임과 써드파티 플러그인을 위해 다양한 관점에서 API를 제공합니다

예시

• 플레이어 컨트롤: 플레이어의 미니게임 입장, 퇴장, 관전, 관전퇴장
• 미니게임 컨트롤: 미니게임 등록, 등록해제, 시작, 끝내기, 예외처리, 세팅
• 유틸 컨트롤: 파티, GUI 메뉴, 미니게임 결과

6. 커스텀 이벤트

• 써드파티 플러그인에서 활용할 수 있는 커스텀 이벤트를 제공합니다
• 예. 미니게임시작 이벤트, 플레이어 미니게임 입장 이벤트, 메뉴 클릭 이벤트

7. 기타

• 이외에도 파티, 백업, 언어, 플레이어 상태 보존 등의 다양한 것들을 지원합니다
• 자세한 정보는 유저 위키, 개발자 위키, API 문서, 데모 미니게임 소스코드에서 확인할 수 있습니다

미니게임 적용법

1. 준비

MiniGameWorld와 wbmMC플러그인을 plugins 폴더에 넣어주세요

다운로드 받은 미니게임 플러그인을 서버의 plugins 폴더에 넣어주세요

서버를 실행킨다음 미니게임이 정상적으로 등록됬다면, 콘솔에 초록 글씨로 등록된 미니게임이 보입니다  (밑 사진은 JumpMap이라는 미니게임이 정상적으로 등록됨)

2. 미니게임 스폰 지역 제작 & 설정

미니게임들은 대부분 규칙만 설정되어 있어서, 맵을 자유롭게 제작해서 적용할 수 있습니다. 각 미니게임의 설명서를 읽고 알맞는 맵을 제작해주세요

초기 설정이 안된 미니게임 스폰지점은 X: 0, y: 4, z: 0로 되어 있기 때문에 밑의 방법중 하나를 선택해서 미니게임 스폰을 설정합니다 (OP 필요 명령어)

• 방법1. /mw games <minigame> location <player>: 미니게임 스폰을 <player>의 위치로 설정합니다
• 방법2. /mw games <minigame> location <x> <y> <z>: 미니게임 스폰을 <x> <y> <z> 의 위치로 설정합니다
• 방법3. 미니게임의 컨피그 파일안의 location을 알맞은 곳으로 수정한 다음 /mw reload 명령어를 입력합니다 (미니게임 컨피그 파일 위치: plugins/MiniGameWorld/minigames/<minigame>.yml)

3. 미니게임 참가하기

/mw menu명령어를 입력한 다음, 위쪽 GUI 메뉴에 등록된 미니게임 아이콘을 눌러서(좌클릭) 참가합니다

4. 테스트

미니게임을 플레이하면서 정했던 규칙들을 테스트해봅니다

필수 다운로드

MiniGameWorld

wbmMC

디스코드