# \ud83c\udf81 PresentsHunt – Gift Hunt<\/p>\n
A plugin that adds an exciting gift hunt with different themed modes. Players search for hidden gift heads throughout the world and receive rewards for collecting them.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udf84 **Themed Modes**: Christmas, Halloween, Easter, and custom mode
\n– \ud83c\udfc6 **Achievement System**: Players collect event items to earn rewards
\n– \ud83d\udcca **Leaderboard**: Player rankings with PlaceholderAPI integration
\n– \ud83c\udfaf **Administrative Tools**: Easy management and cleanup of event items (no need to remember exact locations)
\n– \ud83d\udd0a **Effects**: Particles and sounds when interacting with event items
\n– \ud83d\udcdd **Configurable Messages**: Support for MiniMessage format
\n– \ud83d\udd27 **API Integration**: PlaceholderAPI support for integration with other plugins<\/p>\n
## \u2728 Dependencies
\n**Optional** – PlaceholderAPI<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Main settings in `config.yml`:<\/p>\n
“`yaml
\n# Mode Selection (HALLOWEEN, CHRISTMAS, EASTER, CUSTOM)
\npresentsMode: CHRISTMAS<\/p>\n
# How many event items need to be found to get a reward
\ntotalPresents: 30<\/p>\n
# Commands for each found event item and when a player finds all
\n# In these commands, you can use the variables %player%, %found%, and %total%.
\ncommands:
\n foundCommands: [ ]
\n rewardCommands:
\n – “give %player% diamond 10”<\/p>\n
leaderboard:
\n maxPlayersCount: 100 # How many players will be stored in the leaderboard to display the position in the top<\/p>\n
# Music when interacting with the head
\nsounds:
\n found: “block.pumpkin.carve”
\n alreadyFound: “entity.zombie.ambient”
\n complete: “entity.firework_rocket.blast”<\/p>\n
# Effects when interacting with the head
\nparticles:
\n found: “SWEEP_ATTACK”
\n alreadyFound: “SQUID_INK”
\n“`<\/p>\n
### Head Textures
\nPre-configured textures available for each mode:
\n– **CHRISTMAS**: New Year gift
\n– **HALLOWEEN**: Halloween pumpkin
\n– **EASTER**: Easter egg
\n– **CUSTOM**: Custom head (configure your own texture)<\/p>\n
## \ud83c\udfae Usage<\/p>\n
### For Players
\n1. Find hidden event item heads in the world
\n2. Right-click the event item to collect it
\n3. Collect event items to earn rewards
\n4. Use `\/presentshunt stats` to view statistics<\/p>\n
### For Administrators ### Placing Gifts ## \ud83d\udcca PlaceholderAPI<\/p>\n The plugin supports PlaceholderAPI with the following placeholders:<\/p>\n “` ## \ud83d\udd27 Permissions<\/p>\n “` ## \ud83d\udce5 Installation<\/p>\n ### Installation Steps Let the players find holiday heads and get rewards for it. Christmas, Halloween, Easter, and custom mode.<\/p>\n","protected":false},"featured_media":124745,"template":"","meta":{"_minecraft_slug":"presentshunt","_minecraft_project_id":"OfTmarkO","_minecraft_author":"FlyAwayMaking","_minecraft_license":"MIT","_minecraft_downloads":124,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"presentshunt.zip","_minecraft_size_bytes":151959,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:04:52.581557Z","_minecraft_date_created":"2025-12-21T05:11:43.270618Z","_minecraft_date_modified":"2026-03-11T20:25:39.351149Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/presentshunt","_minecraft_icon_attachment_id":124745,"_minecraft_imported_at":"2026-06-07T07:57:07+00:00","_minecraft_import_hash":"af877184f3fb078385ad7289c4935761","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,866,127,128],"mod_loader":[132,133],"minecraft_version":[36,60,93,94,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-124744","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`
\n\/presentshunt give – Get a head (event item)
\n\/presentshunt stats – Show plugin statistics
\n\/presentshunt reload – Reload configuration
\n\/presentshunt locate [radius] – Find event items within radius
\n\/presentshunt cleanup [radius] – Remove event items within radius
\n\/presentshunt resetplayer
\n\/presentshunt resetall – Reset all player data
\n\/presentshunt setmode [mode] – Set a new event mode
\n\/presentshunt replace [mode] [radius] – Replace all items of the selected event with the current one in the radius
\n“`<\/p>\n
\n1. Get a head with `\/presentshunt give` command
\n2. Place the head anywhere in the world
\n3. The head is automatically marked as a collectible event item<\/p>\n
\n%presentshunt_found% – Number of found event items
\n%presentshunt_total% – Total number of event items
\n%presentshunt_mode% – Current hunt mode
\n%presentshunt_completed% – Number of players who completed the hunt
\n%presentshunt_players% – Number of players with data
\n%presentshunt_position% – Ranking position
\n%presentshunt_status% – Completion status (Completed\/In Progress\/Not Started)
\n%presentshunt_top_1_status% – Status of player in 1st place
\n%presentshunt_top_2_status% – Status of player in 2nd place
\n… and so on up to 10th place
\n“`<\/p>\n
\npresentshunt.use – Collecting Event Items (default: true)
\npresentshunt.admin – Administrative commands (default: op)
\n“`<\/p>\n
\n1. Download the latest version
\n2. Place the `PresentsHunt.jar` file in the `plugins\/` folder
\n3. Restart the server
\n4. Configure the configuration file `plugins\/PresentsHunt\/config.yml` and apply changes with the `\/presentshunt reload` command
\n5. Use the `\/presentshunt give` command to get a event head<\/p>\n","protected":false},"excerpt":{"rendered":"