World EventPaper · Spigot v1.8.0

EggHunt & GeoCaching

The ultimate technical treasure hunting engine.

EggHunt & GeoCaching is an advanced treasure hunt framework engineered for high-performance servers. It features complex, cross-version particle animations via ParticleNativeAPI, deep BlueMap web-map integration, and a highly configurable YAML storage system. Whether you are running seasonal events (Easter, Halloween, Christmas) or permanent geocaches, this plugin provides unparalleled technical control.

Download on Modrinth SpigotMC

Features

Geocaching System

Create physical or virtual caches with proximity beeps, compass tracking, and bossbar hints.

Advanced Animations

Dozens of cross-version particles via ParticleNativeAPI (Spirals, Novas, Swarms, Vortexes).

BlueMap Integration

Live web map markers for Geocaches and 'Flash Event' random spawns.

Flash Events

Periodically spawn random gifts in pre-defined areas with clickable chat announcements.

WorldGuard & Storage

Restrict stat GUIs to specific regions. Efficient YAML-based asynchronous storage.

Presets & GUI

Create caches instantly using presets. Fully interactive GUIs for stats and management.

Compatibility

Paper

Spigot

1.20.4 – 26.3Java 17+ BlueMap PAPIWorldGuard

Technical Commands

Command	Description	Permission
`/geocaching`	Opens the main Geocaches management GUI.	`geocaching.gui`
`/geocaching create <name> [flags]`	Creates a new geocache at your target location. Available Flags: `-p, --preset` Use predefined cache settings `--hidden` Virtual cache (no physical block) `--no-compass` Disable compass tracking `--no-bossbar` Disable proximity bossbar `--no-beep` Disable proximity note block pings `--no-map` Hide from BlueMap `--no-logbook` Disable the finder logbook	`geocaching.admin`
`/geocaching modify <name> [flags]`	Modify properties of an existing cache. Available Flags: `--location` Updates to your current location `--beep=true/false` Toggle proximity sound `--compass=true/false` Toggle compass tracking `--bossbar=true/false` Toggle proximity bossbar `--map=true/false` Toggle BlueMap visibility `--logbook=true/false` Toggle logbook	`geocaching.admin`
`/geocaching delete <name>`	Permanently delete a geocache.	`geocaching.admin`
`/egghunt gui`	Open the main EggHunt admin GUI.	`egghunt.admin`
`/egghunt stats`	View your personal found/missing progress.	—
`/egghunt leaderboard`	View the top 10 players globally.	—
`/egghunt locadder`	Toggle block placement mode to define random spawn areas.	`egghunt.admin`
`/egghunt pulserandomlocations`	Spawns flame particles at all defined random spawn locations.	`egghunt.admin`
`/egghunt viewstats <player>`	View another player's progress.	`egghunt.admin`
`/egghunt forcerandom`	Force a random 'Flash Event' spawn immediately.	`egghunt.admin`
`/egghunt dev`	Advanced tools (backup, start/stop-particles, grand, missing).	`egghunt.dev`

PlaceholderAPI

%egghunt_found%%egghunt_total%%geocaching_found%%geocaching_total%

Documentation & Mechanics

1Geocaching Proximity & Properties

Geocaches are dynamic entities managed by the location-storage.yml file. Unlike standard eggs, Caches possess specific behavioral properties (flags). When a player holds a compass within the configured minimum_distance (default 120 blocks), the BeepService asynchronously calculates the 3D distance and plays hot/cold Note Block pings.

# You can predefine presets in storage.yml for rapid deployment:
geocaching:
  presets:
    - name: preset_hard
      rewards: ["give %player% diamond 1"]
      compass: false # Disables compass pings
      bossbar: false # Hides proximity bossbar
      bluemap: true # Shows marker on web map

2Random Spawns (Flash Events)

The RandomSpawnsLooper is a background service that triggers server-wide events. Define possible spawn locations using /egghunt locadder. Every period (e.g., 7200 seconds), an item spawns for a set duration. It utilizes BlueMapAPI to automatically draw an area marker on your web map, and broadcast a clickable chat message linking directly to those coordinates.

random_spawns:
  enabled: true
  period: 7200
  duration: 200
  animation_pool: "CHRISTMAS"
  url_mapping:
    "world": "https://map.example.com/#world:%x%:%y%:%z%:50:0:0:0:0"
  bluemap:
    label: "Flash Event"

3ParticleNativeAPI & Textures (storage.yml)

Animations are powered by ParticleNativeAPI, ensuring lag-free, mathematically complex particle generation (like Fibonacci Blooms or Double Helixes) across all Minecraft versions. In storage.yml, categories of eggs are grouped under egg-hunt.list. You can define specific animations via animation: ENUM, randomized lists via animation-pool, or bind them to a season via animation-season.

Texture Management: Textures MUST be defined under egg-hunt.textures as Base64 strings. Reference them in categories using their key (e.g., 'xmas_01') or Regex patterns (e.g., 'R:^xmas_.*').

egg-hunt:
  textures:
    xmas_01: "eyJ0ZXh0..." # Base64 texture
  list:
    - name: Xmas-Event
      random-reward: true
      rewards:
        - "give %player% diamond 1"
      animation-season: CHRISTMAS # Uses Christmas particle pool
      season: "CHRISTMAS" # Locks to /egghunt type: CHRISTMAS
      textures:
        - 'R:^xmas_.*' # Regex matches all xmas_ textures

Available EASTER Animations

Set these exact values in your storage.yml under animation: (e.g. animation: SPIRAL) to force a specific effect. To use a randomized pool of animations, set animation-season: to EASTER, HALLOWEEN, or CHRISTMAS. Note: animation-pool only accepts the 3 season values!

SPIRAL

SPARKLE_SHELL

MYST_TWIRL

EGG_NOVA

PETAL_DANCE

MAGIC_BURST

ARCANE_RIPPLE

PSYCHEDELIC_ORBIT

FRACTAL_MIND

COSMIC_FLOWER

CELESTIA_FLUX

ARCANE_SHOCK

GRACEFUL_ARCANE

SPRING_TORNADO

EGG_IMPLOSION

DOUBLE_HELIX

FLOATING_HALO

BUNNY_HOP

GOLDEN_FOUNTAIN

PULSING_HEART

MAGIC_RINGS

STAR_BLAST

FAIRY_DUST_SHOWER

ORBITAL_RESONANCE

EVENT_HORIZON

FIBONACCI_BLOOM

PHOENIX_ASCENSION

LISSAJOUS_KNOT

HATCHING_EGG

EGG_JUGGLER

CARROT_METEOR

REVEAL

4Stats GUI & Grand Rewards

When a player executes /egghunt stats, the plugin hooks into WorldGuard. You can restrict the GUI's usage to specific allowed regions or entire worlds inside config.yml. Additionally, if a player successfully discovers every single egg on the server, the all_eggs_found_rewards execution block is triggered to grant a grand prize.

stats_gui:
  enabled: true
  regions:
    worlds:
      - "world"
    allowed:
      - "spawn-region"

egghunt:
  all_eggs_found_reward: true
  all_eggs_found_random_reward: false
  all_eggs_found_rewards:
    - "minecraft:me &aPlayer %player% found all eggs!"

Version History

59 total downloads

1.8.0LatestOct 29, 20267

v1.8.0

HeadDB integration

1.7.7Oct 22, 202628

v1.7.7

added halloween preset

1.6Mar 31, 202624

Halloween & EggHunt & Geocaching ️

Halloween & EggHunt & Christmas hunt & MCGeocaching ️ Bring an immersive and interactive treasure-hunting experience to your Minecraft server! This plugin combines a highly custom...

Gallery