🏆 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

Command	Description
`/advancely hud show`	Display the HUD tracking overlay on the screen.
`/advancely hud hide`	Hide the HUD tracking overlay from the screen.
`/advancely pin <advancement_id>`	Pin an advancement to the HUD (supports autocompleting all displayable advancements).
`/advancely unpin <advancement_id>`	Unpin an advancement from the HUD (suggests only your currently pinned advancements).
`/advancely info <advancement_id>`	View the description, completion status, and list of remaining criteria of an advancement.
`/advancely list advancements`	List all completed advancements and show your overall progress (e.g., `15/120`).
`/advancely list recipes`	List all unlocked recipe IDs and show your overall progress (e.g., `80/450`).

💾 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.

DN Advancely