HereNavy

插件

· 作者 Merlointhesky

一个 Paper 插件,为发现生物群系和结构添加 RPG 元素

0 本站下载 0 关注 更新于 4 个月前

最新 1.1.2 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

HereNavy

一款高端 Paper Minecraft 插件,专为 RPG 风格探索、视觉导航和技能成长 设计 —— 发现新的生物群系和结构以提升你的“探索”技能等级,并解锁无需客户端模组的沉浸式视觉导航 HUD 工具(包括类似《上古卷轴5》动作/首领条的指南针、指向目标的 3D TextDisplay 箭头以及发光的粒子路径轨迹)!


功能特性

  • RPG 探索技能与等级系统:

    • 通过绘制 Minecraft 世界地图,从 1 级升至 100 级。
    • 被动生物群系发现:每次踏入从未访问过的生物群系时,奖励探索经验值。
    • 主动结构发现:当你靠近生成结构的边界 10 格范围内时触发“发现”机制(如村庄、要塞、神殿等)。奖励大量经验值并广播全服公告!
    • 基于等级的兴趣点 (POI) 解锁进度:更高级别的生物群系和结构需要满足最低探索等级里程碑才能被追踪。
    • 100 级终极奖励:达成大师级别后,授予玩家独特的 “世界探险家”鞘翅。
  • 沉浸式多页制图 GUI 系统:

    • 使用 /hn start 或 /explore 打开一个简洁的主选择中心。
    • 中心功能:
      • 显示完整的实时玩家统计信息(等级、经验进度、已发现的生物群系数量、已发现的地标数量)。
      • 链接到专用的视觉导航菜单。
    • 专用生物群系地图页面 (? Biomes Map ?):一个对称的 54 格箱子,包含所有 28 个注册生物群系,受探索等级锁定限制。
    • 专用地标地图页面 (? Landmarks Map ?):一个对称的 54 格箱子,按进度顺序显示所有 28 个原版注册结构。
    • 交互状态:
      • 已锁定:由灰色染色玻璃板表示,显示解锁所需的等级。
      • 已解锁 / 未访问:由独特的主题物品表示(例如 试炼钥匙 对应试炼密室,回声碎片 对应远古城市)。点击即可开始追踪!
      • 已完成 / 已发现:渲染为发光的附魔物品,表明你已发现该目标。
  • 视觉导航套件(无需客户端模组):

    • 类《上古卷轴5》指南针 HUD:计算到达目的地的实时角度方位,并在 动作栏 或 首领条 上渲染平滑滚动的方向指南针(例如 W - NW - N[♦] - NE - E)。
    • 3D Unicode TomTom 箭头:在玩家正前方 3-4 格处生成一个不可见的 Paper TextDisplay 实体,其中包含粗体方向箭头 (➔)。当你旋转和移动时,它会动态实时旋转。
    • 闪亮粒子轨迹:生成一串引导粒子(青色/绿色魔法火花),沿着你瞄准的地标的物理方向向前飞行。
    • 四种可配置的视觉样式:通过配置文件在仅指南针、仅箭头、仅轨迹或组合显示之间进行选择。
  • BlueMap 网页地图集成:

    • 每当发现全新的物理结构时,自动在 BlueMap 3D 网页地图上放置持久的全局标记。
    • 隔离的标记集 (MarkerSets):在维度地图(主世界、下界、末地)中对称映射并分离地标,确保正确的维度追踪。
    • 动态分组:将匹配的结构聚类到分类标记集中(例如,平原、沙漠、雪地村庄被归入单个可切换的 "Villages" 集合中)。
    • 清晰的地标标签:标记使用唯一 ID (hn-marker-<uuid>) 和带有坐标描述性标题注册(例如 Plains Village [-240, 1800])。
    • Towny 标记委托:暴露直接解耦的插件 API (HereNavyAPI),允许兼容的城市进度插件(如 HereTowny)将城镇标记的创建和更新委托给 HereNavy。这用 HereNavy 精美的自定义村庄图标替换了通用的 POI 图标,并利用玩家定义的城镇名称进行动态更新。
  • BMarker 支持(Solid 16x16 EntitySprites):

    • 如果安装了 BMarker(BlueMap 标记管理器),则使用精美的高对比度 16x16 实心方块 EntitySprite 头部纹理 渲染标记,这些纹理从 Minecraft Wiki 加载(例如,远古城市使用监守者头像,村庄使用村民头像,下界要塞使用烈焰人头像)。
    • 实心背景框架防止透明度在网络地图地形上丢失。
    • 使用配置的锚点偏移量 (16, 16) 以实现绝对精确的地图定位。
  • 管理员结构追踪 GUI (/hn admin):

    • 管理员可以执行 /hn admin 打开一个高端 54 格箱子 GUI,列出所有 28 种结构。
    • 切换追踪状态是实时的:活动追踪的结构发出绿光 (✔ TRACKED),未追踪的显示红色警告方块 (❌ NOT TRACKED)。
    • 禁用某个结构会动态将其从玩家的“地标”GUI 中过滤掉,暂停 20 刻探索循环中的活动区块边界扫描,并停止 BlueMap 注册。
    • 选择会自动持久保存到 config.yml 下的 untracked-structures 字段。
  • 先进的以结构为中心的数据库:

    • 将世界结构组织在 plugins/HereNavy/structures/[structure-type]/[uuid].yml 下。
    • 记录每个结构的精确物理位置,并保存成功发现它的玩家 共享列表,防止在多人游戏环境中重复生成结构配置。
    • 原点偏移目标搜索:使用 Bukkit 的结构位置 API。如果最近的搜索坐标匹配玩家已经发现的结构,则在数学上将搜索原点偏移(例如 +1000 格)并再次搜索,确保导航始终引导你前往 新的、未探索的 区域!
  • 智能深度配置合并:

    • 借鉴高级集成标准,ConfigManager 会在启动时自动将本地服务器的 config.yml 与 JAR 包内的默认资源进行比较。
    • 动态合并并将新的结构、生物群系或等级解锁类别追加到现有配置部分中,同时不会更改或重置任何自定义参数。

命令

所有命令均可使用 /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 许可协议。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源