Go Create: Player Stat's & Leaderboard's - Aeronautics

Advanced player statistics, rankings, classifications, persistent player data and server leaderboards for NeoForge 1.21.1.

Go Create: Player Stat's & Leaderboard's - Aeronautics is a server-focused statistics and ranking system designed to turn Minecraft player activity into meaningful statistics, rankings and classifications.

Instead of only tracking who has the most kills or the most playtime, the mod combines multiple areas of gameplay into a configurable player profile and overall score.

Players can be ranked against everyone recorded by the server, including players who are currently offline.

📊 Player Statistics:

Player activity is separated into multiple statistical categories, allowing players to see where they stand across different areas of gameplay.

Current tracked categories include:

⚔️ Combat 🧟 PvE ⚔️ PvP 🛡️ Survival 🏃 Mobility 🧭 Exploration ⛏️ Mining / Engineering 💰 Economy / Activity 🏆 Overall

Statistics are processed through the mod's scoring system so that individual grindable statistics do not completely dominate the overall ranking and are completely configurable.

🏆 Player Rankings:

Players can be ranked against every player recorded by the server.

The system provides:

Overall player ranking Category-specific rankings Percentile placement Persistent statistics Offline-player rankings Configurable leaderboard sizes

This means players don't disappear from the leaderboard simply because they have logged off.

🎖️ Player Classifications:

Players are assigned a classification based on their overall score.

The current default classification system includes:

CONSCRIPT → SENTINEL → OPERATIVE → VANGUARD → WARDEN → WARLORD → DOMINION

Each classification can also contain a subclass:

CLASS-I / CLASS-II / CLASS-III

Classification names, score thresholds and display formatting are configurable through the TOML configuration.

This allows server owners to completely change the terminology to fit their own server.

For example, a server could use military ranks, guild ranks, corporate levels, faction positions or completely custom names.

💾 Persistent Player Data:

Player statistics are stored persistently in JSON files.

Player records remain available after players leave the server, allowing the leaderboard to contain both online and offline players.

The system also supports rebuilding the database from Minecraft's existing vanilla player statistics.

This allows servers to begin tracking established players without having to start their statistics from zero.

🔄 Vanilla Statistics Backfill:

Servers that already have an established player base can use:

/dominance rebuild

to scan existing vanilla player statistic data and import previously recorded players.

This is particularly useful when adding the mod to an existing world.

💬 Discord Leaderboards:

The mod supports Discord webhook integration.

A leaderboard can be published to Discord and updated in place rather than creating a new message every time.

The Discord integration can be configured through the generated TOML configuration.

No full Discord bot or bot token is required for the webhook functionality.

An administrator can also manually force a Discord leaderboard update using:

/dominance discord refresh

🌐 HTTP Statistics API:

Player statistics can also be exposed through the built-in HTTP API.

The API's:

Enable/disable state Bind address Port

can be configured through TOML.

This makes it possible to connect Player Statistics to external dashboards, websites or other server-management tools.

⚙️ Highly Configurable:

The mod is designed to allow server owners to customise the system without modifying the source code.

Configuration includes options for:

Classification names Classification thresholds Subclass formatting Category display names Overall score weights Leaderboard size Admin permission level Automatic statistics backfill HTTP API settings Discord webhook settings Discord leaderboard presentation Export/update intervals

The configuration is generated automatically as:

config/playerdominance-common.toml

after the server first loads the mod.

✈️ Aeronautics Compatibility:

This project is being developed with Create: Aeronautics / Aeronautics Claims compatibility in mind.

Compatibility has been created between our mod & Create Aeronautics: Claims (FTB/OPAC) by Mapter. on Modrinth and Curseforge The planned system will allow server owners and players to see information such as:

Number of claimed sub-levels Individual craft ownership Player sub-level rankings Aeronautics ownership statistics Aeronautics-related leaderboard data Current Status

Aeronautics integration is currently under development. Mod currently Track's and List's the number of Claimed Sub-Level's assign's them to the player and display's it on a top 10 Leaderboard.

The core Player Statistics and Leaderboard system does not require Aeronautics to operate and is instead a toggle/able feature rather than a strict dependency.

Aeronautics-specific statistics will be added as an optional integration so servers without Aeronautics can continue using the core mod normally.

🧑‍💻 Commands:

Player information Command's:

/dominance player

View a player's statistics, score, classification and ranking information.

Leaderboard Command's:

/dominance top

/dominance me

Display the server's top-ranked players.

Database rebuild Command's (for Backlogging old Playerdata):

/dominance rebuild

Requires administrator permissions.

Discord refresh Command:

/dominance discord refresh

Immediately update the configured Discord leaderboard.

Requires administrator permissions.

🔐 Permissions:

Administrative commands use a configurable permission level.

The required permission level can be changed through the TOML configuration to better suit different server permission systems.

🗂️ Data Storage

Persistent player data is stored in JSON format.

Player records are kept under the mod's persistent statistics directory and are associated with the player's UUID.

This allows statistics to remain tied to the correct player even when their username changes.

🖥️ Designed for Servers

Player Stat's & Leaderboard's is primarily designed for multiplayer servers.

It is particularly suited to and designed for:

Survival servers SMP servers Faction servers Engineering-focused servers Create-based servers Roleplay servers Progression servers Competitive communities Long-running worlds

Discord for Our SMP and Mod Development Available Above on the Right!

The goal is to provide server communities a way to see and compare player progression without reducing the entire server to a single statistic or class, while being completely configurable for each server and owner.

🚧 Development Status

This project is actively being developed.

The core statistics, persistent player data, ranking, classification, Discord webhook and HTTP API systems are being built as the foundation for additional integrations.

Aeronautics compatibility is planned as one of the first major integrations (Currently work's).

More integrations and statistics can be added over time without requiring the core ranking system to be rebuilt.

📜 License

This project is released under the MIT License.

See the included LICENSE file for the complete license text.

❤️ Credits

Go Create Network.

Player Statistics & Leaderboard system developed for the Go Create Minecraft community.

Special thanks to the developers of the mod's and technologies that make the wider server ecosystem possible.

Aeronautics compatibility is intended to integrate with the Aeronautics Claims system rather than replacing or modifying the original mod so just integrate's with the API and read's Data from the Save file.

Developed By ShadowOfficial (Leighton Saxty)

Have an idea?

If you have an idea for a new statistic, ranking category, integration or leaderboard feature, feel free to suggest it in our Discord or Reply with an issue Marked, Suggestion.

Im a reletively new coder. So in this development i used reference's for code and debugging from AI and friend's who are farmiliar with Java. So bug's will be fixed and Polished as i develop my Understanding of coding more. This is by no mean's a Full AI Mod and was coded by a novice so keep in mind their might be problem's, feel free to Report them in our Discord!

The long-term goal is to make Player Stat's & Leaderboard's a flexible server-wide statistics platform that can integrate with the systems your Minecraft server already uses.