MCHunt - Block Hide & Seek Minigame

Hide as a block, seek as a player.

GitHub: rexchoppers/MCHunt

⚠️ Alpha Status

This plugin is currently in Alpha — playable core gameplay is present but features are still being added and refined.
Configurations and features may also break.

Please report bugs, suggest improvements, or contribute via GitHub

📜 History / Background

The first BlockHunt plugin was released over 10 years ago.
MCHunt is a personal remake of that classic gameplay — created out of nostalgia and to bring the fun to modern servers with new features and improvements.

🚀 Quick Start

1. Download the release JAR from GitHub Releases
2. Place the JAR in your server’s plugins/ folder
3. Install dependencies (see below) and restart the server

✨ Features

• Arena-based Hide & Seek gameplay
• GUI-driven setup & admin menus
• Sign integration for joining/interaction
• Localised messages (English provided)
• WorldGuard regions support

🧩 Requirements & Compatibility

• Java 21 (targets Java 21)
• Server: Spigot/Paper 1.21.x
• Dependencies: ProtocolLib, LibsDisguises, WorldGuard
• Recommended: WorldEdit (required by WorldGuard)

📥 Installation

1. Build or download the JAR
2. Place it in plugins/
3. Ensure ProtocolLib, LibsDisguises, WorldGuard (and WorldEdit) are present
4. Restart — plugin will generate config & data folders

🎮 Basic Usage (Commands)

• /mchunt — Opens the main GUI

> Most actions are performed via the in-game GUI rather than typed commands.

🔐 Permissions

• mchunt.admin — Access admin/setup menus

📁 Configuration & Data

• Arenas data: plugins/MCHunt/arenas/
• Arena setup data: plugins/MCHunt/arena_setup/
• Localization files: language_en.properties, language_en_US.properties

🛣️ Roadmap / TODO

See TODO.txt for planned features:
Vault economy support, configurable timings, scoreboard support, and more.

📜 License

Licensed under GPL-3.0

🙏 Credits + Notices

See NOTICES.md for third-party libraries and assets used.

🤝 Contribute & Feedback

Suggestions, bug reports, and contributions are welcome!
Open issues or PRs at rexchoppers/MCHunt

Logo

• The logo for MCHunt was generated using Generative AI. I'm open to offers for a custom logo if anyone is interested in creating one.