Leaderboard+

💠 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:

* Theming API: High-speed polling (every 5 ticks) of scoreboard objectives to ensure data accuracy. * Theming API: Implements `ImageSyncPacket` for raw byte-stream image transfers and `SyncPacket` for global state synchronization. * Theming API: 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 <style_name>` - Switches the active CSS-like layout (e.g., `neon`). * `/leaderboard visual background row <color|imagen>` - Configures the background for individual score rows. * `/leaderboard visual background global <color|imagen>` - Configures the main container background.

2. Data Configuration

* `/leaderboard config objetivo <objective_name>` - Points the engine to a specific Scoreboard objective. * `/leaderboard config teams <true|false>` - Toggles between individual player stats and team-based aggregation. * `/leaderboard limit <1-20>` - Sets the maximum number of entries visible in the list.

3. Utility & Debugging

* `/leaderboard help` - Displays the technical command manual. * `/leaderboard test add <name> <points>` - Injects dummy data for UI testing and layout debugging. * `/leaderboard test clear` - Purges all test data from the cache.

---

📂 Requirements & Environment

* Side: Fabric Loader. * Side: 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.