EggHunt & Geocaching

# 🥚 EggHunt & MCGeocaching 🗺️ Bring an immersive and interactive treasure-hunting experience to your Minecraft server! This plugin combines a highly customizable **Seasonal EggHunt/Treasure Hunt** with a realistic **Geocaching** system. Whether you want players hunting for Easter Eggs, Halloween Pumpkins, or Christmas Presents, or navigating the wilderness with a metal-detector-like compass to find hidden Geocaches, this plugin has it all! --- ## 🥚 The EggHunt System (Seasonal Treasure Hunts) The EggHunt feature is the core of the plugin, designed to keep your players engaged all year round. It is fully adaptable to different seasons: **Easter, Halloween, and Christmas**. ### ✨ Features * **Categories & Rarity:** You can group hidden items (eggs, gifts, pumpkins) into custom categories using `storage.yml`. Each category can have its own distinct set of textures, specific rewards, and animations. This allows you to create common, rare, and legendary treasures! * **62 Unique Animations:** The plugin features a massive library of 62 different particle animations! These are divided into seasons, meaning finding an Easter Egg might trigger a magical spiral, while finding a Christmas present might trigger a festive reveal. * **Random Spawns (Drop Events):** Enable random spawns to periodically drop a treasure somewhere in the world (e.g., every hour). The plugin announces the hunt in chat and can even provide a direct **BlueMap** link pointing to the general area where the treasure is hidden! * **Stats & GUI:** Players can track their progress through a beautiful, customizable GUI to see how many treasures they've found in different regions/worlds. * **Completion Rewards:** Grant special global or random rewards to players who manage to find *every single* hidden item on the server. --- ## 🗺️ MCGeocaching A true-to-life replica of real-world Geocaching, seamlessly integrated into Minecraft. ### ✨ Features * **Interactive Navigation:** Players use a compass that acts like a metal detector—it **beeps faster** and updates a **bossbar** the closer they get to the hidden cache. * **BlueMap Integration:** Caches can be displayed on your BlueMap with custom real-world Geocaching icons. * **Logbooks:** Just like real geocaching, players can sign a virtual logbook when they discover a cache. * **Customizable Difficulty:** Want a harder challenge? You can hide caches completely from the map, disable the compass tracking, or turn off the proximity beep! --- ## ⌨️ Commands ### 🥚 EggHunt Commands ```text /egghunt gui - Opens the interactive GUI. /egghunt stats - View your personal hunting stats. /egghunt locadder - Tool for adding random spawn locations. /egghunt reload - Reloads the plugin configuration. ``` ### 🗺️ Geocaching Commands ```text /geocaching - Opens the main Geocaches GUI. /geocaching create <name> - Creates a new geocache. Options: -p, --preset Create cache based on a preset from config. --hidden Hides the cache completely. --no-compass Disables compass tracking for this cache. --no-bossbar Disables the proximity bossbar. --no-beep Disables the proximity sound effect. --no-map Hides the cache from BlueMap. --no-logbook Disables the logbook feature. /geocaching modify <name> - Edits an existing geocache. Options: --location Updates the cache to your current location. --beep=true/false --compass=true/false --bossbar=true/false --map=true/false --delete Deletes the cache. /geocaching delete <name> - Deletes a specific geocache. ``` --- ## 🛠️ Configuration & Customization This plugin is built with server owners in mind. **Everything** is configurable: * **`config.yml`:** Toggle features, set up BlueMap links, configure the random spawn event timers, and adjust the stats GUI. * **`storage.yml`:** Define your custom treasure categories. Assign specific Base64 textures, commands to run on discovery, and which animation to play. Hundreds of pre-configured Base64 heads are supported out of the box! * **`locale.yml`:** 100% rich text translation support. Every single prefix, broadcast, and menu name can be customized to fit your server's language and style. --- ### Feature request Create an issue using the issue tracker link and briefly describe what would you like to add --- ### Default files <details> <summary>Locale.yml</summary> ```yaml # EggHunt Localization File # ========== ENGLISH TRANSLATIONS DEFAULT ========== en: commands: running_version: "&fRunning McGeocaching v&f{version}" reload: success: "&aEggHunt was reloaded" reloading: "&fReloading EggHunt..." looper_reloaded: "&fLooper reloaded" looper_stop: "&fLooper stop" pulsed: "&aPulsed &f{count} &alocations." particles_stopped: "&aAll particles were stopped."