Installation

Mo’Bosses needs Paper 26.3 or a fork of it, like Purpur, on Java 25. For Fabric and NeoForge, and for singleplayer worlds, see Fabric and NeoForge. GriefPrevention, WorldGuard, CoreProtect, PlaceholderAPI, MiniPlaceholders, WorldAPI, and Plan are optional. See Claims and protection and Integrations.

With Docker (recommended)

If your server runs in itzg/minecraft-server, it fetches Mo’Bosses itself.

1. Name it in MODRINTH_PROJECTS:

   services:
     minecraft:
       image: itzg/minecraft-server:java25
       environment:
         EULA: "TRUE"
         TYPE: PAPER
         VERSION: "26.3"
         MODRINTH_PROJECTS: |
           mobosses
       ports: ["25565:25565"]
       volumes: ["./data:/data"]

2. Start the container: docker compose up -d.

mobosses:2.6.2 pins a version. The optional plugins go on the same list, one per line: griefprevention, placeholderapi, plan, or worldguard together with worldedit, which WorldGuard needs.

To take Mo’Bosses from GitHub instead, use PLUGINS: https://github.com/MairwunNx/mobosses/releases/latest/download/mobosses-paper.jar.

By hand

1. Download the jar from Modrinth, Hangar, or GitHub.
2. Put it in plugins/. Since 2.10.0 the jar is mobosses-paper-X.Y.Z.jar. Delete an older mobosses-X.Y.Z.jar there, so only one Mo’Bosses loads.
3. Restart the server.

What the first start does

1. Mo’Bosses writes its files to plugins/MoBosses/: config.yml, classes.yml, bosses.yml, abilities.yml, minions.yml, loottable.yml, rewards.yml, and lang/.
2. It creates bosses.db, an SQLite file for players’ levels.
3. It downloads DB-IP’s free country database (about 4 MB) into plugins/MoBosses/geoip/, to pick each player’s language.
4. It logs which optional plugins it found, like protection: GriefPrevention, WorldGuard or Plan found.

The defaults play well, so you can go hunting right away. Coming from Mo’Bosses 1.x? Your files and database load as they are. Upgrading from 1.x lists what changed.

Next: First steps