修改版本号

添加ASCII文字与插件介绍
添加下载地址
2026-06-05 09:01:39 +08:00 · 2021-11-21 20:01:49 +08:00 · 2021-11-21 19:53:12 +08:00 · 2021-11-02 11:47:13 +08:00 · 2021-10-30 17:59:07 +08:00 · 2021-10-30 09:56:26 +00:00
37 changed files with 2132 additions and 459 deletions
@@ -0,0 +1,30 @@
+---
+name: 问题提交
+about: 提交并描述问题，帮助我们对其进行检查与修复。
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**问题简述**
+用简短的话语描述一下大概问题。
+
+**问题来源**
+描述一下通过哪些操作才发现的问题，如：
+1. 打开 '...'
+2. 点击了 '....'
+3. 出现了报错 '....'
+
+**预期结果**(可选)
+如果问题不发生，应该是什么情况
+
+**问题截图/问题报错**
+如果有报错或输出，请提供截图。
+
+**操作环境**
+请在后台输入 `version` 并复制相关输出。
+
+
+**其他补充**
+如有其他补充，可以在这里描述。
@@ -0,0 +1,20 @@
+---
+name: 功能需求
+about: 希望我们提供更多的功能。
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**功能简述**
+简单的描述一下你想要的功能
+
+**需求来源**
+简单的描述一下为什么需要这个功能。
+
+**功能参考**(可选)
+如果有相关功能的参考，如文本、截图，请提供给我们。
+
+**附加内容**
+如果有什么小细节需要重点注意，请在这里告诉我们。
@@ -0,0 +1,70 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '44 6 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'java' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1
@@ -0,0 +1,33 @@
+# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
+# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+
+name: Deploy
+
+on:
+  # 支持手动触发构建
+  workflow_dispatch:
+  release:
+    # 创建release的时候触发
+    types: [ published ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: "Set up JDK"
+        uses: actions/setup-java@v2
+        with:
+          java-version: '11'
+          distribution: 'adopt'
+          cache: maven
+          server-id: github
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_TOKEN
+      - name: "Deploy"
+        run: mvn -B deploy --file pom.xml -DskipTests
+        env:
+          MAVEN_USERNAME: ${{ github.repository_owner }}
+          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
@@ -1,13 +1,12 @@
 # This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
 # For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven

-name: Java CI with Maven
+name: Build

 on:
+  # 支持手动触发构建
+  workflow_dispatch:
  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]

 jobs:
  build:
@@ -15,12 +14,25 @@ jobs:
    runs-on: ubuntu-latest

    steps:
-    - uses: actions/checkout@v2
-    - name: Set up JDK 11
-      uses: actions/setup-java@v2
-      with:
-        java-version: '11'
-        distribution: 'adopt'
-        cache: maven
-    - name: Build with Maven
-      run: mvn -B package --file pom.xml
+      - uses: actions/checkout@v2
+      - name: "Set up JDK"
+        uses: actions/setup-java@v2
+        with:
+          java-version: '11'
+          distribution: 'adopt'
+          cache: maven
+          server-id: github
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_TOKEN
+      - name: "Package"
+        run: mvn -B package --file pom.xml
+        env:
+          MAVEN_USERNAME: ${{ github.repository_owner }}
+          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
+      - name: "Target Stage"
+        run: mkdir staging && cp target/*.jar staging
+      - name: "Upload artifact"
+        uses: actions/upload-artifact@v2
+        with:
+          name: Artifact
+          path: staging
@@ -1,3 +1,4 @@
 /.idea/
 /target/
-./*.iml
+./*.iml
+*.iml
@@ -0,0 +1,311 @@
+![BANNER](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/banner.png)
+
+# UserPrefix Plugin
+
+[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840)](https://www.codefactor.io/repository/github/carmjos/userprefix)
+![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/UserPrefix)
+[![License](https://img.shields.io/github/license/CarmJos/UserPrefix)](https://opensource.org/licenses/GPL-3.0)
+[![Java CI with Maven](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml)
+![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-yellow)
+![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)
+
+Lightweight, efficient, and real-time user prefix system.
+
+This plugin is implemented based on Spigot ,**Theoretically** support ALL MineCraft Versions.
+
+The development of this plugin is based on Chinese which purpose is to help Chinese developers learn Bukkit plugin
+development.
+
+> This plugin has been published on [SpigotMC](https://www.spigotmc.org/resources/userprefix.96277/) .
+
+> 本插件已在 [MCBBS](https://www.mcbbs.net/forum.php?mod=viewthread&tid=1261503) 上发布，欢迎中文用户来这里下载。
+
+## Examples
+
+![example](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/using-example.png)
+
+## Dependencies
+
+- **[Necessary]** Plugin developed based on [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT)
+  and [BukkitAPI](http://bukkit.org/).
+- **[Necessary]** Plugin data storage base on  [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/).
+- **[Recommend]** Placeholders based on [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) .
+
+For development dependencies, please see  [Dependencies](https://github.com/CarmJos/UserPrefix/network/dependencies) .
+
+## Features
+
+- **Theoretically** support ALL MineCraft Versions.
+- Reloading the configuration will automatically refresh the prefix of all players.
+- Real-time judgment and feedback to the player when permissions are changed. [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/listener/processor/UserNodeUpdateProcessor.java)
+- Configurable sounds and messages.
+- The prefix icon can be configured as "Selected", "Has Permission" and “No Permission”.
+    - Item configuration is natively configured through ItemStack, which supports all MC settings!
+- TabList is automatically sorted according to the weight of the prefix (if there is a conflict, it can be turned off)
+- The prefix display on the player name (can be turned off if there is a conflict) [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/nametag/UserNameTag.java)
+- Simple Chat Format Placeholder support. (Not Recommended) [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/listener/ChatListener.java)
+- GUI with automatic sorting and page turning! [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/ui/PrefixSelectGUI.java)
+- Support PlaceholderAPI variables! [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/hooker/UserPrefixExpansion.java)
+- Support [Hex Color](https://www.hexcolortool.com/)! (Version 1.16 and above)  `&(#Color)` [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/util/ColorParser.java)
+    - Example: LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)`
+
+## Notice
+
+### 1. Version support issues
+
+This plugin theoretically supports all versions.
+
+If the icon does not load, the sound cannot be played, etc., please check whether the type of the item and sound in the
+configuration file exists in the current version.
+
+Take the SOUND as an example. The sound that the villager said "OK" is "`VILLAGER_YES`" in the lower version, but it
+becomes "`ENTITY_VILLAGER_YES`" in the higher version.
+
+### 2. Scoreboard exception problem
+
+The display of the prefix on the head and the sorting of the TabList both use the scoreboard API.
+
+Please turn of the `functions.OnNamePrefix` in the configuration if there is a conflict.
+
+### 3. Item icon configuration problem
+
+Items are read through the ItemStack serialization method provided by Bukkit. For related configuration methods, please
+refer to  [ItemStack Serialization](https://www.spigotmc.org/wiki/itemstack-serialization/).
+
+## Commands
+
+This plugin's Commands are based on Chinese!
+**May support multi-language in the future.**
+
+```text
+/UserPrefix or /prefix #Open prefix GUI
+/UserPrefixAdmin # View Admin Command Help
+/UserPrefixAdmin reload # Reload Config
+/UserPrefixAdmin list # List all configured prefixes.~~~~
+```
+
+## Placeholders (PlaceholderAPI)
+
+After installed the [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) , you can
+type `/papi info UserPrefix` to see all the placeholders.
+
+```text
+# %UserPrefix_prefix% 
+- Get the content of the current prefix
+# %UserPrefix_weight% 
+- Get the weight of the current prefix.
+# %UserPrefix_identifier% 
+- Get the identifier of the current prefix.
+# %UserPrefix_name% 
+- Get the name of the current prefix.
+# %UserPrefix_has_<Identifier>% 
+- Determine whether the player has a certain prefix(true/false)
+```
+
+## Configuration files
+
+### [Plugin Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml) (config.yml)
+
+Notice: The default configuration is based on Chinese. You can find
+the [English Version here](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml).
+
+```yaml
+version: ${project.version} # DO NOT EDIT IT
+
+debug: false #DEBUG OUT PUT
+
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+  
+GUI:
+  title: "&f&lMy Prefixes List" # Title of the GUI
+  items:
+    next-page: # only show has next page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fNext Page"
+        lore:
+          - ""
+          - "§fRight-Click to the last page"
+    previous-page: # only show has previous page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fPrevious Page"
+        lore:
+          - ""
+          - "§fRight-Click to the first page"
+
+functions:
+  # Whether to add a prefix to the top of the head,
+  # this method uses the scoreboard above the head,
+  # please turn it off if there is a conflict.
+  OnNamePrefix: true
+  # Automatic prefix select.
+  # When the player does not choose a prefix by himself,
+  # the prefix with the highest weight will be used~~~~ automatically
+  autoUsePrefix: true
+  chat:
+    # Chat Function
+    # - I recommend using other chat plugins instead of using this plugin,
+    # - this plugin only provides very basic chat format placeholders.
+    # - Notice that: format must has “%1$s” and “%2$s” for PlayerName and Message (Bukkit Chat Event)
+    enable: false
+    format: "<%UserPrefix_prefix%%1$s> %2$s"
+
+Sounds:
+  # Format is [SOUND_NAME:Volume:Pitch] or [SOUND_NAME:Volume] or [SOUND_NAME]
+  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
+  guiClick: "UI_BUTTON_CLICK"
+  prefixChange: "ENTITY_VILLAGER_YES"
+  prefixExpired: "ENTITY_VILLAGER_NO"
+
+# The default prefix's weight is 0.
+defaultPrefix:
+  name: "Default prefix"
+  content: "&b"
+  itemNotUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix §f(Click to select)"
+      lore:
+        - ""
+        - "§a➥ Click to use"
+  itemUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix"
+      lore:
+        - ""
+        - "§a✔ Selected"
+```
+
+### [Messages Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/messages.yml)  (messages.yml)
+
+```yaml
+selected:
+  - "&7You have selected the  &f%(name) &7as current prefix."
+expired:
+  - "&7Your prefix &f%(oldName) &7has expired,"
+  - "&7Now the prefix is changed to &f%(newName) &7."
+reload:
+  - "&a&lReload completed！&7costs &f%(time)ms&7."
+help:
+  - "&3&lUserPrefixAdmin &fHelp"
+  - "&8#/upa&f list"
+  - "&8- &7Show configured prefixes."
+  - "&8#/upa&f reload"
+  - "&8- &7Reload configuration."
+list-title:
+  - "&3&lUserPrefixAdmin &fList"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7Name &r%(name) &7Perm &r%(permission)"
+  - "&8- &7Example&r %(content) %(sender_name)"
+
+```
+
+### [Prefixes Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/example-prefix.yml) (/prefixes/*.yml)
+
+All prefixes are separate configuration files, stored in the `<Data Folder>/prefixes/` for easy management.
+
+Some symbols in file name may affect reading, please avoid using them.
+
+```yaml
+# identifier [Necessary]
+# This will be used for data-storage.
+identifier: "pro"
+
+# Name [Necessary]
+# Use in messages.
+name: "&b&lPro&b"
+
+# Content [Necessary]
+# Use in Placeholders
+content: "§b§lPro §b"
+
+# Weight [Necessary]
+# used for sorting in the GUI and TabList
+# In GUI : the larger is displayed at the back
+# At TabList : the larger is displayed at the top
+weight: 1
+
+# Permission [Unnecessary]
+# If there is no permission for detection, everyone can use it,
+# which means there is no need to configure "itemNoPermission"
+# (because it is impossible to display items without permission at all)
+permission: "yc.vip"
+
+# itemHasPermission  [Necessary]
+# This Item will be displayed when player has permission
+itemHasPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: org.bukkit.inventory.ItemStack
+      type: DIAMOND
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§b§lVIP Prefix"
+        lore:
+          - ""
+          - "§a➥ Click to  use"
+
+# itemUsing [Unnecessary]
+# This Item will be displayed when the prefix is selected.
+# If there is no such configuration, it will automatically display "itemHasPermission".
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+    type: DIAMOND
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§b§lVIP Prefix"
+      enchants:
+        PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
+      lore:
+        - ""
+        - "§a✔ Selected"
+
+# itemNoPermission [Unnecessary]
+# If player doesn't have the permission,this item will be displayed.
+# If this item is not configured, it will not be displayed in the GUI when the player does not have permission to use it.
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+    type: INK_SACK
+    damage: 8
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§b§lVIP §c(Buy it!)"
+      lore:
+        - ""
+        - "§e✯ Buy the VIP to use it!"
+```
+
+## Support and Donation
+
+This project is support by the  [YourCraft(你的世界)](https://www.ycraft.cn) .
+![TeamLogo](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/team-logo.png)
+
+## Open source agreement
+
+The source code of this project uses  [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0)
+License.
+
@@ -3,14 +3,19 @@
 # 用户前缀系统插件

 [![CodeFactor](https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840)](https://www.codefactor.io/repository/github/carmjos/userprefix)
+![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/UserPrefix)
+[![License](https://img.shields.io/github/license/CarmJos/UserPrefix)](https://opensource.org/licenses/GPL-3.0)
 [![Java CI with Maven](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml)
+![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-yellow)
 ![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)

 轻便、高效、实时的用户前缀系统。

 本插件基于Spigot实现，**理论上支持全版本**。

-本插件已在 [MCBBS](https://www.mcbbs.net/forum.php?mod=viewthread&tid=1261503) 上发布。
+The **English version** of the introduction is [here](https://github.com/CarmJos/UserPrefix/blob/master/README-en.md).
+
+> 本插件已在 [MCBBS](https://www.mcbbs.net/forum.php?mod=viewthread&tid=1261503) 与 [SpigotMC](https://www.spigotmc.org/resources/userprefix-hex-color-support-all-version.96277/) 上发布。

 ## 示例

@@ -28,17 +33,19 @@

 - 理论上全版本支持！
 - 游戏内重载配置文件并实时更新到玩家！
- 当玩家权限变更时会实时监测前缀，若权限不足则自动更换前缀并提示！
+- 当玩家权限变更时会实时监测前缀，若权限不足则自动更换前缀并提示！[✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/listener/processor/UserNodeUpdateProcessor.java)
 - 可配置的声音、消息！
 - 前缀图标可配置“选中”、“有权限”与“无权限”三种状态的物品
-    - 物品的配置通过ItemStack原生配置，支持MC所有的设定！
-    - 具体的设定请参考其他文档哦~
+  - 物品的配置通过ItemStack原生配置，支持MC所有的设定！
+  - 具体的设定请参考其他文档哦~
 - TabList自动按照前缀的权重排序 (如有冲突可关掉)
- 玩家头顶前缀显示 (如有冲突可关掉)
- 自动排序，且可翻页的GUI！
- 支持PlaceholderAPI变量！(凡支持的都可以使用，如BungeeTabListPlus)
- 支持Hex颜色！(1.16以上版本) 格式 `&(#颜色代码)`
-    - 示例： LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)`
+- 玩家头顶前缀显示 (如有冲突可关掉) [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/nametag/UserNameTag.java)
+- 简单的聊天变量修改功能！(不推荐使用) [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/listener/ChatListener.java)
+- 自动排序，且可翻页的GUI！[✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/ui/PrefixSelectGUI.java)
+- 支持PlaceholderAPI变量！(凡支持的都可以使用，如BungeeTabListPlus) [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/hooker/UserPrefixExpansion.java)
+- 支持[Hex颜色](https://www.hexcolortool.com/)！(1.16以上版本)   [✈](https://github.com/CarmJos/UserPrefix/blob/master/src/main/java/cc/carm/plugin/userprefix/util/ColorParser.java)
+  - 格式： `&(#颜色代码)`
+  - 示例： LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)`

 ## 注意事项

@@ -90,21 +97,57 @@

 ## 配置文件示例

+### [基础配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/config.yml) (config.yml)
+
 ```yaml
 version: 1.0.0-SNAPSHOT # 配置文件版本，一般不会动。

 debug: false #debug输出，开发者用的

+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！
+
 functions:
  OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
+  chat:
+    # 聊天功能
+    # - 我不推荐使用本插件的聊天功能，而是建议使用其他的聊天插件。
+    # - 本插件仅仅提供了**最基本**的格式变量支持，不包含其他任何功能。
+    # - 注意聊天格式需要遵守Bukkit原格式，即不得缺失 “%1$s” 和 “%2$s” 。
+    # - 本插件的聊天功能不影响其他插件对聊天事件的操作。
+    enable: false # 是否启用
+    format: "<%UserPrefix_prefix%%1$s> %2$s" #聊天的格式，注意 “%1$s” 和 “%2$s” 不可缺少，分别代表 玩家名 与 消息内容 。

-messages:
-  selected:
-    - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
-  expired:
-    - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
-    - "&7现在已为您重新调整为 &f%(newName) &7。"
+GUI:
+  title: "&f&l我的前缀 &8| 列表"
+  items:
+    # 【必须】 GUI中可能存在的其他物品
+    next-page: # 下一页物品，如果没有下一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f下一页"
+        lore:
+          - ""
+          - "§f右键可前往最后一页哦~"
+    previous-page: # 上一页物品，如果没有上一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f上一页"
+        lore:
+          - ""
+          - "§f右键可前往第一页哦~"

 Sounds: #相关的声音，注释掉则不播放声音 
  # 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
@@ -138,64 +181,117 @@ defaultPrefix:
      lore:
        - ""
        - "§a✔ 您正在使用该前缀"
-
-prefixes:
-  VIP:
-    name: "&b&lPro&b" # [必须] 名字(切换的时候左下角会弹提示 用的就是这个名字)
-    content: "§b§lPro §b" # [必须] 显示在名字前面的内容
-    weight: 1 # [必须] 权重，用于GUI里面的排序(越大显示在越后面)和自动前缀显示
-    permission: "yc.pro" # [非必须] 检测的权限，如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
-    itemHasPermission:
-      #  [必须] 当有权限的时候会显示这个Item
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a➥ 点击切换到该前缀"
-    itemUsing:
-      # [非必需] 当有权限的时候会显示这个Item,如果没有这个配置就自动显示“itemHasPermission”的。
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        enchants:
-          PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a✔ 您正在使用该前缀"
-    itemNoPermission:
-      # [非必需] 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
-      ==: org.bukkit.inventory.ItemStack
-      type: INK_SACK
-      damage: 8
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
-        lore:
-          - "§7Pro+会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - "§f您可以输入 §b/vip §f指令查看详细特权！"
-          - ""
-          - "§e✯ 加入Pro+会员以使用该前缀！"
 ```

+### [消息配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/messages.yml) (messages.yml)
+```yaml
+selected:
+  - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
+expired:
+  - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
+  - "&7现在已为您重新调整为 &f%(newName) &7。"
+reload:
+  - "&a&l重载完成！&7共耗时 &f%(time)ms&7。"
+help:
+  - "&3&l用户前缀系统 &f帮助"
+  - "&8#/upa&f list"
+  - "&8- &7查看当前前缀列表。"
+  - "&8#/upa&f reload"
+  - "&8- &7重载前缀配置。"
+list-title:
+  - "&3&l用户前缀系统 &f前缀列表"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7显示名 &r%(name) &7权限 &r%(permission)"
+  - "&8- &7内容示例&r %(content) %(sender_name)"
+```
+
+### [前缀配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/prefixes/example-prefix.yml) (prefixes/*.yml)
+所有前缀均为单独的配置文件，存放于 `插件配置目录/prefixes` 下，便于管理。
+
+文件名理论上可以随便取，推荐使用英文，部分符号可能会影响正常读取，请避免使用。
+
+```yaml
+# 唯一标识 [必须]
+# 将用于记录玩家所选的前缀，以及用于数据的缓存。
+# 必须 必须 必须 保持唯一！
+identifier: "pro"
+
+# 名字 [必须]
+# 切换的时候左下角会弹提示 用的就是这个名字
+name: "&b&lPro&b"
+
+# 内容 [必须]
+# 显示在名字前面的内容
+content: "§b§lPro §b"
+
+# 权重 [必须]
+# 用于GUI、TabList的排序和自动前缀显示
+# 在GUI中，权重越高的会显示在越后面
+# 在TabList中，权重越高的会显示在越上面
+weight: 1
+
+# 检测的权限 [非必须]
+# 如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
+permission: "yc.pro"
+
+# 有权限时显示的物品  [必须]
+# 当用户有权限且未选中时，会显示该物品
+itemHasPermission: #
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a➥ 点击切换到该前缀"
+
+# 正在使用时显示的物品 [非必需]
+# 当用户正在使用时会显示这个物品，不配置即自动加载“itemHasPermission”
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a✔ 您正在使用该前缀"
+
+# 没有权限时显示的物品 [非必需]
+# 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: INK_SACK
+  damage: 8
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
+    lore:
+      - "§7Pro+会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - "§f您可以输入 §b/vip §f指令查看详细特权！"
+      - ""
+      - "§e✯ 加入Pro+会员以使用该前缀！"
+```
+
+
 ## 支持与捐赠

 本项目由 [YourCraft(你的世界)](https://www.ycraft.cn) 团队提供长期支持与维护。
@@ -205,9 +301,33 @@ prefixes:

 感谢您成为开源项目的支持者！

-<img height=25% width=25% src="https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/PAY.jpg" />
+<img height=25% width=25% src="https://raw.githubusercontent.com/CarmJos/CarmJos/main/img/donate-code.jpg"  alt=""/>

 ## 开源协议

 本项目源码采用 [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0) 开源协议。
+> ### 关于 GPL 协议
+> GNU General Public Licence (GPL) 有可能是开源界最常用的许可模式。GPL 保证了所有开发者的权利，同时为使用者提供了足够的复制，分发，修改的权利：
+>
+> #### 可自由复制
+> 你可以将软件复制到你的电脑，你客户的电脑，或者任何地方。复制份数没有任何限制。
+> #### 可自由分发
+> 在你的网站提供下载，拷贝到U盘送人，或者将源代码打印出来从窗户扔出去（环保起见，请别这样做）。
+> #### 可以用来盈利
+> 你可以在分发软件的时候收费，但你必须在收费前向你的客户提供该软件的 GNU GPL 许可协议，以便让他们知道，他们可以从别的渠道免费得到这份软件，以及你收费的理由。
+> #### 可自由修改
+> 如果你想添加或删除某个功能，没问题，如果你想在别的项目中使用部分代码，也没问题，唯一的要求是，使用了这段代码的项目也必须使用 GPL 协议。
+>
+> 需要注意的是，分发的时候，需要明确提供源代码和二进制文件，另外，用于某些程序的某些协议有一些问题和限制，你可以看一下 @PierreJoye 写的 Practical Guide to GPL Compliance 一文。使用 GPL 协议，你必须在源代码代码中包含相应信息，以及协议本身。
+> 
+> *以上文字来自 [五种开源协议GPL,LGPL,BSD,MIT,Apache](https://www.oschina.net/question/54100_9455) 。*

+```text
+ _    _                   _____              __  _       
+| |  | |                 |  __ \            / _|(_)      
+| |  | | ___   ___  _ __ | |__) |_ __  ___ | |_  _ __  __
+| |  | |/ __| / _ \| '__||  ___/| '__|/ _ \|  _|| |\ \/ /
+| |__| |\__ \|  __/| |   | |    | |  |  __/| |  | | >  < 
+ \____/ |___/ \___||_|   |_|    |_|   \___||_|  |_|/_/\_\
+                                                         
+```
@@ -5,13 +5,50 @@
    <modelVersion>4.0.0</modelVersion>

    <groupId>cc.carm.plugin</groupId>
-    <artifactId>UserPrefix</artifactId>
-    <version>1.2.4</version>
+    <artifactId>userprefix</artifactId>
+    <version>2.1.8</version>
+
+    <name>UserPrefix</name>
+    <description>轻便、高效、实时的用户前缀系统。</description>
+    <url>https://github.com/CarmJos/UserPrefix</url>
+
+    <issueManagement>
+        <system>GitHub Issues</system>
+        <url>${project.url}/issues</url>
+    </issueManagement>
+
+    <ciManagement>
+        <system>GitHub Actions</system>
+        <url>${project.url}/actions/workflows/maven.yml</url>
+    </ciManagement>
+
+    <developers>
+        <developer>
+            <id>CarmJos</id>
+            <name>Carm Jos</name>
+            <email>carm@carm.cc</email>
+            <url>https://work.carm.cc</url>
+            <roles>
+                <role>Main Developer</role>
+            </roles>
+        </developer>
+    </developers>
+
+    <organization>
+        <name>YourCraft你的世界</name>
+        <url>https://www.ycraft.cn/</url>
+    </organization>
+
+    <licenses>
+        <license>
+            <name>GNU General Public License v3.0</name>
+            <url>https://opensource.org/licenses/GPL-3.0</url>
+        </license>
+    </licenses>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
-        <maven.deploy.skip>true</maven.deploy.skip>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
    </properties>
@@ -19,8 +56,8 @@
    <repositories>

        <repository>
-            <id>spigotmc-repo</id>
-            <url>https://hub.spigotmc.org/nexus/content/repositories/public/</url>
+            <id>spigot-repo</id>
+            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
        </repository>

        <repository>
@@ -28,11 +65,6 @@
            <url>https://repo.extendedclip.com/content/repositories/placeholderapi/</url>
        </repository>

-        <repository>
-            <id>lss233-repo</id>
-            <url>https://lss233.littleservice.cn/repositories/minecraft</url>
-        </repository>
-
        <repository>
            <id>oss-repo</id>
            <url>https://oss.sonatype.org/content/groups/public/</url>
@@ -47,13 +79,29 @@
            <id>maven-central</id>
            <url>https://repo1.maven.org/maven2/</url>
        </repository>
+
+        <repository>
+            <id>github</id>
+            <name>GitHub Packages</name>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
+        </repository>
    </repositories>

+    <distributionManagement>
+        <downloadUrl>${project.url}/releases</downloadUrl>
+        <repository>
+            <id>github</id>
+            <name>GitHub Packages</name>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
+        </repository>
+    </distributionManagement>
+
+
    <dependencies>

        <dependency>
            <groupId>org.spigotmc</groupId>
-            <artifactId>spigot</artifactId>
+            <artifactId>spigot-api</artifactId>
            <version>1.17-R0.1-SNAPSHOT</version>
            <scope>provided</scope>
        </dependency>
@@ -75,13 +123,90 @@
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
-            <version>4.13</version>
+            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>

    </dependencies>
    <build>
        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <version>3.2.0</version>
+                <configuration>
+                    <classifier>javadoc</classifier>
+                    <links>
+                        <link>https://javadoc.io/doc/org.jetbrains/annotations/</link>
+                    </links>
+                    <detectJavaApiLink>true</detectJavaApiLink>
+                    <encoding>UTF-8</encoding>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>attach-javadocs</id>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.8.1</version>
+                <configuration>
+                    <source>1.8</source>
+                    <target>1.8</target>
+                    <encoding>UTF-8</encoding>
+                    <compilerArgument>-parameters</compilerArgument>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.2.0</version>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-source-plugin</artifactId>
+                <version>3.2.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>jar-no-fork</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.2.3</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+                <configuration>
+                    <filters>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/MANIFEST.MF</exclude>
+                                <exclude>META-INF/*.txt</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
+                </configuration>
+            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
@@ -91,82 +216,6 @@
                </configuration>
            </plugin>
        </plugins>
-        <pluginManagement>
-            <plugins>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.2.0</version>
-                    <configuration>
-                        <classifier>javadoc</classifier>
-                        <links>
-                            <link>https://javadoc.io/doc/org.jetbrains/annotations/</link>
-                        </links>
-                        <detectJavaApiLink>true</detectJavaApiLink>
-                        <encoding>UTF-8</encoding>
-                    </configuration>
-                    <executions>
-                        <execution>
-                            <id>attach-javadocs</id>
-                            <goals>
-                                <goal>jar</goal>
-                            </goals>
-                        </execution>
-                    </executions>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-compiler-plugin</artifactId>
-                    <version>3.8.1</version>
-                    <configuration>
-                        <source>1.8</source>
-                        <target>1.8</target>
-                        <encoding>UTF-8</encoding>
-                        <compilerArgument>-parameters</compilerArgument>
-                    </configuration>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-jar-plugin</artifactId>
-                    <version>3.2.0</version>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.2.3</version>
-                    <executions>
-                        <execution>
-                            <phase>package</phase>
-                            <goals>
-                                <goal>shade</goal>
-                            </goals>
-                            <configuration>
-                                <createDependencyReducedPom>false</createDependencyReducedPom>
-                            </configuration>
-                        </execution>
-                    </executions>
-                    <configuration>
-                        <filters>
-                            <filter>
-                                <artifact>*:*</artifact>
-                                <excludes>
-                                    <exclude>META-INF/MANIFEST.MF</exclude>
-                                    <exclude>META-INF/*.txt</exclude>
-                                </excludes>
-                            </filter>
-                        </filters>
-                    </configuration>
-                </plugin>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-surefire-plugin</artifactId>
-                    <version>2.22.1</version>
-                    <configuration>
-                        <useSystemClassLoader>false</useSystemClassLoader>
-                    </configuration>
-                </plugin>
-            </plugins>
-        </pluginManagement>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
@@ -4,6 +4,7 @@ import cc.carm.plugin.userprefix.command.UserPrefixAdminCommand;
 import cc.carm.plugin.userprefix.command.UserPrefixCommand;
 import cc.carm.plugin.userprefix.configuration.PrefixConfig;
 import cc.carm.plugin.userprefix.hooker.UserPrefixExpansion;
+import cc.carm.plugin.userprefix.listener.ChatListener;
 import cc.carm.plugin.userprefix.listener.UserListener;
 import cc.carm.plugin.userprefix.listener.processor.UserNodeUpdateProcessor;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
@@ -14,91 +15,124 @@ import cc.carm.plugin.userprefix.util.ColorParser;
 import cc.carm.plugin.userprefix.util.MessageUtil;
 import net.luckperms.api.event.user.UserDataRecalculateEvent;
 import org.bukkit.Bukkit;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.PluginCommand;
+import org.bukkit.command.TabCompleter;
 import org.bukkit.event.Listener;
 import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;

 public class Main extends JavaPlugin {

-    private static Main instance;
+	private static Main instance;

-    @Override
-    public void onEnable() {
-        instance = this;
+	@Override
+	public void onEnable() {
+		instance = this;
+		showPluginName();
+		log(getName() + " " + getDescription().getVersion() + " &7开始加载...");
+		long startTime = System.currentTimeMillis();

-        log(getName() + " " + getDescription().getVersion() + " &7开始加载...");
-        long startTime = System.currentTimeMillis();
+		log("加载配置文件...");
+		ConfigManager.initConfig();
+		PrefixManager.init();

-        log("加载配置文件...");
-        ConfigManager.initConfig();
-        PrefixManager.init();
+		log("注册指令...");
+		registerCommand("UserPrefix", new UserPrefixCommand());
+		registerCommand("UserPrefixAdmin", new UserPrefixAdminCommand());

-        log("注册指令...");
-        Bukkit.getPluginCommand("UserPrefix").setExecutor(new UserPrefixCommand());
-        Bukkit.getPluginCommand("UserPrefixAdmin").setExecutor(new UserPrefixAdminCommand());
+		log("注册监听器...");
+		regListener(new UserListener());
+		regListener(new ChatListener());
+		ServiceManager.getService().getEventBus().subscribe(this, UserDataRecalculateEvent.class, UserNodeUpdateProcessor::process);

-        log("注册监听器...");
-        regListener(new UserListener());
-        ServiceManager.getService().getEventBus().subscribe(this, UserDataRecalculateEvent.class, UserNodeUpdateProcessor::process);
-
-        if (MessageUtil.hasPlaceholderAPI()) {
-            log("注册变量...");
-            new UserPrefixExpansion(getInstance()).register();
-        } else {
-            log("未安装 PlaceholderAPI 不进行变量注册...");
-            log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
-        }
+		if (MessageUtil.hasPlaceholderAPI()) {
+			log("注册变量...");
+			new UserPrefixExpansion(getInstance()).register();
+		} else {
+			log("未安装 PlaceholderAPI 不进行变量注册...");
+			log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
+		}


-        log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+		log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");

-        showAD();
+		showAD();

-        if (Bukkit.getOnlinePlayers().size() > 0) {
-            Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
-        }
+		if (Bukkit.getOnlinePlayers().size() > 0) {
+			Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
+		}

-    }
+	}

-    @Override
-    public void onDisable() {
-        log(getName() + " " + getDescription().getVersion() + " 开始卸载...");
-        long startTime = System.currentTimeMillis();
+	@Override
+	public void onDisable() {
+		showPluginName();
+		log(getName() + " " + getDescription().getVersion() + " 开始卸载...");
+		long startTime = System.currentTimeMillis();

-        log("卸载监听器...");
-        Bukkit.getServicesManager().unregisterAll(this);
+		log("卸载监听器...");
+		Bukkit.getServicesManager().unregisterAll(this);

-        log("卸载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+		log("卸载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");

-        showAD();
+		showAD();

-    }
+	}

-    /**
-     * 注册监听器
-     *
-     * @param listener 监听器
-     */
-    public static void regListener(Listener listener) {
-        Bukkit.getPluginManager().registerEvents(listener, getInstance());
-    }
+	/**
+	 * 注册监听器
+	 *
+	 * @param listener 监听器
+	 */
+	public static void regListener(Listener listener) {
+		Bukkit.getPluginManager().registerEvents(listener, getInstance());
+	}

-    public static void log(String message) {
-        Bukkit.getConsoleSender().sendMessage(ColorParser.parse("[" + getInstance().getName() + "] " + message));
-    }
+	public static void log(String message) {
+		Bukkit.getConsoleSender().sendMessage(ColorParser.parse("[" + getInstance().getName() + "] " + message));
+	}

-    public static void debug(String message) {
-        if (PrefixConfig.DEBUG.get()) {
-            log("[DEBUG] " + message);
-        }
-    }
+	public static void debug(String message) {
+		if (PrefixConfig.DEBUG.get()) {
+			log("[DEBUG] " + message);
+		}
+	}

-    public static JavaPlugin getInstance() {
-        return instance;
-    }
+	public static JavaPlugin getInstance() {
+		return instance;
+	}

-    private void showAD() {
-        log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
-        log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
-    }
+
+	public static void registerCommand(String commandName,
+									   @NotNull CommandExecutor executor) {
+		registerCommand(commandName, executor, null);
+	}
+
+	public static void registerCommand(String commandName,
+									   @NotNull CommandExecutor executor,
+									   @Nullable TabCompleter tabCompleter) {
+		PluginCommand command = Bukkit.getPluginCommand(commandName);
+		if (command == null) return;
+		command.setExecutor(executor);
+		if (tabCompleter != null) command.setTabCompleter(tabCompleter);
+	}
+
+	private void showPluginName() {
+		log("&b _    _                  &f _____              __  _      ");
+		log("&b| |  | |                 &f|  __ \\            / _|(_)    ");
+		log("&b| |  | | ___   ___  _ __ &f| |__) |_ __  ___ | |_  _ __  __");
+		log("&b| |  | |/ __| / _ \\| '__|&f|  ___/| '__|/ _ \\|  _|| |\\ \\/ /");
+		log("&b| |__| |\\__ \\|  __/| |   &f| |    | |  |  __/| |  | | >  < ");
+		log("&b \\____/ |___/ \\___||_|   &f|_|    |_|   \\___||_|  |_|/_/\\_\\");
+		log("&8  ");
+		log("&8> &f" + getDescription().getWebsite());
+	}
+
+	private void showAD() {
+		log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
+		log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
+	}

 }
@@ -1,5 +1,6 @@
 package cc.carm.plugin.userprefix.command;

+import cc.carm.plugin.userprefix.configuration.PrefixConfig;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import cc.carm.plugin.userprefix.manager.PrefixManager;
 import cc.carm.plugin.userprefix.manager.UserManager;
@@ -21,18 +22,28 @@ public class UserPrefixAdminCommand implements CommandExecutor {
        if (args.length == 1) {
            String aim = args[0];
            if (aim.equalsIgnoreCase("list")) {
-                MessageUtil.send(sender, "&3&l用户前缀系统 &f前缀列表");
+                MessageUtil.sendWithPlaceholders(sender, PrefixConfig.Messages.LIST_TITLE.get());
                for (ConfiguredPrefix value : PrefixManager.getPrefixes().values()) {
-                    MessageUtil.send(sender, "&8#" + value.getWeight() + " &f" + value.getIdentifier());
-                    MessageUtil.send(sender, "&8- &7显示名 &r" + value.getName() + (value.isPublic() ? "" : " &7权限&r " + value.getPermission()));
-                    MessageUtil.send(sender, "&8- &7内容示例&r " + value.getContent() + sender.getName());
+                    MessageUtil.sendWithPlaceholders(
+                            sender, PrefixConfig.Messages.LIST_VALUE.get(),
+                            new String[]{
+                                    "%(weight)", "%(identifier)",
+                                    "%(name)", "%(permission)",
+                                    "%(content)", "%(sender_name)"
+                            },
+                            new Object[]{
+                                    value.getWeight(), value.getIdentifier(),
+                                    value.getName(), value.getPermission(),
+                                    value.getContent(), sender.getName()
+                            }
+                    );
                }
                return true;
            } else if (aim.equalsIgnoreCase("reload")) {
                long s1 = System.currentTimeMillis();
                PrefixSelectGUI.closeAll(); // 关掉所有正在显示的前缀列表
-                ConfigManager.reloadConfig(); // 重载配置文件
-                PrefixManager.loadConfiguredPrefixes(); //加载重载后了的配置文件
+                ConfigManager.reload(); // 重载配置文件
+                PrefixManager.loadPrefixes(); //加载重载后了的前缀配置
                for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
                    UserManager.checkPrefix(onlinePlayer, false);
                    /*
@@ -42,7 +53,10 @@ public class UserPrefixAdminCommand implements CommandExecutor {
                     */
                    UserManager.updatePrefixView(onlinePlayer, false);
                }
-                MessageUtil.send(sender, "&a&l重载完成！&7共耗时 &f" + (System.currentTimeMillis() - s1) + " ms&7。");
+                MessageUtil.sendWithPlaceholders(
+                        sender, PrefixConfig.Messages.RELOAD.get(),
+                        new String[]{"%(time)"}, new Object[]{(System.currentTimeMillis() - s1)}
+                );
                return true;
            }
            return help(sender);
@@ -51,11 +65,7 @@ public class UserPrefixAdminCommand implements CommandExecutor {
    }

    public static boolean help(CommandSender sender) {
-        MessageUtil.send(sender, "&3&l用户前缀系统 &f帮助");
-        MessageUtil.send(sender, "&8#&f list");
-        MessageUtil.send(sender, "&8- &7查看当前前缀列表。");
-        MessageUtil.send(sender, "&8#&f reload");
-        MessageUtil.send(sender, "&8- &7重载前缀配置。");
+        MessageUtil.send(sender, PrefixConfig.Messages.HELP.get());
        return true;
    }

@@ -1,6 +1,7 @@
 package cc.carm.plugin.userprefix.command;

 import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
+import org.bukkit.Bukkit;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandExecutor;
 import org.bukkit.command.CommandSender;
@@ -14,6 +15,15 @@ public class UserPrefixCommand implements CommandExecutor {
    public boolean onCommand(@NotNull CommandSender sender, @NotNull Command command, @NotNull String s, @NotNull String[] strings) {
        if (sender instanceof Player) {
            PrefixSelectGUI.open((Player) sender);
+        } else {
+            if (strings.length != 1) {
+                sender.sendMessage("输入 /prefix <ID> 为玩家打开前缀GUI。");
+            } else {
+                Player player = Bukkit.getPlayer(strings[0]);
+                if (player != null) {
+                    PrefixSelectGUI.open(player);
+                }
+            }
        }
        return true;
    }
@@ -1,32 +1,71 @@
 package cc.carm.plugin.userprefix.configuration;

+import cc.carm.plugin.userprefix.configuration.message.ConfigMessageList;
 import cc.carm.plugin.userprefix.configuration.values.ConfigSound;
 import cc.carm.plugin.userprefix.configuration.values.ConfigValue;
-import cc.carm.plugin.userprefix.configuration.values.ConfigValueList;
+import cc.carm.plugin.userprefix.util.ItemStackFactory;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;

 public class PrefixConfig {

    public static ConfigValue<Boolean> DEBUG = new ConfigValue<>("debug", Boolean.class, false);

+    public static class CustomStorage {
+
+        public static ConfigValue<Boolean> ENABLE = new ConfigValue<>("custom-storage.enable", Boolean.class, false);
+
+        public static ConfigValue<String> PATH = new ConfigValue<>("custom-storage.path", String.class, "prefixes/");
+
+    }
+
    public static class Functions {

        public static ConfigValue<Boolean> NAME_PREFIX = new ConfigValue<>("functions.OnNamePrefix", Boolean.class, true);
        public static ConfigValue<Boolean> AUTO_USE = new ConfigValue<>("functions.autoUsePrefix", Boolean.class, true);

+        public static class Chat {
+
+            public static ConfigValue<Boolean> ENABLE = new ConfigValue<>("functions.chat.enable", Boolean.class, false);
+            public static ConfigValue<String> FORMAT = new ConfigValue<>("functions.chat.format", String.class, "<%1$s> %2$s");
+
+        }
+
    }

    public static class GUI {

        public static ConfigValue<String> TITLE = new ConfigValue<>("GUI.title", String.class, "&f&l我的前缀 &8| 列表");

+        public static class Items {
+
+            public static ConfigValue<ItemStack> NEXT_PAGE = new ConfigValue<>("GUI.items.next-page", ItemStack.class,
+                    new ItemStackFactory(Material.ARROW)
+                            .setDisplayName("下一页")
+                            .addLore("&7&o右键可前往最后一页哦")
+                            .toItemStack()
+            );
+            public static ConfigValue<ItemStack> PREVIOUS_PAGE = new ConfigValue<>("GUI.items.previous-page", ItemStack.class,
+                    new ItemStackFactory(Material.ARROW)
+                            .setDisplayName("上一页")
+                            .addLore("&7&o右键可前往第一页哦")
+                            .toItemStack()
+            );
+
+        }
+
    }

    public static class Messages {

-        public static ConfigValueList<String> SELECTED = new ConfigValueList<>("messages.selected", String.class);
-        public static ConfigValueList<String> EXPIRED = new ConfigValueList<>("messages.expired", String.class);
+        public static ConfigMessageList SELECTED = new ConfigMessageList("selected");
+        public static ConfigMessageList EXPIRED = new ConfigMessageList("expired");

+        public static ConfigMessageList RELOAD = new ConfigMessageList("reload");
+        public static ConfigMessageList HELP = new ConfigMessageList("help");

+        public static ConfigMessageList LIST_TITLE = new ConfigMessageList("list-title");
+        public static ConfigMessageList LIST_VALUE = new ConfigMessageList("list-value");
    }

    public static class Sounds {
@@ -0,0 +1,64 @@
+package cc.carm.plugin.userprefix.configuration.file;
+
+
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.bukkit.plugin.java.JavaPlugin;
+
+import java.io.File;
+import java.io.IOException;
+
+public class FileConfig {
+
+    private final JavaPlugin plugin;
+
+    private final String fileName;
+
+    private File file;
+    private FileConfiguration config;
+
+    public FileConfig(final JavaPlugin plugin) {
+        this(plugin, "config.yml");
+    }
+
+    public FileConfig(final JavaPlugin plugin, final String name) {
+        this.plugin = plugin;
+        this.fileName = name;
+        initFile();
+    }
+
+    private void initFile() {
+        this.file = new File(plugin.getDataFolder(), fileName);
+        if (!this.file.exists()) {
+            if (!this.file.getParentFile().exists()) {
+                this.file.getParentFile().mkdirs();
+            }
+            plugin.saveResource(fileName, true);
+        }
+        this.config = YamlConfiguration.loadConfiguration(this.file);
+    }
+
+    public File getFile() {
+        return file;
+    }
+
+    public FileConfiguration getConfig() {
+        return config;
+    }
+
+    public void save() {
+        try {
+            getConfig().save(getFile());
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
+    }
+
+    public void reload() {
+        if (getFile().exists()) {
+            this.config = YamlConfiguration.loadConfiguration(getFile());
+        } else {
+            initFile();
+        }
+    }
+}
@@ -0,0 +1,32 @@
+package cc.carm.plugin.userprefix.configuration.message;
+
+import cc.carm.plugin.userprefix.configuration.values.ConfigValue;
+import cc.carm.plugin.userprefix.manager.ConfigManager;
+import cc.carm.plugin.userprefix.util.MessageUtil;
+import org.bukkit.command.CommandSender;
+
+import java.util.Arrays;
+
+public class ConfigMessage extends ConfigValue<String> {
+
+    public ConfigMessage(String configSection) {
+        this(configSection, null);
+    }
+
+    public ConfigMessage(String configSection, String defaultValue) {
+        super(ConfigManager.getMessageConfig(), configSection, String.class, defaultValue);
+    }
+
+    public void send(CommandSender sender) {
+        MessageUtil.send(sender, get());
+    }
+
+    public void sendWithPlaceholders(CommandSender sender) {
+        MessageUtil.sendWithPlaceholders(sender, get());
+    }
+
+    public void sendWithPlaceholders(CommandSender sender, String[] params, Object[] values) {
+        MessageUtil.sendWithPlaceholders(sender, Arrays.asList(get()), params, values);
+    }
+
+}
@@ -0,0 +1,29 @@
+package cc.carm.plugin.userprefix.configuration.message;
+
+import cc.carm.plugin.userprefix.configuration.values.ConfigValueList;
+import cc.carm.plugin.userprefix.manager.ConfigManager;
+import cc.carm.plugin.userprefix.util.MessageUtil;
+import org.bukkit.command.CommandSender;
+
+public class ConfigMessageList extends ConfigValueList<String> {
+
+    public ConfigMessageList(String configSection) {
+        super(ConfigManager.getMessageConfig(), configSection, String.class);
+    }
+
+    public ConfigMessageList(String configSection, String[] defaultValue) {
+        super(ConfigManager.getMessageConfig(), configSection, String.class, defaultValue);
+    }
+
+    public void send(CommandSender sender) {
+        MessageUtil.send(sender, get());
+    }
+
+    public void sendWithPlaceholders(CommandSender sender) {
+        MessageUtil.sendWithPlaceholders(sender, get());
+    }
+
+    public void sendWithPlaceholders(CommandSender sender, String[] params, Object[] values) {
+        MessageUtil.sendWithPlaceholders(sender, get(), params, values);
+    }
+}
@@ -1,13 +1,16 @@
 package cc.carm.plugin.userprefix.configuration.values;

 import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.configuration.file.FileConfig;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import org.bukkit.Sound;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.entity.Player;

 public class ConfigSound {
-    FileConfiguration source;
+
+
+    FileConfig source;
    String configSection;

    Sound defaultValue;
@@ -17,18 +20,26 @@ public class ConfigSound {
    }

    public ConfigSound(String configSection, Sound defaultValue) {
-        this.source = ConfigManager.getConfig();
+        this(ConfigManager.getPluginConfig(), configSection, defaultValue);
+    }
+
+    public ConfigSound(FileConfig source, String configSection, Sound defaultValue) {
+        this.source = source;
        this.configSection = configSection;
        this.defaultValue = defaultValue;
    }

+    public FileConfiguration getConfiguration() {
+        return this.source.getConfig();
+    }
+
    public void set(Sound value, float volume) {
-        this.source.set(this.configSection, value.name() + ":" + volume);
+        getConfiguration().set(this.configSection, value.name() + ":" + volume);
        this.save();
    }

    public void set(Sound value, float volume, float pitch) {
-        this.source.set(this.configSection, value.name() + ":" + volume + ":" + pitch);
+        getConfiguration().set(this.configSection, value.name() + ":" + volume + ":" + pitch);
        this.save();
    }

@@ -36,7 +47,7 @@ public class ConfigSound {
        Sound finalSound = defaultValue;
        float pitch = 1;
        float volume = 1;
-        String soundString = this.source.getString(this.configSection);
+        String soundString = getConfiguration().getString(this.configSection);
        if (soundString != null) {
            String[] args = soundString.contains(":") ? soundString.split(":") : new String[]{soundString};
            try {
@@ -54,7 +65,7 @@ public class ConfigSound {
    }

    public void save() {
-        ConfigManager.saveConfig();
+        this.source.save();
    }

 }
@@ -1,10 +1,13 @@
 package cc.carm.plugin.userprefix.configuration.values;

+import cc.carm.plugin.userprefix.configuration.file.FileConfig;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import org.bukkit.configuration.file.FileConfiguration;

 public class ConfigValue<V> {
-    FileConfiguration source;
+
+    FileConfig source;
+
    String configSection;
    Class<V> clazz;
    V defaultValue;
@@ -14,24 +17,42 @@ public class ConfigValue<V> {
    }

    public ConfigValue(String configSection, Class<V> clazz, V defaultValue) {
-        this.source = ConfigManager.getConfig();
+        this(ConfigManager.getPluginConfig(), configSection, clazz, defaultValue);
+    }
+
+    public ConfigValue(FileConfig source, String configSection, Class<V> clazz, V defaultValue) {
+        this.source = source;
        this.configSection = configSection;
        this.clazz = clazz;
        this.defaultValue = defaultValue;
    }

+    public FileConfiguration getConfiguration() {
+        return this.source.getConfig();
+    }
+
    public V get() {
-        Object val = this.source.get(this.configSection, this.defaultValue);
-        return this.clazz.isInstance(val) ? this.clazz.cast(val) : this.defaultValue;
+        if (getConfiguration().contains(this.configSection)) {
+            Object val = getConfiguration().get(this.configSection, this.defaultValue);
+            return this.clazz.isInstance(val) ? this.clazz.cast(val) : this.defaultValue;
+        } else {
+            // 如果没有默认值，就把配置写进去，便于配置
+            return setDefault();
+        }
    }

    public void set(V value) {
-        this.source.set(this.configSection, value);
+        getConfiguration().set(this.configSection, value);
        this.save();
    }

    public void save() {
-        ConfigManager.saveConfig();
+        this.source.save();
+    }
+
+    public V setDefault() {
+        set(this.defaultValue);
+        return this.defaultValue;
    }

 }
@@ -1,26 +1,52 @@
 package cc.carm.plugin.userprefix.configuration.values;

+import cc.carm.plugin.userprefix.configuration.file.FileConfig;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import org.bukkit.configuration.file.FileConfiguration;

 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;

 public class ConfigValueList<V> {
-    FileConfiguration source;
+    FileConfig source;
    String configSection;
    Class<V> clazz;

+    V[] defaultValue;
+
    public ConfigValueList(String configSection, Class<V> clazz) {
-        this.source = ConfigManager.getConfig();
-        this.configSection = configSection;
-        this.clazz = clazz;
+        this(ConfigManager.getPluginConfig(), configSection, clazz);
    }

+    public ConfigValueList(String configSection, Class<V> clazz, V[] defaultValue) {
+        this(ConfigManager.getPluginConfig(), configSection, clazz, defaultValue);
+    }
+
+    public ConfigValueList(FileConfig configuration, String configSection, Class<V> clazz) {
+        this(configuration, configSection, clazz, null);
+    }
+
+    public ConfigValueList(FileConfig configuration, String configSection, Class<V> clazz, V[] defaultValue) {
+        this.source = configuration;
+        this.configSection = configSection;
+        this.clazz = clazz;
+        this.defaultValue = defaultValue;
+    }
+
+    public FileConfiguration getConfiguration() {
+        return this.source.getConfig();
+    }
+
+
    public ArrayList<V> get() {
-        List<?> list = this.source.getList(this.configSection);
+        List<?> list = getConfiguration().getList(this.configSection);
        if (list == null) {
-            return new ArrayList(0);
+            if (defaultValue != null) {
+                return new ArrayList<>(Arrays.asList(defaultValue));
+            } else {
+                return new ArrayList(0);
+            }
        } else {
            ArrayList<V> result = new ArrayList();

@@ -29,17 +55,17 @@ public class ConfigValueList<V> {
                    result.add(this.clazz.cast(object));
                }
            }
-
            return result;
        }
    }

    public void set(ArrayList<V> value) {
-        this.source.set(this.configSection, value);
+        getConfiguration().set(this.configSection, value);
        this.save();
    }

    public void save() {
-        ConfigManager.saveConfig();
+        this.source.save();
    }
+
 }
@@ -0,0 +1,32 @@
+package cc.carm.plugin.userprefix.listener;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.util.MessageUtil;
+import me.clip.placeholderapi.PlaceholderAPI;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.AsyncPlayerChatEvent;
+
+public class ChatListener implements Listener {
+
+    @EventHandler
+    public void onChat(AsyncPlayerChatEvent event) {
+        if (!PrefixConfig.Functions.Chat.ENABLE.get()) return;
+        String format = PrefixConfig.Functions.Chat.FORMAT.get();
+        if (format == null || format.length() < 1) return;
+
+        if (!MessageUtil.hasPlaceholderAPI()) return;
+
+        try {
+            event.setFormat(PlaceholderAPI.setPlaceholders(event.getPlayer(), format));
+        } catch (Exception exception) {
+            Main.log("Please check the chat configuration.");
+            Main.log("请检查配置文件中聊天相关是否配置正确。");
+            exception.printStackTrace();
+        }
+
+    }
+
+
+}
@@ -1,30 +1,47 @@
 package cc.carm.plugin.userprefix.manager;

 import cc.carm.plugin.userprefix.Main;
-import org.bukkit.configuration.file.FileConfiguration;
+import cc.carm.plugin.userprefix.configuration.file.FileConfig;
+
+import java.io.File;

 public class ConfigManager {

-    private static FileConfiguration config;
+    private static FileConfig config;
+    private static FileConfig messageConfig;
+

    public static void initConfig() {
-        Main.getInstance().saveDefaultConfig();
-        Main.getInstance().reloadConfig();
+        File configFile = new File(Main.getInstance().getDataFolder(), "config.yml");
+        if (!configFile.exists()) {
+            //没找到配置文件，可能是第一次加载此插件
+            //把一些英文版的东西复制出来，方便英文用户使用。
+            Main.getInstance().saveResource("prefixes/example-prefix.yml", false);
+            Main.getInstance().saveResource("en_US/config.yml", false);
+            Main.getInstance().saveResource("en_US/messages.yml", false);
+            Main.getInstance().saveResource("en_US/example-prefix.yml", false);
+        }

-        config = Main.getInstance().getConfig();
+        ConfigManager.config = new FileConfig(Main.getInstance(), "config.yml");
+        ConfigManager.messageConfig = new FileConfig(Main.getInstance(), "messages.yml");
    }

-    public static FileConfiguration getConfig() {
+    public static FileConfig getPluginConfig() {
        return config;
    }

-    public static void reloadConfig() {
-        Main.getInstance().reloadConfig();
-        config = Main.getInstance().getConfig();
+    public static FileConfig getMessageConfig() {
+        return messageConfig;
+    }
+
+    public static void reload() {
+        getPluginConfig().reload();
+        getMessageConfig().reload();
    }

    public static void saveConfig() {
-        Main.getInstance().saveConfig();
+        getPluginConfig().save();
+        getMessageConfig().save();
    }


@@ -1,6 +1,7 @@
 package cc.carm.plugin.userprefix.manager;

 import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.configuration.PrefixConfig;
 import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
 import cc.carm.plugin.userprefix.util.ItemStackFactory;
 import org.bukkit.Material;
@@ -11,6 +12,8 @@ import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

+import java.io.File;
+import java.util.Arrays;
 import java.util.Comparator;
 import java.util.HashMap;
 import java.util.List;
@@ -21,45 +24,50 @@ public class PrefixManager {
    public static ConfiguredPrefix defaultPrefix;
    public static HashMap<String, ConfiguredPrefix> prefixes = new HashMap<>();

+    private static final String FOLDER_NAME = "prefixes";

    public static void init() {
-        loadConfiguredPrefixes();
+        loadPrefixes();
        Main.log("共加载了 " + prefixes.size() + " 个前缀。");
    }

-    public static void loadConfiguredPrefixes() {
+    public static void loadPrefixes() {
        loadDefaultPrefix();
+        loadConfiguredPrefixes();
+    }

-        ConfigurationSection prefixesSection = ConfigManager.getConfig().getConfigurationSection("prefixes");
-        if (prefixesSection == null || prefixesSection.getKeys(false).isEmpty()) {
-            Main.log("配置文件中暂无任何前缀配置，请检查。");
+    public static void loadConfiguredPrefixes() {
+
+        File prefixDataFolder = getStorageFolder();
+        if (!prefixDataFolder.isDirectory() || !prefixDataFolder.exists()) {
+            prefixDataFolder.mkdir();
+        }
+
+        String[] filesList = prefixDataFolder.list();
+        if (filesList == null || filesList.length < 1) {
+            Main.log("配置文件夹中暂无任何前缀配置问，请检查。");
+            Main.log("There's no configured prefix.");
+            Main.log("Path: " + prefixDataFolder.getAbsolutePath());
            return;
        }

+        List<File> files = Arrays.stream(filesList)
+                .map(s -> new File(prefixDataFolder, s))
+                .filter(File::isFile)
+                .collect(Collectors.toList());
+
        HashMap<String, ConfiguredPrefix> dataPrefixes = new HashMap<>();

-        for (String prefixIdentifier : prefixesSection.getKeys(false)) {
-            ConfigurationSection configuredPrefixSection = prefixesSection.getConfigurationSection(prefixIdentifier);
-            if (configuredPrefixSection == null) continue;
-            try {
-                String name = configuredPrefixSection.getString("name", "前缀名配置错误");
-                String content = configuredPrefixSection.getString("content", "&r");
-                String permission = configuredPrefixSection.getString("permission");
-                int weight = configuredPrefixSection.getInt("weight", 1);
-
-                ItemStack itemHasPermission = configuredPrefixSection.getItemStack("itemHasPermission",
-                        new ItemStackFactory(Material.STONE).setDisplayName(name).addLore(" ").addLore("§a➥ 点击切换到该前缀").toItemStack()
-                );
-                ItemStack itemNoPermission = configuredPrefixSection.getItemStack("itemNoPermission", itemHasPermission);
-                ItemStack itemUsing = configuredPrefixSection.getItemStack("itemUsing", itemHasPermission);
-
-
-                Main.log("完成前缀加载 " + prefixIdentifier + " : " + name);
-
-                dataPrefixes.put(prefixIdentifier, new ConfiguredPrefix(prefixIdentifier, name, content, weight, permission, itemHasPermission, itemNoPermission, itemUsing));
-            } catch (Exception exception) {
-                Main.log("在加载前缀 " + prefixIdentifier + " 时出错，请检查配置！");
-                exception.printStackTrace();
+        if (files.size() > 0) {
+            for (File file : files) {
+                try {
+                    ConfiguredPrefix prefix = new ConfiguredPrefix(file);
+                    Main.log("完成前缀加载 " + prefix.getIdentifier() + " : " + prefix.getName());
+                    dataPrefixes.put(prefix.getIdentifier(), prefix);
+                } catch (Exception ex) {
+                    Main.log("Error occurred when loading prefix #" + file.getAbsolutePath() + " !");
+                    ex.printStackTrace();
+                }
            }
        }

@@ -69,7 +77,8 @@ public class PrefixManager {

    public static void loadDefaultPrefix() {
        PrefixManager.defaultPrefix = null;
-        ConfigurationSection defaultPrefixSection = ConfigManager.getConfig().getConfigurationSection("defaultPrefix");
+        ConfigurationSection defaultPrefixSection = ConfigManager.getPluginConfig()
+                .getConfig().getConfigurationSection("defaultPrefix");
        if (defaultPrefixSection != null) {
            try {
                String name = defaultPrefixSection.getString("name", "默认前缀");
@@ -145,5 +154,13 @@ public class PrefixManager {
        }
    }

+    private static File getStorageFolder() {
+        if (PrefixConfig.CustomStorage.ENABLE.get()) {
+            return new File(PrefixConfig.CustomStorage.PATH.get());
+        } else {
+            return new File(Main.getInstance().getDataFolder() + File.separator + FOLDER_NAME);
+        }
+    }
+

 }
@@ -24,11 +24,22 @@ public class UserManager {

    public static HashSet<UUID> checkingPlayers = new HashSet<>();

+    @Nullable
    public static UserNameTag getNameTag(Player player) {
-        return nameTags.get(player.getUniqueId());
+        if (PrefixConfig.Functions.NAME_PREFIX.get()) {
+            if (nameTags.containsKey(player.getUniqueId())) {
+                return nameTags.get(player.getUniqueId());
+            } else {
+                return createNameTag(player);
+            }
+        } else {
+            return null;
+        }
    }

+    @NotNull
    public static UserNameTag createNameTag(Player player) {
+        if (nameTags.containsKey(player.getUniqueId())) return nameTags.get(player.getUniqueId());
        UserNameTag nameTag = new UserNameTag(player);
        nameTags.put(player.getUniqueId(), nameTag);
        return nameTag;
@@ -56,6 +67,7 @@ public class UserManager {
     * @param loadOthers 是否为玩家更新其他人的前缀(一般用于加入游戏)
     */
    public static void updatePrefixView(Player player, boolean loadOthers) {
+        if (!PrefixConfig.Functions.NAME_PREFIX.get()) return; //未启用的情况下，不需要进行任何操作。
        ConfiguredPrefix playerPrefix = UserManager.getPrefix(player);

        UserNameTag tag = getNameTag(player);
@@ -1,12 +1,23 @@
 package cc.carm.plugin.userprefix.model;

 import cc.carm.plugin.userprefix.util.ColorParser;
+import cc.carm.plugin.userprefix.util.ItemStackFactory;
+import org.bukkit.Material;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.inventory.ItemStack;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

+import java.io.File;
+
 public class ConfiguredPrefix {

+    @Nullable
+    private File dataFile;
+    @Nullable
+    private FileConfiguration configuration;
+
    String identifier;

    String name;
@@ -20,6 +31,25 @@ public class ConfiguredPrefix {
    ItemStack itemNoPermission;
    ItemStack itemWhenUsing;

+
+    public ConfiguredPrefix(@NotNull File dataFile) {
+        this.dataFile = dataFile;
+        this.configuration = YamlConfiguration.loadConfiguration(dataFile);
+        if (getConfiguration() != null) {
+            this.identifier = getConfiguration().getString("identifier", "ERROR");
+            this.name = getConfiguration().getString("name", "ERROR");
+            this.content = getConfiguration().getString("content", "&r");
+            this.permission = getConfiguration().getString("permission");
+            this.weight = getConfiguration().getInt("weight", 1);
+
+            this.itemHasPermission = (ItemStack) getConfiguration().get("itemHasPermission",
+                    new ItemStackFactory(Material.STONE).setDisplayName(name).addLore(" ").addLore("§a➥ 点击切换到该前缀").toItemStack()
+            );
+            this.itemNoPermission = (ItemStack) getConfiguration().get("itemNoPermission", itemHasPermission);
+            this.itemWhenUsing = (ItemStack) getConfiguration().get("itemUsing", itemHasPermission);
+        }
+    }
+
    public ConfiguredPrefix(@NotNull String identifier,
                            @NotNull String name,
                            @NotNull String content,
@@ -37,6 +67,11 @@ public class ConfiguredPrefix {
        this.itemWhenUsing = itemWhenUsing;
    }

+    @Nullable
+    public FileConfiguration getConfiguration() {
+        return configuration;
+    }
+
    @NotNull
    public String getIdentifier() {
        return identifier;
@@ -28,6 +28,7 @@ public class MessageUtil {
    }

    public static void sendWithPlaceholders(CommandSender sender, List<String> messages) {
+        if (messages == null || messages.isEmpty()) return;
        if (hasPlaceholderAPI() && sender instanceof Player) {
            send(sender, PlaceholderAPI.setPlaceholders((Player) sender, messages));
        } else {
@@ -1,8 +1,6 @@
 package cc.carm.plugin.userprefix.util.gui;

 import cc.carm.plugin.userprefix.configuration.PrefixConfig;
-import cc.carm.plugin.userprefix.util.ItemStackFactory;
-import org.bukkit.Material;
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.ClickType;
 import org.bukkit.inventory.ItemStack;
@@ -53,10 +51,7 @@ public class AutoPagedGUI extends CommonPagedGUI {
    public void openGUI(Player user) {
        if (previousPageSlot >= 0)
            if (hasPreviousPage()) {
-                setItem(previousPageSlot, new GUIItem(previousPageUI == null ? new ItemStackFactory(Material.ARROW)
-                        .setDisplayName("&f上一页")
-                        .addLore("&7&o右键可前往第一页哦")
-                        .toItemStack() : previousPageUI) {
+                setItem(previousPageSlot, new GUIItem(previousPageUI == null ? PrefixConfig.GUI.Items.PREVIOUS_PAGE.get() : previousPageUI) {
                    @Override
                    public void onClick(ClickType type) {
                        if (type == ClickType.RIGHT) {
@@ -70,12 +65,9 @@ public class AutoPagedGUI extends CommonPagedGUI {
                });
            }

-        if (previousPageSlot >= 0)
+        if (nextPageSlot >= 0)
            if (hasNextPage()) {
-                setItem(nextPageSlot, new GUIItem(nextPageUI == null ? new ItemStackFactory(Material.ARROW)
-                        .setDisplayName("下一页")
-                        .addLore("&7&o右键可前往最后一页哦")
-                        .toItemStack() : nextPageUI) {
+                setItem(nextPageSlot, new GUIItem(nextPageUI == null ? PrefixConfig.GUI.Items.NEXT_PAGE.get() : nextPageUI) {
                    @Override
                    public void onClick(ClickType type) {
                        if (type == ClickType.RIGHT) {
@@ -1,20 +1,51 @@
-version: ${project.version}
+version: ${project.version} #配置文件版本，若与插件版本不同请记得检查配置文件内容

 debug: false

+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！
+
 functions:
  OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
+  chat:
+    # 聊天功能
+    # - 我不推荐使用本插件的聊天功能，而是建议使用其他的聊天插件。
+    # - 本插件仅仅提供了**最基本**的格式变量支持，不包含其他任何功能。
+    # - 注意聊天格式需要遵守Bukkit原格式，即不得缺失 “%1$s” 和 “%2$s” 。
+    # - 本插件的聊天功能不影响其他插件对聊天事件的操作。
+    enable: false # 是否启用
+    format: "<%UserPrefix_prefix%%1$s> %2$s" #聊天的格式，注意 “%1$s” 和 “%2$s” 不可缺少，分别代表 玩家名 与 消息内容 。

 GUI:
  title: "&f&l我的前缀 &8| 列表"
-
-messages:
-  selected:
-    - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
-  expired:
-    - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
-    - "&7现在已为您重新调整为 &f%(newName) &7。"
+  items:
+    # 【必须】 GUI中可能存在的其他物品
+    next-page: # 下一页物品，如果没有下一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f下一页"
+        lore:
+          - ""
+          - "§f右键可前往最后一页哦~"
+    previous-page: # 上一页物品，如果没有上一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f上一页"
+        lore:
+          - ""
+          - "§f右键可前往第一页哦~"

 Sounds: #相关的声音，注释掉则不播放声音 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
@@ -46,58 +77,4 @@ defaultPrefix:
      display-name: "§f默认玩家前缀"
      lore:
        - ""
-        - "§a✔ 您正在使用该前缀"
-
-prefixes:
-  VIP:
-    name: "&b&lPro&b" # [必须] 名字(切换的时候左下角会弹提示 用的就是这个名字)
-    content: "§b§lPro §b" # [必须] 显示在名字前面的内容
-    weight: 1 # [必须] 权重，用于GUI里面的排序(越大显示在越后面)和自动前缀显示
-    permission: "yc.pro" # [非必须] 检测的权限，如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
-    itemHasPermission: #  [必须] 当有权限的时候会显示这个Item
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a➥ 点击切换到该前缀"
-    itemUsing: # [非必需] 当有权限的时候会显示这个Item,如果没有这个配置就自动显示“itemHasPermission”的。
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        enchants:
-          PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a✔ 您正在使用该前缀"
-    itemNoPermission: # [非必需] 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
-      ==: org.bukkit.inventory.ItemStack
-      type: INK_SACK
-      damage: 8
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
-        lore:
-          - "§7Pro+会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - "§f您可以输入 §b/vip §f指令查看详细特权！"
-          - ""
-          - "§e✯ 加入Pro+会员以使用该前缀！"
-
+        - "§a✔ 您正在使用该前缀"
@@ -0,0 +1,85 @@
+version: ${project.version} # DO NOT EDIT IT
+
+debug: false #DEBUG OUT PUT
+
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+
+GUI:
+  title: "&f&lMy Prefixes List" # Title of the GUI
+  items:
+    next-page: # only show has next page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fNext Page"
+        lore:
+          - ""
+          - "§fRight-Click to the last page"
+    previous-page: # only show has previous page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fPrevious Page"
+        lore:
+          - ""
+          - "§fRight-Click to the first page"
+
+functions:
+  # Whether to add a prefix to the top of the head,
+  # this method uses the scoreboard above the head,
+  # please turn it off if there is a conflict.
+  OnNamePrefix: true
+  # Automatic prefix select.
+  # When the player does not choose a prefix by himself,
+  # the prefix with the highest weight will be used automatically
+  autoUsePrefix: true
+  chat:
+    # Chat Function
+    # - I recommend using other chat plugins instead of using this plugin,
+    # - this plugin only provides very basic chat format placeholders.
+    # - Notice that: format must has “%1$s” and “%2$s” for PlayerName and Message (Bukkit Chat Event)
+    enable: false
+    format: "<%UserPrefix_prefix%%1$s> %2$s"
+
+
+
+Sounds:
+  # Format is [SOUND_NAME:Volume:Pitch] or [SOUND_NAME:Volume] or [SOUND_NAME]
+  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
+  guiClick: "UI_BUTTON_CLICK"
+  prefixChange: "ENTITY_VILLAGER_YES"
+  prefixExpired: "ENTITY_VILLAGER_NO"
+
+# The default prefix's weight is 0.
+defaultPrefix:
+  name: "Default prefix"
+  content: "&b"
+  itemNotUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix §f(Click to select)"
+      lore:
+        - ""
+        - "§a➥ Click to use"
+  itemUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix"
+      lore:
+        - ""
+        - "§a✔ Selected"
@@ -0,0 +1,68 @@
+
+# identifier [Necessary]
+# This will be used for data-storage.
+identifier: "pro"
+
+# Name [Necessary]
+# Use in messages.
+name: "&b&lPro&b"
+
+# Content [Necessary]
+# Use in Placeholders
+content: "§b§lPro §b"
+
+# Weight [Necessary]
+# used for sorting in the GUI and TabList
+# In GUI : the larger is displayed at the back
+# At TabList : the larger is displayed at the top
+weight: 1
+
+# Permission [Unnecessary]
+# If there is no permission for detection, everyone can use it,
+# which means there is no need to configure "itemNoPermission"
+# (because it is impossible to display items without permission at all)
+permission: "yc.vip"
+
+# itemHasPermission  [Necessary]
+# This Item will be displayed when player has permission
+itemHasPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP Prefix"
+    lore:
+      - ""
+      - "§a➥ Click to  use"
+
+# itemUsing [Unnecessary]
+# This Item will be displayed when the prefix is selected.
+# If there is no such configuration, it will automatically display "itemHasPermission".
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP Prefix"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
+    lore:
+      - ""
+      - "§a✔ Selected"
+
+# itemNoPermission [Unnecessary]
+# If player doesn't have the permission,this item will be displayed.
+# If this item is not configured, it will not be displayed in the GUI when the player does not have permission to use it.
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: INK_SACK
+  damage: 8
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP §c(Buy it!)"
+    lore:
+      - ""
+      - "§e✯ Buy the VIP to use it!"
@@ -0,0 +1,19 @@
+selected:
+  - "&7You have selected the  &f%(name) &7as current prefix."
+expired:
+  - "&7Your prefix &f%(oldName) &7has expired,"
+  - "&7Now the prefix is changed to &f%(newName) &7."
+reload:
+  - "&a&lReload completed！&7costs &f%(time)ms&7."
+help:
+  - "&3&lUserPrefixAdmin &fHelp"
+  - "&8#/upa&f list"
+  - "&8- &7Show configured prefixes."
+  - "&8#/upa&f reload"
+  - "&8- &7Reload configuration."
+list-title:
+  - "&3&lUserPrefixAdmin &fList"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7Name &r%(name) &7Perm &r%(permission)"
+  - "&8- &7Example&r %(content) %(sender_name)"
@@ -0,0 +1,19 @@
+selected:
+  - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
+expired:
+  - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
+  - "&7现在已为您重新调整为 &f%(newName) &7。"
+reload:
+  - "&a&l重载完成！&7共耗时 &f%(time)ms&7。"
+help:
+  - "&3&l用户前缀系统 &f帮助"
+  - "&8#/upa&f list"
+  - "&8- &7查看当前前缀列表。"
+  - "&8#/upa&f reload"
+  - "&8- &7重载前缀配置。"
+list-title:
+  - "&3&l用户前缀系统 &f前缀列表"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7显示名 &r%(name) &7权限 &r%(permission)"
+  - "&8- &7内容示例&r %(content) %(sender_name)"
@@ -1,10 +1,13 @@
 main: cc.carm.plugin.userprefix.Main
-name: UserPrefix
+name: ${project.name}
 version: ${project.version}
 authors:
  - Carm
-  - YourCraft
+  - ${project.organization.name}
  - SakuraGame
+website: ${project.url}
+description: ${project.description}
+
 depend:
  - LuckPerms
 softdepend:
@@ -0,0 +1,78 @@
+# 唯一标识 [必须]
+# 将用于记录玩家所选的前缀，以及用于数据的缓存。
+# 必须 必须 必须 保持唯一！
+identifier: "pro"
+
+# 名字 [必须]
+# 切换的时候左下角会弹提示 用的就是这个名字
+name: "&b&lPro&b"
+
+# 内容 [必须]
+# 显示在名字前面的内容
+content: "§b§lPro §b"
+
+# 权重 [必须]
+# 用于GUI、TabList的排序和自动前缀显示
+# 在GUI中，权重越高的会显示在越后面
+# 在TabList中，权重越高的会显示在越上面
+weight: 1
+
+
+# 检测的权限 [非必须]
+# 如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
+permission: "yc.pro"
+
+# 有权限时显示的物品  [必须]
+# 当用户有权限且未选中时，会显示该物品
+itemHasPermission: #
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a➥ 点击切换到该前缀"
+
+# 正在使用时显示的物品 [非必需]
+# 当用户正在使用时会显示这个物品，不配置即自动加载“itemHasPermission”
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a✔ 您正在使用该前缀"
+
+# 没有权限时显示的物品 [非必需]
+# 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: INK_SACK
+  damage: 8
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
+    lore:
+      - "§7Pro+会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - "§f您可以输入 §b/vip §f指令查看详细特权！"
+      - ""
+      - "§e✯ 加入Pro+会员以使用该前缀！"
@@ -1,6 +1,8 @@
 [align=center][attachimg]1905166[/attachimg]
 [/align]
-[align=left][b][size=6]用户前缀系统插件[/size][/b][/align][align=left][hr][/align][align=left]轻便、高效、实时的用户前缀系统。[/align]
+[align=left][b][size=6]用户前缀系统插件[/size][/b][/align][align=left][hr][/align][align=left][img]https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840[/img] [img]https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master[/img] [img]https://visitor-badge.glitch.me/badge?page_id=userprefix.readme[/img]
+[/align]
+[align=left]轻便、高效、实时的用户前缀系统。[/align]
 [align=left]本插件基于Spigot实现，[b]理论上支持全版本[/b]。[/align]
 [align=left][size=5][b]示例[/b][/size][/align][align=left][hr][/align]
 [attachimg]1905175[/attachimg]
@@ -23,7 +25,7 @@
 [*]物品的配置通过ItemStack原生配置，支持MC所有的设定！
 [*]TabList自动按照前缀的权重排序 (如有冲突可关掉)
 [*]玩家头顶前缀实时显示 (如有冲突可关掉)
-[*]自动排序，且可翻页的GUI！
+[*][b]自动排序[/b]，且[b]可翻页[/b]的GUI！
 [*]支持PlaceholderAPI变量！(凡支持的都可以使用，如BungeeTabListPlus)
 [*]支持Hex颜色！(1.16以上版本) 格式 [u]&(#颜色代码)[/u]
 [/list][size=5][b]
@@ -49,7 +51,6 @@
 /UserPrefixAdmin list 查看已配置的前缀内容[/code]
 [size=5][b]变量 (PlaceholderAPI)[/b][/size]
 [hr]
-
 安装 [url=https://github.com/PlaceholderAPI/PlaceholderAPI]PlaceholderAPI[/url]后，可以输入 [u]/papi info UserPrefix[/u] 查看相关变量。
 变量内容如下
 [code]# %UserPrefix_prefix%
@@ -63,24 +64,60 @@
 # %UserPrefix_has_<Identifier>%
 - 判断玩家是否拥有某个前缀(true/false)[/code][size=5][b]
 配置文件示例[/b][/size]
-[hr][spoiler]
-[code]version: 1.0.0-SNAPSHOT # 配置文件版本，一般不会动。
+[hr]
+[size=4][b]基础配置文件 [/b][/size][color=#24292f][font=Tahoma][size=4](config.yml)[/size][/font][/color]
+[spoiler]
+[code]
+version: ${project.version} #配置文件版本，若与插件版本不同请记得检查配置文件内容

-debug: false #debug输出，开发者用的
+debug: false
+
+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！

 functions:
  OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
+  chat:
+    # 聊天功能
+    # - 我不推荐使用本插件的聊天功能，而是建议使用其他的聊天插件。
+    # - 本插件仅仅提供了**最基本**的格式变量支持，不包含其他任何功能。
+    # - 注意聊天格式需要遵守Bukkit原格式，即不得缺失 “%1$s” 和 “%2$s” 。
+    # - 本插件的聊天功能不影响其他插件对聊天事件的操作。
+    enable: false # 是否启用
+    format: "<%UserPrefix_prefix%%1$s> %2$s" #聊天的格式，注意 “%1$s” 和 “%2$s” 不可缺少，分别代表 玩家名 与 消息内容 。

-messages:
-  selected:
-    - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
-  expired:
-    - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
-    - "&7现在已为您重新调整为 &f%(newName) &7。"
+GUI:
+  title: "&f&l我的前缀 &8| 列表"
+  items:
+    # 【必须】 GUI中可能存在的其他物品
+    next-page: # 下一页物品，如果没有下一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f下一页"
+        lore:
+          - ""
+          - "§f右键可前往最后一页哦~"
+    previous-page: # 上一页物品，如果没有上一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f上一页"
+        lore:
+          - ""
+          - "§f右键可前往第一页哦~"

-Sounds: #相关的声音，注释掉则不播放声音
-  # 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
+Sounds: #相关的声音，注释掉则不播放声音 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
  guiClick: "UI_BUTTON_CLICK"
  prefixChange: "ENTITY_VILLAGER_YES"
@@ -111,75 +148,146 @@ defaultPrefix:
      lore:
        - ""
        - "§a✔ 您正在使用该前缀"
+[/code]
+[/spoiler]

-prefixes:
-  VIP:
-    name: "&b&lPro&b" # [必须] 名字(切换的时候左下角会弹提示 用的就是这个名字)
-    content: "§b§lPro §b" # [必须] 显示在名字前面的内容
-    weight: 1 # [必须] 权重，用于GUI里面的排序(越大显示在越后面)和自动前缀显示
-    permission: "yc.pro" # [非必须] 检测的权限，如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
-    itemHasPermission:
-      #  [必须] 当有权限的时候会显示这个Item
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a➥ 点击切换到该前缀"
-    itemUsing:
-      # [非必需] 当有权限的时候会显示这个Item,如果没有这个配置就自动显示“itemHasPermission”的。
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        enchants:
-          PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a✔ 您正在使用该前缀"
-    itemNoPermission:
-      # [非必需] 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
-      ==: org.bukkit.inventory.ItemStack
-      type: INK_SACK
-      damage: 8
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
-        lore:
-          - "§7Pro+会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - "§f您可以输入 §b/vip §f指令查看详细特权！"
-          - ""
-          - "§e✯ 加入Pro+会员以使用该前缀！"[/code][/spoiler]
+[b][size=4][backcolor=transparent]消息配置文件[/backcolor][/size] [/b][size=4](messages.yml)[/size]
+[spoiler][code]selected:
+  - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
+expired:
+  - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
+  - "&7现在已为您重新调整为 &f%(newName) &7。"
+reload:
+  - "&a&l重载完成！&7共耗时 &f%(time)ms&7。"
+help:
+  - "&3&l用户前缀系统 &f帮助"
+  - "&8#/upa&f list"
+  - "&8- &7查看当前前缀列表。"
+  - "&8#/upa&f reload"
+  - "&8- &7重载前缀配置。"
+list-title:
+  - "&3&l用户前缀系统 &f前缀列表"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7显示名 &r%(name) &7权限 &r%(permission)"
+  - "&8- &7内容示例&r %(content) %(sender_name)"[/code][/spoiler]
+
+[size=4][backcolor=transparent][b]前缀配置文件[/b][/backcolor] (prefixes/*.yml) [自2.1.7可自定义目录][/size]
+[align=left][font=-apple-system, BlinkMacSystemFont, &quot;][size=3][color=#000000]所有前缀均为单独的配置文件，存放于 [u]插件配置目录/prefixes[/u] 下，便于管理。[/color][/size][/font][/align][align=left][font=-apple-system, BlinkMacSystemFont, &quot;][size=3][color=#000000]文件名理论上可以随便取，推荐使用英文，部分符号可能会影响正常读取，请避免使用。[/color][/size][/font][/align][align=left][spoiler][/align][code]# 唯一标识 [必须]
+# 将用于记录玩家所选的前缀，以及用于数据的缓存。
+# 必须 必须 必须 保持唯一！
+identifier: "pro"
+
+# 名字 [必须]
+# 切换的时候左下角会弹提示 用的就是这个名字
+name: "&b&lPro&b"
+
+# 内容 [必须]
+# 显示在名字前面的内容
+content: "§b§lPro §b"
+
+# 权重 [必须]
+# 用于GUI、TabList的排序和自动前缀显示
+# 在GUI中，权重越高的会显示在越后面
+# 在TabList中，权重越高的会显示在越上面
+weight: 1
+
+# 检测的权限 [非必须]
+# 如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
+permission: "yc.pro"
+
+# 有权限时显示的物品  [必须]
+# 当用户有权限且未选中时，会显示该物品
+itemHasPermission: #
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a➥ 点击切换到该前缀"
+
+# 正在使用时显示的物品 [非必需]
+# 当用户正在使用时会显示这个物品，不配置即自动加载“itemHasPermission”
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro §b会员前缀"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
+    lore:
+      - "§7Pro会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - ""
+      - "§a✔ 您正在使用该前缀"
+
+# 没有权限时显示的物品 [非必需]
+# 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: INK_SACK
+  damage: 8
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
+    lore:
+      - "§7Pro+会员专属称号"
+      - ""
+      - "§f尊贵的Pro会员专属称号。"
+      - "§f您将获得多种特权与更好的游戏体验。"
+      - "§f您可以输入 §b/vip §f指令查看详细特权！"
+      - ""
+      - "§e✯ 加入Pro+会员以使用该前缀！"[/code][align=left][/spoiler][/align]

 [size=5][b]下载地址[/b][/size]
-
 [hr]
-[size=3][b]最新版本 1.2.3[/b][/size][attach]1905406[/attach]
-[size=3]更新内容： [/size][quote][size=3]1. 支持Hex颜色！(1.16以上版本) 格式 [u]&(#颜色代码)[/u] 。[/size]
-[size=3][backcolor=initial]-   如 [/backcolor][/size][backcolor=initial][size=3]LightSlateBlue &(#8470FF) 、 DarkSlateBlue &(#483D8B)[/size][/backcolor]
+[size=3][b]最新版本 [/b][/size][size=3][b]2.1.7 [/b][/size][attach]1919669[/attach][quote][b][size=3]更新内容[/size][/b]
+1. 提供自定义配置文件存储位置的功能，便于多子服共享配置。(custome-storage)
+2. 添加控制台打开玩家菜单时的反馈(来自 @Yuri南城 )。
+3. 支持由控制台为其他玩家打开GUI。
+4. 若出现新配置文件条目，将自动写入默认值，便于配置。[/quote][spoiler][size=3][b]2.1.2 [/b][/size][attach]1912028[/attach][quote][b][size=3]更新内容[/size][/b]
+1. 修复不开启插件自带的头顶前缀功能时出现的报错。[/quote]
+[size=3][b]2.1.0 [/b][/size][attach]1909962[/attach][quote][b][size=3]更新内容[/size][/b]
+1. 添加聊天相关设定，支持聊天前缀。(但不推荐使用哦~)[/quote]
+[size=3][b] 2.0.0 [/b][/size][attach]1905700[/attach]
+[quote][b][size=3]更新内容[/size][/b]
+1. 修复低版本可能无法读取物品的bug。
+2. 分离配置文件，消息配置文件改为messages.yml，前缀配置文件改 prefixes/*.yml，便于配置和管理。
+3. 允许配置GUI中上一页和下一页的物品。
+4. 补全帮助文档，在插件首次加载将提供一份英文版的配置，以便使用。[/quote]
+[size=3][b] 1.2.5 [/b][/size][attach]1905430[/attach][quote][size=3][b]更新内容[/b]
+1. 支持指令的多语言配置。[/size][/quote]
+[b][size=3]
+1.2.4[/size][size=4] [/size][/b][attach]1905431[/attach]
+[quote][size=3][b]更新内容：[/b]
+1. 修复closeAll方法中，未移除玩家缓存的bug。
+2. 当玩家权限更新时，将关闭玩家的GUI，令其自行打开刷新所有前缀。
+3. 允许配置GUI的标题。[/size][/quote]
+[size=3][b]1.2.3 [/b][/size][attach]1905406[/attach]
+[quote][size=3][b]更新内容：[/b]
+[/size][size=3]1. 支持Hex颜色！(1.16以上版本) 格式 [u]&(#颜色代码)[/u] ；[/size]
+[size=3][backcolor=initial]-   如 “[/backcolor][/size][backcolor=initial][size=3]LightSlateBlue [u]&(#8470FF)[/u] ”、 “DarkSlateBlue [u]&(#483D8B)[/u]”。[/size][/backcolor]
 [backcolor=initial][size=3]2. 修复未安装PlaceholderAPI的情况下可能导致的部分报错。[/size][/backcolor]
 [backcolor=initial][size=3]
 [/size][/backcolor]
 [/quote]
+[/spoiler]
+
 更多版本请移步 [url=https://github.com/CarmJos/UserPrefix/releases]Releases · CarmJos/UserPrefix (github.com)[/url] 。

+
 [size=5][b]开源地址[/b][/size]
 [hr]
 [size=3]本插件于 [/size][url=https://github.com/CarmJos/UserPrefix]Github[/url][size=3] 开源。[/size]
@@ -189,6 +297,7 @@ prefixes:
 [font=-apple-system, BlinkMacSystemFont][color=#24292f][size=16px]
 [/size][/color][/font][size=3]喜欢本插件的话，也可以去Github上给我点个小星星哦~
 [/size]
+
 [size=5][b]插件支持[/b][/size]
 [hr]
 [size=4]本项目由 [url=https://www.mcbbs.net/group-2077-1.html]YourCraft(你的世界)[/url] 团队提供长期支持与维护。
@@ -200,3 +309,6 @@ prefixes:

 [hr]
 [align=center][b][size=4][color=#ff0000]本插件所用所有代码均为原创,不存在借用/抄袭等行为[/color][/size][/b][/align]
+
+
+
@@ -0,0 +1,284 @@
+[URL='https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/banner.png'][IMG]https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/banner.png[/IMG][/URL]
+
+[SIZE=6][B]UserPrefix Plugin[/B][/SIZE]
+[URL='https://www.codefactor.io/repository/github/carmjos/userprefix'][IMG]https://camo.githubusercontent.com/6040f5c07ea04f9cb666459d6b6f08d19971fc29a26183cdc6595297b287234b/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f6361726d6a6f732f757365727072656669782f62616467653f733d62373666656331663634373236623566313939383961616365366164623566383566646162383430[/IMG][/URL] [URL='https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml'][IMG]https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master[/IMG][/URL] [URL='https://opensource.org/licenses/GPL-3.0'][IMG]https://camo.githubusercontent.com/fd3e53788a319da1b7287d976c2f23fcb8e3d474249af0bf7f8e671f968faebd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4361726d4a6f732f55736572507265666978[/IMG][/URL] [URL='https://camo.githubusercontent.com/753f86cc8d2a514a026309afab251b090749751b35409f1e633c77cc0b3f5618/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d696e6563726166742d4a617661253230312e382d2d4c61746573742d79656c6c6f77'][IMG]https://camo.githubusercontent.com/753f86cc8d2a514a026309afab251b090749751b35409f1e633c77cc0b3f5618/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d696e6563726166742d4a617661253230312e382d2d4c61746573742d79656c6c6f77[/IMG][/URL] [URL='https://camo.githubusercontent.com/75543844e4f92947d837bd45ab75d5a268e63ff485cd7b354cf69f52e60be28d/68747470733a2f2f76697369746f722d62616467652e676c697463682e6d652f62616467653f706167655f69643d757365727072656669782e726561646d65'][IMG]https://camo.githubusercontent.com/75543844e4f92947d837bd45ab75d5a268e63ff485cd7b354cf69f52e60be28d/68747470733a2f2f76697369746f722d62616467652e676c697463682e6d652f62616467653f706167655f69643d757365727072656669782e726561646d65[/IMG][/URL]
+
+Lightweight, efficient, and real-time user prefix system.
+
+This plugin is implemented based on Spigot ,Theoretically support ALL MineCraft Versions.
+
+The development of this plugin is based on Chinese, which purpose is to help Chinese developers learn Bukkit plugin development.
+
+[QUOTE]
+本插件已在 [URL='https://www.mcbbs.net/forum.php?mod=viewthread&tid=1261503']MCBBS[/URL] 上发布，欢迎中文用户来这里下载。
+[/QUOTE]
+
+[SIZE=5][B]Examples[/B][/SIZE]
+[URL='https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/using-example.png'][IMG]https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/using-example.png[/IMG][/URL]
+
+[SIZE=5][B]Dependencies[/B][/SIZE]
+[LIST]
+[*][B][Necessary][/B] Plugin developed based on [URL='https://hub.spigotmc.org/stash/projects/SPIGOT']Spigot-API[/URL] and [URL='http://bukkit.org/']BukkitAPI[/URL].
+[*][B][Necessary][/B] Plugin data storage base on [URL='https://www.spigotmc.org/resources/luckperms.28140/']LuckPerms[/URL].
+[*][Recommend] Placeholders based on [URL='https://www.spigotmc.org/resources/6245/']PlaceholderAPI[/URL] .
+[/LIST]
+For development dependencies, please see [URL='https://github.com/CarmJos/UserPrefix/network/dependencies']Dependencies[/URL] .
+
+[SIZE=5][B]Features[/B][/SIZE]
+[LIST]
+[*]Theoretically support ALL MineCraft Versions.
+[*]Reloading the configuration will automatically refresh the prefix of all players.
+[*]Real-time judgment and feedback to the player when permissions are changed.
+[*]Configurable sounds and messages.
+[*]The prefix icon can be configured as "Selected", "Has Permission" and “No Permission”.
+[LIST]
+[*]Item configuration is natively configured through ItemStack, which supports all MC settings!
+[/LIST]
+[*]TabList is automatically sorted according to the weight of the prefix (if there is a conflict, it can be turned off)
+[*]The prefix display on the player name (can be turned off if there is a conflict)
+[*]GUI with automatic sorting and page turning!
+[*]Support PlaceholderAPI variables!
+[*]Support Hex color! (Version 1.16 and above) [U]&(#Color)[/U]
+[LIST]
+[*]Example: LightSlateBlue [U]&(#8470FF)[/U] 、 DarkSlateBlue [U]&(#483D8B)[/U]
+[/LIST]
+[/LIST]
+[SIZE=5][B]Notice[/B][/SIZE]
+[SIZE=4][B]1. Version support issues[/B][/SIZE]
+This plugin theoretically supports all versions.
+
+If the icon does not load, the sound cannot be played, etc., please check whether the type of the item and sound in the configuration file exists in the current version.
+
+Take the SOUND as an example. The sound that the villager said "OK" is "[U]VILLAGER_YES[/U]" in the lower version, but it becomes "[U]ENTITY_VILLAGER_YES[/U]" in the higher version.
+
+[SIZE=4][B]2. Scoreboard exception problem[/B][/SIZE]
+The display of the prefix on the head and the sorting of the TabList both use the scoreboard API.
+
+Please turn of the [U]functions.OnNamePrefix[/U] in the configuration if there is a conflict.
+
+[SIZE=4][B]3. Item icon configuration problem[/B][/SIZE]
+Items are read through the ItemStack serialization method provided by Bukkit. For related configuration methods, please refer to [URL='https://www.spigotmc.org/wiki/itemstack-serialization/']ItemStack Serialization[/URL].
+
+[SIZE=5][B]Commands[/B]
+[/SIZE]
+[code]
+/UserPrefix or /prefix #Open prefix GUI
+/UserPrefixAdmin # View Admin Command Help
+/UserPrefixAdmin reload # Reload Config
+/UserPrefixAdmin list # List all configured prefixes.
+[/code]
+
+[SIZE=5][B]Placeholders (PlaceholderAPI)[/B][/SIZE]
+After installed the [URL='https://github.com/PlaceholderAPI/PlaceholderAPI']PlaceholderAPI[/URL] , you can type /papi info UserPrefix to see all the placeholders.
+
+[code]
+# %UserPrefix_prefix%
+- Get the content of the current prefix
+# %UserPrefix_weight%
+- Get the weight of the current prefix.
+# %UserPrefix_identifier%
+- Get the identifier of the current prefix.
+# %UserPrefix_name%
+- Get the name of the current prefix.
+# %UserPrefix_has_<Identifier>%
+- Determine whether the player has a certain prefix(true/false)
+[/code]
+
+[SIZE=5][B]Configuration Files[/B][/SIZE]
+[B][SIZE=4][URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml']Plugin Configuration[/URL] (config.yml)[/SIZE]
+[/B]
+Notice: The default configuration is based on Chinese. You can find the English Version [URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml']here[/URL].
+
+[code=YAML]
+version: ${project.version}
+
+debug: false #DEBUG OUT PUT
+
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+
+GUI:
+  title: "&f&lMy Prefixes List" # Title of the GUI
+  items:
+    next-page: # only show has next page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fNext Page"
+        lore:
+          - ""
+          - "§fRight-Click to the last page"
+    previous-page: # only show has previous page
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§fPrevious Page"
+        lore:
+          - ""
+          - "§fRight-Click to the first page"
+
+functions:
+  # Whether to add a prefix to the top of the head,
+  # this method uses the scoreboard above the head,
+  # please turn it off if there is a conflict.
+  OnNamePrefix: true
+  # Automatic prefix select.
+  # When the player does not choose a prefix by himself,
+  # the prefix with the highest weight will be used automatically
+  autoUsePrefix: true
+  chat:
+  # Chat Function
+  # - I recommend using other chat plugins instead of using this plugin,
+  # - this plugin only provides very basic chat format placeholders.
+  # - Notice that: format must has “%1$s” and “%2$s” for PlayerName and Message (Bukkit Chat Event)
+    enable: false
+    format: "<%UserPrefix_prefix%%1$s> %2$s"
+
+Sounds:
+  # Format is [SOUND_NAME:Volume:Pitch] or [SOUND_NAME:Volume] or [SOUND_NAME]
+  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
+  guiClick: "UI_BUTTON_CLICK"
+  prefixChange: "ENTITY_VILLAGER_YES"
+  prefixExpired: "ENTITY_VILLAGER_NO"
+
+# The default prefix's weight is 0.
+defaultPrefix:
+  name: "Default prefix"
+  content: "&b"
+  itemNotUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix §f(Click to select)"
+      lore:
+        - ""
+        - "§a➥ Click to use"
+  itemUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§fThe default prefix"
+      lore:
+        - ""
+        - "§a✔ Selected"
+[/code]
+
+[B][SIZE=4][URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/messages.yml']Messages Configuration[/URL] (messages.yml)[/SIZE][/B]
+[code=YAML]
+selected:
+  - "&7You have selected the  &f%(name) &7as current prefix."
+expired:
+  - "&7Your prefix &f%(oldName) &7has expired,"
+  - "&7Now the prefix is changed to &f%(newName) &7."
+reload:
+  - "&a&lReload completed！&7costs &f%(time)ms&7."
+help:
+  - "&3&lUserPrefixAdmin &fHelp"
+  - "&8#/upa&f list"
+  - "&8- &7Show configured prefixes."
+  - "&8#/upa&f reload"
+  - "&8- &7Reload configuration."
+list-title:
+  - "&3&lUserPrefixAdmin &fList"
+list-value:
+  - "&8#%(weight) &f%(identifier)"
+  - "&8- &7Name &r%(name) &7Perm &r%(permission)"
+  - "&8- &7Example&r %(content) %(sender_name)"
+[/code]
+
+[B][URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/example-prefix.yml']Prefixes [/URL][B][URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/example-prefix.yml']Configuration[/URL] [/B](/prefixes/*.yml)
+[/B]
+All prefixes are separate configuration files, stored in the [U]<Data Folder>/prefixes/[/U] for easy management.
+
+Some symbols in file name may affect reading, please avoid using them.
+
+[code]# identifier [Necessary]
+# This will be used for data-storage.
+identifier: "pro"
+
+# Name [Necessary]
+# Use in messages.
+name: "&b&lPro&b"
+
+# Content [Necessary]
+# Use in Placeholders
+content: "§b§lPro §b"
+
+# Weight [Necessary]
+# used for sorting in the GUI and TabList
+# In GUI : the larger is displayed at the back
+# At TabList : the larger is displayed at the top
+weight: 1
+
+# Permission [Unnecessary]
+# If there is no permission for detection, everyone can use it,
+# which means there is no need to configure "itemNoPermission"
+# (because it is impossible to display items without permission at all)
+permission: "yc.vip"
+
+# itemHasPermission  [Necessary]
+# This Item will be displayed when player has permission
+itemHasPermission:
+  ==: org.bukkit.inventory.ItemStack
+  type: DIAMOND
+  meta:
+    ==: org.bukkit.inventory.ItemStack
+      type: DIAMOND
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§b§lVIP Prefix"
+        lore:
+          - ""
+          - "§a➥ Click to  use"
+
+# itemUsing [Unnecessary]
+# This Item will be displayed when the prefix is selected.
+# If there is no such configuration, it will automatically display "itemHasPermission".
+itemUsing:
+  ==: org.bukkit.inventory.ItemStack
+    type: DIAMOND
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§b§lVIP Prefix"
+      enchants:
+        PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
+      lore:
+        - ""
+        - "§a✔ Selected"
+
+# itemNoPermission [Unnecessary]
+# If player doesn't have the permission,this item will be displayed.
+# If this item is not configured, it will not be displayed in the GUI when the player does not have permission to use it.
+itemNoPermission:
+  ==: org.bukkit.inventory.ItemStack
+    type: INK_SACK
+    damage: 8
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§b§lVIP §c(Buy it!)"
+      lore:
+        - ""
+        - "§e✯ Buy the VIP to use it!"[/code]
+
+
+
+[SIZE=5][B]Support and Donation[/B][/SIZE]
+This project is support by the [URL='https://www.ycraft.cn/']YourCraft(你的世界)[/URL] . [URL='https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/team-logo.png'][IMG]https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/team-logo.png[/IMG][/URL]
+
+[SIZE=5][B]Open source agreement[/B][/SIZE]
+The source code of this project uses [URL='https://opensource.org/licenses/GPL-3.0']GNU General Public License v3.0[/URL] License.
Author	SHA1	Message	Date
carm	9f738ff1ae	修改版本号	2021-11-21 20:01:49 +08:00
carm	f23fa03f7a	添加ASCII文字与插件介绍	2021-11-21 19:53:12 +08:00
carm	cf749bf5c0	添加下载地址	2021-11-02 11:47:13 +08:00
Carm	01e321686f	Merge pull request #6 from CarmJos/dependabot/maven/junit-junit-4.13.1 Bump junit from 4.13 to 4.13.1	2021-10-30 17:59:07 +08:00
dependabot[bot]	deba26c713	Bump junit from 4.13 to 4.13.1 Bumps [junit](https://github.com/junit-team/junit4) from 4.13 to 4.13.1. - [Release notes](https://github.com/junit-team/junit4/releases) - [Changelog](https://github.com/junit-team/junit4/blob/main/doc/ReleaseNotes4.13.1.md) - [Commits](https://github.com/junit-team/junit4/compare/r4.13...r4.13.1) --- updated-dependencies: - dependency-name: junit:junit dependency-type: direct:development ... Signed-off-by: dependabot[bot] <support@github.com>	2021-10-30 09:56:26 +00:00
Carm	5b4d49f6ed	Create codeql-analysis.yml	2021-10-30 17:54:55 +08:00
carm	2e5250dd36	更新帖子	2021-10-25 08:10:54 +08:00
carm	88730c98f2	更新帖子	2021-10-25 07:58:43 +08:00
carm	e003a543f5	支持由控制台为其他玩家打开GUI	2021-10-24 21:22:08 +08:00
Carm	07edaeb401	Merge pull request #5 from Yurinann/master 添加控制台尝试打开称号菜单时的反馈	2021-10-24 21:17:10 +08:00
carm	2357699324	自动提交默认值	2021-10-24 21:14:29 +08:00
“Yurinan”	c2fa1a1e95	添加控制台尝试打开称号菜单时的反馈	2021-10-24 14:29:57 +08:00
carm	3b03ec4616	修改readme	2021-10-24 07:22:23 +08:00
carm	1a2644210b	2.1.7 提供自定义配置文件存储位置的功能	2021-10-24 07:12:47 +08:00
carm	83b9ced6f5	2.1.6 补充介绍，优化部署密钥配置。	2021-10-21 21:46:01 +08:00
carm	dd96c6d6da	修改源地址	2021-10-19 10:49:35 +08:00
carm	ba7d4b90c3	修改源地址	2021-10-19 10:47:55 +08:00
carm	ab984acc73	修改源地址	2021-10-19 10:41:18 +08:00
carm	32df1de83d	2.1.5 1. 修复示例config中yaml格式错误的问题 2. 更改构建方式，分开构建与部署的工作流。	2021-10-19 10:40:02 +08:00
carm	dfe447393e	2.1.5 1. 修复示例config中yaml格式错误的问题 2. 更改构建方式，分开构建与部署的工作流。	2021-10-19 10:37:41 +08:00
Carm	26ce6d7e66	Merge pull request #3 from OskyEdz/patch-1 YAML formatting	2021-10-19 10:16:04 +08:00
OskyEdz	2e4d1122d9	YAML formatting Fixed mapping values are not allowed in this context error.	2021-10-19 02:15:38 +02:00
carm	b5a2199e1e	Update .gitignore	2021-10-19 00:37:07 +08:00
carm	3678a201c7	2.1.4 修改tag机制与测试部署	2021-10-07 23:04:00 +08:00
carm	f08a5e84d3	2.1.3 自动构建与部署 (无实质更新)	2021-10-07 22:52:20 +08:00
carm	7743bbb3ff	2.1.3 自动构建与部署 (无实质更新)	2021-10-07 22:50:23 +08:00
carm	1942c50078	2.1.3 自动构建与部署 (无实质更新)	2021-10-07 22:40:53 +08:00
carm	2b701510bc	添加更多maven介绍	2021-10-07 22:37:31 +08:00
carm	0d17e7f1b6	添加packages自动部署	2021-10-07 21:51:16 +08:00
carm	3a41560972	添加packages自动部署	2021-10-07 21:49:39 +08:00
Carm	313aa77d72	Update README.md	2021-10-05 19:40:48 +08:00
Carm	dab774a389	Update README.md	2021-10-05 19:29:51 +08:00
Carm	5469c3101f	Delete PAY.jpg	2021-10-05 19:29:38 +08:00
Carm	dbf826cec8	补全协议介绍	2021-10-05 18:17:08 +08:00
Carm	87c87127b9	Update maven.yml	2021-10-05 18:14:41 +08:00
Carm	50c35488ef	Update README.md	2021-10-03 23:54:12 +08:00
Carm	29539ddb6f	Update README-en.md	2021-10-03 23:53:40 +08:00
Carm	cab2b60abf	add code link	2021-10-03 17:57:22 +08:00
Carm	693ff4a4af	添加相关代码参考的地址	2021-10-03 17:28:48 +08:00
Carm	7c90b8ff99	Rename ----.md to feature_issues.md	2021-10-02 17:00:06 +08:00
Carm	e5ba217873	Update issue templates	2021-10-02 16:59:42 +08:00
Carm	33e0e64b7d	Rename ----.md to bugs_report.md	2021-10-02 16:54:01 +08:00
Carm	6eb60d83d8	添加问题issues模板	2021-10-02 16:53:24 +08:00
carm	875655bc60	2.1.2版本更新修复 “OnNamePrefix” 为true时存在的报错现象	2021-10-02 15:41:39 +08:00
carm	9ca289e4ba	2.1.1版本更新修复 “OnNamePrefix” 为false时存在的报错现象	2021-10-02 15:40:35 +08:00
carm	41a9582d03	2.1.1版本更新修复 “OnNamePrefix” 为false时存在的报错现象	2021-10-02 15:24:54 +08:00
carm	e14901ac86	2.1.0版本更新支持聊天前缀	2021-09-27 01:32:17 +08:00
carm	9a620d7324	更新帖子内容	2021-09-18 13:40:02 +08:00
carm	9cff1c03dc	2.0.0 1. 修复低版本可能无法读取物品的bug。 2. 分离配置文件，消息配置文件改为`messages.yml`，前缀配置文件改为`prefixes/*.yml`，便于配置和管理。 3. 允许配置GUI中上一页和下一页的物品。 4. 补全帮助文档，在插件首次加载将提供一份英文版的配置，以便使用。	2021-09-18 13:19:06 +08:00
Carm	3a457082b1	Update README-en.md	2021-09-17 22:00:22 +08:00
Carm	12218a2141	Update README.md	2021-09-17 22:00:05 +08:00
carm	389e4d3904	添加自动上传构建设定	2021-09-17 19:47:51 +08:00
Carm	6ac3cea7c0	Update spigot.source	2021-09-17 19:24:28 +08:00
carm	3f14294e67	添加发布地址	2021-09-17 19:19:42 +08:00
carm	93521f6621	添加Spigot帖子源码	2021-09-17 19:17:37 +08:00
carm	43a4fb08a6	多语言支持	2021-09-17 19:10:23 +08:00
carm	3dd6398afa	添加英文版介绍	2021-09-17 18:53:20 +08:00