# \ud83e\uddf1 Block Shuffle \u2014 Minecraft Mini-Game Plugin<\/p>\n
Block Shuffle is a fast-paced, competitive Minecraft minigame inspired by popular YouTube challenges.
\nPlayers are given a random block every round and must stand on it before the timer runs out \u2014 or they\u2019re eliminated.<\/p>\n
Perfect for:
\n\u2714 Survival servers
\n\u2714 Events & tournaments
\n\u2714 SMP mini-games
\n\u2714 Content creators<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features<\/p>\n
– \ud83c\udfaf **Random Block Challenges**
\n – Each player receives a unique block every round.<\/p>\n
– \ud83e\udde0 **Smart Difficulty Scaling**
\n – Difficulty increases as rounds progress.
\n – Fewer players = harder challenges.<\/p>\n
– \u2696\ufe0f **Weighted Block System**
\n – Common blocks appear more often.
\n – Rare blocks stay rare.
\n – Fully configurable.<\/p>\n
– \ud83e\uddf1 **Dimension Control**
\n – Enable\/disable Overworld, Nether, or End blocks.<\/p>\n
– \u274c **Automatic Elimination**
\n – Fail to find your block \u2192 eliminated.
\n – Last player standing wins.<\/p>\n
– \u26a1 **Optimized for Paper**
\n – Lightweight
\n – Lag-free
\n – Event-based logic<\/p>\n
—<\/p>\n
## \ud83c\udfae How It Works<\/p>\n
1. Run:
\n“`<\/p>\n
\/bs start<\/p>\n
“`<\/p>\n
2. Each player receives a random block.<\/p>\n
3. Players must stand on that block before the timer ends.<\/p>\n
4. Players who fail are eliminated.<\/p>\n
5. Rounds continue until one player remains.<\/p>\n
\u2764\ufe0f Why Use Block Shuffle?<\/p>\n
\u2714 Clean UI
\n\u2714 Competitive & fun
\n\u2714 Highly customizable
\n\u2714 Lightweight
\n\u2714 Perfect for events
\n\u2714 Actively developed<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Everything is configurable via `config.yml`.<\/p>\n
### Example:
\n“`yaml
\nround-time: 300
\nmin-players: 2
\nallow-bossbar: true<\/p>\n
allow:
\n overworld: true
\n nether: true
\n end: false<\/p>\n
messages:
\n start: “&a\ud83d\udfe2 Block Shuffle started!”
\n win: “&6\ud83c\udfc6 {player} won the game!”
\n fail: “&cYou failed this round!”<\/p>\n
weight-categories:
\n common-blocks: 10
\n building-blocks: 8
\n decorative: 7
\n common-ores: 6
\n nether-blocks: 5
\n default: 5
\n uncommon-ores: 4
\n end-blocks: 3
\n rare-ores: 2
\n ultra-rare: 1<\/p>\n
weights:
\n # STONE: 10
\n # DIRT: 9<\/p>\n
difficulty:
\n weight-reduction-per-round: 0.15<\/p>\n
blacklist:
\n – END_PORTAL_FRAME
\n – SPAWNER
\n – BARRIER
\n – DEEPSLATE_EMERALD_ORE
\n – ANCIENT_DEBRIS
\n – LODESTONE
\n – COMMAND_BLOCK
\n – STRUCTURE_BLOCK
\n \/\/ more like player heads<\/p>\n
““<\/p>\n
—<\/p>\n
## \ud83e\udde0 Smart Difficulty System<\/p>\n
\u2714 Early rounds \u2192 easy blocks
\n\u2714 Mid rounds \u2192 moderate challenge
\n\u2714 Late rounds \u2192 rare & difficult blocks<\/p>\n
The game adapts automatically to keep gameplay fair and exciting.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the plugin `.jar`
\n2. Place it in `\/plugins`
\n3. Restart your server
\n4. Edit `config.yml`
\n5. Run `\/bs start`<\/p>\n
—<\/p>\n
## \ud83d\ude80 Planned Features<\/p>\n
### \ud83d\udd35 Future Updates<\/p>\n
* Difficulty presets (Easy \/ Normal \/ Hardcore)
\n* Scoreboard support
\n* Per-world games
\n* Random teleport on round start
\n* Anti-cheat protections<\/p>\n
### \ud83d\udd34 Long-Term Goals<\/p>\n
* Player statistics
\n* Leaderboards
\n* Multiple game arenas
\n* Power-ups & special rounds
\n* GUI-based configuration
\n* Database support (SQLite \/ MySQL)<\/p>\n
—<\/p>\n
## \ud83c\udfc6 Why Use Block Shuffle?<\/p>\n
\u2714 Fun & competitive
\n\u2714 Easy to configure
\n\u2714 Works great for events
\n\u2714 Scales with player skill
\n\u2714 Lightweight & optimized<\/p>\n
—<\/p>\n
## \u2764\ufe0f Support & Community<\/p>\n
\u2b50 Star the project
\n\ud83d\udc1e Report bugs
\n\ud83d\udca1 Suggest features<\/p>\n
—<\/p>\n
### \ud83e\udd1d Sponsor<\/p>\n
GitHub Sponsors<\/p>\n
### \ud83d\udcac Discord<\/p>\n
https:\/\/discord.gg\/vUHMxPvege<\/p>\n","protected":false},"excerpt":{"rendered":"
Dream inspired minecraft block shuffle game<\/p>\n","protected":false},"featured_media":32458,"template":"","meta":{"_minecraft_slug":"blockshuffle","_minecraft_project_id":"z0t0H4LV","_minecraft_author":"hellofaizan","_minecraft_license":"MIT","_minecraft_downloads":884,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"blockshuffle.zip","_minecraft_size_bytes":1228348,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T09:03:25.825336Z","_minecraft_date_created":"2026-01-13T21:54:25.108325Z","_minecraft_date_modified":"2025-12-30T11:08:54.374316Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/blockshuffle","_minecraft_icon_attachment_id":32458,"_minecraft_imported_at":"2026-06-01T14:49:04+00:00","_minecraft_import_hash":"7b3d6449e7242b7f4c6b046406624b43","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,866,127,867,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-32457","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-minigame","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n