Minecraft Block Shuffle Fabric

Minecraft Block Shuffle Fabric is an unofficial Fabric port of the original MinecraftBlockShuffle plugin by Matistan. It runs a multiplayer minigame where every participant receives a random target block and must stand on it before the round timer expires.

This version targets Minecraft Java Edition 1.21.11 and works on dedicated Fabric servers and integrated Open-to-LAN worlds.

Gameplay

At the beginning of each round, every active player receives a target block. Reaching and standing on that block completes the objective.

Two game modes are available:

• Elimination mode removes players who fail to find their block in time.
• Points mode awards points for completed objectives until a player reaches the configured score.

Target block names use Minecraft’s built-in translations, so each player sees the name in their selected client language.

Difficulty levels

Target blocks are divided into three configurable difficulty levels:

• easy focuses on common Overworld blocks.
• normal adds ores, processed materials, decorative blocks, and some dimension-specific blocks.
• hard allows rare or expensive survival-obtainable blocks.

Administrators can also ban or unban individual blocks. Impossible and administrative blocks are excluded by default.

Random teleportation

Optional random teleportation can move players to new safe Overworld locations during selected rounds.

Available modes:

• off disables random teleportation.
• shared sends every player to the same location for a fair race.
• separate gives each player an independent location.

The teleport interval and radius are configurable. The mod checks for solid ground, headroom, fluids, and the world border before teleporting players, then grants brief damage protection.

Commands

/blockshuffle add <players>
/blockshuffle remove <players>
/blockshuffle start
/blockshuffle reset
/blockshuffle skip
/blockshuffle list
/blockshuffle difficulty <easy|normal|hard>
/blockshuffle teleport <off|shared|separate>
/blockshuffle ban <block>
/blockshuffle unban <block>

Configuration is generated at:

config/minecraft-block-shuffle.json

Installation

The hosting environment requires:

• Minecraft Java Edition 1.21.11
• Fabric Loader 0.18.1 or newer
• Fabric API for Minecraft 1.21.11
• Java 21

For a dedicated server, install the mod and Fabric API in the server’s mods directory. Joining players do not need the mod.

For an Open-to-LAN world, the hosting client must install both the mod and Fabric API because the host runs the integrated server. Other players can join without installing the mod.

Alpha status

This is an alpha release. Core gameplay is functional, but some features from the original Spigot plugin are not yet fully ported:

• The original Bukkit scoreboard has been replaced with action-bar information.
• Granular permission nodes and LuckPerms integration are not yet available.
• Difficulty selection currently remains fixed for the match and does not automatically increase by round.
• NeoForge is not currently supported.

Credits and license

This is an unofficial Fabric port of MinecraftBlockShuffle, originally created by Matistan.

The original project and this port are distributed under the MIT License.

Copyright (c) 2025 Matistan
Fabric port maintained by HanLax93