Ardania信息HUD

Ardania信息HUD

屏幕右侧的一个小型信息HUD,提供关于一个特定服务器玩家统计的许多重要信息。

Ardania Info HUD

Ardania Info HUD Logo

一款为 Minecraft 服务器 Ardania.de 打造的简洁、轻量级客户端 HUD 覆盖层。
基于 Fabric 构建,支持 Minecraft 1.21.X(1.21 – 1.21.11)、26.2 和 26.3。


📌 概述

Ardania Info HUD 是一款客户端 Fabric 模组,专为德国多人服务器 Ardania.de 的玩家设计。它会自动追踪并以简洁、不显眼的 Hypixel 风格计分板方框形式,在屏幕上显示你的游戏内货币、奖励点数、在线时长以及职业统计数据。

无需再每隔几分钟手动输入 /geld、/ardapoints me 或 /jobs stats 了!


✨ 主要功能

  • 💰 Euronen(货币/银行):
    • 通过 ArdaBank 静默查询并追踪你的真实银行余额。
    • 从动作栏收入(+0.15$、+0.02 Euronen)实时检测收益。
    • 无缝处理直接交易通知(付款、转账、利息)。
  • 💠 ArdaPoints:
    • 实时显示你当前的 ArdaPoints 余额。
    • 捕获每日奖励、每月领取奖励以及投票奖励点数(+25 ArdaPoints)。
  • ⏳ 多服务器在线时长追踪(Ontime):
    • 将所有服务器世界的在线时长(Main Server、Mine/下界、Creative、Event Server)合并为一个总在线时长计数器。
    • 在本地累加已过去的分钟数,并定期与服务器同步。
  • ⛏️ 多职业与 MAX 等级检测:
    • 通过 /jobs stats 自动检测所有激活的职业(包括进度条)。
    • 显示当前职业等级(例如 Mobhunter [24]、Farmer [12]、Miner [21])。
    • 将满级 30 级的职业以金色 [MAX] 醒目显示(例如 Mobhunter [MAX])。
    • 在职业升级或加入新职业时自动刷新([ArdaniaJobs])。
  • 💾 本地状态缓存(离线与子服务器回退):
    • 在断开连接和状态更新时,将最后已知的余额、在线时长和职业保存到 .minecraft/config/ardania_hud_cache.json。
    • 如果某个命令在子服务器上被禁用(例如下界/Mine 世界),HUD 会平滑回退到缓存值,而不会显示 ?。
  • 🌍 完整本地化(DE / EN / ES / FR):
    • 原生支持德语(de_de)、英语(en_us)、**西班牙语(es_es)和法语(fr_fr)**翻译。
    • 自动匹配你的 Minecraft 客户端语言,也可在游戏内设置界面中强制指定。
  • 🎬 平滑滑出动画与 Tab 集成:
    • 可选的自动隐藏功能,空闲时平滑滑出,状态变化时滑回。
    • 可配置的自动隐藏显示计时器(3s、5s、8s、10s、15s)。
    • 按住或轻按 Tab 键(玩家列表)使 HUD 滑入视野。
  • 🔕 静默后台同步与聊天过滤:
    • 所有后台查询完全不会显示在聊天窗口中。
    • 子服务器错误消息(例如 "Du kannst diesen Befehl in dieser Welt nicht benutzen")会被干净地抑制。
    • 手动输入到聊天中的玩家命令仍照常显示。
  • 🛡️ 防刷屏与限流:
    • 后台命令会以安全延迟错开执行,防止被服务器标记为刷屏。
    • 防抖触发器可在快速挖矿或收割作物时防止刷屏。
  • 🎨 简洁且可配置的设计:
    • 半透明深色背景,在各种生物群系下都能获得最佳对比度。
    • 按下 F1 时自动隐藏。
    • 仅在连接到 ardania.de(或本地测试)时激活。

⚙️ 游戏内配置(ModMenu)

安装 ModMenu 以访问游戏内的图形设置界面(或直接编辑 .minecraft/config/ardania_hud.json):

  • HUD 启用:开启或关闭覆盖层。
  • 语言:Auto (Client) / Deutsch / English / Español / Français。
  • 位置:Middle Right (Hypixel)(默认)、Top Right、Bottom Right。
  • 模块开关:分别切换 Euronen、ArdaPoints、在线时长和职业。
  • 自动隐藏(滑出):启用空闲时的平滑滑出。
  • 显示时长:3s、5s*(默认)*、8s、10s、15s。
  • Tab 时显示:按住/轻按 Tab 键时显示 HUD。
  • 同步冷却:
    • 金钱冷却:15s / 30s*(默认)* / 60s / 120s
    • 点数间隔:30s / 60s*(默认)* / 120s / 300s
    • 在线时长间隔:15m / 30m / 60m*(默认)* / 120m
    • 加入时同步:加入服务器时查询统计数据。

🎮 控制

  • J(默认):立即且静默地强制与服务器进行完整同步(/geld、/ardapoints me、/jobs stats、/ontime)。
  • 切换 HUD(默认未绑定):按下以立即滑入或滑出 HUD。
  • 两个按键绑定均可在选项 → 控制 → 按键绑定中的 Ardania Info HUD 分类下自定义。

📦 前置需求与安装

  1. 为你的 Minecraft 版本安装 Fabric Loader。
  2. 将 Fabric API 放入你的 .minecraft/mods 文件夹(必需!)。
  3. *(推荐)*安装 ModMenu 以进行游戏内配置。
  4. 下载对应你 Minecraft 版本的模组 .jar 文件并放入 .minecraft/mods:
    • Minecraft 1.21.X(1.21 – 1.21.11):ardania-info-hud-mc1.21.x-1.5.0.jar
    • Minecraft 26.3:ardania-info-hud-mc26.3-1.5.0.jar
    • Minecraft 26.2:ardania-info-hud-mc26.2-1.5.0.jar

⚠️ LabyMod / CurseForge App 用户注意:请确保 Fabric API 已放入你配置文件的 mods 文件夹中,因为 LabyMod 的 Fabric Loader 附加组件默认不包含 Fabric API。


📄 许可证

本项目基于 CC0 1.0 Universal(公有领域) 许可证发布。你可自由使用、修改和再分发。