MiniGameCore

MiniGameCore

MiniGameCore is a central plugin for managing minigame lobbies in Minecraft Paper Servers. It handles hosting, joining, starting, and stopping games – with animated scoreboards, statistics, and multiverse support.

---

🔧 Installation

1. Download the latest .jar from Modrinth or Releases.
2. Place the file in the plugins/ folder of your Minecraft server.
3. For permission-management, you can optionally use a plugin like LuckPerms.
4. Restart the server once.

---

📜 Commands & Permissions

Aliases: /p for /party and /tc for /teamchat

---

⚙️ Plugin-Configurations

Plugin Configurations are located in the folder: ./plugins/MiniGameCore. The main configuration file is config.yml.

config.yml

Example config:

available-games:
- Game1
- Game2
- Game3
banned-players:
- 2e0749e5-4ec0-4201-b58d-c4277014749c
- 337482fe-8a15-47f6-bea5-a84918a86393
keep-worlds: false
disable-scoreboard: false
keep-inventories-after-games: true

Note: if keep-worlds: true, the plugin is going to move them to ./plugins/MiniGameCore/ArchivedWorlds instead of deleting them.

Loading Game-Worlds & Configuring them

The Folder for Gameworlds and configs is ./MiniGameCore. Every Game World should be named like this: <Game name>_world. If you want multiple maps per game, name the other worlds <Game name>_world<index>. The world configs are named config.yml and should be located in the Game's world folder.

All available options:

Example config for an 8 player Spleef-Game:

game:
  name: Spleef
  maxPlayers: 8
  teams: 0
  spawnPoints:
    spawn1:
      x: -11
      y: 64
      z: 0
    spawn2:
      x: -7
      y: 64
      z: -7
    spawn3:
      x: 0
      y: 64
      z: -11
    spawn4:
      x: 7
      y: 64
      z: -7
    spawn5:
      x: 11
      y: 64
      z: 0
    spawn6:
      x: 7
      y: 64
      z: 7
    spawn7:
      x: 0
      y: 64
      z: 11
    spawn8:
      x: -7
      y: 64
      z: 7
  inventory:
    - "iron_shovel"
  allowed_break_blocks:
    - "snow_block"
  respawnMode: false
  doDurability: false
  allowPVP: false

‼️ API

You can use the MiniGameCoreAPI by importing the Project using Gradle! Paste this in your build.gradle:

repositories {
    maven { url "https://jitpack.io"  }
}

dependencies {
    implementation 'com.github.Wueffi:MiniGameCore:master-SNAPSHOT'
}

In your project, import classes/events/methods using import wueffi.MiniGameCore.x

Available Events are:
GameStartEvent with event.getGameName() and event.getLobby()
GameOverEvent with event.getLobby()

Helpful MGC Classes are:
Lobby
Team

Available API methods are:
getLobbyManager() -> return the LobbyManager instance
winPlayer(Lobby lobby, Player player) -> let a singular Player win a game
winTeam(Lobby lobby, Team team) -> let a Team win a game
playerDeath(UUID playerid) -> notify MiniGameCore of a Players Death
playerAlive(UUID playerid) -> notify MiniGameCore of a Players Respawn
getRespawnLocation(UUID playerid) -> returns the Respawn location of a player