Custom Mini Games

Custom Mini Games

Adds mini-games like ffa/team deathmatch, and Capture the Flag that are fully customizable with commands!

by
600 Downloads
fabricforgegame-mechanicslibraryminigame
Rent Server with this Mod

About this Mod

Dependencies

This mod requires 1wholibs!

Summary

This is a minecraft forge mod that adds some customizable mini-games that can be started using commands. The mod currently includes free for all/team death-match, simple buy-attack phase game mode, and a kill the flag game mode.

The games were designed to work in SMPs. For example, players can make their teams and put on the best gear that they have, and start a team death-match mini-game. The mod will automatically put the players that ran out of lives into spectator mode.

The mod also includes a custom kit and shop system. Server devs can add custom kits and shops via datapacks.

The mod is intended to allow other mod devs to create their own custom minigames using this mod's frame work. Complete documentation on how to do this will come when this mod is stable.

This mod is currently in beta and has many bugs. I recommend immediate respawn to be turned on!

How to Use

Here is a basic map of a mini-game's life cycle:

  1. Create a new mini-game instance with /minigame create_new

  2. Add players/teams to this game instance /minigame setup add_player/add_team

  3. Configure the game instance with the setup command. One can see all the different options with the command suggestions /minigame setup These settings are saved in the world.

  4. Start the mini-game /minigame setup start If the game doesn't start, read the error. There may be a parameter that you didn't configure.

  5. You can reset the game at anytime with /minigame reset confirm_reset Note that reset doesn't undo the settings in steps 2 and 3. It is mostly used to play the same game configuration again.

  6. If you want to remove that game configuration from the world /minigame remove confirm_remove

More details about all the different setup settings will come out later. But most of them are fairly self explanatory.

Players that don't have op can use /kit and /shop to select a kit and open a shop.

Available Versions

forge 1.20.1 v0.5.0 betarelease
MC 1.20.1forge
January 4, 2026
fabric 1.19.2 v0.4.2 betarelease
MC 1.19.2fabric
December 20, 2025
forge 1.19.2 v0.4.2 betarelease
MC 1.19.2forge
December 20, 2025
fabric 1.20.1 v0.4.2 betarelease
MC 1.20.1fabric
December 17, 2025
forge 1.20.1 v0.4.2 betarelease
MC 1.20.1forge
December 17, 2025

How to Install Custom Mini Games on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.20.1).

3

Install Mod

Open the mod browser in the dashboard and search for "Custom Mini Games". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforge

Minecraft Versions

1.20.1, 1.19.4, 1.19.3 (+1 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Custom Mini Games server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.

Is Custom Mini Games compatible with fabric and forge?

Custom Mini Games officially supports fabric, forge for Minecraft 1.20.1, 1.19.4, 1.19.3. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Custom Mini Games – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Custom Mini Games consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Custom Mini Games with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.20.11.19.41.19.31.19.2