
概述
HeadFinderEvent 是一款功能全面的 Minecraft 插件,旨在通过使用玩家头颅打造互动寻宝体验。服务器管理员可以在世界中放置特定的玩家头颅,玩家可以发现这些头颅以获取奖励并竞争排行榜排名。
核心功能
头颅发现系统
- 玩家右键点击已放置的玩家头颅即可“发现”它们
- 每位玩家对每个头颅只能发现一次(防止重复领取奖励)
- 提供视觉和听觉反馈,支持可配置的音效
- 成功发现时显示标题和聊天消息
- 通过数据库追踪自动防止重复发现
Vault 经济集成
- 可选支持与 Vault 兼容的经济插件集成
- 可为每个独立头颅配置奖励数值
- 收集全部头颅可获得特殊额外奖励
- 使用你所在经济插件的格式显示货币
排行榜系统
- 全局排行榜跟踪玩家的进度
- 根据发现的头颅数量进行排名
- 当数量相同时,依据首次发现的时间戳作为决胜条件
- 通过命令查看易于阅读的排行榜展示
MySQL 数据库存储
- 强大的 MySQL 数据库集成以实现数据持久化
- 自动创建数据库和表
- 存储玩家进度、时间戳和奖励历史
- 防止服务器重启期间数据丢失
全面配置
- 头颅配置 (
head.yml):定义可用的玩家头颅及其各自的奖励值
- 主配置文件 (
config.yml):数据库设置、消息和音效
- Vault 集成:开启或关闭经济功能
- 自定义消息:完全可定制面向玩家的消息,支持占位符
- 音效:可配置发现头颅和完成收集时的庆祝音效
管理功能
命令系统 (/hfe)
/hfe gethead <player|all> - 给自己发放用于放置的头颅(仅限管理员)
/hfe leaderboard - 查看当前排行榜
/hfe reload - 重新加载配置文件(仅限管理员)
/hfe reset-database - 重置所有玩家进度(仅限管理员)
权限系统
headfinderevent.use - 基础插件访问权限(默认:true)
headfinderevent.admin - 管理员命令,如 gethead 和 reload(默认:op)
headfinderevent.leaderboard - 查看排行榜(默认:true)
headfinderevent.reset - 数据库重置权限(默认:op)
头颅管理
- 内置带有正确头颅元数据的头颅创建系统
- 使用持久化数据容器来识别插件生成的头颅
- 支持离线玩家头颅生成
- 自动加载皮肤和管理个人资料
应用场景
- 服务器活动:举办限时头颅发现的特别寻宝活动
- 玩家参与:鼓励玩家探索你的服务器世界
- 竞技比拼:通过排行榜培养友好的竞争氛围
- 经济集成:通过服务器的经济系统提供有意义的奖励
- 社区建设:为玩家设立共同目标,发现所有可用的头颅
兼容性
- Minecraft 版本:1.21.x
- 服务器软件:Spigot/Paper 及其分支
- Java 版本:21+
- 软依赖项:Vault(用于经济集成)
此插件为在您的 Minecraft 服务器上运行寻头活动提供了一个完整、生产就绪的系统,具备强大的错误处理、全面的配置选项以及与现有服务器基础设施的无缝集成。

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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧