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

• Head Configuration (head.yml): Define which players' heads are available and their individual reward values
• Main Configuration (config.yml): Database settings, messages, and sound effects
• Vault Integration: Toggle economy features on/off
• Custom Messages: 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

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

Compatibility

• Minecraft Version: 1.21.x
• Server Software: Spigot/Paper and forks
• Java Version: 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.