ColonyRank | Minecolonies Addon

ColonyRank 为 MineColonies 服务器添加了竞技排行榜系统，支持 NeoForge 1.21.1（Java 21）和 Forge 1.20.1（Java 17）。

它会扫描服务器上所有殖民地的数据，并为每个殖民地计算透明且可配置的分数。排行榜可通过命令在游戏内查看，也可通过 webhook 自动发布到 Discord 频道。

计分模式

OLD 模式 — 传统倍率系统

5 项数据（人口、建筑、建筑平均等级、已占领区块、总体幸福度）分别乘以各自的倍率。倍率必须严格遵循配额：两项为 ×5、两项为 ×10，以及一项为 ×100。这样可以确保各殖民地的排名平衡，不会让某一项数据占据主导。

NEW 模式 — 交叉乘积系统

将相关数据关联起来，计算更灵活的分数。公式不再使用固定倍率，而是采用交叉乘积，例如 Population × Happiness 和 Average Level × Buildings，然后将总分乘以 5。

提供六种预设：

| 预设 | 人口系数 | 幸福度系数 | 建筑系数 | 等级系数 | 占领区块系数 |
|—|—|—|—|—|—|
| 发展 | 5 | 0.4 | 5 | 2.5 | 0.5 |
| 人口 | 10 | 0.6 | 5 | 1.5 | 0.5 |
| 扩张 | 5 | 0.4 | 8 | 1.5 | 2 |
| 管理 | 5 | 1.0 | 6 | 1.5 | 0.5 |
| 大都会 | 5 | 0.4 | 12 | 1.0 | 1 |
| 自定义 | — | — | — | — | — |

自定义允许你直接在配置界面中设置自己的 5 项系数。

随时可以通过 /colonyadmin preset <name> 或 Fzzy Config 界面切换预设。

忽略殖民地

将指定殖民地从排行榜、Discord 发布和 JSON 导出中排除。适用于管理员殖民地、测试殖民地，或任何不希望出现在公开排行榜中的殖民地。

| 命令 | 说明 |
|—|—|
| /colonyadmin ignore <colonyId> | 排除一个殖民地 |
| /colonyadmin unignore <colonyId> | 恢复已忽略的殖民地 |
| /colonyadmin ignorelist | 列出所有已忽略的殖民地 |

持久保存于 config/colonyrank/ignored_colonies.json

游戏内配置界面

所有设置均可通过 Fzzy Config界面（colonyrank:settings）进行配置，无需手动编辑文件：

• 计分模式选择（OLD / NEW）
• 预设选择（包括可编辑 5 项系数的自定义模式）
• OLD 模式倍率自动执行配额限制
• 语言选择（英语 / 法语）
• 更改即时生效— 分数会立即重新计算

命令

玩家命令

| 命令 | 说明 |
|—|—|—|
| /colonyrank | 显示实时殖民地排行榜 |
| /colonyscore list | 列出所有殖民地及其 ID |
| /colonyscore id <colonyId> | 按殖民地 ID 查看详细分数明细 |
| /colonyscore <colonyName> | 按殖民地名称查看详细信息 |

管理员命令（/colonyadmin — 权限等级 4）

| 命令 | 描述 |
|—|—|
| reload | 从服务器重新加载所有殖民地 |
| refresh | 重新计算分数并保存 |
| clear | 清除殖民地缓存 |
| status | 显示模组状态（殖民地数量、模式、已忽略、Discord） |
| export | 将殖民地数据导出为 JSON |
| scoringmode <old\|new> | 切换计分系统 |
| preset <name> | 设置 NEW 模式预设 |
| ignore <colonyId> | 将某个殖民地排除在排名之外 |
| unignore <colonyId> | 恢复已忽略的殖民地 |
| ignorelist | 列出所有已忽略的殖民地 |
| sendleaderboard | 立即将排行榜发送到 Discord |
| senddaily | 强制每日发送到 Discord |
| discordstatus | 显示 Discord webhook 状态 |
| help | 显示所有管理员命令 |

Discord 集成

通过 webhook 将殖民地排行榜发布到 Discord 频道。

• 更新模式 — 每当殖民地数据变化时发布
• 每日模式 — 每天在可配置的时间和时区发布一次

通过 config/colonyrank-discord.properties

配置其他功能

• 以可读格式显示殖民地年龄（天/小时）
• 建筑等级归一化为 1–5 级
• 完整的殖民地数据 JSON 导出
• 英语和法语 语言支持（消息、配置界面、Discord 输出）
• 仅服务端 — 无需安装客户端

要求

| | NeoForge 1.21.1 | Forge 1.20.1 |
|—|—|—|
| Minecraft | 1.21.1 | 1.20.1 |
| 加载器 | NeoForge 21.1.219+ | Forge 47.4.10+ |
| Java | 21 | 17 |

两个版本都需要 MineColonies（兼容的整合包/服务器）。

依赖

• Fzzy Config — 游戏内配置界面
• MineColonies — 殖民地数据源