Developer Introduction

MiniModes is a platform for writing Minecraft minigames as small Kotlin extension modules. The main advantage of MiniModes is that it takes care of everything that is not specific to your game, so you can focus on the fun parts.

Extension

Your game logic and assets, packaged into an mmx file

API

Everything you need to interact with Minecraft using MiniModes

Platform

MiniModes automatically translates your game to run on ANY platform, like a Paper server or a Fabric mod

The model

The Extension: is your game package. It is a .mmx file that contains one or more games, as well as any assets that your game needs to run, like a map, a datapack, or a schematic. MultiPlatform support: By only using MiniModes’ own API instead of the Bukkit or Fabric APIs, MiniModes can translate your extension to support both Paper and Fabric, as well as other platforms in the future, so you can write your game once and run it on any platforms that MiniModes supports!

What MiniModes does for you

MiniModes does everything possible to make your job as the game developer easier, by including the following features by default:

Loading and reloading your extensions without having to restart the game by using the /minimodes reload command.
Automatic registration of your game, and all of its
Smart performance optimizations, like caching and pooling, to make your game run as fast as possible, without you having to worry about it.
Automatic cleanup of your game after it ends, so players are properly reset before the next game starts.
Powerful and convenient APIs that feel less like a game engine and more like telling Minecraft what to do

What your extension owns

Your game still owns the actual design:

The rules and phases.
Spawn positions, arena construction, or selected maps.
How players receive items and abilities.
Event reactions such as blocking damage, scoring tags, or eliminating players.
Win conditions and ranked results.
Settings that make sense for the game.