等级 · 我的世界Mod

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

Ranks - 社区进度系统

Ranks 是一个适用于 NeoForge 1.21.1 的服务端进度模组，它根据玩家真实活动自动添加排名系统。包含 30 个等级、12 项追踪统计、需管理员验证的社区目标，以及完整的聊天和 Tab 列表集成，Ranks 能将你的服务器转变为一个奖励丰厚的进度体验。

主要特性

10 个阶段共 30 个等级

玩家将通过 30 个等级逐步前进，这些等级被组织成 10 个主题阶段，每个阶段都有其专属颜色：

阶段	主题	颜色	等级
1	抵达	灰色	Naufrage, Echoue
2	生存	绿色	Rescape, Survivant
3	连接	青色	Cueilleur, Defricheur
4	发展	黄色	Explorateur, Voyageur, Eclaireur
5	经济	橙色	Batisseur, Artisan, Architecte
6	参与	蓝色	Apprenti Marchand, Negociant, Commercant
7	贡献	紫色	Resident, Habitant, Citoyen
8	认可	粉色	Intendant, Conseiller, Magistrat
9	影响力	红色	Notable, Dignitaire, Senateur
10	威望	金色	Gouverneur, Regent, Chancelier, Patriarche, Legende, Mythique

所有等级、阈值和颜色均可通过 grades.json 完全配置。

12 项自动追踪统计

每位玩家都会实时追踪以下 12 项不同指标：

活跃游戏时间（内置 AFK 检测）
不同登录天数
放置/破坏方块数
移动距离（带防传送上限）
击杀生物数
合成物品/收获作物数
赚取/花费金钱（经济集成）
完成交易数
访问独特区块数（探索）

晋升是自动的：一旦玩家满足下一等级的所有阈值，就会立即晋升。

社区目标

除了自动统计之外，每个等级还可要求定性目标，这些目标需要由管理员手动验证：

建造一个庇护所、房屋、商店
连接到铁路网络
创建一座有街道和照明的城镇
帮助新玩家入门
组织一次社区活动
建造主要基础设施
……以及更多（完全可配置）

晋升要求：所有统计达标 + 所有目标已验证。

管理员拥有完整的 GUI 界面来管理和验证目标。

聊天与 Tab 列表集成

玩家的等级会显示在所有位置：

聊天： [Batisseur] Steve > 大家好！

Tab 列表： [Batisseur] Steve

聊天中的玩家名称保留悬停（显示 UUID）和点击（建议 /msg 命令）功能。

晋升公告

当玩家升级时，所有玩家都会看到庆祝公告：

★══════════════════════════════★
         ⬆ 晋 升 ⬆
    Steve : Survivant ➜ Batisseur
    等级 10 / 30 — 阶段 5
★══════════════════════════════★

公告颜色会动态匹配所达到的等级。

图形界面 (GUI)

按下 R 键或输入 /rank — 打开进度面板：

彩色阶段条，高亮当前阶段
当前等级和下一等级进度
每项统计的进度条
社区目标区域，显示已验证/待定状态
内容超出屏幕时可滚动

奖励系统

每次晋升时会自动执行命令（可在 rewards.json 中配置）：

给予物品、经验、效果
执行任意服务器命令
可用占位符：{player}, {rank}, {rank_name}, {rank_number}

完整管理员工具集

命令：

命令	描述
`/rank`	显示你的等级 + 打开 GUI
`/rank info [玩家]`	详细进度信息
`/rank top`	按等级显示前 10 名玩家
`/rank check`	强制进行一次晋升检查
`/rank objectives`	查看你下一等级的目标
`/rank admin set <玩家> <等级>`	设置玩家等级
`/rank admin reset <玩家>`	重置玩家数据
`/rank admin reload`	重新加载所有配置
`/rank admin validate <玩家> <目标>`	验证一个目标
`/rank admin unvalidate <玩家> <目标>`	移除验证
`/rank admin objectives <玩家>`	管理员 GUI：查看/验证玩家目标
`/rank admin manage`	管理员 GUI：管理目标定义（添加/移除）

管理员 GUI：

目标验证 (/rank admin objectives <玩家>)：列出所有目标，带有验证/移除按钮，按等级顺序排序
目标管理 (/rank admin manage)：查看所有等级及其目标，通过 GUI 添加或移除目标

AFK 检测

游戏时间仅在玩家活跃时计算：

每 20 秒检查一次移动
可配置的移动阈值（默认 3 格）
AFK 超时：5 分钟无活动

配置

所有配置文件在首次启动时自动生成于 world/ranks/ 目录：

文件	内容
config.json	AFK、晋升、经济、距离间隔
grades.json	所有 30 个等级定义及阈值
rewards.json	每个等级的奖励命令
objectives.json	每个等级的社区目标

使用 /rank admin reload 热重载。

经济集成

与 HUDCreator 兼容（可选依赖），用于追踪赚取/花费金钱。如果未安装 HUDCreator，也能正常工作。

技术信息

Minecraft: 1.21.1
模组加载器: NeoForge
端: 服务端（GUI 含客户端同步）
存储: 每个玩家 JSON 文件，每 5 分钟自动保存
性能: 每 60 秒进行一次晋升检查，每刻追踪轻量高效

安装

安装 NeoForge 1.21.1
将 .jar 文件放入服务器和客户端的 mods/ 文件夹
启动服务器 — 配置文件会自动生成
自定义等级、奖励和目标以适应你的服务器
使用 /rank admin reload 应用更改