Ranks

Ranks – 社区进度系统

  Ranks 是一款适用于 NeoForge 1.21.1 的服务端进度模组，可根据玩家的实际活动自动进行排名
 。它包含 30 个等级、12 项追踪统计数据、由管理员验证的社区目标
   以及完整的聊天和玩家列表集成，让你的服务器成为充满成就感的
 进度体验。

  —
  主要特色

  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 界面管理并审核目标。

  —
  聊天与玩家列表集成

  玩家的等级会显示在各处：

  聊天：
  [建造者] Steve > 大家好！

  玩家列表：
  [建造者] Steve

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

  —
  晋升公告

  玩家晋升时，所有玩家都会看到一则庆祝公告：

  ★══════════════════════════════★
      ⬆ 晋 升 ⬆
      Steve：生存者 ➜ 建造者
      等级 10 / 30 — 阶段 5
  ★══════════════════════════════★

  颜色会随晋升后的等级动态变化。

  —
  图形界面（GUI）

  按 R 或输入 /rank — 打开进度面板：
  – 用彩色阶段栏突出显示当前阶段
  – 显示当前等级及下一等级的进度
  – 为每项统计数据显示进度条
  – 社区目标区域显示已审核 / 待审核状态
  – 内容超出屏幕时可滚动查看

  —
  奖励系统

  每次晋升时都会自动执行命令（可在 rewards.json 中配置）：
  – 给予物品、经验值和效果
  – 执行任意服务器命令
  – 可用占位符：{player}、{rank}、{rank_name}、{rank_number}

  —
  完整的管理员工具包

  命令：

  命令：/rank
  描述：查看你的等级并打开界面
  ────────────────────────────────────────
  命令：/rank info [player]
  描述：查看详细信息和进度
  ────────────────────────────────────────
  命令：/rank top
  描述：按等级列出前 10 名玩家
  ────────────────────────────────────────
  命令：/rank check
  描述：强制检查是否可以晋级
  ────────────────────────────────────────
  命令：/rank objectives
  描述：查看你晋升到下一级所需完成的目标
  ────────────────────────────────────────
  命令：/rank admin set <player> <grade>
  描述：设置玩家等级
  ────────────────────────────────────────
  命令：/rank admin reset <player>
  描述：重置玩家数据
  ────────────────────────────────────────
  命令：/rank admin reload
  描述：重新加载所有配置
  ────────────────────────────────────────
  命令：/rank admin validate <player> <objective>
  描述：验证一个目标
  ────────────────────────────────────────
  命令：/rank admin unvalidate <player> <objective>
  描述：移除一项验证
  ────────────────────────────────────────
  命令：/rank admin objectives <player>
  描述：管理员界面：查看/验证玩家目标
  ────────────────────────────────────────
  命令：/rank admin manage
  描述：管理员界面：管理目标定义（添加/移除）

  管理员界面：
  – 目标验证（/rank admin objectives <player>）：列出所有目标，并提供“验证/移除”
  按钮，按等级顺序排序
  – 目标管理（/rank admin manage）：查看所有等级及其目标，并通过界面添加或移除
  目标

  —
  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 秒检查一次晋升，逐刻追踪开销低

  —
  安装

  1. 安装 NeoForge 1.21.1
  2. 将 .jar 放入服务器和客户端的 mods/ 文件夹
  3. 启动服务器 — 配置文件会自动生成
  4. 根据服务器需求自定义等级、奖励和目标
  5. 运行 /rank admin reload 应用更改