UltimateRanks

插件

· 作者 geturplugins

一款集成的多功能排名插件,支持自定义排名制作、聊天与名牌标签的排名集成,以及玩家排名管理等功能。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

** ?️ UltimateRanks - 完整文档

概述

描述

UltimateRanks 是一款面向运行 Paper 1.21+ 的 Minecraft 服务器的下一代权限组管理插件。与传统仅允许玩家拥有单一权限组的插件不同,UltimateRanks 引入了一种革命性的 混合系统,允许玩家 同时拥有多个权限组,并选择其中一个作为在聊天和标签页列表中 主动显示 的权限组。

UltimateRanks 基于现代 Java 21 特性和 Paper API 构建,通过异步数据库操作、智能缓存以及美观的基于 GUI 的权限组管理界面,提供卓越的性能。

为何选择 UltimateRanks?

功能 传统插件 UltimateRanks
多权限组 ❌ 仅限一个权限组 ✅ 无限权限组
权限叠加 ❌ 仅单个权限组的权限 ✅ 所有拥有的权限组均生效
视觉自定义 ❌ 固定显示 ✅ 可选择显示的活跃权限组
GUI 管理 ⚠️ 基础或无 ✅ 美观的分页 GUI
RGB 颜色 ⚠️ 支持有限 ✅ 完整的 MiniMessage 支持
性能 ⚠️ 同步操作 ✅ 100% 异步数据库
LuckPerms 同步 ⚠️ 替换或冲突 ✅ 无缝集成

目标受众

  • 网络服务器(Network):管理复杂的权限组层级(VIP + Builder + Staff)
  • RPG 服务器:职业权限组 + 成就权限组 + 捐赠者权限组
  • 创造服务器:建造者角色 + 主题权限组 + VIP 等级
  • 生存服务器:进度权限组 + 捐赠者特权 + 特殊活动
  • 监狱服务器:矿坑权限组 + Prestige + VIP 套餐

功能

? 核心功能

  1. 多权限组所有权系统
  • 玩家可以同时拥有 无限个权限组
  • 同时拥有 VIP + Builder + Helper
  • 所有权限组贡献权限(累加系统)
  • 权限组之间零冲突
示例:
  玩家拥有:[Member, VIP, Builder]
  权限 = Member + VIP + Builder (合并)
  活跃显示 = VIP (在聊天中显示)
  1. 活跃显示权限组选择
  • 选择在聊天前缀/后缀中显示的权限组
  • 通过交互式 GUI 在拥有的权限组之间切换
  • 实时刷新,无需重新连接
  • 保留来自其他权限组的所有权限
  1. 美观的分页 GUI
  • 简洁直观的权限组选择菜单
  • 视觉状态:Active(发光)、Owned(可用)、Locked(不可用)
  • 每页 28 个权限组,导航流畅
  • GUI 中直接显示过期计时器
  • 支持资源包的自定义图标
  1. 高级权限系统
  • 双模式运行:
    • 独立模式(Standalone Mode):内置 Bukkit 权限系统
    • LuckPerms 模式:与 LuckPerms API 完全集成
  • 自动检测可用系统
  • 聚合所有拥有权限组的权限
  • 支持通配符(例如 essentials.*)
  • 支持否定权限(例如 -essentials.fly)
  1. 过期与时间管理
  • 临时权限组,自动过期
  • 灵活的时间格式:30d、7d、1w、1mo、1y、permanent
  • 自动清理过期的权限组
  • 过期前的警告通知
  • GUI 中的可视化倒计时
  1. 完整的 MiniMessage 支持
  • RGB 颜色:<FF5555>text</color>
  • 渐变:<gradient:gold:yellow>VIP</gradient>
  • 格式化:<bold>、<italic>、<underline>
  • 悬停事件和点击动作
  • 旧版颜色代码转换
  1. 高性能数据库
  • SQLite:零配置,非常适合小型服务器
  • MySQL:HikariCP 连接池,适用于大型网络
  • 100% 异步操作(零服务器卡顿)
  • 事务支持以确保数据完整性
  • 自动架构管理
  1. 智能缓存系统
  • 在线玩家的内存缓存
  • 亚毫秒级查找时间
  • 自动缓存失效
  • 线程安全的并发操作

? 视觉功能

聊天格式化

之前:
  <Player> Hello!

之后:
  [VIP] Player ★: Hello!
  
格式:
  {prefix} + {player} + {suffix} + : + {message}

GUI 状态

状态 视觉效果 描述
Active ? 发光物品 当前装备的权限组
Owned ✅ 普通图标 点击以装备
Locked ? 障碍方块 未拥有

权限组显示示例

╔══════════════════════════════╗
║        My Ranks              ║
╠══════════════════════════════╣
║                              ║
║  [? VIP] (Active)           ║
║  Click to keep equipped      ║
║  Duration: Permanent         ║
║                              ║
║  [✅ Builder]                ║
║  Click to equip              ║
║  Expires in: 15 days         ║
║                              ║
║  [? MVP] (Locked)           ║
║  You don't own this rank     ║
║                              ║
╚══════════════════════════════╝

? 技术功能

架构

  • SOLID 原则:单一职责、接口隔离
  • 设计模式:策略、构建器、仓储、单例
  • 依赖注入:代码整洁,易于测试
  • 分层分离:模型、管理器、数据库、GUI、命令

性能指标

数据库操作:
  ✅ 加载玩家数据:~5ms (SQLite), ~3ms (MySQL)
  ✅ 保存玩家数据:~8ms (SQLite), ~4ms (MySQL)
  ✅ 权限组切换:~2ms (缓存命中)

内存使用:
  ✅ 插件基础占用:~5MB
  ✅ 每位玩家(已缓存):~2KB
  ✅ GUI 打开时:+8KB

可扩展性:
  ✅ 支持 1,000+ 并发玩家
  ✅ 已测试 100+ 权限组
  ✅ 零 Tick 卡顿(100% 异步)

线程安全

  • 用于玩家缓存的并发哈希表
  • 用于异步操作的 CompletableFuture
  • 同步数据库事务
  • 权限组切换中无竞态条件

? 集成功能

LuckPerms 集成

  • 自动同步:UltimateRanks ⟷ LuckPerms 群组
  • 回退支持:无论是否安装 LuckPerms 均可工作
  • 群组创建:自动创建缺失的 LuckPerms 群组
  • 权限继承:尊重 LuckPerms 的层级结构

PlaceholderAPI 支持

可用占位符:
  %ultimateranks_prefix%           → 当前等级前缀
  %ultimateranks_suffix%           → 当前等级后缀
  %ultimateranks_rank_displayname% → 等级显示名称
  %ultimateranks_rank_id%          → 等级 ID
  %ultimateranks_rank_weight%      → 等级权重
  %ultimateranks_total_ranks%      → 拥有的等级总数

聊天插件兼容性

  • ✅ EssentialsX Chat
  • ✅ ChatControl
  • ✅ VentureChat
  • ✅ 任何使用 PlaceholderAPI 的插件

安装

要求

  • Minecraft 服务器: Paper 1.21+ (或 Purpur/Pufferfish)
  • Java 版本: Java 21+
  • 可选依赖项:
    • LuckPerms 5.4+ (用于高级权限管理)
    • PlaceholderAPI 2.11+ (用于占位符变量)

快速安装

  1. 下载

    从 Releases 页面下载 UltimateRanks-1.0.0.jar
    
  2. 安装

     放入 plugins 文件夹
    cp UltimateRanks-1.0.0.jar /path/to/server/plugins/
    
  3. 首次启动

     启动服务器以生成配置文件
    java -jar paper.jar
    
     等待出现以下信息: "[UltimateRanks] ✓ UltimateRanks enabled successfully"
    
     停止服务器
    stop
    
  4. 配置

     编辑生成的配置文件
    nano plugins/UltimateRanks/config.yml
    nano plugins/UltimateRanks/ranks.yml
    
  5. 重启

     再次启动服务器
    java -jar paper.jar
    

验证

控制台输出(成功):
  [UltimateRanks] ═══════════════════════════════
  [UltimateRanks] UltimateRanks v1.0.0
  [UltimateRanks] Advanced Rank Management
  [UltimateRanks] ═══════════════════════════════
  [UltimateRanks] Loading configuration files...
  [UltimateRanks] ✓ Configuration loaded
  [UltimateRanks] Connecting to database...
  [UltimateRanks] ✓ Database connected (SQLite)
  [UltimateRanks] Initializing managers...
  [UltimateRanks] ✓ Loaded 10 ranks
  [UltimateRanks] ✓ Managers initialized
  [UltimateRanks] Initializing permission system...
  [UltimateRanks] ✓ LuckPerms detected - Using LuckPerms handler
  [UltimateRanks] Registering event listeners...
  [UltimateRanks] ✓ Event listeners registered
  [UltimateRanks] Registering commands...
  [UltimateRanks] ✓ Commands registered
  [UltimateRanks] ✓ PlaceholderAPI integration enabled
  [UltimateRanks] ✓ UltimateRanks enabled successfully in 245ms
  [UltimateRanks] ✓ Permission Mode: LuckPerms

配置

主配置文件 (config.yml)

数据库选择
database:
  type: sqlite   选项: sqlite, mysql

GUI 自定义
gui:
  menu-title: '<gradient:gold:yellow>My Ranks</gradient>'
  items-per-page: 28
  refresh-interval: 100   刻 (ticks)

聊天格式化
chat:
  enabled: true
  format: '{prefix}{player}{suffix}: {message}'
  allow-colors: true

过期管理
expiration:
  auto-cleanup: true
  cleanup-interval: 30   分钟
  notify-on-expiration: true
  warn-before-expiration: 24   小时

权限系统
permissions:
  mode: auto   选项: auto, standalone, luckperms
  apply-on-join: true
  refresh-on-change: true

等级定义 (ranks.yml)

ranks:
  vip:
    weight: 10                               层级关系(数值越高,等级越高)
    display_name: '<gold>VIP</gold>'         在 GUI/消息中显示的名称
    prefix: '<gradient:yellow:gold>[VIP]</gradient> '
    suffix: ''
    gui_icon: GOLD_INGOT                     GUI 中显示的图标
    custom_model_data: 0                     资源包支持
    permissions:
      - 'essentials.fly'
      - 'essentials.heal'
      - 'ultimateranks.chat.color'

MySQL 配置

database:
  type: mysql
  mysql:
    host: localhost
    port: 3306
    database: ultimateranks
    username: root
    password: 'your_password'
    pool-size: 10
    parameters: '?useSSL=false&autoReconnect=true'

? 从零创建等级 - 完整指南

? 快速概览

在哪里创建等级: plugins/UltimateRanks/ranks.yml

流程:

  1. 定义等级结构
  2. 设置权重(层级)
  3. 选择颜色/前缀
  4. 添加权限节点
  5. 选择 GUI 图标
  6. 重载插件

? 逐步教程

步骤 1:打开 ranks.yml

进入服务器文件夹
cd plugins/UltimateRanks/

编辑 ranks.yml
nano ranks.yml
或者使用 Notepad++/VSCode

步骤 2:基础等级结构

ranks:
  your_rank_name:           唯一标识符(小写,无空格)
    weight: 10              数字(数值越高,重要性越高)
    display_name: '<gold>Display Name</gold>'  玩家看到的名称
    prefix: '<gold>[Prefix]</gold> '            聊天前缀
    suffix: ''              聊天后缀(可选)
    gui_icon: GOLD_INGOT    菜单中显示的物品
    custom_model_data: 0    用于资源包(0 = 禁用)
    permissions:            该等级赋予的权限列表
      - 'permission.node.1'
      - 'permission.node.2'

? 示例:创建你的第一个等级

让我们从头创建一个 "Supporter" 等级:

ranks:
  supporter:
    weight: 5                                     低阶(高于默认等级)
    display_name: '<gradient:green:lime>Supporter</gradient>'
    prefix: '<gradient:green:lime>[Supporter]</gradient> '
    suffix: ' <green>♥</green>'
    gui_icon: EMERALD                             绿色绿宝石物品
    custom_model_data: 0
    permissions:
      - 'essentials.spawn'                       基本传送点
      - 'essentials.sethome'                      设置家
      - 'essentials.home'                         传送到家
      - 'essentials.back'                         返回死亡地点

保存文件,然后在游戏中执行:

/rank reload
/rank grant YourName supporter

命令与权限

命令

命令 描述 权限 使用示例
/rank menu 打开等级 GUI ultimateranks.menu /rank menu
/rank set <玩家> <等级> 设置主要等级 ultimateranks.admin.set /rank set Steve vip
/rank grant <玩家> <等级> [时间] 添加等级 ultimateranks.admin.grant /rank grant Steve builder 30d
/rank remove <玩家> <等级> 移除等级 ultimateranks.admin.remove /rank remove Steve vip
/rank reload 重新加载配置 ultimateranks.admin.reload /rank reload

命令别名

/rank    → /ranks, /ur
menu     → gui, open
remove   → take, revoke
reload   → rl

权限层级

ultimateranks.*                    (所有权限)
├── ultimateranks.use             (基本访问权限)
├── ultimateranks.menu            (GUI 访问权限)
└── ultimateranks.admin.*         (管理员命令)
    ├── ultimateranks.admin.set
    ├── ultimateranks.admin.grant
    ├── ultimateranks.admin.remove
    └── ultimateranks.admin.reload

特殊权限

权限 描述 默认值
ultimateranks.chat.color 在聊天中使用颜色代码 false
ultimateranks.bypass.expiration 等级永不过期 op
ultimateranks.notify.expiration 接收过期警告 true

使用指南

为玩家

打开等级菜单

1. 输入:/rank menu
2. GUI 将显示所有可用的等级
3. 点击任意已拥有的等级以装备它
4. 你的聊天前缀会立即更新

理解等级状态

? 发光物品 = 当前激活
   → 这是你的展示等级
   → 在聊天和标签页列表中显示

✅ 普通物品 = 已拥有但未激活
   → 点击可切换至此等级
   → 你仍拥有其权限

? 屏障 = 锁定
   → 你未拥有此等级
   → 请联系工作人员授予

检查过期时间

打开 /rank menu 并悬停在任意已拥有的等级上:
  
  [VIP]
  ✅ 点击以装备
  
  持续时间:25 天,14 小时
  权重:10

对于管理员

设置等级

1. 在 ranks.yml 中定义等级

ranks:
  premium:
    weight: 20
    display_name: '<gradient:aqua:blue>Premium</gradient>'
    prefix: '<gradient:aqua:blue>[Premium]</gradient> '
    suffix: ' <aqua>★</aqua>'
    gui_icon: DIAMOND
    permissions:
      - 'essentials.*'
      - 'worldedit.selection.*'

2. 重新加载配置

/rank reload

3. 授予玩家

 永久等级
/rank grant PlayerName premium

 30 天等级
/rank grant PlayerName premium 30d

 1 周等级
/rank grant PlayerName premium 1w

管理玩家等级

查看玩家等级

 玩家可通过 /rank menu 查看自己的等级
 管理员使用数据库或缓存检查

重置玩家等级

 移除所有等级并设置为默认
/rank set PlayerName default

临时 VIP 促销

授予玩家 7 天的 VIP 权限
/rank grant PlayerName vip 7d

玩家将在到期前 24 小时收到通知 Rank 在 7 天后自动移除


**多重 Rank 分配**
```bash
 玩家可以同时拥有 VIP + Builder + Helper
/rank grant PlayerName vip
/rank grant PlayerName builder
/rank grant PlayerName helper

 所有三个 Rank 均授予权限
 玩家可通过 GUI 选择聊天中显示的 Rank

常见工作流程

新玩家设置

 1. 玩家加入 → 自动获得 "default" Rank
 2. 玩家捐赠 → 授予 VIP
/rank grant PlayerName vip

 3. 玩家申请成为 builder → 授予 builder
/rank grant PlayerName builder

 玩家现在拥有:default + vip + builder(所有权限)
 玩家可选择 "vip" 或 "builder" 用于聊天显示

员工晋升

 晋升为 Helper(保留 VIP)
/rank grant PlayerName helper

 玩家保留 VIP 特权 + 获得员工权限
 可在 GUI 中切换 [VIP] 和 [Helper] 前缀

季节性活动

 万圣节活动 - 30 天
/rank grant * halloween 30d

 所有在线玩家获得 halloween Rank
 活动结束后自动过期

占位符

PlaceholderAPI 集成

所有占位符均可与任何支持 PlaceholderAPI 的插件配合使用(DeluxeChat、FeatherBoard 等)

占位符 输出 示例
%ultimateranks_prefix% 当前 Rank 前缀 [VIP]
%ultimateranks_suffix% 当前 Rank 后缀 ★
%ultimateranks_rank_displayname% Rank 显示名称 VIP
%ultimateranks_rank_id% Rank 标识符 vip
%ultimateranks_rank_weight% Rank 权重 10
%ultimateranks_total_ranks% 拥有的总 Rank 数 3

使用示例

DeluxeChat 格式

formats:
  default:
    format: '%ultimateranks_prefix%%player_name%%ultimateranks_suffix%: %message%'
     输出: [VIP] Steve ★: Hello!

Tab 列表 (TAB 插件)

header: |
  &6Server Name
  &e%ultimateranks_prefix%%player_name%

记分板 (FeatherBoard)

board:
  title: '&6&lServer'
  lines:
    - '&7Rank: %ultimateranks_rank_displayname%'
    - '&7Weight: %ultimateranks_rank_weight%'
    - '&7Total Ranks: %ultimateranks_total_ranks%'

告示牌

[Shop]
仅限 VIP
%ultimateranks_rank_displayname%
需要

常见问题解答

一般问题

Q: UltimateRanks 与其他 Rank 插件有何不同?

A: UltimateRanks 允许玩家同时拥有多个 Rank,并选择聊天中显示哪一个。传统插件强制“仅一个 Rank”——我们提供来自所有 Rank 的全部权限,同时让玩家自定义外观。

Q: 这会取代 LuckPerms 吗?

A: 不会!UltimateRanks 与 LuckPerms 集成。使用 LuckPerms 进行复杂的权限设置,而使用 UltimateRanks 进行视觉 Rank 管理和 GUI 系统。两者可无缝协同工作。

问:我可以在不使用 LuckPerms 的情况下使用此模组吗?

答:可以!UltimateRanks 内置了一个权限系统(独立模式),无需任何依赖即可运行。

问:这与我当前的权限组兼容吗?

答:如果您使用的是 LuckPerms,UltimateRanks 可以与您的现有用户组同步。您需要在 ranks.yml 中创建匹配的权限组定义。

技术问题

问:这会导致服务器延迟吗?

答:不会。所有数据库操作均为 100% 异步。UltimateRanks 不会造成任何服务器刻(tick)延迟。

问:它支持多少玩家?

答:已测试支持 1,000+ 名并发玩家。配合 MySQL 和适当的缓存机制,它可以适应任何规模的服务器。

问:如果我的数据库崩溃了怎么办?

答:在会话期间,玩家会保留其缓存的权限组数据。重新加入时,UltimateRanks 将尝试重新连接。不会发生数据丢失(断开连接前会保存缓存数据)。

问:我可以在 BungeeCord 网络中使用它吗?

答:可以!请使用 MySQL 数据库模式。您网络中的所有服务器将共享同一个权限组数据库。玩家在不同服务器之间保持其权限组不变。

配置问题

问:如何创建新的权限组?

 添加到 ranks.yml:
ranks:
  newrank:
    weight: 15
    display_name: '<aqua>NewRank</aqua>'
    prefix: '<aqua>[NewRank]</aqua> '
    suffix: ''
    gui_icon: DIAMOND
    permissions:
      - 'permission.node.here'

 然后执行: /rank reload

问:如何更改 GUI 标题?

 config.yml:
gui:
  menu-title: '<gradient:red:blue>Custom Title</gradient>'

问:渐变效果是如何工作的?

 简单渐变(2种颜色):
prefix: '<gradient:red:blue>VIP</gradient> '

 多色渐变:
prefix: '<gradient:red:yellow:green:blue>Rainbow</gradient> '

 带格式化的渐变:
prefix: '<bold><gradient:gold:yellow>VIP</gradient></bold> '

游戏性问题

问:玩家可以拥有多个权限组吗?

答:可以! 这是核心功能之一。玩家可以同时拥有 VIP、Builder 和 Helper 等多个权限组。

问:多个权限组的权限会叠加吗?

答:会! 如果您拥有 [Member] 权限组的 essentials.spawn 和 [VIP] 权限组的 essentials.fly,您将同时获得这两项权限。

问:玩家可以选择在聊天中显示哪个权限组吗?

答:可以! 打开 /rank menu 并点击任意已拥有的权限组即可将其设为活动状态。

问:当权限组过期时会发生什么?

1. 自动清理移除过期的权限组
2. 玩家收到通知(如果已启用)
3. 来自过期权限组的权限被移除
4. 如果过期的权限组是活动状态,则切换到其他已拥有的权限组
5. 删除数据库条目

问:我可以给予临时权限组吗?

 可以!使用持续时间语法:
/rank grant Steve vip 30d       30天
/rank grant Steve builder 1w    1周
/rank grant Steve premium 1mo   1个月
/rank grant Steve special 1y    1年
/rank grant Steve permanent     永久

管理员问题

问:如何给某人赋予多个权限组?

/rank grant PlayerName vip
/rank grant PlayerName builder
/rank grant PlayerName helper

 现在该玩家拥有这三个权限组!
 他们可以通过 /rank menu 选择在聊天中显示的权限组

问:如何重置某人的权限组?

 选项 1:设置为单个权限组(移除其他所有)
/rank set PlayerName default

 选项 2:移除特定权限组
/rank remove PlayerName vip
/rank remove PlayerName builder

问:我可以看到某人有哪些权限组吗?

目前可通过检查数据库或缓存来实现。未来的更新将添加 /rank info <player> 命令。

问:如何备份数据库?

 SQLite(自动备份):
cp plugins/UltimateRanks/data.db plugins/UltimateRanks/data.db.backup

 MySQL(使用 mysqldump):
mysqldump -u username -p ultimateranks > backup.sql

故障排除

问:GUI 中未显示权限组

1. 检查 ranks.yml 语法(使用 YAML 验证器)
2. 确保权限组具有有效的 gui_icon 材质
3. 运行 /rank reload
4. 检查控制台是否有错误

问:权限不生效

1. 检查启动时控制台中显示的权限处理器模式
2. 验证 ranks.yml 中的权限
3. 使用 /rank menu 进行测试(需要 ultimateranks.menu 权限)
4. 检查 LuckPerms 是否产生干扰(如果使用独立模式)

问:数据库连接失败

 SQLite:
1. 检查文件权限
2. 确保 data 文件夹存在

 MySQL:
1. 验证 config.yml 中的凭据
2. 检查 MySQL 服务器是否正在运行
3. 手动测试连接
4. 检查防火墙规则

问:聊天前缀未显示

1. 确保 config.yml 中 chat.enabled: true
2. 检查是否有其他聊天插件覆盖
3. 验证玩家拥有活动的权限组(/rank menu)
4. 测试 PlaceholderAPI 占位符

支持

获取帮助

  1. 查看文档
  • 仔细阅读本文档
  • 查看示例配置
  • 查阅常见问题解答中的常见问题
  1. 控制台日志
启用调试模式:
  config.yml → advanced.debug: true
  
检查日志:
  /logs/latest.log
  查找 [UltimateRanks] 消息
  1. 社区支持
  • Discord: [geturplugins]
  1. 报告 Bug
请包含:
  ✅ 服务器版本(Paper 1.21.x)
  ✅ 插件版本
  ✅ 完整错误日志
  ✅ config.yml 和 ranks.yml
  ✅ 复现步骤
  ✅ 预期行为与实际行为的对比

用于支持的有用命令

 检查插件版本
/version UltimateRanks

 测试数据库连接
/rank reload
 观察控制台中的数据库消息

 启用调试模式
 config.yml → advanced.debug: true
 重启服务器

 导出玩家数据(未来功能)
/rank export <player>

 测试权限
/rank menu
 如果此命令有效,则权限系统功能正常

性能优化

推荐设置

小型服务器(1-50 名玩家)

database:
  type: sqlite

performance:
  enable-cache: true
  cache-expiration: 60   分钟
  batch-size: 50

中型服务器(50-200 名玩家)

database:
  type: mysql
  mysql:
    pool-size: 5

performance:
  enable-cache: true
  cache-expiration: 45
  batch-size: 100

大型服务器(200+ 名玩家)

database:
  type: mysql
  mysql:
    pool-size: 15
    minimum-idle: 5

performance:
  enable-cache: true
  cache-expiration: 30
  batch-size: 200

网络(BungeeCord/Velocity)

database:
  type: mysql
  mysql:
    host: central-db.example.com
    pool-size: 20
    minimum-idle: 10

performance:
  enable-cache: true
  cache-expiration: 20
  batch-size: 500

迁移指南

从 LuckPerms Groups 迁移

1. 导出 LuckPerms 组
/lp export

2. 在 ranks.yml 中创建对应的等级
ranks:
  vip:   匹配 LuckPerms 组名
    weight: 10
    display_name: '<gold>VIP</gold>'
    prefix: '<gold>[VIP]</gold> '
    permissions: []   留空,由 LuckPerms 处理权限

3. 启用 LuckPerms 同步
config.yml:
  integrations:
    luckperms:
      sync-groups: true

4. 重载配置
/rank reload

玩家的 LuckPerms 组现在将与 UltimateRanks 同步

从 EssentialsX Kits/Ranks 迁移

1. 将 Essentials 组映射到 UltimateRanks
Essentials: "default" → UltimateRanks: "default"
Essentials: "vip" → UltimateRanks: "vip"

2. 从 Essentials 配置中复制权限

3. 授予玩家等级
/rank grant <player> <rank>

4. 移除 Essentials 等级系统(可选)

更新日志

版本 1.0.0 (初始发布)

✨ 特性:
  ✅ 多等级所有权系统
  ✅ 活动显示等级选择
  ✅ 分页 GUI,每页 28 个等级
  ✅ 双权限系统(独立模式 + LuckPerms)
  ✅ 完整 MiniMessage 支持(RGB、渐变)
  ✅ SQLite 和 MySQL 数据库支持
  ✅ 异步数据库操作
  ✅ 智能缓存系统
  ✅ 带警告的过期系统
  ✅ PlaceholderAPI 集成
  ✅ 5 个带有 Tab 补全的管理命令
  ✅ 包含 16 个示例等级

? 技术细节:
  ✅ Java 21 + Paper 1.21 API
  ✅ HikariCP 连接池
  ✅ 线程安全操作
  ✅ SOLID 架构
  ✅ 零刻延迟(100% 异步)

? 文档:
  ✅ 完整用户指南
  ✅ 管理员手册
  ✅ 配置示例

致谢与许可

开发团队

  • 首席开发者: geturplugins
  • 特别感谢: Paper Team, LuckPerms, PlaceholderAPI

使用的库

  • Paper API - Minecraft 服务器 API
  • LuckPerms API - 权限系统集成
  • PlaceholderAPI - 占位符支持
  • HikariCP - 连接池
  • Adventure API - 文本组件系统

快速参考卡片

╔══════════════════════════════════════════════════════════════╗
║              ULTIMATERANKS 快速参考                          ║
╠══════════════════════════════════════════════════════════════╣
║                                                              ║
║  玩家命令:                                                   ║
║    /rank menu              → 打开等级选择 GUI                ║
║                                                              ║
║  管理员命令:                                                 ║
║    /rank set <player> <rank>           → 设置主等级          ║
║    /rank grant <player> <rank> [time]  → 添加等级            ║
║    /rank remove <player> <rank>        → 移除等级            ║
║    /rank reload                        → 重载配置            ║
║                                                              ║
║  时间格式:                                                   ║
║    30d = 30天    1w = 1周    1mo = 1个月                     ║
║    permanent = 永久有效                                      ║

║ ║ ║ 占位符: ║ ║ %ultimateranks_prefix% → 当前排名前缀 ║ ║ %ultimateranks_rank_displayname% → 排名显示名称 ║ ║ %ultimateranks_total_ranks% → 拥有数量 ║ ║ ║ ║ 配置文件: ║ ║ config.yml → 数据库、GUI、聊天设置 ║ ║ ranks.yml → 排名定义 ║ ║ ║ ║ 支持: ║ ║ Discord: geturplugins ║ ║ ║

╚══════════════════════════════════════════════════════════════╝


---

最终说明

反馈与建议

我们根据用户反馈持续改进 UltimateRanks!

**提交建议:**
- Discord
- SpigotMC 评论

---

**? 感谢您选择 UltimateRanks!**

*简化高级排名管理*

--- **

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源