ChaosLoop Plugin
If you have ever built a custom Minecraft minigame, you know the frustration of hitting a wall. A datapack can do a lot, but it cannot read a player's inventory back out, fetch a skin, or delete a world. That is where the ChaosLoop Plugin steps in. It is the mechanical half of the ChaosLoop experience, designed to work hand-in-hand with its datapack counterpart to deliver features that are simply impossible with vanilla commands alone.
Think of the datapack as the brain and the ChaosLoop Plugin as the hands. On its own, the plugin does very little. But when paired with the datapack, it unlocks a suite of game-changing mechanics that make your minigame fairer, more immersive, and a whole lot more fun. This guide will walk you through everything it adds, how to install it, and why it is an essential tool for any server owner running a ChaosLoop-style game.
What Does the ChaosLoop Plugin Add?
The plugin is built around a simple philosophy: a minigame should be the same game for everybody. No unfair advantages, no lost items, no cheap deaths. Here is what it brings to the table.
The Vault: Fair Play for Your Inventory
Imagine you are in the middle of a tense match, and suddenly the game resets. Without the ChaosLoop Plugin, whatever you are carrying is gone forever. The Vault solves this. Whatever you are carrying is held at the door when the game starts and given back to you at the end, with prizes on top. Anything that will not fit in your inventory is dropped at your feet rather than deleted, so nothing is ever lost. Your walkie-talkie stays with you at all times, because being unable to talk to your team is not a fair fight.
Graves: No More Scavenger Hunts
Death in a minigame should be a setback, not a catastrophe. With the ChaosLoop Plugin, when you die, your things wait for you in a chest at the exact spot you fell. No more watching your hard-earned gear despawn on the floor after twelve minutes. If you had more than an inventory's worth of items, it automatically becomes a double chest. It is a simple quality-of-life feature that keeps the game moving.
Mimics: Your Friends, But Hostile
This is where things get creepy. The ChaosLoop Plugin can spawn hostile mobs that wear your friends' skins and names, fetched live from their player profiles. These mimics hunt, they gather, and they are exactly as unsettling as that sounds. It adds a layer of psychological horror to the game that a standard mob just cannot replicate. You will second-guess every player you see on the horizon.
World Reset: Clean Slate, On Command
Running a recurring event? The plugin lets you execute a full world reset with a single command: /chaosloop reset confirm. This deletes and regenerates the world, optionally on a seed you name. Everybody waits in a sealed room while it happens, so there is no risk of someone falling into the void mid-reset. It is the cleanest way to start a new round without manually deleting files on the server.
The Chronicle: Your Match, In Writing
When the dragon falls, the ChaosLoop Plugin generates a written book for each player. The Chronicle contains a leaderboard, per-player stats, ore counters, and a clickable contents page. It is a beautiful way to recap the match and give players something to take home with them. It is a small touch, but it makes the victory feel earned.
Walkie-Talkies: Communication at Any Distance
Finally, the plugin adds craftable, tuneable walkie-talkies. These are audible at any distance to anybody on the same frequency, making them perfect for coordinating with teammates across a large map. The feature is optional and requires the Simple Voice Chat mod to carry sound. Without it, the radios still craft and tune, but they simply carry no sound. Nothing else changes, so it is safe to include even if your players do not use voice chat.
Compatibility and Loaders
The ChaosLoop Plugin is built for Paper 1.20.1. It is a server-side plugin, so players do not need to install anything on their client to benefit from the core features. Every optional dependency is loaded behind a guard, so a missing plugin is a missing feature and never a stack trace. No third-party code is bundled in the jar, and everything is original or vanilla. It is MIT licensed, meaning you can use it, change it, learn from it, and credit the author, Amjed Elkateb.
How to Install the ChaosLoop Plugin
Getting started is straightforward. Follow these steps to get the full ChaosLoop experience running on your server.
- Download the ChaosLoop-Plugin-1.0.0.jar file and place it into your server's
plugins/folder. - Place the ChaosLoop datapack into
world/datapacks/. - Restart your server, then run the command
/function chaosloop:setup.
That is it. The plugin and datapack will sync up, and you are ready to play. For players who want the simplest possible setup, the foxygame.net launcher offers a one-click install for the ChaosLoop Plugin, bundling the jar and datapack together so you can skip the manual file dragging entirely. It is a convenient option if you manage multiple servers or want to avoid version mismatch headaches.
Why You Need the Datapack
It is worth repeating: the ChaosLoop Plugin on its own does very little. The datapack is what you actually want. The plugin exists to do the heavy lifting that a datapack cannot, such as reading inventory data, fetching player skins, and resetting the world. Together, they form a complete package. If you are looking to download ChaosLoop Plugin, make sure you also grab the datapack, or you will miss out on the Vault, Graves, Mimics, and the rest.
For those wondering how to install the pair correctly, just follow the steps above. The order matters: plugin first, then datapack, then the setup function. Once that is done, the ChaosLoop Plugin for Minecraft will handle the rest. It is a polished, well-documented tool that respects the vanilla feel while pushing the boundaries of what a minigame can be. Whether you are a server admin looking to run a fair competition or a map maker wanting to add a horror twist, this plugin is worth your time.
--- **Update Sep 14, 2026:** Added 2 files for version 1.20.1.