🏆 DN-Advancely - Real-time Advancement & Recipe Tracker (Fabric)

DN-Advancely is a premium Fabric mod designed to help players track their completed Advancements and Recipe unlocks in real-time. It features a customizable, clean in-game HUD overlay and progression pins to monitor your milestones seamlessly.

Whether you are a completionist looking to achieve 100% of the game, a speedrunner optimizing your route, or simply someone wanting to know exactly what is left to unlock a complex advancement, DN-Advancely is your perfect companion.

✨ Features

📊 1. Real-time HUD Statistics

• Intuitive Overlay: Displays your total unlocked advancements and recipes on the screen (positioned at the bottom-left, dynamically adjusted to avoid overlapping the chat feed).
• Smooth Synchronization: Updates data every second (20 ticks) from the server to the client without causing any performance hits or network overhead (no TPS/FPS drops).
• Auto-Hide: Automatically hides itself when you open the F3 debug screen or turn off the GUI (F1) to keep your interface clean.

📌 2. Advancement Pins (Progression Pins)

• Close Tracking: Pin one or multiple advancements directly to your HUD to monitor goals closely.
• Detailed Criteria: Displays completion progress (e.g., 3/5) alongside a list of remaining criteria (e.g., specific mobs left to kill, biomes to visit, etc.).
• Dynamic Updating: The UI automatically truncates long titles, shows a Completed! state when finished, and unpins the advancement once it is fully complete.

💻 3. Command System & Smart Autocompletion

• Smart Tab-Completion: Dynamically suggests all valid, displayable advancement IDs when typing the /advancely pin command.
• Targeted Unpin Suggestions: When using /advancely unpin, it only suggests advancements that you currently have pinned.
• Instant Detailed Query: Use /advancely info to view an advancement's description, status, and exact remaining criteria in the chat without opening the heavy in-game advancements menu.

🛠️ Commands

💾 Configuration & Persistence

• All player preferences (pinned advancements list and HUD visibility status) are stored independently on the server inside: config/dn-advancely-pins.json.
• These settings are saved automatically on changes (pinning, unpinning, or toggling HUD) and are loaded when players connect back to the server.

⚙️ Requirements & Compatibility

• Mod Loader: Fabric Loader (Version >=0.19.3 or higher).
• Required Dependencies: Fabric API (Make sure to download the compatible version).
• Minecraft Versions: 1.21.x / 1.21.1 (Configured using Yarn mappings 1.21.11+build.6 and Minecraft version 26.1.2).
• Multiplayer Support: Fully supported in both Singleplayer and Multiplayer. The mod must be installed on both Server and Client to ensure network packets (AdvancelySyncPayload) synchronize correctly.

📝 License

This project is licensed under the BSD-2-Clause-FreeBSD License. You are free to use, modify, and redistribute the source code under the terms of this license.