Ardania Info HUD

Ardania Info HUD

A clean, lightweight client-side HUD overlay for the Minecraft server Ardania.de.
Built for Fabric supporting Minecraft 1.21.X (1.21 – 1.21.11), 26.2, and 26.3.

📌 Overview

Ardania Info HUD is a client-side Fabric mod designed for players on the German multiplayer server Ardania.de. It automatically tracks and displays your in-game currency, reward points, playtime, and job statistics in a clean, unobtrusive Hypixel-style scoreboard box on your screen.

No more manually typing /geld, /ardapoints me, or /jobs stats every few minutes!

✨ Key Features

• 💰 Euronen (Currency / Bank):
  • Silently checks and tracks your real bank balance via ArdaBank.
  • Detects earnings in real-time from action-bar income (+0.15$, +0.02 Euronen).
  • Seamlessly processes direct transaction notifications (payments, transfers, interest).
• 💠 ArdaPoints:
  • Displays your current ArdaPoints balance in real-time.
  • Captures daily rewards, monthly claim rewards, and vote reward credits (+25 ArdaPoints).
• ⏳ Multi-Server Playtime Tracking (Ontime):
  • Combines playtime across all server worlds (Main Server, Mine / Nether, Creative, Event Server) into one single total playtime counter.
  • Ticks elapsed minutes locally and syncs with the server periodically.
• ⛏️ Multi-Job & MAX Rank Detection:
  • Automatically detects all active jobs via /jobs stats (including progress bars).
  • Shows current job levels (e.g. Mobhunter [24], Farmer [12], Miner [21]).
  • Renders Level 30 maxed jobs prominently in gold as [MAX] (e.g. Mobhunter [MAX]).
  • Automatically refreshes upon job level-ups or joining new jobs ([ArdaniaJobs]).
• 💾 Local State Caching (Offline & Sub-Server Fallback):
  • Saves the last known balances, playtime, and jobs to .minecraft/config/ardania_hud_cache.json upon disconnect and stat updates.
  • If a command is disabled on a sub-server (such as the Nether / Mine world), the HUD smoothly falls back to the cached values instead of displaying ?.
• 🌍 Full Localization (DE / EN / ES / FR):
  • Native translations for German (de_de), English (en_us), Spanish (es_es), and French (fr_fr).
  • Automatically matches your Minecraft client language, or can be forced in the in-game settings screen.
• 🎬 Smooth Slide Animation & Tab Integration:
  • Optional auto-hide feature that slides out smoothly when idle and slides back in on stat changes.
  • Configurable auto-hide display timer (3s, 5s, 8s, 10s, 15s).
  • Hold or tap Tab (player list) to slide the HUD into view.
• 🔕 Silent Background Sync & Chat Filtering:
  • All background queries are completely hidden from the chat window.
  • Sub-server error messages (e.g. “Du kannst diesen Befehl in dieser Welt nicht benutzen”) are cleanly suppressed.
  • Manual player commands typed into chat remain visible as usual.
• 🛡️ Anti-Spam & Rate Limiting:
  • Background commands are staggered with safe delays to prevent server spam flags.
  • Debounced triggers protect against spam while mining ores or harvesting crops quickly.
• 🎨 Clean & Configurable Design:
  • Semi-transparent dark background for optimal contrast across biomes.
  • Automatically hides when pressing F1.
  • Only active while connected to ardania.de (or local testing).

⚙️ In-Game Configuration (ModMenu)

Install ModMenu to access the graphical settings screen in-game (or edit .minecraft/config/ardania_hud.json directly):

• HUD Enabled: Turn the overlay on or off.
• Language: Auto (Client) / Deutsch / English / Español / Français.
• Position: Middle Right (Hypixel) (Default), Top Right, Bottom Right.
• Module Toggles: Toggle Euronen, ArdaPoints, Playtime, and Jobs individually.
• Auto-Hide (Slide): Enable smooth slide-out when idle.
• Display Duration: 3s, 5s (Default), 8s, 10s, 15s.
• Show on Tab: Show HUD while holding/tapping the Tab key.
• Sync Cooldowns:
  • Money Cooldown: 15s / 30s (Default) / 60s / 120s
  • Points Interval: 30s / 60s (Default) / 120s / 300s
  • Playtime Interval: 15m / 30m / 60m (Default) / 120m
  • Sync on Join: Query stats upon joining the server.

🎮 Controls

• J (Default): Instantly and silently forces a full synchronization with the server (/geld, /ardapoints me, /jobs stats, /ontime).
• Toggle HUD (Unbound by default): Press to slide the HUD in or out immediately.
• Both keybindings can be customized under Options → Controls → Key Binds in the Ardania Info HUD category.

📦 Requirements & Installation

1. Install Fabric Loader for your Minecraft version.
2. Place Fabric API in your .minecraft/mods folder (Required!).
3. (Recommended) Install ModMenu for in-game configuration.
4. Download the corresponding mod .jar file for your Minecraft version and place it into .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

⚠️ Note for LabyMod / CurseForge App users: Ensure Fabric API is placed inside your profile’s mods folder, as LabyMod’s Fabric Loader addon does not include the Fabric API by default.

📄 License

This project is released under the CC0 1.0 Universal (Public Domain) license. You are free to use, modify, and redistribute it.