HereNavy

# HereNavy A premium (https://papermc.io) 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 `). - **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 st