HereNavy
一款高端 Paper Minecraft 插件,专为 RPG 风格探索、视觉导航和技能成长 设计 —— 发现新的生物群系和结构以提升你的“探索”技能等级,并解锁无需客户端模组的沉浸式视觉导航 HUD 工具(包括类似《上古卷轴5》动作/首领条的指南针、指向目标的 3D TextDisplay 箭头以及发光的粒子路径轨迹)!
功能特性
命令
所有命令均可使用 /hn 或 /explore 替代 /herenavy 来执行。
| 命令 |
描述 |
权限 |
/hn start (或 /explore) |
打开主选择制图中心 |
herenavy.use |
/hn stop |
取消任何活动的导航目标 |
herenavy.use |
/hn info |
显示您当前的探索等级、经验值及进度状态 |
herenavy.use |
/hn go <x> <y> <z> |
开始手动坐标导航(仅到达模式,无经验奖励) |
herenavy.use |
/hn admin |
打开管理员结构跟踪仪表板 GUI |
herenavy.admin |
权限
| 权限 |
描述 |
默认值 |
herenavy.use |
允许完全访问所有 /hn 命令和导航菜单 |
true |
herenavy.admin |
允许完全访问 HereNavy 管理员命令和跟踪 GUI |
op |
从源代码构建
使用 Gradle 打包插件:
./gradlew build
编译后的插件 JAR 文件将保存在 build/libs/ 中。
许可证
本项目遵循 GNU General Public License v3.0 许可协议。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧