🧱 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

1. Run:

/bs start

1. Each player receives a random block.

2. Players must stand on that block before the timer ends.

3. Players who fail are eliminated.

4. 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

1. Download the plugin .jar
2. Place it in /plugins
3. Restart your server
4. Edit config.yml
5. 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

GitHub Sponsors

💬 Discord

https://discord.gg/vUHMxPvege