NametagsPlus - 玩家名牌插件

MyPrefixSystem 是一款功能全面的 Minecraft 前缀与权限管理插件，它提供了高度自定义的聊天、计分板、玩家列表等功能，并支持网络同步与丰富的 API，适合各类服务器使用。

💡主要特性

• 强大的 API：为开发者提供丰富的接口，便于二次开发与集成。
• 自动更新器：可检查并下载新版本，保持插件最新。
• 自定义前缀/后缀：为每个等级设置独特的前缀与后缀。
• 自定义权限：每个等级可关联独立的权限节点。
• 自定义标题与页脚：在玩家列表（Tablist）顶部和底部显示自定义信息。
• 自定义计分板：可完全自定义侧边栏计分板的内容与样式。
• 无限等级：支持创建任意数量的玩家等级。
• 自定义聊天布局：自定义聊天信息的显示格式。
• 自定义加入/退出消息：设置玩家加入和离开服务器时的提示信息。
• BungeeCord 网络支持：支持在多服务器网络中同步数据。
• PlaceholderAPI 支持：兼容 PlaceholderAPI，可使用大量变量。

🔧安装步骤

• 下载插件文件。
• 将 MyPrefixSystem.jar 文件放入服务器的 /plugins/ 文件夹。
• 启动或重启 Spigot 服务器。
• 如需自定义配置，可编辑生成的 config.yml 和 ranks.yml 文件。
• 在 ranks.yml 中，按照示例格式添加你的等级。
• 完成配置，享受 MyPrefixSystem 带来的便利。

🎮命令与权限

• /myprefixsystem 或 /mps
• 权限节点：myprefixsystem.command
• 描述：MyPrefixSystem 的主命令。

- **/myprefixsystem help** 或 **/mps help**

- 描述：显示插件帮助信息。

- **/myprefixsystem reload** 或 **/mps reload**

- 描述：重载插件的配置文件。

❓重要说明

等级系统

• SortID：此数值决定了等级在玩家列表（Tablist）中的显示顺序。
• SortID: 0 代表最高等级，会显示在列表最前面。
• 数值越大，该等级在列表中的位置越靠后。

MySQL 网络同步

• 此功能专为多服务器网络设计。
• 你需要指定一个后端服务器，该服务器负责将 ranks.yml 的数据同步到数据库中。
• 每次编辑 ranks.yml 后，数据会在服务器启动、关闭或重载时同步至数据库。
• 网络中的其他服务器必须在 config.yml 中将 BackendServer 设置为 false。
• 注意：整个网络中只能有一个服务器作为后端服务器。
• 如果不需要跨服同步，可以忽略此设置。

可用变量（Placeholders）

插件内置了丰富的变量，并支持所有 PlaceholderAPI 的变量。

• %player% - 玩家名称
• %displayname% - 玩家显示名称
• %rank% - 等级名称
• %prefix% - 玩家前缀
• %suffix% - 玩家后缀
• %rankcolor% - 等级颜色代码
• %health% - 玩家生命值
• %food% - 玩家饱食度
• %world% - 玩家所在世界
• %server% - 服务器名称
• %online-players% - 当前在线玩家数
• %max-players% - 服务器最大玩家数
• %server-version% - 服务器版本
• %server-port% - 服务器端口

⭐开发者 API

RankAPI

Rank rank = Rank.getRank(String rankName); // 通过名称获取等级
Rank rank = Rank.getRankByPlayer(Player p); // 获取玩家的等级
rank.getName(); // 获取等级名称
rank.getPrefix(); // 获取等级前缀
rank.getSuffix(); // 获取等级后缀
rank.getColor(); // 获取等级颜色代码
rank.getSortID(); // 获取等级排序ID
rank.getPermission(); // 获取等级所需权限
rank.getBoardName(); // 获取等级在计分板中的名称
Rank.getRanks(); // 获取所有等级

PlayerAPI

CustomPlayer cp = getCustomPlayer(Player p); // 获取 CustomPlayer 对象
cp.sendNametag(); // 设置玩家的名称标签（前缀/后缀）
cp.sendTablist(); // 设置玩家列表的标题和页脚
cp.sendTitle(String title, String subtitle, int fadeIn, int stay, int fadeOut); // 向玩家发送标题
cp.sendActionBar(String message); // 向玩家发送动作栏信息
cp.getPlayer(); // 获取玩家对象
cp.getRank(); // 获取玩家的等级
cp.getScoreboard(); // 获取玩家的计分板
cp.getCustomScoreboard(); // 获取玩家的自定义计分板对象
CustomPlayer.getCustomPlayers(); // 获取所有 CustomPlayer 对象

ScoreboardAPI

CustomScoreboard csb = getCustomPlayer(Player p).getCustomScoreboard(); // 获取 CustomScoreboard 对象
csb.updateSideboard(); // 更新计分板
csb.getCustomPlayer(); // 获取关联的 CustomPlayer 对象
csb.getObjective(); // 获取计分板目标对象
CustomScoreboard.getCustomScoreboards(); // 获取所有 CustomScoreboard 对象

✨配置文件示例

config.yml

Settings:
  Prefix: '&7[&bMyPrefixSystem&7]'
Updater:
  Enabled: true
  Download: false
Network:
  BackendServer: true
Nametags:
  Enabled: true
Tablist:
  Enabled: true
  Header: '&eThis is the Header!'
  Footer: '&cThis is the Footer!'
Chat:
  Enabled: true
  Format: '%displayname%&8: &f%message%'
Join:
  Enabled: true
  Message: '&7[&a+&7] %displayname%'
Quit:
  Enabled: true
  Message: '&7[&c-&7] %displayname%'
Scoreboard:
  Enabled: true
  Title: '&6&lMyPrefixSystem &7&l❙ &aBoard'
  Lines:
  - '&0'
  - "%rankcolor%⬛ &8| &7Your Rank:"
  - "&7➥ %rankcolor%%rank%"
  - '&2'
  - "&b⬛ &8| &7World:"
  - "&7➥ &b%world%"
  - '&3'
  - "&a⬛ &8| &7Players:"
  - "&a➥ &a%online-players%/%max-players%"
  - '&4'
  - "&e⬛ &8| &7Website:"
  - "&7➥ &equanturix.de"
  - '&5'
  - "&9⬛ &8| &7TeamSpeak:"
  - "&7➥ &9ts.quanturix.de"

mysql.yml

MySQL:
  Enabled: false
  Hostname: localhost
  Port: 3306
  Database: MyPrefixSystem
  Username: MyPrefixSystem
  Password: password
  SSL: false

ranks.yml

Ranks:
  Example:
    Prefix: '&8'
    Suffix: ''
    RankColor: '&8'
    SortID: 100
    Permission: system.example

🔧使用条款

• 您不得以任何形式重新分发本插件，包括作为任何软件包的一部分。
• 您不得以任何形式对本插件及其文件进行反编译或修改。
• 购买后不会提供任何退款。
• 以任何方式不尊重本条款或版权都将导致投诉。
• 请勿在评分区联系作者、报告漏洞或请求新功能。
• 我们保留随时更改此条款的权利，无论是否提前通知，您同意遵守最新版本的条款。