🧱 Block Shuffle — Minecraft Mini-Game Plugin
Block Shuffle is a fast-paced, competitive Minecraft minigame inspired by popular YouTube challenges. Players are given a random block every round and must stand on it before the timer runs out — or they’re eliminated.
Perfect for: ✔ Survival servers ✔ Events & tournaments ✔ SMP mini-games ✔ Content creators
🌟 Features
-
🎯 Random Block Challenges
- Each player receives a unique block every round.
-
🧠 Smart Difficulty Scaling
- Difficulty increases as rounds progress.
- Fewer players = harder challenges.
-
⚖️ Weighted Block System
- Common blocks appear more often.
- Rare blocks stay rare.
- Fully configurable.
-
🧱 Dimension Control
- Enable/disable Overworld, Nether, or End blocks.
-
❌ Automatic Elimination
- Fail to find your block → eliminated.
- Last player standing wins.
-
⚡ Optimized for Paper
- Lightweight
- Lag-free
- Event-based logic
🎮 How It Works
- Run:
/bs start
-
Each player receives a random block.
-
Players must stand on that block before the timer ends.
-
Players who fail are eliminated.
-
Rounds continue until one player remains.
❤️ Why Use Block Shuffle?
✔ Clean UI ✔ Competitive & fun ✔ Highly customizable ✔ Lightweight ✔ Perfect for events ✔ Actively developed
⚙️ Configuration
Everything is configurable via config.yml.
Example:
round-time: 300
min-players: 2
allow-bossbar: true
allow:
overworld: true
nether: true
end: false
messages:
start: "&a🟢 Block Shuffle started!"
win: "&6🏆 {player} won the game!"
fail: "&cYou failed this round!"
weight-categories:
common-blocks: 10
building-blocks: 8
decorative: 7
common-ores: 6
nether-blocks: 5
default: 5
uncommon-ores: 4
end-blocks: 3
rare-ores: 2
ultra-rare: 1
weights:
# STONE: 10
# DIRT: 9
difficulty:
weight-reduction-per-round: 0.15
blacklist:
- END_PORTAL_FRAME
- SPAWNER
- BARRIER
- DEEPSLATE_EMERALD_ORE
- ANCIENT_DEBRIS
- LODESTONE
- COMMAND_BLOCK
- STRUCTURE_BLOCK
// more like player heads
🧠 Smart Difficulty System
✔ Early rounds → easy blocks ✔ Mid rounds → moderate challenge ✔ Late rounds → rare & difficult blocks
The game adapts automatically to keep gameplay fair and exciting.
📦 Installation
- Download the plugin
.jar - Place it in
/plugins - Restart your server
- Edit
config.yml - Run
/bs start
🚀 Planned Features
🔵 Future Updates
- Difficulty presets (Easy / Normal / Hardcore)
- Scoreboard support
- Per-world games
- Random teleport on round start
- Anti-cheat protections
🔴 Long-Term Goals
- Player statistics
- Leaderboards
- Multiple game arenas
- Power-ups & special rounds
- GUI-based configuration
- Database support (SQLite / MySQL)
🏆 Why Use Block Shuffle?
✔ Fun & competitive ✔ Easy to configure ✔ Works great for events ✔ Scales with player skill ✔ Lightweight & optimized
❤️ Support & Community
⭐ Star the project 🐞 Report bugs 💡 Suggest features
🤝 Sponsor
💬 Discord
