Описание
# 💠 Leaderboard Core | High-Fidelity HUD Engine for Fabric
**Leaderboard Core** is a robust, production-grade HUD engine designed for the Fabric environment. It specializes in real-time data visualization, dynamic asset injection, and seamless scoreboard integration. This mod was engineered to provide a high-performance alternative to static UIs, allowing for fluid, server-driven visual updates without client restarts.
---
## 🛠️ Developer Specifications
The mod architecture focuses on low-latency packet processing and modular UI rendering:
* **Logic Engine:** High-speed polling (every 5 ticks) of scoreboard objectives to ensure data accuracy.
* **Packet Handling:** Implements `ImageSyncPacket` for raw byte-stream image transfers and `SyncPacket` for global state synchronization.
* **Asset Management:** Features an internal cache for reconstructed `.png` assets, allowing for custom branding to be injected directly into the HUD.
* **Theming API:** Supports multiple design profiles (e.g., `neon`) and granular control over background colors, scales, and positioning.
---
## ⌨️ Command API (Full Documentation)
The mod provides a comprehensive set of commands for real-time configuration. Access requires level 2 permissions.
### 1. Visual & State Management
* `/leaderboard status start` - Initializes the rendering engine and displays the HUD.
* `/leaderboard status stop` - Halts all rendering and hides the interface.
* `/leaderboard visual diseno ` - Switches the active CSS-like layout (e.g., `neon`).
* `/leaderboard visual background row ` - Configures the background for individual score rows.
* `/leaderboard visual background global ` - Configures the main container background.
### 2. Data Configuration
* `/leaderboard config objetivo ` - Points the engine to a specific Scoreboard objective.
* `/leaderboard config teams ` - Toggles between individual player stats and team-based aggregation.
* `/leaderboard limit ` - Sets the maximum number of entries visible in the list.
### 3. Utility & Debugging
* `/leaderboard help` - Displays the technical command manual.
* `/leaderboard test add ` - Injects dummy data for UI testing and layout debugging.
* `/leaderboard test clear` - Purges all test data from the cache.
---
## 📂 Requirements & Environment
* **Platform:** Fabric Loader.
* **Java:** Optimized for Java 21.
* **Side:** Client-side rendering with optional server-side logic sync.
---
## 🚀 About Luxfiro Studio
This project is part of the **Luxfiro Studio** ecosystem, where we bridge the gap between technical Minecraft development and high-end graphic design. Our goal is to provide tools that are as beautiful as they are functional.