Community listing page, reviews here may not be monitored by the author.
ColonyRank | Minecolonies Addon
No reviews yet
ColonyRank ranks MineColonies colonies by progression stats with two scoring systems, six presets, in-game commands, ignored-colonies management, and Discord webhook posting. NeoForge 1.21.1 & Forge 1.20.1.
Community voices
Reviews
Filters
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Runs entirely on the server. Also works in singleplayer.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
ColonyRank adds a competitive leaderboard system to MineColonies servers, available for both NeoForge 1.21.1 (Java 21) and Forge 1.20.1 (Java 17).
It scans colony data from all colonies on the server and calculates a transparent, configurable score for each one. Rankings are displayed in-game via commands and can be automatically published to a Discord channel through a webhook.
Scoring Modes
OLD Mode — Historical Multiplier System
Each of the 5 stats (Population, Buildings, Average Building Level, Claimed Chunks, Overall Happiness) is multiplied by an individual multiplier. A strict quota is enforced: two stats at ×5, two stats at ×10, and one stat at ×100. This ensures every colony ranking is balanced and no single stat can dominate.
NEW Mode — Cross-Product System
Links related stats together for a more dynamic score. Instead of flat multipliers, the formula uses cross-products like Population × Happiness and Average Level × Buildings, then multiplies the total by 5.
Six presets are available:
| Preset | Pop coef | Happiness coef | Buildings coef | Level coef | Claims coef |
|---|---|---|---|---|---|
| Development | 5 | 0.4 | 5 | 2.5 | 0.5 |
| Population | 10 | 0.6 | 5 | 1.5 | 0.5 |
| Expansion | 5 | 0.4 | 8 | 1.5 | 2 |
| Management | 5 | 1.0 | 6 | 1.5 | 0.5 |
| Metropolis | 5 | 0.4 | 12 | 1.0 | 1 |
| Custom | — | — | — | — | — |
Custom lets you define your own 5 coefficients directly in the config screen.
Presets can be switched at any time with /colonyadmin preset <name> or through the Fzzy Config screen.
Ignored Colonies
Exclude specific colonies from the ranking, Discord publishing, and JSON export. Useful for admin colonies, test colonies, or any colony you don't want appearing in the public leaderboard.
| Command | Description |
|---|---|
/colonyadmin ignore <colonyId> |
Exclude a colony |
/colonyadmin unignore <colonyId> |
Restore an ignored colony |
/colonyadmin ignorelist |
List all ignored colonies |
Stored persistently in config/colonyrank/ignored_colonies.json
In-Game Config Screen
All settings are configurable through the Fzzy Config screen (colonyrank:settings) without editing files manually:
- Scoring mode selection (OLD / NEW)
- Preset selection (including Custom with 5 editable coefficients)
- OLD mode multipliers with automatic quota enforcement
- Language selection (English / French)
- Changes apply live — scores recalculate instantly
Commands
Player Commands
| Command | Description |
|---|---|
/colonyrank |
Show the live colony ranking |
/colonyscore list |
List all colonies with their IDs |
/colonyscore id <colonyId> |
Detailed score breakdown by colony ID |
/colonyscore <colonyName> |
Show details by colony name |
Admin Commands (/colonyadmin — permission level 4)
| Command | Description |
|---|---|
reload |
Reload all colonies from the server |
refresh |
Recalculate scores and save |
clear |
Clear the colony cache |
status |
Show mod status (colony count, mode, ignored, Discord) |
export |
Export colony data to JSON |
scoringmode <old|new> |
Switch scoring system |
preset <name> |
Set NEW mode preset |
ignore <colonyId> |
Exclude a colony from ranking |
unignore <colonyId> |
Restore an ignored colony |
ignorelist |
List all ignored colonies |
sendleaderboard |
Send leaderboard to Discord immediately |
senddaily |
Force a daily Discord send |
discordstatus |
Show Discord webhook status |
help |
Show all admin commands |
Discord Integration
Publishes the colony leaderboard to a Discord channel via webhook.
- Update mode — publishes whenever colony data changes
- Daily mode — publishes once per day at a configurable time and timezone
Configured via config/colonyrank-discord.properties
Other Features
- Colony age displayed in a readable format (days/hours)
- Building level normalized to a 1–5 scale
- Full JSON export of colony data
- English and French language support (messages, config screen, Discord output)
- Server-side only — no client installation required
Requirements
| NeoForge 1.21.1 | Forge 1.20.1 | |
|---|---|---|
| Minecraft | 1.21.1 | 1.20.1 |
| Loader | NeoForge 21.1.219+ | Forge 47.4.10+ |
| Java | 21 | 17 |
Both versions require MineColonies (compatible modpack/server).
Dependencies
- Fzzy Config — in-game config screen
- MineColonies — colony data source
ColonyRank adds a competitive leaderboard system to MineColonies servers, available for both NeoForge 1.21.1 (Java 21) and Forge 1.20.1 (Java 17).
It scans colony data from all colonies on the server and calculates a transparent, configurable score for each one. Rankings are displayed in-game via commands and can be automatically published to a Discord channel through a webhook.
Scoring Modes
OLD Mode — Historical Multiplier System
Each of the 5 stats (Population, Buildings, Average Building Level, Claimed Chunks, Overall Happiness) is multiplied by an individual multiplier. A strict quota is enforced: two stats at ×5, two stats at ×10, and one stat at ×100. This ensures every colony ranking is balanced and no single stat can dominate.
NEW Mode — Cross-Product System
Links related stats together for a more dynamic score. Instead of flat multipliers, the formula uses cross-products like Population × Happiness and Average Level × Buildings, then multiplies the total by 5.
Six presets are available:
| Preset | Pop coef | Happiness coef | Buildings coef | Level coef | Claims coef |
|---|---|---|---|---|---|
| Development | 5 | 0.4 | 5 | 2.5 | 0.5 |
| Population | 10 | 0.6 | 5 | 1.5 | 0.5 |
| Expansion | 5 | 0.4 | 8 | 1.5 | 2 |
| Management | 5 | 1.0 | 6 | 1.5 | 0.5 |
| Metropolis | 5 | 0.4 | 12 | 1.0 | 1 |
| Custom | — | — | — | — | — |
Custom lets you define your own 5 coefficients directly in the config screen.
Presets can be switched at any time with /colonyadmin preset <name> or through the Fzzy Config screen.
Ignored Colonies
Exclude specific colonies from the ranking, Discord publishing, and JSON export. Useful for admin colonies, test colonies, or any colony you don't want appearing in the public leaderboard.
| Command | Description |
|---|---|
/colonyadmin ignore <colonyId> |
Exclude a colony |
/colonyadmin unignore <colonyId> |
Restore an ignored colony |
/colonyadmin ignorelist |
List all ignored colonies |
Stored persistently in config/colonyrank/ignored_colonies.json
In-Game Config Screen
All settings are configurable through the Fzzy Config screen (colonyrank:settings) without editing files manually:
- Scoring mode selection (OLD / NEW)
- Preset selection (including Custom with 5 editable coefficients)
- OLD mode multipliers with automatic quota enforcement
- Language selection (English / French)
- Changes apply live — scores recalculate instantly
Commands
Player Commands
| Command | Description |
|---|---|
/colonyrank |
Show the live colony ranking |
/colonyscore list |
List all colonies with their IDs |
/colonyscore id <colonyId> |
Detailed score breakdown by colony ID |
/colonyscore <colonyName> |
Show details by colony name |
Admin Commands (/colonyadmin — permission level 4)
| Command | Description |
|---|---|
reload |
Reload all colonies from the server |
refresh |
Recalculate scores and save |
clear |
Clear the colony cache |
status |
Show mod status (colony count, mode, ignored, Discord) |
export |
Export colony data to JSON |
scoringmode <old|new> |
Switch scoring system |
preset <name> |
Set NEW mode preset |
ignore <colonyId> |
Exclude a colony from ranking |
unignore <colonyId> |
Restore an ignored colony |
ignorelist |
List all ignored colonies |
sendleaderboard |
Send leaderboard to Discord immediately |
senddaily |
Force a daily Discord send |
discordstatus |
Show Discord webhook status |
help |
Show all admin commands |
Discord Integration
Publishes the colony leaderboard to a Discord channel via webhook.
- Update mode — publishes whenever colony data changes
- Daily mode — publishes once per day at a configurable time and timezone
Configured via config/colonyrank-discord.properties
Other Features
- Colony age displayed in a readable format (days/hours)
- Building level normalized to a 1–5 scale
- Full JSON export of colony data
- English and French language support (messages, config screen, Discord output)
- Server-side only — no client installation required
Requirements
| NeoForge 1.21.1 | Forge 1.20.1 | |
|---|---|---|
| Minecraft | 1.21.1 | 1.20.1 |
| Loader | NeoForge 21.1.219+ | Forge 47.4.10+ |
| Java | 21 | 17 |
Both versions require MineColonies (compatible modpack/server).
Dependencies
- Fzzy Config — in-game config screen
- MineColonies — colony data source
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources