Head Finder Event

Overview

HeadFinderEvent is a comprehensive Minecraft plugin designed to create an interactive treasure hunt experience using player heads. Server administrators can place specific player heads throughout their world, and players can discover these heads to earn rewards and compete for leaderboard rankings.

Core Features

Head Discovery System

- Players right-click on placed player heads to "find" them - Each head can only be found once per player (prevents duplicate rewards) - Visual and audio feedback with configurable sound effects - Title displays and chat messages for successful discoveries - Automatic prevention of duplicate finds with database tracking

Vault Economy Integration

- Optional integration with Vault-compatible economy plugins - Configurable reward values for each individual head - Special bonus rewards for completing the entire collection - Formatted currency display using your economy plugin's formatting

Leaderboard System

- Global leaderboard tracking players' progress - Rankings based on number of heads found - Tiebreaker system using first discovery timestamp - Easy-to-read leaderboard display via command

MySQL Database Storage

- Robust MySQL database integration for data persistence - Automatic database and table creation - Stores player progress, timestamps, and reward history - Prevents data loss during server restarts

Comprehensive Configuration

- Sound Effects (`head.yml`): Define which players' heads are available and their individual reward values - Sound Effects (`config.yml`): Database settings, messages, and sound effects - Sound Effects: Toggle economy features on/off - Sound Effects: Fully customizable player-facing messages with placeholder support - Sound Effects: Configurable celebration sounds for discoveries and completion

Administrative Features

Command System (`/hfe`)

- `/hfe gethead <player|all>` - Give yourself heads for placement (Admin only) - `/hfe leaderboard` - View the current leaderboard - `/hfe reload` - Reload configuration files (Admin only) - `/hfe reset-database` - Reset all player progress (Admin only)

Permission System

- `headfinderevent.use` - Basic plugin access (default: true) - `headfinderevent.admin` - Admin commands like gethead and reload (default: op) - `headfinderevent.leaderboard` - View leaderboard (default: true) - `headfinderevent.reset` - Database reset permission (default: op)

Head Management

- Built-in head creation system with proper skull metadata - Persistent data containers to identify plugin-generated heads - Support for offline player head generation - Automatic skin loading and profile management

Use Cases

- Community Building: Create special treasure hunt events with limited-time head discoveries - Community Building: Encourage exploration of your server world - Community Building: Foster friendly competition with leaderboards - Community Building: Provide meaningful rewards through your server's economy - Community Building: Create shared goals for players to discover all available heads

Compatibility

- Soft Dependencies: 1.21.x - Soft Dependencies: Spigot/Paper and forks - Soft Dependencies: 21+ - Soft Dependencies: Vault (for economy integration)

This plugin provides a complete, production-ready system for running head-finding events on your Minecraft server, with robust error handling, comprehensive configuration options, and seamless integration with existing server infrastructure.