关于
DuskRankColors 为玩家提供了一个游戏内菜单,允许自定义用于排名、加号(plus sign)和用户名的颜色。每个部分都可以使用服务器预设、自定义 HEX 颜色或渐变。
服务器管理员通过权限控制一切。排名在 config.yml 中定义,通过 duskrankcolors.ranks.<id> 分配,当玩家拥有多个排名的访问权限时,按优先级解析。每个排名可以限制其玩家可用的颜色模式和预设。
功能
- 排名、加号和玩家名称的独立颜色
- 预设、RGB 和渐变色模式
- 基于权限的排名系统,支持可配置优先级
- 每个排名可选的颜色和模式限制
- 带颜色预览的可配置物品栏菜单
- 烟花之星显示真实 RGB 颜色
- 可配置的消息、音效、材质和菜单槽位
- 通过 PersistentDataContainer 保存玩家选择
- 权限变更时自动更新排名
- 支持 Paper 和 Folia 调度器
- 无需任何依赖项
HEX 输入通过聊天窗口进行,并支持与取消或桥接现代和旧版聊天事件的插件兼容。在玩家拥有活跃的颜色提示期间,消息会被捕获而不会发送到普通聊天频道。
PlaceholderAPI
PlaceholderAPI 是可选的。安装后,DuskRankColors 为聊天、TAB 列表、名称标签和计分板提供格式化占位符:
%duskrankcolors_chat%
%duskrankcolors_tab%
%duskrankcolors_nametag%
%duskrankcolors_scoreboard%
还提供独立的排名、加号、名称、HEX、旧版格式、渐变、模式和 MiniMessage 值。
DuskRankColors 不会替换你的聊天、TAB 列表、名称标签或计分板插件。请配置该插件以使用对应的占位符。如果你只想让 DuskRankColors 直接应用玩家的显示名称或玩家列表名称,则可使用可选设置。
快速开始
- 将 JAR 文件放入服务器的
plugins 文件夹。
- 启动服务器以生成配置文件。
- 在
config.yml 的 ranks 下创建你的排名。
- 授予每个排名对应的权限
duskrankcolors.ranks.<id>。
- 向需要使用菜单的玩家授予
duskrankcolors.use 权限。
- 使用
/rankcolors 打开菜单。
管理工具可通过 /drc admin 获得,包括配置重载、玩家检查、颜色管理、重置以及配置验证。
要求
- Paper 1.20.1 或更高版本
- Java 17 字节码兼容性
- PlaceholderAPI 为可选
没有默认或成员排名。未配置排名权限的玩家在拥有所需权限时仍可使用名称颜色,但排名和加号的输出将保持为空。
许可证
DuskRankColors 采用 MIT 许可证授权。
About
DuskRankColors gives players an in-game menu where they can customize the colors used for their rank, plus sign, and username. Each part can use a server preset, a custom HEX color, or a gradient.
Server owners keep control through permissions. Ranks are defined in config.yml, assigned with duskrankcolors.ranks.<id>, and resolved by priority when a player has access to more than one. Each rank can limit which color modes and presets its players are allowed to use.
Features
- Separate colors for ranks, plus signs, and player names
- Preset, RGB, and gradient color modes
- Permission-based ranks with configurable priorities
- Optional color and mode restrictions for each rank
- Configurable inventory menus with colored previews
- Real RGB colors on firework stars
- Configurable messages, sounds, materials, and menu slots
- Player selections saved through PersistentDataContainer
- Automatic rank updates when permissions change
- Paper and Folia scheduler support
- No required dependencies
HEX input works through chat and supports plugins that cancel or bridge modern and legacy chat events. The message is captured while the player has an active color prompt and is not sent to normal chat.
PlaceholderAPI
PlaceholderAPI is optional. When installed, DuskRankColors provides formatted placeholders for chat, TAB, nametags, and scoreboards:
%duskrankcolors_chat%
%duskrankcolors_tab%
%duskrankcolors_nametag%
%duskrankcolors_scoreboard%
Individual rank, plus, name, HEX, legacy, gradient, mode, and MiniMessage values are also available.
DuskRankColors does not replace your chat, TAB, nametag, or scoreboard plugin. Configure that plugin to use the matching placeholder. Optional settings are available if you only want DuskRankColors to apply the player's display name or player-list name directly.
Getting started
- Place the JAR in your server's
plugins folder.
- Start the server to generate the configuration files.
- Create your ranks under
ranks in config.yml.
- Grant each rank with
duskrankcolors.ranks.<id>.
- Grant
duskrankcolors.use to players who should have access to the menu.
- Open the menu with
/rankcolors.
Administrative tools are available under /drc admin, including configuration reloads, player inspection, color management, resets, and configuration validation.
Requirements
- Paper 1.20.1 or newer
- Java 17 bytecode compatibility
- PlaceholderAPI is optional
There is no default or member rank. Players without a configured rank permission can still use name colors when they have the required permissions, while rank and plus output remains empty.
License
DuskRankColors is licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧