ColonyRank | Minecolonies 附属模组

ColonyRank | Minecolonies 附属模组

ColonyRank根据发展统计数据对MineColonies殖民地排名,具有两套评分系统、六个预设、游戏内命令、忽略殖民地管理以及Discord webhook发布功能。支持NeoForge 1.21.1和Forge 1.20.1。

ColonyRank 为 MineColonies 服务器添加了一个竞争性的排行榜系统,可用于 NeoForge 1.21.1(Java 21)和 Forge 1.20.1(Java 17)。

它会扫描服务器上所有殖民地的数据,并为每个殖民地计算一个透明且可配置的分数。排名通过游戏内指令显示,并可通过 Webhook 自动发布到 Discord 频道。


计分模式

旧模式 — 历史倍率系统

5 项统计数据(人口、建筑、平均建筑等级、已认领区块、整体幸福度)中的每一项都会乘以各自的倍率。系统会强制执行严格的配额:两项统计为 ×5、两项统计为 ×10、一项统计为 ×100。这确保了每个殖民地的排名都是平衡的,没有任何单一统计项可以占据主导地位。

新模式 — 交叉乘积系统

将相关的统计数据关联起来,以获得更动态的分数。该公式不使用固定倍率,而是采用交叉乘积,例如 人口 × 幸福度 和 平均等级 × 建筑,然后将总和乘以 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 <名称> 或 Fzzy Config 界面切换预设。


忽略的殖民地

将特定殖民地排除在排名、Discord 发布和 JSON 导出之外。这对于管理员殖民地、测试殖民地或任何您不想出现在公共排行榜上的殖民地非常有用。

指令 描述
/colonyadmin ignore <殖民地ID> 排除一个殖民地
/colonyadmin unignore <殖民地ID> 恢复一个被忽略的殖民地
/colonyadmin ignorelist 列出所有被忽略的殖民地

持久化存储在 config/colonyrank/ignored_colonies.json 中


游戏内配置界面

所有设置都可以通过 Fzzy Config 界面(colonyrank:settings)进行配置,无需手动编辑文件:

  • 计分模式选择(旧/新)
  • 预设选择(包括带有 5 个可编辑系数的自定义模式)
  • 旧模式倍率并自动执行配额
  • 语言选择(英语 / 法语)
  • 更改会实时生效 — 分数会立即重新计算

指令

玩家指令

指令 描述
/colonyrank 显示实时殖民地排名
/colonyscore list 列出所有殖民地及其 ID
/colonyscore id <殖民地ID> 按殖民地 ID 查看详细的分数明细
/colonyscore <殖民地名称> 按殖民地名称显示详细信息

管理员指令(/colonyadmin — 权限等级 4)

指令 描述
reload 从服务器重新加载所有殖民地
refresh 重新计算分数并保存
clear 清除殖民地缓存
status 显示模组状态(殖民地数量、模式、忽略列表、Discord)
export 将殖民地数据导出为 JSON
scoringmode <old|new> 切换计分系统
preset <名称> 设置新模式预设
ignore <殖民地ID> 将殖民地从排名中排除
unignore <殖民地ID> 恢复一个被忽略的殖民地
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 — 殖民地数据源