StatsSigns

StatsSigns - Dynamic In-World Statistic Displays

StatsMod integrates seamlessly with StatsMod to bring your server's detailed player statistics directly into the game world! This Fabric mod allows server owners to create highly customizable and interactive signs that display live leaderboards, individual player profiles, and specific stat totals. From showcasing the top miners to displaying a player's total deaths, StatsSigns provides engaging visual data and clickable actions, enhancing the player experience and offering a powerful administrative tool for server analytics.

REQUIRES StatsMod

---

🔥 Key New Feature: Skull Linking

* Recursive Deletion Protection: Link any placed Player or Mob Skull to a StatsSign. * Recursive Deletion Protection: When the sign updates, the linked skull automatically fetches and displays the profile of the player/rank shown on the sign. * Recursive Deletion Protection: Breaking a linked StatsSign will also break the associated skulls. Conversely, breaking a linked skull requires permission and will unlink it from the sign.

---

Features

Dynamic & Customizable Sign Displays

* Standard & Hanging Sign Support: Signs automatically refresh with the latest statistics at a configurable interval (`update_interval_minutes` in `settings.yml`). * Standard & Hanging Sign Support: Pulls any statistic tracked by StatsMod, including total broken/placed blocks, mobs/players killed, distance traveled, and playtime. * Standard & Hanging Sign Support: Fully configure the appearance of each sign type using six distinct YAML configuration files, including separate files for standard and hanging signs. * Standard & Hanging Sign Support: Supports both regular and hanging signs, with separate customizable formats for each.

Diverse Sign Types

* 5 Display ranked lists of players for any StatsMod statistic, genre, or type. * 5 Showcase various statistics for a specific player name defined on Line 3. * 5 Dedicate a sign to a single rank on a leaderboard (e.g., `#1` in Line 3). * 5 Extend leaderboards over multiple signs, linking to a "master" sign through directional path characters (e.g., `>>`, `^`). * Follower signs are also used to automatically sequence Digit Rank signs. * Chains support a depth of up to 5 followers. * A master sign can have up to 5 direct children/followers.

Interactive Elements & Placeholders

* Extensive Placeholders: Configure signs to execute commands (`/profile %player%`), suggest commands, open URLs, copy text to clipboard, or change help pages when clicked. * Extensive Placeholders: Add rich hover-over text to sign lines using the `{hover text}` syntax. * Extensive Placeholders: Full support for Minecraft color codes (`&c`) and hex colors (`&#RRGGBB`). * Extensive Placeholders: Add a `+` on Line 4 of the master sign to mirror its updated text to the back of the sign. * Extensive Placeholders: Dynamic placeholders populate sign text with player names, stat values, ranks, and other contextual information.

Admin & Management Tools

* README Generation: Create or convert any placed sign into a StatsSign using a simple command while looking at it: `/signstat [StatsMod] <line2> [line3] [line4]`. * README Generation: Toggle the glow effect on an existing StatsSign by right-clicking it with a Glow Ink Sac. * README Generation: * Configurable automatic updates for all signs. * Force an immediate update of all signs with `/statssigns signupdate`. * README Generation: All sign data is saved persistently to `data/statssigns.json` using Gson serialization. * README Generation: Apply changes to configuration files instantly. * README Generation: The mod automatically generates a `README.yml` with a full reference guide for all placeholders and usage.

Commands

* `/statssigns`, `/ss`: Displays the main help interface. * `/statssigns page <number>`: Navigates through help pages. * `/statssigns reload`: Reloads all StatsSigns configurations. * `/statssigns signupdate`: Forces an update on all stat signs. * `/signstat [StatsMod] <line2> [line3] [line4]`: Sets a sign's text and updates its config.

Permissions

StatsSigns integrates with the Fabric Permissions API (v0), falling back to operator levels if no compatible permissions mod is found.