[2.4.2] 修复跨版本时配置文件不全而导致序列化异常的问题

Merge pull request #11 from Ghost-chu/master
Fixed #10, 自定义物品反序列化工具
2026-06-05 09:01:39 +08:00 · 2022-02-21 04:46:39 +08:00 · 2022-02-20 19:48:11 +08:00 · 2022-02-20 19:46:26 +08:00 · 2022-02-20 19:44:36 +08:00 · 2022-02-20 19:36:39 +08:00
45 changed files with 1128 additions and 1117 deletions
@@ -0,0 +1,9 @@
+# UserPrefix Javadoc
+
+基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UserPrefix) 。
+
+## 如何实现？
+
+若您也想通过 [Github Actions](https://docs.github.com/en/actions/learn-github-actions)
+自动部署项目的Javadoc到 [Github Pages](https://pages.github.com/) ，
+可以参考我的文章 [《自动部署Javadoc到Github Pages》](https://pages.carm.cc/doc/javadoc-in-github.html) 。
@@ -0,0 +1,73 @@
+```text
+ _    _                   _____              __  _       
+| |  | |                 |  __ \            / _|(_)      
+| |  | | ___   ___  _ __ | |__) |_ __  ___ | |_  _ __  __
+| |  | |/ __| / _ \| '__||  ___/| '__|/ _ \|  _|| |\ \/ /
+| |__| |\__ \|  __/| |   | |    | |  |  __/| |  | | >  < 
+ \____/ |___/ \___||_|   |_|    |_|   \___||_|  |_|/_/\_\
+```
+
+# UserPrefix 帮助介绍文档
+
+## 插件介绍目录
+
+- 使用示例
+    - [前缀配置文件预设示例](../src/main/resources/prefixes/example-prefix.yml)
+
+## [开发文档](JAVADOC-README.md)
+
+基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/UltraDepository) 。
+
+## 依赖方式
+
+### Maven 依赖
+
+```xml
+
+<project>
+    <repositories>
+
+        <repository>
+            <!--采用github依赖库，安全稳定，但需要配置 (推荐)-->
+            <id>UserPrefix</id>
+            <name>GitHub Packages</name>
+            <url>https://maven.pkg.github.com/CarmJos/UserPrefix</url>
+        </repository>
+
+        <repository>
+            <!--采用我的私人依赖库，简单方便，但可能因为变故而无法使用-->
+            <id>carm-repo</id>
+            <name>Carm's Repo</name>
+            <url>https://repo.carm.cc/repository/maven-public/</url>
+        </repository>
+
+    </repositories>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>cc.carm.plugin</groupId>
+            <artifactId>userprefix</artifactId>
+            <version>[LATEST RELEASE]</version>
+            <scope>provided</scope>
+        </dependency>
+
+    </dependencies>
+</project>
+```
+
+### Gradle 依赖
+
+```groovy
+repositories {
+    // 采用github依赖库，安全稳定，但需要配置 (推荐)
+    maven { url 'https://maven.pkg.github.com/CarmJos/UserPrefix' }
+
+    // 采用我的私人依赖库，简单方便，但可能因为变故而无法使用
+    maven { url 'https://repo.carm.cc/repository/maven-public/' }
+}
+
+dependencies {
+    compileOnly "cc.carm.plugin:userprefix:[LATEST RELEASE]"
+}
+```
@@ -1,30 +1,30 @@
 ---
 name: 问题提交
-about: 提交并描述问题，帮助我们对其进行检查与修复。
+about: 描述问题并提交，帮助我们对其进行检查与修复。
 title: ''
 labels: bug
 assignees: ''

 ---

-**问题简述**
+### **问题简述**
 用简短的话语描述一下大概问题。

-**问题来源**
+### **问题来源**
 描述一下通过哪些操作才发现的问题，如：
 1. 打开 '...'
 2. 点击了 '....'
 3. 出现了报错 '....'

-**预期结果**(可选)
+### **预期结果**(可选)
 如果问题不发生，应该是什么情况

-**问题截图/问题报错**
+### **问题截图/问题报错**
 如果有报错或输出，请提供截图。

-**操作环境**
+### **操作环境**
 请在后台输入 `version` 并复制相关输出。


-**其他补充**
+### **其他补充**
 如有其他补充，可以在这里描述。
@@ -7,14 +7,14 @@ assignees: ''

 ---

-**功能简述**
+### **功能简述**
 简单的描述一下你想要的功能

-**需求来源**
+### **需求来源**
 简单的描述一下为什么需要这个功能。

-**功能参考**(可选)
+### **功能参考**(可选)
 如果有相关功能的参考，如文本、截图，请提供给我们。

-**附加内容**
+### **附加内容**
 如果有什么小细节需要重点注意，请在这里告诉我们。
@@ -9,7 +9,7 @@
 # the `language` matrix defined below to confirm you have the correct set of
 # supported CodeQL languages.
 #
-name: "CodeQL"
+name: "CodeQL Analysis"

 on:
  push:
@@ -1,7 +1,7 @@
 # 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
+name: Deploy & Upload

 on:
  # 支持手动触发构建
@@ -26,8 +26,65 @@ jobs:
          server-id: github
          server-username: MAVEN_USERNAME
          server-password: MAVEN_TOKEN
-      - name: "Deploy"
+
+      - name: "Maven Deploy"
        run: mvn -B deploy --file pom.xml -DskipTests
        env:
          MAVEN_USERNAME: ${{ github.repository_owner }}
-          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
+          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
+
+      - name: "Release Asset Upload"
+        id: upload-release-asset
+        uses: shogo82148/actions-upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ github.event.release.upload_url }}
+          asset_path: asset/*.jar
+          asset_content_type: application/java-archive
+
+      - name: "Javadoc Deploy Staging"
+        run: |
+          rm -rf docs
+          mkdir -vp docs
+          cp -vrf target/apidocs/* docs/
+          cp -vrf .documentation/JAVADOC-README.md docs/README.md
+
+      - name: "Generate the Javadoc sitemap"
+        id: sitemap
+        uses: cicirello/generate-sitemap@v1
+        with:
+          base-url-path: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}
+          path-to-root: docs
+
+      - name: "Output Javadoc stats"
+        run: |
+          echo "sitemap-path = ${{ steps.sitemap.outputs.sitemap-path }}"
+          echo "url-count = ${{ steps.sitemap.outputs.url-count }}"
+          echo "excluded-count = ${{ steps.sitemap.outputs.excluded-count }}"
+
+      - name: "Configure Git"
+        env:
+          DEPLOY_PRI: ${{secrets.DEPLOY_PRI}}
+        run: |
+          sudo timedatectl set-timezone "Asia/Shanghai"
+          mkdir -p ~/.ssh/
+          echo "$DEPLOY_PRI" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          ssh-keyscan github.com >> ~/.ssh/known_hosts
+          git config --global user.name 'CarmJos'
+          git config --global user.email 'carm@carm.cc'
+
+      - name: "Commit Javadocs"
+        run: |
+          cd docs
+          git init
+          git remote add origin git@github.com:${{ github.repository }}.git
+          git checkout -b gh-pages
+          git add -A
+          git commit -m "API Document generated."
+
+      - name: "Push javadocs"
+        run: |
+          cd docs
+          git push origin HEAD:gh-pages --force
@@ -1,84 +0,0 @@
-# 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: Javadoc
-
-on:
-  # 支持手动触发构建
-  workflow_dispatch:
-  release:
-    # 创建release的时候触发
-    types: [ published ]
-
-jobs:
-  api-website:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout the repo
-        uses: actions/checkout@v2
-
-      - name: Set up the Java JDK
-        uses: actions/setup-java@v2
-        with:
-          java-version: '11'
-          distribution: 'adopt'
-
-      - name: Generate docs
-        run: mvn package -DskipTests
-
-      - name: Copy to Location
-        run: |
-          rm -rf docs
-          mkdir -vp docs
-          cp -vrf target/apidocs/* docs/
-          cp -vrf JAVADOC-README.md docs/README.md
-
-#      - name: Tidy up
-#        id: tidy
-#        uses: cicirello/javadoc-cleanup@v1
-#        with:
-#          base-url-path: https://carmjos.github.io/userprefix
-#          path-to-root: docs
-#
-#      - name: Log output
-#        run: |
-#          echo "modified-count = ${{ steps.tidy.outputs.modified-count }}"
-
-      - name: Generate the sitemap
-        id: sitemap
-        uses: cicirello/generate-sitemap@v1
-        with:
-          base-url-path: https://carmjos.github.io/userprefix
-          path-to-root: docs
-
-      - name: Output stats
-        run: |
-          echo "sitemap-path = ${{ steps.sitemap.outputs.sitemap-path }}"
-          echo "url-count = ${{ steps.sitemap.outputs.url-count }}"
-          echo "excluded-count = ${{ steps.sitemap.outputs.excluded-count }}"
-
-      - name: Configure Git
-        env:
-          DEPLOY_PRI: ${{secrets.DEPLOY_PRI}}
-        run: |
-          sudo timedatectl set-timezone "Asia/Shanghai"
-          mkdir -p ~/.ssh/
-          echo "$DEPLOY_PRI" > ~/.ssh/id_rsa
-          chmod 600 ~/.ssh/id_rsa
-          ssh-keyscan github.com >> ~/.ssh/known_hosts
-          git config --global user.name 'CarmJos'
-          git config --global user.email 'carm@carm.cc'
-
-      - name: Commit documentation changes
-        run: |
-          cd docs
-          git init
-          git remote add origin git@github.com:CarmJos/UserPrefix.git
-          git checkout -b gh-pages
-          git add -A
-          git commit -m "API Document generated."
-      - name: Push javadocs
-        run: |
-          cd docs
-          git push origin HEAD:gh-pages --force
-
@@ -1,7 +1,7 @@
 # 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: Build
+name: Build & Tests

 on:
  # 支持手动触发构建
@@ -29,10 +29,15 @@ jobs:
        env:
          MAVEN_USERNAME: ${{ github.repository_owner }}
          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
-      - name: "Target Stage"
-        run: mkdir staging && cp target/*.jar staging
+
+      - name: "Target Staging"
+        run: |
+          mkdir artifacts
+          cp -vrf target/ artifacts/target/
+          cp -vrf asset/*.jar artifacts
+
      - name: "Upload artifact"
        uses: actions/upload-artifact@v2
        with:
          name: Artifact
-          path: staging
+          path: artifacts
@@ -2,3 +2,4 @@
 /target/
 ./*.iml
 *.iml
+asset/
@@ -1,3 +0,0 @@
-# UserPrefix Javadoc
-
-请访问 [JavaDoc](https://carmjos.github.io/UserPrefix) 。
@@ -1,4 +1,6 @@
-![BANNER](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/banner.png)
+![BANNER](.documentation/images/banner.png)
+
+README LANGUAGES [ [中文](README.md) | [**English**](README-en.md)  ]

 # UserPrefix Plugin

@@ -22,7 +24,7 @@ development.

 ## Examples

-![example](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/using-example.png)
+![example](.documentation/images/using-example.png)

 ## Dependencies

@@ -37,16 +39,16 @@ For development dependencies, please see  [Dependencies](https://github.com/Carm

 - **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)
+- 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”.
    - 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)
+- The prefix display on the player name (can be turned off if there has any conflict)
+- Simple Chat Format Placeholder support. (Not Recommended)
+- GUI with automatic sorting and page turning!
+- Support PlaceholderAPI variables!
+- Support [Hex Color](https://www.hexcolortool.com/)! (Version 1.16 and above)  `&(#Color)`
    - Example: LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)`

 ## Notice
@@ -81,7 +83,7 @@ This plugin's Commands are based on Chinese!
 /UserPrefix or /prefix #Open prefix GUI
 /UserPrefixAdmin # View Admin Command Help
 /UserPrefixAdmin reload # Reload Config
-/UserPrefixAdmin list # List all configured prefixes.~~~~
+/UserPrefixAdmin list # List all configured prefixes.
 ```

 ## Placeholders (PlaceholderAPI)
@@ -104,221 +106,25 @@ type `/papi info UserPrefix` to see all the placeholders.

 ## Configuration files

-### [Plugin Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml) (config.yml)
+### Plugin Configuration ([`config.yml`](src/main/resources/en_US/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).
+the [English Version here](src/main/resources/en_US/config.yml).

-<details>
-  <summary>Click to see plugin configuration</summary>
+### Messages Configuration ([`messages.yml`](src/main/resources/en_US/messages.yml))

+Please see the [Source File](src/main/resources/en_US/messages.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"
-```
-
-</details>
-
-### [Messages Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/messages.yml)  (messages.yml)
-
-<details>
-  <summary>Click to see messages configuration</summary>
-
-```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)"
-
-```
-
-</details>
-
-### [Prefixes Configuration](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/example-prefix.yml) (/prefixes/*.yml)
+### Prefixes Configuration ([`prefixes/*.yml`](src/main/resources/en_US/example-prefix.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.

-<details>
-  <summary>Example prefix configuration.</summary>
-
-```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!"
-```
-
-</details>
-
 ## 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)
+![TeamLogo](.documentation/images/team-logo.png)

 ## Open source agreement

@@ -1,25 +1,25 @@
-![BANNER](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/banner.png)
+![BANNER](.documentation/images/banner.png)
+
+README LANGUAGES [ [**中文**](README.md) | [English](README-en.md)  ]

 # 用户前缀系统插件

 [![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)
+[![Download](https://img.shields.io/github/downloads/CarmJos/UserPrefix/total)](https://github.com/CarmJos/UserPrefix/releases)
 [![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)
+![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-green)
 ![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)

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

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

-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/) 上发布。

 ## 示例

-![example](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/using-example.png)
+![example](.documentation/images/using-example.png)

 ## 依赖

@@ -33,19 +33,19 @@ The **English version** of the introduction is [here](https://github.com/CarmJos

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

 ## 注意事项

@@ -97,222 +97,30 @@ The **English version** of the introduction is [here](https://github.com/CarmJos

 ## 配置文件示例

-### [基础配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/config.yml) (config.yml)
+### 基础配置文件 ([`config.yml`](src/main/resources/config.yml))

-<details>
-  <summary>展开查看详细基础配置文件</summary>
+详见 [源文件](src/main/resources/messages.yml) 。

-```yaml
-version: 2.1.9 # 配置文件版本，一般不会动。
+### 消息配置文件 ([`messages.yml`](src/main/resources/messages.yml))

-debug: false #debug输出，开发者用的
+详见 [源文件](src/main/resources/messages.yml) 。

-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| 列表"
-  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"
-  guiClick: "UI_BUTTON_CLICK"
-  prefixChange: "ENTITY_VILLAGER_YES"
-  prefixExpired: "ENTITY_VILLAGER_NO"
-
-# 默认前缀的配置
-# 默认前缀的权重为0哦
-defaultPrefix:
-  name: "默认前缀"
-  content: "&b"
-  itemNotUsing:
-    ==: org.bukkit.inventory.ItemStack
-    type: NAME_TAG
-    meta:
-      ==: ItemMeta
-      meta-type: UNSPECIFIC
-      display-name: "§f默认玩家前缀 §f(点击切换)"
-      lore:
-        - ""
-        - "§a➥ 点击切换到该前缀"
-  itemUsing:
-    ==: org.bukkit.inventory.ItemStack
-    type: NAME_TAG
-    meta:
-      ==: ItemMeta
-      meta-type: UNSPECIFIC
-      display-name: "§f默认玩家前缀"
-      lore:
-        - ""
-        - "§a✔ 您正在使用该前缀"
-```
-
-</details>
-
-### [消息配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/messages.yml) (messages.yml)
-
-<details>
-  <summary>展开查看详细消息配置文件</summary>
-
-```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)"
-```
-
-</details>
-
-### [前缀配置文件](https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/prefixes/example-prefix.yml) (prefixes/*.yml)
+### 前缀配置文件 ([`prefixes/*.yml`](src/main/resources/prefixes/example-prefix.yml))

 所有前缀均为单独的配置文件，存放于 `插件配置目录/prefixes` 下，便于管理。

 文件名理论上可以随便取，推荐使用英文，部分符号可能会影响正常读取，请避免使用。

+您可以 [点击这里](src/main/resources/prefixes/example-prefix.yml) 查看示例前缀配置文件。

-<details>
-  <summary>展开查看示例前缀配置文件</summary>
+## 使用统计

-```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+会员以使用该前缀！"
-```
-
-</details>
+[![bStats](https://bstats.org/signatures/bukkit/UserPrefix.svg)](https://bstats.org/plugin/bukkit/UserPrefix/13776)

 ## 支持与捐赠

 本项目由 [YourCraft(你的世界)](https://www.ycraft.cn) 团队提供长期支持与维护。
-![TeamLogo](https://raw.githubusercontent.com/CarmJos/UserPrefix/master/img/team-logo.png)
+![TeamLogo](.documentation/images/team-logo.png)

 若您觉得本插件做的不错，您可以捐赠支持我！

@@ -352,4 +160,4 @@ itemNoPermission:
 | |  | |/ __| / _ \| '__||  ___/| '__|/ _ \|  _|| |\ \/ /
 | |__| |\__ \|  __/| |   | |    | |  |  __/| |  | | >  < 
 \____/ |___/ \___||_|   |_|    |_|   \___||_|  |_|/_/\_\
-```
+```
@@ -4,9 +4,16 @@
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

+    <properties>
+        <maven.compiler.source>8</maven.compiler.source>
+        <maven.compiler.target>8</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
+    </properties>
+
    <groupId>cc.carm.plugin</groupId>
    <artifactId>userprefix</artifactId>
-    <version>2.2.1</version>
+    <version>2.4.2</version>

    <name>UserPrefix</name>
    <description>轻便、高效、实时的用户前缀系统。</description>
@@ -46,13 +53,6 @@
        </license>
    </licenses>

-    <properties>
-        <maven.compiler.source>8</maven.compiler.source>
-        <maven.compiler.target>8</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
-    </properties>
-
    <repositories>

        <repository>
@@ -80,6 +80,11 @@
            <url>https://repo1.maven.org/maven2/</url>
        </repository>

+        <repository>
+            <id>sonatype-repo</id>
+            <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
+        </repository>
+
        <repository>
            <id>github</id>
            <name>GitHub Packages</name>
@@ -123,7 +128,14 @@
        <dependency>
            <groupId>org.bstats</groupId>
            <artifactId>bstats-bukkit</artifactId>
-            <version>2.2.1</version>
+            <version>3.0.0</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>githubreleases4j</artifactId>
+            <version>1.3.1</version>
            <scope>compile</scope>
        </dependency>

@@ -200,18 +212,25 @@
                        <goals>
                            <goal>shade</goal>
                        </goals>
-                        <configuration>
-                            <createDependencyReducedPom>false</createDependencyReducedPom>
-                        </configuration>
                    </execution>
                </executions>
                <configuration>
+                    <finalName>${project.name}-${project.version}</finalName>
+                    <outputDirectory>${project.basedir}/asset/</outputDirectory>
+                    <createDependencyReducedPom>false</createDependencyReducedPom>
                    <relocations>
                        <relocation>
                            <pattern>org.bstats</pattern>
-                            <!-- Replace this with your package! -->
                            <shadedPattern>cc.carm.plugin.userprefix.bstats</shadedPattern>
                        </relocation>
+                        <relocation>
+                            <pattern>cc.carm.lib.githubreleases4j</pattern>
+                            <shadedPattern>cc.carm.plugin.userprefix.lib.github</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>org.json</pattern>
+                            <shadedPattern>cc.carm.plugin.userprefix.lib.json</shadedPattern>
+                        </relocation>
                    </relocations>
                    <filters>
                        <filter>
@@ -242,4 +261,4 @@
    </build>


-</project>
+</project>
@@ -2,7 +2,8 @@ package cc.carm.plugin.userprefix;

 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.configuration.PluginConfig;
+import cc.carm.plugin.userprefix.hooker.UpdateChecker;
 import cc.carm.plugin.userprefix.hooker.UserPrefixExpansion;
 import cc.carm.plugin.userprefix.listener.ChatListener;
 import cc.carm.plugin.userprefix.listener.UserListener;
@@ -13,140 +14,160 @@ import cc.carm.plugin.userprefix.manager.ServiceManager;
 import cc.carm.plugin.userprefix.manager.UserManager;
 import cc.carm.plugin.userprefix.util.ColorParser;
 import cc.carm.plugin.userprefix.util.MessageUtil;
+import cc.carm.plugin.userprefix.wrapper.ItemStackWrapper;
 import net.luckperms.api.event.user.UserDataRecalculateEvent;
 import org.bstats.bukkit.Metrics;
+import org.bstats.charts.SimplePie;
 import org.bstats.charts.SingleLineChart;
 import org.bukkit.Bukkit;
 import org.bukkit.command.CommandExecutor;
 import org.bukkit.command.PluginCommand;
 import org.bukkit.command.TabCompleter;
+import org.bukkit.configuration.serialization.ConfigurationSerialization;
 import org.bukkit.event.Listener;
+import org.bukkit.plugin.Plugin;
 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 Metrics metrics;
+    private static Main instance;

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

-		log("加载配置文件...");
-		ConfigManager.initConfig();
-		PrefixManager.init();
+        log("注入序列化处理工具...");
+        ConfigurationSerialization.registerClass(ItemStackWrapper.class);

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

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

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

-		if (PrefixConfig.METRICS.get()) {
-			log("启用统计数据...");
-			metrics = new Metrics(this, 13776);
-			metrics.addCustomChart(new SingleLineChart("active_prefixes", () -> PrefixManager.getPrefixes().size()));
-		}
+        if (MessageUtil.hasPlaceholderAPI()) {
+            log("注册变量...");
+            new UserPrefixExpansion(getInstance()).register();
+        } else {
+            log("未安装 PlaceholderAPI 不进行变量注册...");
+            log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
+        }

-		log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+        if (PluginConfig.METRICS.get()) {
+            log("启用统计数据...");
+            Metrics metrics = new Metrics(this, 13776);
+            metrics.addCustomChart(new SingleLineChart("active_prefixes", () -> PrefixManager.getPrefixes().size()));
+            metrics.addCustomChart(new SimplePie("custom_storage", () -> PluginConfig.CustomStorage.ENABLE.get() ? "ENABLE" : "DISABLE"));
+            metrics.addCustomChart(new SimplePie("lp_version", () -> ServiceManager.getService().getPluginMetadata().getVersion()));
+            metrics.addCustomChart(new SimplePie("papi_version", () -> {
+                Plugin plugin = Bukkit.getPluginManager().getPlugin("PlaceholderAPI");
+                if (plugin == null) return "Not installed";
+                else return plugin.getDescription().getVersion();
+            }));
+        }

-		showAD();
+        if (PluginConfig.CHECK_UPDATE.get()) {
+            log("开始检查更新...");
+            UpdateChecker.checkUpdate(getDescription().getVersion());
+        } else {
+            log("已禁用检查更新，跳过。");
+        }

-		if (Bukkit.getOnlinePlayers().size() > 0) {
-			Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
-		}
+        log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+
+        showAD();
+
+        if (Bukkit.getOnlinePlayers().size() > 0) {
+            Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
+        }


-	}
+    }

-	@Override
-	public void onDisable() {
-		showPluginName();
-		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 (PluginConfig.DEBUG.get()) {
+            log("[DEBUG] " + message);
+        }
+    }

-	public static void error(String message) {
-		log("&c[ERROR] &r" + message);
-	}
+    public static void error(String message) {
+        log("&c[ERROR] &r" + message);
+    }


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


-	public static void registerCommand(String commandName,
-									   @NotNull CommandExecutor executor) {
-		registerCommand(commandName, executor, null);
-	}
+    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);
-	}
+    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 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提供长期支持与维护。");
-	}
+    private void showAD() {
+        log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
+        log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
+    }

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

-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.configuration.PluginConfig;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import cc.carm.plugin.userprefix.manager.PrefixManager;
 import cc.carm.plugin.userprefix.manager.UserManager;
@@ -22,10 +22,10 @@ public class UserPrefixAdminCommand implements CommandExecutor {
        if (args.length == 1) {
            String aim = args[0];
            if (aim.equalsIgnoreCase("list")) {
-                MessageUtil.sendWithPlaceholders(sender, PrefixConfig.Messages.LIST_TITLE.get());
+                MessageUtil.sendWithPlaceholders(sender, PluginConfig.Messages.LIST_TITLE.get());
                for (ConfiguredPrefix value : PrefixManager.getPrefixes().values()) {
                    MessageUtil.sendWithPlaceholders(
-                            sender, PrefixConfig.Messages.LIST_VALUE.get(),
+                            sender, PluginConfig.Messages.LIST_VALUE.get(),
                            new String[]{
                                    "%(weight)", "%(identifier)",
                                    "%(name)", "%(permission)",
@@ -54,7 +54,7 @@ public class UserPrefixAdminCommand implements CommandExecutor {
                    UserManager.updatePrefixView(onlinePlayer, false);
                }
                MessageUtil.sendWithPlaceholders(
-                        sender, PrefixConfig.Messages.RELOAD.get(),
+                        sender, PluginConfig.Messages.RELOAD.get(),
                        new String[]{"%(time)"}, new Object[]{(System.currentTimeMillis() - s1)}
                );
                return true;
@@ -65,7 +65,7 @@ public class UserPrefixAdminCommand implements CommandExecutor {
    }

    public static boolean help(CommandSender sender) {
-        MessageUtil.send(sender, PrefixConfig.Messages.HELP.get());
+        MessageUtil.send(sender, PluginConfig.Messages.HELP.get());
        return true;
    }

@@ -0,0 +1,87 @@
+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.util.ItemStackFactory;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemStack;
+
+public class PluginConfig {
+
+    public static ConfigValue<Boolean> DEBUG = new ConfigValue<>("debug", Boolean.class, false);
+
+    public static ConfigValue<Boolean> METRICS = new ConfigValue<>("metrics", Boolean.class, true);
+
+    public static final ConfigValue<Boolean> CHECK_UPDATE = new ConfigValue<>("check-update", Boolean.class, true);
+
+    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 ConfigMessageList SELECTED = new ConfigMessageList("selected");
+        public static ConfigMessageList EXPIRED = new ConfigMessageList("expired");
+        public static ConfigMessageList REMOVED = new ConfigMessageList("removed");
+
+        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 {
+
+        public static ConfigSound GUI_OPEN = new ConfigSound("Sounds.openGUI");
+        public static ConfigSound GUI_CLICK = new ConfigSound("Sounds.guiClick");
+        public static ConfigSound PREFIX_CHANGE = new ConfigSound("Sounds.prefixChange");
+        public static ConfigSound PREFIX_EXPIRED = new ConfigSound("Sounds.prefixExpired");
+
+    }
+
+
+}
@@ -1,83 +0,0 @@
-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.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 ConfigValue<Boolean> METRICS = new ConfigValue<>("metrics", Boolean.class, true);
-
-	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 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 {
-
-		public static ConfigSound GUI_OPEN = new ConfigSound("Sounds.openGUI");
-		public static ConfigSound GUI_CLICK = new ConfigSound("Sounds.guiClick");
-		public static ConfigSound PREFIX_CHANGE = new ConfigSound("Sounds.prefixChange");
-		public static ConfigSound PREFIX_EXPIRED = new ConfigSound("Sounds.prefixExpired");
-
-	}
-
-
-}
@@ -1,8 +1,8 @@
 package cc.carm.plugin.userprefix.configuration.file;


+import cc.carm.plugin.userprefix.util.ConfigurationUtil;
 import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.plugin.java.JavaPlugin;

 import java.io.File;
@@ -35,7 +35,7 @@ public class FileConfig {
            }
            plugin.saveResource(fileName, true);
        }
-        this.config = YamlConfiguration.loadConfiguration(this.file);
+        this.config = ConfigurationUtil.bang(this.file);
    }

    public File getFile() {
@@ -56,7 +56,7 @@ public class FileConfig {

    public void reload() {
        if (getFile().exists()) {
-            this.config = YamlConfiguration.loadConfiguration(getFile());
+            this.config =  ConfigurationUtil.bang(getFile());
        } else {
            initFile();
        }
@@ -0,0 +1,75 @@
+package cc.carm.plugin.userprefix.event;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Cancellable;
+import org.bukkit.event.HandlerList;
+import org.bukkit.scheduler.BukkitRunnable;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.function.Consumer;
+
+public class UserPrefixChangeEvent extends UserPrefixEvent implements Cancellable {
+
+	public static HandlerList handler = new HandlerList();
+
+	private boolean cancelled;
+
+	private final @Nullable ConfiguredPrefix before;
+	private @NotNull ConfiguredPrefix after;
+
+	public UserPrefixChangeEvent(@NotNull Player who,
+								 @Nullable ConfiguredPrefix before,
+								 @NotNull ConfiguredPrefix after) {
+		super(who);
+		this.before = before;
+		this.after = after;
+	}
+
+	public @Nullable ConfiguredPrefix getBefore() {
+		return before;
+	}
+
+	public @NotNull ConfiguredPrefix getAfter() {
+		return after;
+	}
+
+	public void setAfter(@NotNull ConfiguredPrefix after) {
+		this.after = after;
+	}
+
+	@Override
+	public boolean isCancelled() {
+		if (before == null) return false; //Could not be cancelled when prefix is null.
+		else return this.cancelled;
+	}
+
+	@Override
+	public void setCancelled(boolean cancel) {
+		this.cancelled = cancel;
+	}
+
+	@NotNull
+	@Override
+	public HandlerList getHandlers() {
+		return handler;
+	}
+
+	public static void call(@NotNull Player who,
+							@Nullable ConfiguredPrefix before,
+							@NotNull ConfiguredPrefix after,
+							@Nullable Consumer<@Nullable ConfiguredPrefix> finish) {
+		new BukkitRunnable() {
+			@Override
+			public void run() {
+				UserPrefixChangeEvent event = new UserPrefixChangeEvent(who, before, after);
+				Bukkit.getPluginManager().callEvent(event);
+				if (finish != null) finish.accept(event.isCancelled() ? null : event.getAfter());
+			}
+		}.runTask(Main.getInstance());
+	}
+
+}
@@ -0,0 +1,13 @@
+package cc.carm.plugin.userprefix.event;
+
+import org.bukkit.entity.Player;
+import org.bukkit.event.player.PlayerEvent;
+import org.jetbrains.annotations.NotNull;
+
+public abstract class UserPrefixEvent extends PlayerEvent {
+
+	public UserPrefixEvent(@NotNull Player who) {
+		super(who);
+	}
+
+}
@@ -0,0 +1,43 @@
+package cc.carm.plugin.userprefix.event;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.HandlerList;
+import org.bukkit.scheduler.BukkitRunnable;
+import org.jetbrains.annotations.NotNull;
+
+public class UserPrefixExpireEvent extends UserPrefixEvent {
+
+	public static HandlerList handler = new HandlerList();
+
+
+	public final @NotNull ConfiguredPrefix expiredPrefix;
+
+	public UserPrefixExpireEvent(@NotNull Player who,
+								 @NotNull ConfiguredPrefix expiredPrefix) {
+		super(who);
+		this.expiredPrefix = expiredPrefix;
+	}
+
+	public @NotNull ConfiguredPrefix getExpiredPrefix() {
+		return expiredPrefix;
+	}
+
+	@NotNull
+	@Override
+	public HandlerList getHandlers() {
+		return handler;
+	}
+
+	public static void call(@NotNull Player player, @NotNull ConfiguredPrefix currentPrefix) {
+		new BukkitRunnable() {
+			@Override
+			public void run() {
+				Bukkit.getPluginManager().callEvent(new UserPrefixExpireEvent(player, currentPrefix));
+			}
+		}.runTask(Main.getInstance());
+	}
+
+}
@@ -0,0 +1,35 @@
+package cc.carm.plugin.userprefix.hooker;
+
+import cc.carm.lib.githubreleases4j.GithubReleases4J;
+import cc.carm.plugin.userprefix.Main;
+import org.bukkit.scheduler.BukkitRunnable;
+
+public class UpdateChecker {
+
+    public static void checkUpdate(String currentVersion) {
+        new BukkitRunnable() {
+            @Override
+            public void run() {
+                String downloadURL = GithubReleases4J.getReleasesURL("CarmJos", "UserPrefix");
+                Integer behindVersions = GithubReleases4J.getVersionBehind(
+                        "CarmJos", "UserPrefix", currentVersion
+                );
+
+                if (behindVersions == null) {
+                    Main.error("检查更新失败，请您定期查看插件是否更新，避免安全问题。");
+                    Main.error("下载地址 " + downloadURL);
+                } else if (behindVersions == 0) {
+                    Main.log("检查完成，当前已是最新版本。");
+                } else if (behindVersions > 0) {
+                    Main.log("发现新版本! 目前已落后 " + behindVersions + " 个版本。");
+                    Main.log("最新版下载地址 " + downloadURL);
+                } else {
+                    Main.error("检查更新失败! 当前版本未知，请您使用原生版本以避免安全问题。");
+                    Main.error("最新版下载地址 " + downloadURL);
+                }
+            }
+        }.runTaskAsynchronously(Main.getInstance());
+    }
+
+
+}
@@ -1,7 +1,7 @@
 package cc.carm.plugin.userprefix.listener;

 import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.configuration.PluginConfig;
 import cc.carm.plugin.userprefix.util.MessageUtil;
 import me.clip.placeholderapi.PlaceholderAPI;
 import org.bukkit.event.EventHandler;
@@ -12,8 +12,8 @@ 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 (!PluginConfig.Functions.Chat.ENABLE.get()) return;
+		String format = PluginConfig.Functions.Chat.FORMAT.get();
 		if (format == null || format.length() < 1) return;

 		if (!MessageUtil.hasPlaceholderAPI()) return;
@@ -1,7 +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.configuration.PluginConfig;
 import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
 import cc.carm.plugin.userprefix.util.ItemStackFactory;
 import org.bukkit.Material;
@@ -36,6 +36,7 @@ public class PrefixManager {
 		loadConfiguredPrefixes();
 	}

+	@SuppressWarnings("ResultOfMethodCallIgnored")
 	public static void loadConfiguredPrefixes() {

 		File prefixDataFolder = getStorageFolder();
@@ -159,8 +160,8 @@ public class PrefixManager {
 	}

 	private static File getStorageFolder() {
-		if (PrefixConfig.CustomStorage.ENABLE.get()) {
-			return new File(PrefixConfig.CustomStorage.PATH.get());
+		if (PluginConfig.CustomStorage.ENABLE.get()) {
+			return new File(PluginConfig.CustomStorage.PATH.get());
 		} else {
 			return new File(Main.getInstance().getDataFolder() + File.separator + FOLDER_NAME);
 		}
@@ -1,11 +1,12 @@
 package cc.carm.plugin.userprefix.manager;

 import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.configuration.PluginConfig;
+import cc.carm.plugin.userprefix.event.UserPrefixChangeEvent;
+import cc.carm.plugin.userprefix.event.UserPrefixExpireEvent;
 import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
 import cc.carm.plugin.userprefix.nametag.UserNameTag;
 import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
-import cc.carm.plugin.userprefix.util.MessageUtil;
 import cc.carm.plugin.userprefix.util.gui.GUI;
 import net.luckperms.api.model.user.User;
 import net.luckperms.api.node.NodeType;
@@ -20,247 +21,269 @@ import java.util.stream.Collectors;

 public class UserManager {

-    public static HashMap<UUID, UserNameTag> nameTags = new HashMap<>();
+	public static HashMap<UUID, UserNameTag> nameTags = new HashMap<>();

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

-    @Nullable
-    public static UserNameTag getNameTag(Player player) {
-        if (PrefixConfig.Functions.NAME_PREFIX.get()) {
-            if (nameTags.containsKey(player.getUniqueId())) {
-                return nameTags.get(player.getUniqueId());
-            } else {
-                return createNameTag(player);
-            }
-        } else {
-            return null;
-        }
-    }
+	@Nullable
+	public static UserNameTag getNameTag(Player player) {
+		if (PluginConfig.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;
-    }
+	@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;
+	}

-    public static void initPlayer(Player player) {
-        UserManager.checkPrefix(player, false);
-        if (PrefixConfig.Functions.NAME_PREFIX.get()) {
-            UserManager.createNameTag(player);
-            UserManager.updatePrefixView(player, true);
-        }
-    }
+	public static void initPlayer(Player player) {
+		UserManager.checkPrefix(player, false);
+		if (PluginConfig.Functions.NAME_PREFIX.get()) {
+			UserManager.createNameTag(player);
+			UserManager.updatePrefixView(player, true);
+		}
+	}

-    public static void unloadPlayer(Player player) {
-        PrefixSelectGUI.removeOpening(player);
-        UserManager.unloadNameTag(player.getUniqueId());
-        UserManager.checkingPlayers.remove(player.getUniqueId());
-        GUI.removeOpenedGUI(player); // 清空打开过的GUI缓存 (用于记录物品点击的
-    }
+	public static void unloadPlayer(Player player) {
+		PrefixSelectGUI.removeOpening(player);
+		UserManager.unloadNameTag(player.getUniqueId());
+		UserManager.checkingPlayers.remove(player.getUniqueId());
+		GUI.removeOpenedGUI(player); // 清空打开过的GUI缓存 (用于记录物品点击的
+	}

-    /**
-     * 更新前缀显示效果
-     *
-     * @param player     玩家
-     * @param loadOthers 是否为玩家更新其他人的前缀(一般用于加入游戏)
-     */
-    public static void updatePrefixView(Player player, boolean loadOthers) {
-        if (!PrefixConfig.Functions.NAME_PREFIX.get()) return; //未启用的情况下，不需要进行任何操作。
-        ConfiguredPrefix playerPrefix = UserManager.getPrefix(player);
+	/**
+	 * 更新前缀显示效果
+	 *
+	 * @param player     玩家
+	 * @param loadOthers 是否为玩家更新其他人的前缀(一般用于加入游戏)
+	 */
+	public static void updatePrefixView(Player player, boolean loadOthers) {
+		if (!PluginConfig.Functions.NAME_PREFIX.get()) return; //未启用的情况下，不需要进行任何操作。
+		UserNameTag tag = getNameTag(player);
+		if (tag == null) return;  //未启用的情况下，不需要进行任何操作。

-        UserNameTag tag = getNameTag(player);
+		ConfiguredPrefix playerPrefix = UserManager.getPrefix(player);

-        tag.setPrefix(playerPrefix.getContent());
-        tag.setOrder(playerPrefix.getWeight());
+		tag.setPrefix(playerPrefix.getContent());
+		tag.setOrder(playerPrefix.getWeight());

-        Main.debug("为玩家 " + player.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());
+		Main.debug("为玩家 " + player.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());

-        for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
-            if (onlinePlayer.equals(player)) continue;
-            UserNameTag onlinePlayerTag = getNameTag(onlinePlayer);
-            if (onlinePlayerTag != null) {
-                onlinePlayerTag.setPrefix(player, playerPrefix.getContent());
-                onlinePlayerTag.setOrder(player, playerPrefix.getWeight());
-                Main.debug("为玩家 " + onlinePlayer.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());
+		for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
+			if (onlinePlayer.equals(player)) continue;
+			UserNameTag onlinePlayerTag = getNameTag(onlinePlayer);
+			if (onlinePlayerTag != null) {
+				onlinePlayerTag.setPrefix(player, playerPrefix.getContent());
+				onlinePlayerTag.setOrder(player, playerPrefix.getWeight());
+				Main.debug("为玩家 " + onlinePlayer.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());

-            }
+			}

-            if (loadOthers) {
-                ConfiguredPrefix onlinePlayerPrefix = UserManager.getPrefix(onlinePlayer);
-                tag.setPrefix(onlinePlayer, onlinePlayerPrefix.getContent());
-                tag.setOrder(onlinePlayer, onlinePlayerPrefix.getWeight());
-                Main.debug("为玩家 " + player.getName() + " 设置了 " + onlinePlayer.getName() + "的前缀为 #" + onlinePlayerPrefix.getWeight() + " " + onlinePlayerPrefix.getName());
-            }
-        }
-    }
+			if (loadOthers) {
+				ConfiguredPrefix onlinePlayerPrefix = UserManager.getPrefix(onlinePlayer);
+				tag.setPrefix(onlinePlayer, onlinePlayerPrefix.getContent());
+				tag.setOrder(onlinePlayer, onlinePlayerPrefix.getWeight());
+				Main.debug("为玩家 " + player.getName() + " 设置了 " + onlinePlayer.getName() + "的前缀为 #" + onlinePlayerPrefix.getWeight() + " " + onlinePlayerPrefix.getName());
+			}
+		}
+	}

-    /**
-     * 检查玩家的前缀的使用权
-     *
-     * @param player     玩家
-     * @param updateView 是否更新头顶与TabList中的前缀
-     */
-    public static void checkPrefix(Player player, boolean updateView) {
-        if (checkingPlayers.contains(player.getUniqueId())) {
-            /*
-             * 这里为了避免极短时间内的重复触发导致多次判断且结果相同误导玩家，
-             * 故没有采用同步锁，而是采用添加到一个临时Set中，对Set中玩家跳过判断。
-             */
-            return;
-        }
-        checkingPlayers.add(player.getUniqueId());
-        String currentPrefixIdentifier = UserManager.getPrefixData(player);
-        ConfiguredPrefix currentPrefix = PrefixManager.getPrefix(currentPrefixIdentifier);
-        if (!UserManager.isPrefixUsable(player, currentPrefixIdentifier)) {
-            ConfiguredPrefix newPrefix = UserManager.getHighestPrefix(player);
-            // 更新前缀
-            UserManager.setPrefix(player, newPrefix, updateView);
-            // 发送消息
-            MessageUtil.sendWithPlaceholders(player, PrefixConfig.Messages.EXPIRED.get(),
-                    new String[]{"%(newName)", "%(oldName)"},
-                    new Object[]{newPrefix.getName(), currentPrefix != null ? currentPrefix.getName() : currentPrefixIdentifier}
-            );
-            // 播放声音
-            PrefixConfig.Sounds.PREFIX_EXPIRED.play(player);
-        }
-        checkingPlayers.remove(player.getUniqueId());
-    }
+	/**
+	 * 检查玩家的前缀的使用权
+	 *
+	 * @param player     玩家
+	 * @param updateView 是否更新头顶与TabList中的前缀
+	 */
+	public static void checkPrefix(Player player, boolean updateView) {
+		if (checkingPlayers.contains(player.getUniqueId())) {
+			/*
+			 * 这里为了避免极短时间内的重复触发导致多次判断且结果相同误导玩家，
+			 * 故没有采用同步锁，而是采用添加到一个临时Set中，对Set中玩家跳过判断。
+			 */
+			return;
+		}
+		checkingPlayers.add(player.getUniqueId());
+		String currentPrefixData = UserManager.getPrefixData(player);

-    public static void unloadNameTag(UUID uuid) {
-        nameTags.remove(uuid);
-    }
+		if (!UserManager.isPrefixUsable(player, currentPrefixData)) {
+			ConfiguredPrefix currentPrefix = PrefixManager.getPrefix(currentPrefixData);
+			ConfiguredPrefix newPrefix = UserManager.getHighestPrefix(player);

-    /**
-     * 得到玩家的前缀。
-     * 该方法会自动判断玩家当前的前缀是否可用，并返回最终可用的前缀。
-     *
-     * @param player 玩家
-     * @return 前缀配置
-     */
-    @NotNull
-    public static ConfiguredPrefix getPrefix(Player player) {
-        String identifier = getPrefixData(player);
-        if (identifier == null || !isPrefixUsable(player, identifier)) {
-            return getHighestPrefix(player);
-        } else {
-            ConfiguredPrefix prefix = PrefixManager.getPrefix(identifier);
-            return prefix == null ? PrefixManager.getDefaultPrefix() : prefix;
-        }
-    }
+			if (currentPrefix != null) {
+				//当前前缀不为空，则代表属于前缀过期的情况
+				UserPrefixExpireEvent.call(player, currentPrefix);

-    /**
-     * 设定玩家前缀
-     *
-     * @param player     玩家
-     * @param prefix     前缀配置
-     * @param updateView 是否更新头顶上、TabList的前缀
-     */
-    public static void setPrefix(Player player, ConfiguredPrefix prefix, boolean updateView) {
-        setPrefixData(player, prefix.getIdentifier());
-        if (updateView) updatePrefixView(player, false);
-    }
+				// 发送消息
+				PluginConfig.Messages.EXPIRED.sendWithPlaceholders(player,
+						new String[]{"%(newName)", "%(oldName)"},
+						new Object[]{newPrefix.getName(), currentPrefix.getName()}
+				);

-    /**
-     * 得到玩家所有可用的前缀
-     *
-     * @param player 玩家
-     * @return 可用前缀列表
-     */
-    @NotNull
-    public static List<ConfiguredPrefix> getUsablePrefixes(Player player) {
-        return PrefixManager.getPrefixes().values().stream()
-                .filter(configuredPrefix -> isPrefixUsable(player, configuredPrefix)) //过滤出玩家可用的前缀
-                .sorted(Comparator.comparingInt(ConfiguredPrefix::getWeight)) // 以前缀排序
-                .collect(Collectors.toList()); // 返回集合
-    }
+				// 播放声音
+				PluginConfig.Sounds.PREFIX_EXPIRED.play(player);
+			} else {
+				// 当前前缀为空，则代表是旧的前缀不存在了，
+				PluginConfig.Messages.REMOVED.sendWithPlaceholders(player,
+						new String[]{"%(newName)", "%(oldName)"},
+						new Object[]{newPrefix.getName(), currentPrefixData}
+				);
+			}
+
+			UserPrefixChangeEvent.call(player, currentPrefix, newPrefix, (after) -> {
+				if (after != null) {
+					UserManager.setPrefix(player, after, updateView);
+				}
+				checkingPlayers.remove(player.getUniqueId());
+			});
+			
+		} else {
+			checkingPlayers.remove(player.getUniqueId());
+		}
+	}
+
+	public static void unloadNameTag(UUID uuid) {
+		nameTags.remove(uuid);
+	}
+
+	/**
+	 * 得到玩家的前缀。
+	 * 该方法会自动判断玩家当前的前缀是否可用，并返回最终可用的前缀。
+	 *
+	 * @param player 玩家
+	 * @return 前缀配置
+	 */
+	@NotNull
+	public static ConfiguredPrefix getPrefix(Player player) {
+		String identifier = getPrefixData(player);
+		if (identifier == null || !isPrefixUsable(player, identifier)) {
+			return getHighestPrefix(player);
+		} else {
+			ConfiguredPrefix prefix = PrefixManager.getPrefix(identifier);
+			return prefix == null ? PrefixManager.getDefaultPrefix() : prefix;
+		}
+	}
+
+	/**
+	 * 设定玩家前缀
+	 *
+	 * @param player     玩家
+	 * @param prefix     前缀配置
+	 * @param updateView 是否更新头顶上、TabList的前缀
+	 */
+	public static void setPrefix(Player player, ConfiguredPrefix prefix, boolean updateView) {
+		setPrefixData(player, prefix.getIdentifier());
+		if (updateView) updatePrefixView(player, false);
+	}
+
+	/**
+	 * 得到玩家所有可用的前缀
+	 *
+	 * @param player 玩家
+	 * @return 可用前缀列表
+	 */
+	@NotNull
+	public static List<ConfiguredPrefix> getUsablePrefixes(Player player) {
+		return PrefixManager.getPrefixes().values().stream()
+				.filter(configuredPrefix -> isPrefixUsable(player, configuredPrefix)) //过滤出玩家可用的前缀
+				.sorted(Comparator.comparingInt(ConfiguredPrefix::getWeight)) // 以前缀排序
+				.collect(Collectors.toList()); // 返回集合
+	}


-    /**
-     * 得到玩家可使用的最高权重的权限
-     * 注意：若配置文件中关闭了 “autoUsePrefix” ,则会返回默认前缀。
-     *
-     * @param player 玩家
-     * @return 权限内容
-     */
-    @NotNull
-    public static ConfiguredPrefix getHighestPrefix(Player player) {
-        if (PrefixConfig.Functions.AUTO_USE.get()) {
-            // 关闭了自动选择，就直接给默认的前缀，让玩家自己去设置吧~
-            return PrefixManager.getDefaultPrefix();
-        }
-        return getUsablePrefixes(player).stream()
-                .max(Comparator.comparingInt(ConfiguredPrefix::getWeight)) // 取权重最大
-                .orElseGet(PrefixManager::getDefaultPrefix); // 啥都没有？ 返回默认前缀。
-    }
+	/**
+	 * 得到玩家可使用的最高权重的权限
+	 * 注意：若配置文件中关闭了 “autoUsePrefix” ,则会返回默认前缀。
+	 *
+	 * @param player 玩家
+	 * @return 权限内容
+	 */
+	@NotNull
+	public static ConfiguredPrefix getHighestPrefix(Player player) {
+		if (PluginConfig.Functions.AUTO_USE.get()) {
+			// 关闭了自动选择，就直接给默认的前缀，让玩家自己去设置吧~
+			return PrefixManager.getDefaultPrefix();
+		}
+		return getUsablePrefixes(player).stream()
+				.max(Comparator.comparingInt(ConfiguredPrefix::getWeight)) // 取权重最大
+				.orElseGet(PrefixManager::getDefaultPrefix); // 啥都没有？ 返回默认前缀。
+	}

-    /**
-     * 判断一个前缀对某玩家是否可用
-     *
-     * @param player           玩家
-     * @param prefixIdentifier 前缀标识
-     * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
-     */
-    public static boolean isPrefixUsable(Player player, String prefixIdentifier) {
-        if (prefixIdentifier == null || prefixIdentifier.equalsIgnoreCase("default")) return true;
-        ConfiguredPrefix prefix = PrefixManager.getPrefix(prefixIdentifier);
-        if (prefix == null) return false;
-        return isPrefixUsable(player, prefix);
-    }
+	/**
+	 * 判断一个前缀对某玩家是否可用
+	 *
+	 * @param player           玩家
+	 * @param prefixIdentifier 前缀标识
+	 * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
+	 */
+	public static boolean isPrefixUsable(Player player, String prefixIdentifier) {
+		if (prefixIdentifier == null || prefixIdentifier.equalsIgnoreCase("default")) return true;
+		ConfiguredPrefix prefix = PrefixManager.getPrefix(prefixIdentifier);
+		if (prefix == null) return false;
+		return isPrefixUsable(player, prefix);
+	}

-    /**
-     * 判断一个前缀对某玩家是否可用
-     *
-     * @param player           玩家
-     * @param configuredPrefix 前缀配置
-     * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
-     */
-    public static boolean isPrefixUsable(Player player, ConfiguredPrefix configuredPrefix) {
-        return configuredPrefix.isPublic()
-                || ServiceManager.hasPermission(ServiceManager.getUser(player), configuredPrefix.getPermission());
-    }
+	/**
+	 * 判断一个前缀对某玩家是否可用
+	 *
+	 * @param player           玩家
+	 * @param configuredPrefix 前缀配置
+	 * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
+	 */
+	public static boolean isPrefixUsable(Player player, ConfiguredPrefix configuredPrefix) {
+		return configuredPrefix.isPublic()
+				|| ServiceManager.hasPermission(ServiceManager.getUser(player), configuredPrefix.getPermission());
+	}

-    /**
-     * 得到用户当前正在使用的前缀Identifier。
-     * 该方法通过LuckPerms的MetaData实现，因此可以通过指令去操作。
-     *
-     * @param player 玩家
-     * @return 正在使用的前缀Identifier(若不存在则返回null)
-     */
-    @Nullable
-    public static String getPrefixData(Player player) {
-        return ServiceManager.getAPI().getMetaData(player)
-                .getMetaValue("userprefix", String::valueOf)
-                .orElse(null);
-    }
+	/**
+	 * 得到用户当前正在使用的前缀Identifier。
+	 * 该方法通过LuckPerms的MetaData实现，因此可以通过指令去操作。
+	 *
+	 * @param player 玩家
+	 * @return 正在使用的前缀Identifier(若不存在则返回null, 代表未设置前缀)
+	 */
+	@Nullable
+	public static String getPrefixData(Player player) {
+		return ServiceManager.getAPI().getMetaData(player)
+				.getMetaValue("userprefix", String::valueOf)
+				.orElse(null);
+	}

-    /**
-     * 设定用户所使用的的prefix。
-     * 该方法通过LuckPerms的MetaData实现，因此可以通过指令去操作。
-     *
-     * @param player           玩家
-     * @param prefixIdentifier 前缀的标识
-     */
-    public static void setPrefixData(Player player, String prefixIdentifier) {
-        User user = ServiceManager.getUser(player);
-        clearPrefixData(player); // 清除掉旧的数据，LuckPerms不会去覆盖一个Meta，需要手动清除。
-        if (prefixIdentifier != null) {
-            user.data().add(MetaNode.builder("userprefix", prefixIdentifier).build());
-            ServiceManager.getService().getUserManager().saveUser(user); // 保存数据
-        }
-    }
+	/**
+	 * 设定用户所使用的的prefix。
+	 * 该方法通过LuckPerms的MetaData实现，因此可以通过指令去操作。
+	 *
+	 * @param player           玩家
+	 * @param prefixIdentifier 前缀的标识
+	 */
+	public static void setPrefixData(Player player, String prefixIdentifier) {
+		User user = ServiceManager.getUser(player);
+		clearPrefixData(player); // 清除掉旧的数据，LuckPerms不会去覆盖一个Meta，需要手动清除。
+		if (prefixIdentifier != null) {
+			user.data().add(MetaNode.builder("userprefix", prefixIdentifier).build());
+			ServiceManager.getService().getUserManager().saveUser(user); // 保存数据
+		}
+	}

-    /**
-     * 清除玩家所选择的前缀数据
-     *
-     * @param player 玩家
-     */
-    public static void clearPrefixData(Player player) {
-        User user = ServiceManager.getUser(player);
-        // LuckPerms竟然会把所有的metaKey全部转换为小写... 那我这里就直接写成小写吧~
-        user.data().clear(NodeType.META.predicate(mn -> mn.getMetaKey().equals("userprefix")));
-    }
+	/**
+	 * 清除玩家所选择的前缀数据
+	 *
+	 * @param player 玩家
+	 */
+	public static void clearPrefixData(Player player) {
+		User user = ServiceManager.getUser(player);
+		// LuckPerms竟然会把所有的metaKey全部转换为小写... 那我这里就直接写成小写吧~
+		user.data().clear(NodeType.META.predicate(mn -> mn.getMetaKey().equals("userprefix")));
+	}


 }
@@ -1,11 +1,11 @@
 package cc.carm.plugin.userprefix.model;

 import cc.carm.plugin.userprefix.util.ColorParser;
+import cc.carm.plugin.userprefix.util.ConfigurationUtil;
 import cc.carm.plugin.userprefix.util.ItemStackFactory;
 import cc.carm.plugin.userprefix.util.MessageUtil;
 import org.bukkit.Material;
 import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.configuration.file.YamlConfiguration;
 import org.bukkit.entity.Player;
 import org.bukkit.inventory.ItemStack;
 import org.bukkit.inventory.meta.ItemMeta;
@@ -38,7 +38,11 @@ public class ConfiguredPrefix {

 	public ConfiguredPrefix(@NotNull File dataFile) {
 		this.dataFile = dataFile;
-		this.configuration = YamlConfiguration.loadConfiguration(dataFile);
+		try {
+			this.configuration = ConfigurationUtil.bang(dataFile);
+		} catch (Exception e) {
+			e.printStackTrace();
+		}
 		if (getConfiguration() != null) {
 			this.identifier = getConfiguration().getString("identifier", "ERROR");
 			this.name = getConfiguration().getString("name", "ERROR");
@@ -1,6 +1,6 @@
 package cc.carm.plugin.userprefix.ui;

-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.configuration.PluginConfig;
 import cc.carm.plugin.userprefix.manager.PrefixManager;
 import cc.carm.plugin.userprefix.manager.UserManager;
 import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
@@ -17,80 +17,81 @@ import java.util.List;

 public class PrefixSelectGUI extends AutoPagedGUI {

-    public static HashSet<Player> openingUsers = new HashSet<>();
+	public static HashSet<Player> openingUsers = new HashSet<>();

-    Player player;
+	Player player;

-    public PrefixSelectGUI(Player player) {
-        super(GUIType.SIXBYNINE, PrefixConfig.GUI.TITLE.get(), 10, 43);
-        this.player = player;
+	public PrefixSelectGUI(Player player) {
+		super(GUIType.SIXBYNINE, PluginConfig.GUI.TITLE.get(), 10, 43);
+		this.player = player;

-        setPreviousPageSlot(18);
-        setNextPageSlot(26);
+		setPreviousPageSlot(18);
+		setNextPageSlot(26);

-        loadItems();
-    }
+		loadItems();
+	}

-    public Player getPlayer() {
-        return player;
-    }
+	public Player getPlayer() {
+		return player;
+	}

-    public void loadItems() {
-        List<ConfiguredPrefix> prefixList = new ArrayList<>();
-        prefixList.add(PrefixManager.getDefaultPrefix());
-        prefixList.addAll(PrefixManager.getVisiblePrefix()); //只需要读取看得见的
+	public void loadItems() {
+		List<ConfiguredPrefix> prefixList = new ArrayList<>();
+		prefixList.add(PrefixManager.getDefaultPrefix());
+		prefixList.addAll(PrefixManager.getVisiblePrefix()); //只需要读取看得见的

-        ConfiguredPrefix usingPrefix = UserManager.getPrefix(getPlayer());
+		ConfiguredPrefix usingPrefix = UserManager.getPrefix(getPlayer());

-        for (ConfiguredPrefix prefix : prefixList) {
-            if (prefix.getIdentifier().equals(usingPrefix.getIdentifier())) {
-                addItem(new GUIItem(prefix.getItemWhenUsing(player) != null ? prefix.getItemWhenUsing(player) : prefix.getItemHasPermission(player)));
-            } else if (UserManager.isPrefixUsable(player, prefix)) {
-                addItem(new GUIItem(prefix.getItemHasPermission(player)) {
-                    @Override
-                    public void onClick(ClickType type) {
-                        //再次检查，防止打开GUI后、选择前的时间段内权限消失
-                        if (UserManager.isPrefixUsable(player, prefix)) {
-                            player.closeInventory();
-                            UserManager.setPrefix(player, prefix, true);
+		for (ConfiguredPrefix prefix : prefixList) {
+			if (prefix.getIdentifier().equals(usingPrefix.getIdentifier())) {
+				addItem(new GUIItem(prefix.getItemWhenUsing(player) != null ? prefix.getItemWhenUsing(player) : prefix.getItemHasPermission(player)));
+			} else if (UserManager.isPrefixUsable(player, prefix)) {
+				addItem(new GUIItem(prefix.getItemHasPermission(player)) {
+					@Override
+					public void onClick(ClickType type) {
+						//再次检查，防止打开GUI后、选择前的时间段内权限消失
+						if (UserManager.isPrefixUsable(player, prefix)) {
+							player.closeInventory();
+							UserManager.setPrefix(player, prefix, true);

-                            PrefixConfig.Sounds.PREFIX_CHANGE.play(player);
-                            MessageUtil.sendWithPlaceholders(player, PrefixConfig.Messages.SELECTED.get(),
-                                    new String[]{"%(name)"},
-                                    new Object[]{prefix.getName()});
+							PluginConfig.Sounds.PREFIX_CHANGE.play(player);
+							MessageUtil.sendWithPlaceholders(player, PluginConfig.Messages.SELECTED.get(),
+									new String[]{"%(name)"},
+									new Object[]{prefix.getName()});

-                        }
-                    }
-                });
-            } else {
-                addItem(new GUIItem(prefix.getItemNoPermission(player)));
-            }
-        }
+						}
+					}
+				});
+			} else {
+				addItem(new GUIItem(prefix.getItemNoPermission(player)));
+			}
+		}


-    }
+	}

-    @Override
-    public void onClose() {
-        removeOpening(player);
-    }
+	@Override
+	public void onClose() {
+		removeOpening(player);
+	}

-    public static void removeOpening(Player player) {
-        openingUsers.remove(player);
-    }
+	public static void removeOpening(Player player) {
+		openingUsers.remove(player);
+	}

-    public static void closeAll() {
-        for (Player player : new HashSet<>(openingUsers)) {
-            player.closeInventory();
-        }
-        openingUsers.clear();
-    }
+	public static void closeAll() {
+		for (Player player : new HashSet<>(openingUsers)) {
+			player.closeInventory();
+		}
+		openingUsers.clear();
+	}

-    public static void open(Player player) {
-        PrefixConfig.Sounds.GUI_OPEN.play(player);
-        new PrefixSelectGUI(player).openGUI(player);
-        openingUsers.add(player);
-    }
+	public static void open(Player player) {
+		player.closeInventory(); // 防止冲突
+		PluginConfig.Sounds.GUI_OPEN.play(player);
+		new PrefixSelectGUI(player).openGUI(player);
+		openingUsers.add(player);
+	}


 }
@@ -0,0 +1,38 @@
+package cc.carm.plugin.userprefix.util;
+
+import cc.carm.plugin.userprefix.wrapper.ItemStackWrapper;
+import com.google.common.io.Files;
+import org.bukkit.configuration.InvalidConfigurationException;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.bukkit.inventory.ItemStack;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.util.StringJoiner;
+
+public class ConfigurationUtil {
+    public static FileConfiguration bang(File file) {
+        YamlConfiguration conf = new YamlConfiguration();
+        StringJoiner builder = new StringJoiner("\n");
+        try {
+            //noinspection UnstableApiUsage
+            Files.readLines(file, StandardCharsets.UTF_8).forEach(builder::add);
+        } catch (IOException e) {
+            e.printStackTrace();
+            return conf;
+        }
+        String tmpConf = builder.toString().replace("==: "+ ItemStack.class.getName(), "==: "+ ItemStackWrapper.class.getName());
+        try {
+             conf.loadFromString(tmpConf);
+        } catch (InvalidConfigurationException e) {
+            e.printStackTrace();
+        }
+        return conf;
+    }
+
+    public static String dong(FileConfiguration conf) {
+        return conf.saveToString().replace("==: "+ ItemStackWrapper.class.getName(),"==: "+ ItemStack.class.getName());
+    }
+}
@@ -1,87 +1,93 @@
 package cc.carm.plugin.userprefix.util.gui;

-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
+import cc.carm.plugin.userprefix.configuration.PluginConfig;
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.ClickType;
 import org.bukkit.inventory.ItemStack;

 public class AutoPagedGUI extends CommonPagedGUI {

-    ItemStack previousPageUI;
-    ItemStack nextPageUI;
-    ItemStack noPreviousPageUI;
-    ItemStack noNextPageUI;
-    int previousPageSlot = -1;
-    int nextPageSlot = -1;
+	ItemStack previousPageUI;
+	ItemStack nextPageUI;
+	ItemStack noPreviousPageUI;
+	ItemStack noNextPageUI;
+	int previousPageSlot = -1;
+	int nextPageSlot = -1;

-    public AutoPagedGUI(GUIType type, String name, int[] range) {
-        super(type, name, range);
-    }
+	public AutoPagedGUI(GUIType type, String name, int[] range) {
+		super(type, name, range);
+	}

-    public AutoPagedGUI(GUIType type, String name, int a, int b) {
-        super(type, name, a, b);
-    }
+	public AutoPagedGUI(GUIType type, String name, int a, int b) {
+		super(type, name, a, b);
+	}

-    public void setPreviousPageUI(ItemStack lastPageUI) {
-        this.previousPageUI = lastPageUI;
-    }
+	public void setPreviousPageUI(ItemStack lastPageUI) {
+		this.previousPageUI = lastPageUI;
+	}

-    public void setNextPageUI(ItemStack nextPageUI) {
-        this.nextPageUI = nextPageUI;
-    }
+	public void setNextPageUI(ItemStack nextPageUI) {
+		this.nextPageUI = nextPageUI;
+	}

-    public void setNoPreviousPageUI(ItemStack noPreviousPageUI) {
-        this.noPreviousPageUI = noPreviousPageUI;
-    }
+	public void setNoPreviousPageUI(ItemStack noPreviousPageUI) {
+		this.noPreviousPageUI = noPreviousPageUI;
+	}

-    public void setNoNextPageUI(ItemStack noNextPageUI) {
-        this.noNextPageUI = noNextPageUI;
-    }
+	public void setNoNextPageUI(ItemStack noNextPageUI) {
+		this.noNextPageUI = noNextPageUI;
+	}

-    public void setPreviousPageSlot(int slot) {
-        this.previousPageSlot = slot;
-    }
+	public void setPreviousPageSlot(int slot) {
+		this.previousPageSlot = slot;
+	}

-    public void setNextPageSlot(int slot) {
-        this.nextPageSlot = slot;
-    }
+	public void setNextPageSlot(int slot) {
+		this.nextPageSlot = slot;
+	}


-    @Override
-    public void openGUI(Player user) {
-        if (previousPageSlot >= 0)
-            if (hasPreviousPage()) {
-                setItem(previousPageSlot, new GUIItem(previousPageUI == null ? PrefixConfig.GUI.Items.PREVIOUS_PAGE.get() : previousPageUI) {
-                    @Override
-                    public void onClick(ClickType type) {
-                        if (type == ClickType.RIGHT) {
-                            goFirstPage();
-                        } else {
-                            goPreviousPage();
-                        }
-                        PrefixConfig.Sounds.GUI_CLICK.play(user);
-                        openGUI(user);
-                    }
-                });
-            }
+	@Override
+	public void openGUI(Player user) {
+		if (previousPageSlot >= 0) {
+			if (hasPreviousPage()) {
+				setItem(previousPageSlot, new GUIItem(previousPageUI == null ? PluginConfig.GUI.Items.PREVIOUS_PAGE.get() : previousPageUI) {
+					@Override
+					public void onClick(ClickType type) {
+						if (type == ClickType.RIGHT) {
+							goFirstPage();
+						} else {
+							goPreviousPage();
+						}
+						PluginConfig.Sounds.GUI_CLICK.play(user);
+						openGUI(user);
+					}
+				});
+			} else {
+				setItem(previousPageSlot, null);
+			}
+		}

-        if (nextPageSlot >= 0)
-            if (hasNextPage()) {
-                setItem(nextPageSlot, new GUIItem(nextPageUI == null ? PrefixConfig.GUI.Items.NEXT_PAGE.get() : nextPageUI) {
-                    @Override
-                    public void onClick(ClickType type) {
-                        if (type == ClickType.RIGHT) {
-                            goLastPage();
-                        } else {
-                            goNextPage();
-                        }
-                        PrefixConfig.Sounds.GUI_CLICK.play(user);
-                        openGUI(user);
-                    }
-                });
-            }
+		if (nextPageSlot >= 0) {
+			if (hasNextPage()) {
+				setItem(nextPageSlot, new GUIItem(nextPageUI == null ? PluginConfig.GUI.Items.NEXT_PAGE.get() : nextPageUI) {
+					@Override
+					public void onClick(ClickType type) {
+						if (type == ClickType.RIGHT) {
+							goLastPage();
+						} else {
+							goNextPage();
+						}
+						PluginConfig.Sounds.GUI_CLICK.play(user);
+						openGUI(user);
+					}
+				});
+			} else {
+				setItem(nextPageSlot, null);
+			}
+		}

-        super.openGUI(user);
-    }
+		super.openGUI(user);
+	}

 }
@@ -0,0 +1,43 @@
+package cc.carm.plugin.userprefix.wrapper;
+
+import org.bukkit.Bukkit;
+import org.bukkit.Material;
+import org.bukkit.configuration.serialization.ConfigurationSerializable;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Map;
+
+public class ItemStackWrapper implements ConfigurationSerializable {
+    private static boolean unsafeAvailable;
+
+    static {
+        try {
+            Class.forName("org.bukkit.UnsafeValues");
+            unsafeAvailable = true;
+        } catch (ClassNotFoundException e) {
+            unsafeAvailable = false;
+        }
+    }
+
+    @NotNull
+    @Override
+    public Map<String, Object> serialize() {
+        throw new UnsupportedOperationException("Use ConfigurationUtil#dong to save configuration");
+    }
+
+    @NotNull
+    public static ItemStack deserialize(@NotNull Map<String, Object> args) {
+        // static define will cause problem, lazy load it
+        if (unsafeAvailable) {
+            if (!args.containsKey("v")) {
+                Material material = Material.matchMaterial(args.get("type").toString());
+                if (material == null) {
+                    throw new IllegalArgumentException("物品 "+args.get("type")+" 不存在");
+                }
+                args.put("v", Bukkit.getServer().getUnsafe().getDataVersion());
+            }
+        }
+        return ItemStack.deserialize(args);
+    }
+}
@@ -7,6 +7,11 @@ debug: false
 # 当然，您也可以选择在这里关闭，或在plugins/bStats下的配置文件中关闭。
 metrics: true

+# 检查更新设定
+# 该选项用于插件判断是否要检查更新，若您不希望插件检查更新并提示您，可以选择关闭。
+# 检查更新为异步操作，绝不会影响性能与使用体验。
+check-update: true
+
 custom-storage:
  # 自定义存储位置
  # 默认存储位置为 “插件文件夹”/prefixes
@@ -37,20 +42,20 @@ GUI:
      meta:
        ==: ItemMeta
        meta-type: UNSPECIFIC
-        display-name: "§f下一页"
+        display-name: "&f下一页"
        lore:
          - ""
-          - "§f右键可前往最后一页哦~"
+          - "&f右键可前往最后一页哦~"
    previous-page: # 上一页物品，如果没有上一页则不显示
      ==: org.bukkit.inventory.ItemStack
      type: ARROW
      meta:
        ==: ItemMeta
        meta-type: UNSPECIFIC
-        display-name: "§f上一页"
+        display-name: "&f上一页"
        lore:
          - ""
-          - "§f右键可前往第一页哦~"
+          - "&f右键可前往第一页哦~"

 Sounds: #相关的声音，注释掉则不播放声音 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
@@ -69,17 +74,17 @@ defaultPrefix:
    meta:
      ==: ItemMeta
      meta-type: UNSPECIFIC
-      display-name: "§f默认玩家前缀 §f(点击切换)"
+      display-name: "&f默认玩家前缀 &f(点击切换)"
      lore:
        - ""
-        - "§a➥ 点击切换到该前缀"
+        - "&a➥ 点击切换到该前缀"
  itemUsing:
    ==: org.bukkit.inventory.ItemStack
    type: NAME_TAG
    meta:
      ==: ItemMeta
      meta-type: UNSPECIFIC
-      display-name: "§f默认玩家前缀"
+      display-name: "&f默认玩家前缀"
      lore:
        - ""
-        - "§a✔ 您正在使用该前缀"
+        - "&a✔ 您正在使用该前缀"
@@ -4,6 +4,9 @@ debug: false #DEBUG OUT PUT

 metrics: true #Metrics stats (to help developer know the stats)

+# Auto check the updates.
+check-update: true
+
 custom-storage:
  # Custom storage location
  # default location is "./prefixes"
@@ -9,7 +9,7 @@ name: "&b&lPro&b"

 # Content [Necessary]
 # Use in Placeholders
-content: "§b§lPro §b"
+content: "&b&lPro &b"

 # Weight [Necessary]
 # used for sorting in the GUI and TabList
@@ -31,10 +31,10 @@ itemHasPermission:
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lVIP Prefix"
+    display-name: "&b&lVIP Prefix"
    lore:
      - ""
-      - "§a➥ Click to  use"
+      - "&a➥ Click to  use"

 # itemUsing [Unnecessary]
 # This Item will be displayed when the prefix is selected.
@@ -45,12 +45,12 @@ itemUsing:
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lVIP Prefix"
+    display-name: "&b&lVIP Prefix"
    enchants:
      PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
    lore:
      - ""
-      - "§a✔ Selected"
+      - "&a✔ Selected"

 # itemNoPermission [Unnecessary]
 # If player doesn't have the permission,this item will be displayed.
@@ -62,7 +62,7 @@ itemNoPermission:
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lVIP §c(Buy it!)"
+    display-name: "&b&lVIP &c(Buy it!)"
    lore:
      - ""
-      - "§e✯ Buy the VIP to use it!"
+      - "&e✯ Buy the VIP to use it!"
@@ -3,6 +3,8 @@ selected:
 expired:
  - "&7Your prefix &f%(oldName) &7has expired,"
  - "&7Now the prefix is changed to &f%(newName) &7."
+removed:
+  - "&7Your using prefix has been removed, now the prefix is changed to &f%(newName) &7."
 reload:
  - "&a&lReload completed！&7costs &f%(time)ms&7."
 help:
@@ -3,6 +3,8 @@ selected:
 expired:
  - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
  - "&7现在已为您重新调整为 &f%(newName) &7。"
+removed:
+  - "&7您先前使用的前缀已被移除，现在已为您重新调整为 &f%(newName) &7。"
 reload:
  - "&a&l重载完成！&7共耗时 &f%(time)ms&7。"
 help:
@@ -7,6 +7,7 @@ authors:
  - SakuraGame
 website: ${project.url}
 description: ${project.description}
+api-version: 1.13

 depend:
  - LuckPerms
@@ -22,4 +23,4 @@ commands:
      - upa
      - prefixAdmin
    permission: "UserPrefix.admin"
-    description: "用户前缀系统管理指令，可以查看前缀列表与重载配置文件。"
+    description: "用户前缀系统管理指令，可以查看前缀列表与重载配置文件。"
@@ -9,7 +9,7 @@ name: "&b&lPro&b"

 # 内容 [必须]
 # 显示在名字前面的内容
-content: "§b§lPro §b"
+content: "&b&lPro &b"

 # 权重 [必须]
 # 用于GUI、TabList的排序和自动前缀显示
@@ -30,14 +30,14 @@ itemHasPermission: #
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lPro §b会员前缀"
+    display-name: "&b&lPro &b会员前缀"
    lore:
-      - "§7Pro会员专属称号"
+      - "&7Pro会员专属称号"
      - ""
-      - "§f尊贵的Pro会员专属称号。"
-      - "§f您将获得多种特权与更好的游戏体验。"
+      - "&f尊贵的Pro会员专属称号。"
+      - "&f您将获得多种特权与更好的游戏体验。"
      - ""
-      - "§a➥ 点击切换到该前缀"
+      - "&a➥ 点击切换到该前缀"

 # 正在使用时显示的物品 [非必需]
 # 当用户正在使用时会显示这个物品，不配置即自动加载“itemHasPermission”
@@ -47,16 +47,16 @@ itemUsing:
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lPro §b会员前缀"
+    display-name: "&b&lPro &b会员前缀"
    enchants:
      PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
    lore:
-      - "§7Pro会员专属称号"
+      - "&7Pro会员专属称号"
      - ""
-      - "§f尊贵的Pro会员专属称号。"
-      - "§f您将获得多种特权与更好的游戏体验。"
+      - "&f尊贵的Pro会员专属称号。"
+      - "&f您将获得多种特权与更好的游戏体验。"
      - ""
-      - "§a✔ 您正在使用该前缀"
+      - "&a✔ 您正在使用该前缀"

 # 没有权限时显示的物品 [非必需]
 # 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
@@ -67,12 +67,12 @@ itemNoPermission:
  meta:
    ==: ItemMeta
    meta-type: UNSPECIFIC
-    display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
+    display-name: "&b&lPro+ &b会员前缀 &c(未拥有)"
    lore:
-      - "§7Pro+会员专属称号"
+      - "&7Pro+会员专属称号"
      - ""
-      - "§f尊贵的Pro会员专属称号。"
-      - "§f您将获得多种特权与更好的游戏体验。"
-      - "§f您可以输入 §b/vip §f指令查看详细特权！"
+      - "&f尊贵的Pro会员专属称号。"
+      - "&f您将获得多种特权与更好的游戏体验。"
+      - "&f您可以输入 &b/vip &f指令查看详细特权！"
      - ""
-      - "§e✯ 加入Pro+会员以使用该前缀！"
+      - "&e✯ 加入Pro+会员以使用该前缀！"
Author	SHA1	Message	Date
carm	774e9b764e	[2.4.2] 修复跨版本时配置文件不全而导致序列化异常的问题	2022-02-21 04:46:39 +08:00
carm	a31da83531	Merge pull request #11 from Ghost-chu/master Fixed #10, 自定义物品反序列化工具	2022-02-20 19:48:11 +08:00
Ghost_chu	61857d6305	清理debug	2022-02-20 19:46:26 +08:00
Ghost_chu	dd96188b22	use FileConfiguration	2022-02-20 19:44:36 +08:00
Ghost_chu	eb4ecaada9	Fixed #10 , 自定义物品反序列化工具	2022-02-20 19:36:39 +08:00
carm	acc9ea7e7c	Update plugin.yml	2022-02-20 18:08:14 +08:00
carm	83b3c45d57	Update plugin.yml	2022-02-20 00:37:17 +08:00
carm	3ec39b9ca3	[2.4.1] 尝试修复 #9 问题。	2022-02-18 18:26:12 +08:00
carm	821b42cc03	每次构建同时提供“测试产物”与“最终产物”。	2022-02-17 21:42:14 +08:00
carm	81e0c0960f	每次构建同时提供“测试产物”与“最终产物”。	2022-02-17 21:40:52 +08:00
carm	99c577c361	[2.4.0] 添加自动检查更新机制，并允许开关。	2022-02-07 03:27:59 +08:00
carm	5df6e1fe34	[v2.3.3] 修改构建配置	2022-01-16 09:08:10 +08:00
carm	7c887822ba	[v2.3.3] [R] 移除“v”前缀。	2022-01-16 08:18:16 +08:00
carm	6b601950a3	[v2.3.2] [R] 整合构建、部署(Javadoc)与版本发布。	2022-01-16 08:02:06 +08:00
carm	d752461c74	[v2.3.1] [F] 修复前缀数量超过一页时翻页可能出现错误的问题	2022-01-13 01:00:46 +08:00
carm	548f1d366f	修改参考配置的位置	2022-01-07 09:23:40 +08:00
carm	686b28cf93	修改参考配置的位置	2022-01-07 09:13:05 +08:00
carm	92e14e29fe	修复格式错误	2022-01-07 09:01:36 +08:00
carm	78f9639092	[v2.3.0] [U] 修改图片位置	2022-01-07 08:45:46 +08:00
carm	096c23351f	Merge remote-tracking branch 'origin/master'	2022-01-07 08:37:36 +08:00
carm	b4f8404648	[v2.3.0] 版本更新 - [A] 添加数个事件，方便其他插件调用使用。 - [A] 当原前缀已不存在的情况下的向玩家发送消息。	2022-01-07 08:37:25 +08:00
carm	623356ce21	Update README.md	2022-01-03 15:32:57 +08:00
carm	9164541e4f	Merge remote-tracking branch 'origin/master'	2022-01-02 10:14:23 +08:00
carm	2453305420	添加更多统计数据	2022-01-02 10:14:11 +08:00
carm	1856de5e5d	Update README.md	2022-01-02 09:33:03 +08:00
carm	c38adbeca6	添加统计数据显示	2021-12-31 02:34:31 +08:00