Skip to content

hellofaizaaan/BlockShuffle

Repository files navigation

🧱 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

If you want, I can also:

  • Optimize this for Modrinth SEO
  • Create a short description
  • Write a changelog template
  • Design a banner image text

Just tell me 👍

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages