Block Shuffle

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

2. Each player receives a random block.

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

4. Players who fail are eliminated.

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