RankSystem by MarciGamer98

A standalone ore-shard event and ranking system for NeoForge servers (1.21.1). No dependency on other mods.

What does this mod do?

Players earn "ore shard" points over time (e.g. through quest rewards) and compete against each other in recurring, time-limited events. At the end of each event, there's a leaderboard with configurable rewards per ranking.

Recurring events with a fixed duration or a fixed weekly schedule (weekday + time), repeating automatically
Custom HUD sidebar overlay instead of the vanilla scoreboard – shows the live leaderboard and remaining time, freely draggable, with adjustable size and transparency
Custom GUI with leaderboard, multiplier tab, rewards, history, and statistics
8 selectable color themes for both the GUI and the sidebar
Rewards per ranking tier, fully configurable (items + amount)
Multi-reward system: up to 5 unclaimed rewards stack up instead of being lost if a player was offline for a while
Bonus thresholds: players who've collected a lot of ore shards overall get a reward multiplier (e.g. x2 from 10,000 points) – with a chat notification when a new threshold is reached
Multi-points system: players earn extra points through rewards, which can be exchanged for a permanent points multiplier (up to x5)
Discord integration: a webhook for simple event notifications, or optionally a real Discord bot that automatically publishes (crossposts) messages in announcement channels to follower servers – both can be enabled independently
Fully configurable via /eventadmin (rewards, bonus thresholds, schedule, manual point adjustments)

Commands

/eventgui – opens the main GUI
/eventadmin start / stop / info – event control
/eventadmin schedule <weekday> <hour> <minute> – set the automatic weekly schedule
/eventadmin give / remove <player> <amount> – manually adjust points
/eventadmin platz <tier> add/remove/list <item> <amount> – manage rewards per tier
/eventadmin platz <tier> multipunkte <value> – set multi-points per tier
/eventadmin bonusschwelle add/remove/list <multiplier> <points> – manage bonus thresholds

Configuration

The Discord webhook URL and/or bot token + channel ID can be set via the server config (config/ranksystem-server.toml) – no code edits or rebuilds required. Both Discord modes can be enabled independently.

Notes

Server-side focused; points are typically awarded through a quest system (e.g. FTB Quests + KubeJS)
No dependency on other mods

Quest integration

This mod doesn't depend on any quest system, but you'll need a small bridge script to award points from FTB Quests rewards. See this KubeJS Integration Example for a ready-to-use script and setup guide.

Technical Details


Minecraft Version	1.21.1
Mod Loader	NeoForge 21.1.220+
Java Version	21
Side	Both (client needed for GUI/HUD overlay)
Dependencies	None
Mod ID	`ranksystem`
Config File	`config/ranksystem-server.toml` (auto-generated)