HereNavy

A premium Paper Minecraft plugin for RPG-style Exploration, Visual Navigation, and Skill Progression — discover new biomes and structures to level up your Exploration skill, and unlock immersive, client-mod-free visual navigation HUD tools (including a Skyrim-style action/boss bar compass, a 3D TextDisplay pointing arrow, and glowing particle path trails)!

---

Features

• RPG Exploration Skill & Levels:

  • Progress from Level 1 to 100 by mapping out the Minecraft world.
  • Passive Biome Discovery: Awards Exploration EXP every time you step into a biome you've never visited before.
  • Active Structure Discovery: Triggers "Discovery" when you venture within 10 blocks of generated structure boundaries (Villages, Strongholds, Monuments, etc.). Awards huge EXP and broadcasts a server-wide announcement!
  • Level-Based POI Unlock Progression: Higher-tier biomes and structures require meeting minimum Exploration level milestones before they can be tracked.
  • Level 100 Capstone Reward: Grants players the unique "World Explorer" Elytra upon achieving mastery level.

• Immersive Multi-Page Cartography GUI System:

  • Open a sleek main landing selection hub using /hn start or /explore.
  • Hub Features:
    • Displays complete live player stats (Level, EXP progression, Biomes found, Landmarks found).
    • Links to dedicated visual navigation menus.
  • Dedicated Biomes Map Page (🌿 Biomes Map 🌿): A symmetrical 54-slot chest containing all 28 registered biomes, locked by exploration level locks.
  • Dedicated Landmarks Map Page (🏰 Landmarks Map 🏰): A symmetrical 54-slot chest displaying all 28 registered vanilla structures sorted in progression order.
  • Interactive States:
    • Locked: Represented by gray stained glass panes indicating the required Level to unlock.
    • Unlocked / Unvisited: Represented by unique thematic items (e.g., Trial Key for Trial Chambers, Echo Shard for Ancient Cities). Click to start tracking!
    • Completed / Discovered: Renders a glowing enchanted item showing that you've discovered it.

• Visual Navigation Suite (Client-Mod-Free):

  • Skyrim-Style Compass HUD: Computes real-time angular headings towards your destination and renders a smooth scrolling directional compass on your Action Bar or Boss Bar (e.g. W - NW - N[♦] - NE - E).
  • 3D Unicode TomTom Arrow: Spawns an invisible Paper TextDisplay entity containing a bold direction arrow (➔) exactly 3-4 blocks in front of the player. It rotates dynamically in real-time as you spin and move.
  • Shiny Particle Trails: Spawns a stream of guiding particles (cyan/green magic sparkles) that fly forward in the physical direction of your targeted landmark.
  • Four Configurable Visual Styles: Choose between Compass-Only, Arrow-Only, Trail-Only, or Combined displays via configuration.

• BlueMap Web Map Integration:

  • Automatically places persistent global markers on the BlueMap 3D web map whenever a brand-new physical structure is discovered.
  • Segregated MarkerSets: Symmetrically maps and separates landmarks across dimensional maps (Overworld, Nether, End), ensuring correct dimension tracking.
  • Dynamic Groupings: Clusters matching structures under categorized marker sets (e.g. Plains, Desert, Snowy Villages are grouped under a single toggleable "Villages" set on the map).
  • Clear Landmark Labels: Markers are registered with unique IDs (hn-marker-<uuid>) and descriptive coordinate-appended titles (e.g., Plains Village [-240, 1800]).
  • Towny Marker Delegation: Exposes a direct, decoupled plugin API (HereNavyAPI) which allows compatible town-progression plugins (such as HereTowny) to delegate town marker creation and updates to HereNavy. This replaces generic POI icons with HereNavy's nice custom village icons and utilizes player-defined town names dynamically.

• BMarker Support (Solid 16x16 EntitySprites):

  • If BMarker (BlueMap Marker Manager) is installed, markers are rendered using beautiful, high-contrast 16x16 solid square EntitySprite head textures loaded from the Minecraft Wiki (e.g., Warden head for Ancient Cities, Villager head for Villages, Blaze head for Nether Fortresses).
  • Solid background frames prevent transparency from getting lost on the web map terrain.
  • Uses configured anchor offsets (16, 16) for absolute pinpoint map accuracy.

• Admin Structure Tracking GUI (/hn admin):

  • Administrators can execute /hn admin to open a premium 54-slot chest GUI listing all 28 structures.
  • Toggling tracking states is real-time: active tracked structures glow green (✔ TRACKED), and untracked ones show red warning blocks (❌ NOT TRACKED).
  • Disabling a structure dynamically filters it out from the players' Landmarks GUI, suspends active chunk boundary scanning in the 20-tick exploration loop, and stops BlueMap registrations.
  • Choices automatically persist to config.yml under untracked-structures.

• Advanced Structure-Centric Database:

  • Organizes world structures under plugins/HereNavy/structures/[structure-type]/[uuid].yml.
  • Records the exact physical location of each structure and holds a shared list of players who have successfully discovered it, preventing duplicate structure generation configurations in multiplayer environments.
  • Origin Shifting Target Search: Uses Bukkit's structure location API. If the nearest search coordinate matches a structure already discovered by the player, it mathematically shifts the search origin (e.g. +1000 blocks) and searches again, ensuring navigation always guides you to new, unexplored territory!

• Smart Deep Configuration Merging:

  • Modeled after premium integration standards, ConfigManager automatically compares your local server config.yml with default jar resources on startup.
  • Dynamically merges and appends new structures, biomes, or level unlock categories into existing config sections without altering or resetting any of your custom parameters.

---

Commands

All commands can be run with /hn or /explore instead of /herenavy.

Command	Description	Permission
/hn start (or /explore)	Opens the main Selection Cartography Hub	herenavy.use
/hn stop	Cancels any active navigation target	herenavy.use
/hn info	Displays your current Exploration Level, EXP, and progression status	herenavy.use
/hn go <x> <y> <z>	Starts manual coordinates navigation (Arrival-only, no EXP rewards)	herenavy.use
/hn admin	Opens the Admin Structure Tracking Dashboard GUI	herenavy.admin

---

Permissions

Permission	Description	Default
herenavy.use	Allows full access to all /hn commands and navigation menus	true
herenavy.admin	Allows full access to HereNavy admin commands and tracking GUI	op

---

Building from Source

Package the plugin using Gradle:

./gradlew build

The compiled plugin JAR will be saved in build/libs/.

---

License

This project is licensed under the GNU General Public License v3.0.