chore(deps): update dependency org.apache.maven.plugins:maven-surefire-plugin to v3.5.6 (#145)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

.documentation/ACTIONS.md

@@ -0,0 +1,31 @@
+# UserPrefix Actions 操作
+
+## 使用方式
+
+在 `actions` 配置节点下，可以配置多个操作，格式为 `[操作类型] {操作参数}`，例如：
+
+- `[CHAT] HELLO %player_name%!`
+- `[SOUND] ENTITY_PLAYER_LEVELUP`
+
+## 操作类型
+
+目前支持以下操作类型：
+- `CHAT` 以玩家聊天的形式发送，若需要发送指令则添加“/”前缀
+- `CONSOLE` 以后台的形式发送指令
+- `MESSAGE` 向玩家发送一条消息
+- `SOUND` 向玩家发送声音
+- `CLOSE` 关闭当前打开的GUI
+
+所有需要键入文本的类型均支持 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 变量 。
+
+## 限定点击类型
+
+若您需要限定玩家点击的类型，如左键、右键等，则可以添加在操作类型后，以“`:`”分割，如：
+
+- `[CLOSE:LEFT]` 代表左键点击关闭
+- `[MESSAGE:MIDDLE] HELLO WORLD` 代表鼠标中间点击发送消息
+
+详细点击类型见 [`org.bukkit.event.inventory.ClickType`](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/ClickType.html) 。
+
+
+

.documentation/JAVADOC-README.md

@@ -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) 。

.documentation/README.md

@@ -0,0 +1,74 @@
+```text
+ _    _                   _____              __  _       
+| |  | |                 |  __ \            / _|(_)      
+| |  | | ___   ___  _ __ | |__) |_ __  ___ | |_  _ __  __
+| |  | |/ __| / _ \| '__||  ___/| '__|/ _ \|  _|| |\ \/ /
+| |__| |\__ \|  __/| |   | |    | |  |  __/| |  | | >  < 
+ \____/ |___/ \___||_|   |_|    |_|   \___||_|  |_|/_/\_\
+```
+
+# UserPrefix 帮助介绍文档
+
+## 插件介绍目录
+
+- 使用示例
+    - [前缀配置文件预设示例](../src/main/resources/prefixes/example-prefix.yml)
+- [操作(Actions)配置](ACTIONS.md)
+
+## [开发文档](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]"
+}
+```

.documentation/images/README.md

@@ -0,0 +1,5 @@
+ # 图片文件夹
+ 
+ 用于存放相关介绍图片。
+ 
+ 图片保留版权，未经授权禁止使用。

.github/ISSUE_TEMPLATE/bugs_report.md

@@ -0,0 +1,32 @@
+---
+name: 问题提交 
+about: 描述问题并提交，帮助我们对其进行检查与修复。 
+title: ''
+labels: bug 
+assignees: ''
+
+---
+
+### **问题简述**
+<!--用简短的话语描述一下大概问题。-->
+
+### **问题来源**
+
+<!-- 
+描述一下通过哪些操作才发现的问题，如：
+1. 打开 '...'
+2. 点击了 '....'
+3. 出现了报错 '....'
+-->
+
+### **预期结果**(可选)
+<!--如果问题不发生，应该是什么情况-->
+
+### **问题截图/问题报错**
+<!--如果有报错或输出，请提供截图。-->
+
+### **操作环境**
+<!--请在后台输入 `version` 并复制相关输出。-->
+
+### **其他补充**
+<!--如有其他补充，可以在这里描述。-->

.github/ISSUE_TEMPLATE/feature_issues.md

@@ -0,0 +1,20 @@
+---
+name: 功能需求
+about: 希望我们提供更多的功能。
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+### **功能简述**
+<!--简单的描述一下你想要的功能-->
+
+### **需求来源**
+<!--简单的描述一下为什么需要这个功能。-->
+
+### **功能参考**(可选)
+<!--如果有相关功能的参考，如文本、截图，请提供给我们。-->
+
+### **附加内容**
+<!--如果有什么小细节需要重点注意，请在这里告诉我们。-->

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,70 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL Analysis"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '44 6 * * 4'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'java' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v6
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v4
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v4
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v4

.github/workflows/deploy.yml

@@ -0,0 +1,113 @@
+# 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 & Upload
+
+on:
+  # 支持手动触发构建
+  workflow_dispatch:
+  release:
+    # 创建release的时候触发
+    types: [ published ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: "Set up JDK"
+        uses: actions/setup-java@v5
+        with:
+          java-version: '11'
+          distribution: 'adopt'
+          cache: maven
+          server-id: github
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_TOKEN
+
+      - name: "Maven Deploy"
+        run: mvn -B deploy --file pom.xml -DskipTests
+        env:
+          MAVEN_USERNAME: ${{ github.repository_owner }}
+          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/reports/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
+
+      - name: "Modrinth Publish"
+        id: publish-modrinth
+        uses: Kir-Antipov/mc-publish@v3.3
+        with:
+          modrinth-id: tLcVHCPk
+          modrinth-featured: true
+          modrinth-token: ${{ secrets.MODRINTH_TOKEN }}
+          files: |
+            asset/*.jar
+          loaders: |
+            spigot
+            paper
+            purpur
+            folia
+            bukkit
+          game-versions: |
+            >=1.8 <=1.21.8
+          game-version-filter: releases
+          java: |
+            8
+          dependencies: |
+            placeholderapi(recommended)

.github/workflows/maven.yml

@@ -0,0 +1,44 @@
+# 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 & Tests
+
+on:
+  # 支持手动触发构建
+  workflow_dispatch:
+  push:
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - name: "Set up JDK"
+        uses: actions/setup-java@v5
+        with:
+          java-version: '11'
+          distribution: 'adopt'
+          cache: maven
+          server-id: github
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_TOKEN
+      - name: "Package"
+        run: mvn -B package --file pom.xml
+        env:
+          MAVEN_USERNAME: ${{ github.repository_owner }}
+          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
+
+      - name: "Target Staging"
+        run: |
+          mkdir artifacts
+          cp -vrf target/ artifacts/target/
+          cp -vrf asset/*.jar artifacts
+
+      - name: "Upload artifact"
+        uses: actions/upload-artifact@v7
+        with:
+          name: Artifact
+          path: artifacts
+          include-hidden-files: true

.gitignore

@@ -1,3 +1,5 @@
 /.idea/
 /target/
 ./*.iml
+*.iml
+asset/

LICENSE

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

README-en.md

@@ -0,0 +1,126 @@
+![BANNER](.documentation/images/banner.png)
+
+README LANGUAGES [ [中文](README.md) | [**English**](README-en.md)  ]
+
+# UserPrefix Plugin
+
+[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840)](https://www.codefactor.io/repository/github/carmjos/userprefix)
+![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/UserPrefix)
+[![License](https://img.shields.io/github/license/CarmJos/UserPrefix)](https://opensource.org/licenses/GPL-3.0)
+[![Java CI with Maven](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml)
+![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-yellow)
+![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)
+
+Lightweight, efficient, and real-time user prefix system.
+
+This plugin is implemented based on Spigot ,**Theoretically** support ALL MineCraft Versions.
+
+The development of this plugin is based on Chinese which purpose is to help Chinese developers learn Bukkit plugin
+development.
+
+> This plugin has been published on [SpigotMC](https://www.spigotmc.org/resources/userprefix.96277/) .
+
+## Examples
+
+![example](.documentation/images/using-example.png)
+
+## Dependencies
+
+- **[Necessary]** Plugin developed based on [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT)
+  and [BukkitAPI](http://bukkit.org/).
+- **[Necessary]** Plugin data storage base on  [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/).
+- **[Recommend]** Placeholders based on [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) .
+
+For development dependencies, please see  [Dependencies](https://github.com/CarmJos/UserPrefix/network/dependencies) .
+
+## Features
+
+- **Theoretically** support ALL MineCraft Versions.
+- Reloading the configuration will automatically refresh the prefix of all players.
+- Real-time judgment and feedback to the player when permissions are changed.
+- Configurable sounds and messages.
+- The prefix icon can be configured as "Selected", "Has Permission" and “No Permission”.
+- 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 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)`
+- Support Gradient Color! (Version 1.16 and above)  `&<#Color1>Message&<#Color2>`
+    - Example: `&<#8470FF>Hello World!&<#483D8B>`
+
+## Notice
+
+### 1. Version support issues
+
+This plugin theoretically supports all versions.
+
+If the icon does not load, the sound cannot be played, etc., please check whether the type of the item and sound in the
+configuration file exists in the current version.
+
+Take the SOUND as an example. The sound that the villager said "OK" is "`VILLAGER_YES`" in the lower version, but it
+becomes "`ENTITY_VILLAGER_YES`" in the higher version.
+
+### 2. Scoreboard exception problem
+
+The display of the prefix on the head and the sorting of the TabList both use the scoreboard API.
+
+Please turn of the `functions.on-name-prefix` in the configuration if there is a conflict.
+
+## Commands
+
+This plugin's Commands are based on Chinese!
+**May support multi-language in the future.**
+
+```text
+/UserPrefix or /prefix #Open prefix GUI
+/UserPrefixAdmin # View Admin Command Help
+/UserPrefixAdmin reload # Reload Config
+/UserPrefixAdmin list # List all configured prefixes.
+```
+
+## Placeholders (PlaceholderAPI)
+
+After installed the [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) , you can
+type `/papi info UserPrefix` to see all the placeholders.
+
+```text
+# %UserPrefix_prefix% 
+- Get the content of the current prefix
+# %UserPrefix_weight% 
+- Get the weight of the current prefix.
+# %UserPrefix_identifier% 
+- Get the identifier of the current prefix.
+# %UserPrefix_name% 
+- Get the name of the current prefix.
+# %UserPrefix_has_<Identifier>% 
+- Determine whether the player has a certain prefix(true/false)
+```
+
+## Configuration files
+
+### Plugin Configuration ([`config.yml`]() .
+
+Will be generated on the first boot up.
+
+### Messages Configuration ([`messages.yml`]())
+
+Will be generated on the first boot up.
+
+### 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.
+
+## Support and Donation
+
+This project is support by the  [YourCraft(你的世界)](https://www.ycraft.cn) .
+![TeamLogo](.documentation/images/team-logo.png)
+
+## Open source agreement
+
+The source code of this project uses  [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0)
+License.
+

README.md

@@ -1,22 +1,53 @@
+![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)
+[![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-green)
+![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)
+
 轻便、高效、实时的用户前缀系统。
 
-数据部分基于 [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/) 实现。
+本插件基于Spigot实现，**理论上支持全版本**。
+
+> 本插件已在  [SpigotMC](https://www.spigotmc.org/resources/userprefix-hex-color-support-all-version.96277/) 上发布。
+
+## 示例
+
+![example](.documentation/images/using-example.png)
+
+## 依赖
+
+- **[必须]** 插件本体基于 [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT)、[BukkitAPI](http://bukkit.org/) 实现。
+- **[必须]** 数据部分基于 [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/) 实现。
+- **[推荐]** 变量部分基于 [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) 实现。
+
+详细依赖列表可见 [Dependencies](https://github.com/CarmJos/UserPrefix/network/dependencies) 。
 
 ## 特性
 
 - 理论上全版本支持！
 - 游戏内重载配置文件并实时更新到玩家！
-- 当玩家权限变更时会实时监测前缀，若权限不足则自动更换前缀并提示！
+- 当玩家权限变更时会实时监测前缀，若权限不足则自动更换前缀并提示
 - 可配置的声音、消息！
 - 前缀图标可配置“选中”、“有权限”与“无权限”三种状态的物品
-    - 物品的配置通过ItemStack原生配置，支持MC所有的设定！
-    - 具体的设定请参考其他文档哦~
 - TabList自动按照前缀的权重排序 (如有冲突可关掉)
 - 玩家头顶前缀显示 (如有冲突可关掉)
-- 自动排序，且可翻页的GUI
-- 支持PlaceholderAPI变量
+- 简单的聊天变量修改功能！(不推荐使用) `[自 v2.1.0 版本起]`
+- 支持动态前缀内容轮换！`[自 v3.3.0 版本起]`
+- 自动排序，且可翻页的GUI！
+- 支持PlaceholderAPI变量！(凡支持的都可以使用，如BungeeTabListPlus)
+- 支持[Hex颜色](https://www.hexcolortool.com/)！(1.16以上版本) `[自 v1.2.3 版本起]`
+    - 格式： `&(#颜色代码)`
+    - 示例： LightSlateBlue `&(#8470FF)` 、 DarkSlateBlue `&(#483D8B)`
+- 支持渐变色！(1.16以上版本) `[自 v1.2.3 版本起]`
+    - 格式： `&<#颜色代码1>消息内容&<#颜色代码2>`
+    - 示例： `&<#8470FF>Hello World!&<#483D8B>`
 
 ## 注意事项
 
@@ -30,10 +61,7 @@
 
 头顶上前缀的显示与TabList的排序均使用到了计分板API。
 
-如有冲突导致其他插件的计分板无法显示，请关掉配置文件中`functions.OnNamePrefix`。
-
-### 3. 物品图标配置问题
-物品相关均通过Bukkit提供的ItemStack序列化方法读取，相关配置方式请参考其他文档。
+如有冲突导致其他插件的计分板无法显示，请关掉配置文件中`functions.on-name-prefix`。
 
 ## 指令
 
@@ -67,109 +95,58 @@
 
 ## 配置文件示例
 
-```yaml
-version: 1.0.0-SNAPSHOT # 配置文件版本，一般不会动。
+### 基础配置文件 ([`config.yml`](src/main/java/cc/carm/plugin/userprefix/conf/PluginConfig.java))
 
-debug: false #debug输出，开发者用的
+将会在服务器首次启动时生成，如果您想要修改配置，请在服务器启动后打开配置文件。
 
-functions:
-  OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
-  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
+### 消息配置文件 ([`messages.yml`](src/main/java/cc/carm/plugin/userprefix/conf/PluginMessages.java))
 
-messages:
-  selected:
-    - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
-  expired:
-    - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
-    - "&7现在已为您重新调整为 &f%(newName) &7。"
-  help:
-    - "&7输入 &b/prefix &7打开前缀选择菜单。"
+将会在服务器首次启动时生成，如果您想要修改配置，请在服务器启动后打开配置文件 。
 
-Sounds: #相关的声音，注释掉则不播放声音 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
-  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
-  guiClick: "UI_BUTTON_CLICK"
-  prefixChange: "ENTITY_VILLAGER_YES"
-  prefixExpired: "ENTITY_VILLAGER_NO"
+### 前缀配置文件 ([`prefixes/*.yml`](src/main/resources/prefixes/example-prefix.yml))
 
-# 默认前缀的配置
-# 默认前缀的权重为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✔ 您正在使用该前缀"
+所有前缀均为单独的配置文件，存放于 `插件配置目录/prefixes` 下，便于管理。
 
-prefixes:
-  VIP:
-    name: "&b&lPro&b" # [必须] 名字(切换的时候左下角会弹提示 用的就是这个名字)
-    content: "§b§lPro §b" # [必须] 显示在名字前面的内容
-    weight: 1 # [必须] 权重，用于GUI里面的排序(越大显示在越后面)和自动前缀显示
-    permission: "yc.pro" # [非必须] 检测的权限，如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
-    itemHasPermission: 
-      #  [必须] 当有权限的时候会显示这个Item
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a➥ 点击切换到该前缀"
-    itemUsing: 
-      # [非必需] 当有权限的时候会显示这个Item,如果没有这个配置就自动显示“itemHasPermission”的。
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        enchants:
-          PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a✔ 您正在使用该前缀"
-    itemNoPermission: 
-      # [非必需] 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
-      ==: org.bukkit.inventory.ItemStack
-      type: INK_SACK
-      damage: 8
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
-        lore:
-          - "§7Pro+会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - "§f您可以输入 §b/vip §f指令查看详细特权！"
-          - ""
-          - "§e✯ 加入Pro+会员以使用该前缀！"
-```
+文件名理论上可以随便取，推荐使用英文，部分符号可能会影响正常读取，请避免使用。
+
+您可以 [点击这里](src/main/resources/prefixes/example-prefix.yml) 查看示例前缀配置文件。
+
+## 使用统计
+
+[![bStats](https://bstats.org/signatures/bukkit/UserPrefix.svg)](https://bstats.org/plugin/bukkit/UserPrefix/13776)
+
+## 支持与捐赠
+
+本项目由 [YourCraft(你的世界)](https://www.ycraft.cn) 团队提供长期支持与维护。
+![TeamLogo](.documentation/images/team-logo.png)
+
+若您觉得本插件做的不错，您可以捐赠支持我！感谢您成为开源项目的支持者！
+
+Many thanks to Jetbrains for kindly providing a license for me to work on this and other open-source projects.  
+[![](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg)](https://www.jetbrains.com/?from=https://github.com/CarmJos/UserPrefix)
+
+## 开源协议
+
+本项目源码采用 [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0) 开源协议。
+
+<details>
+  <summary>关于 GPL 协议</summary>
+
+> GNU General Public Licence (GPL) 有可能是开源界最常用的许可模式。GPL 保证了所有开发者的权利，同时为使用者提供了足够的复制，分发，修改的权利：
+>
+> #### 可自由复制
+> 你可以将软件复制到你的电脑，你客户的电脑，或者任何地方。复制份数没有任何限制。
+> #### 可自由分发
+> 在你的网站提供下载，拷贝到U盘送人，或者将源代码打印出来从窗户扔出去（环保起见，请别这样做）。
+> #### 可以用来盈利
+> 你可以在分发软件的时候收费，但你必须在收费前向你的客户提供该软件的 GNU GPL 许可协议，以便让他们知道，他们可以从别的渠道免费得到这份软件，以及你收费的理由。
+> #### 可自由修改
+> 如果你想添加或删除某个功能，没问题，如果你想在别的项目中使用部分代码，也没问题，唯一的要求是，使用了这段代码的项目也必须使用 GPL 协议。
+>
+> 需要注意的是，分发的时候，需要明确提供源代码和二进制文件，另外，用于某些程序的某些协议有一些问题和限制，你可以看一下 @PierreJoye 写的 Practical Guide to GPL Compliance 一文。使用 GPL
+> 协议，你必须在源代码代码中包含相应信息，以及协议本身。
+>
+> *以上文字来自 [五种开源协议GPL,LGPL,BSD,MIT,Apache](https://www.oschina.net/question/54100_9455) 。*
+</details>
+
+## Project supported by JetBrains

pom.xml

@@ -1,75 +1,229 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>cc.carm.plugin</groupId>
-    <artifactId>UserPrefix</artifactId>
-    <version>1.0.0-SNAPSHOT</version>
-
     <properties>
-        <maven.compiler.source>8</maven.compiler.source>
-        <maven.compiler.target>8</maven.compiler.target>
-        <maven.deploy.skip>true</maven.deploy.skip>
+        <project.jdk.version>8</project.jdk.version>
+        <project.package>cc.carm.plugin.userprefix</project.package>
+
+        <maven.compiler.source>${project.jdk.version}</maven.compiler.source>
+        <maven.compiler.target>${project.jdk.version}</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
+
+        <deps.easyplugin.version>1.5.14</deps.easyplugin.version>
+        <deps.mineconfig.version>3.1.3</deps.mineconfig.version>
     </properties>
 
+    <groupId>cc.carm.plugin</groupId>
+    <artifactId>userprefix</artifactId>
+    <version>3.3.1</version>
+
+    <name>UserPrefix</name>
+    <description>轻便、高效、实时的用户前缀系统。</description>
+    <url>https://github.com/CarmJos/UserPrefix</url>
+
+    <issueManagement>
+        <system>GitHub Issues</system>
+        <url>https://github.com/CarmJos/UserPrefix/issues</url>
+    </issueManagement>
+
+    <ciManagement>
+        <system>GitHub Actions</system>
+        <url>https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml</url>
+    </ciManagement>
+
+    <developers>
+        <developer>
+            <id>CarmJos</id>
+            <name>Carm Jos</name>
+            <email>carm@carm.cc</email>
+            <url>https://work.carm.cc</url>
+            <roles>
+                <role>Main Developer</role>
+            </roles>
+        </developer>
+    </developers>
+
+    <organization>
+        <name>YourCraft你的世界</name>
+        <url>https://www.ycraft.cn/</url>
+    </organization>
+
+    <licenses>
+        <license>
+            <name>GNU General Public License v3.0</name>
+            <url>https://opensource.org/licenses/GPL-3.0</url>
+        </license>
+    </licenses>
+
     <repositories>
 
         <repository>
-            <id>ycraft</id>
-            <url>https://maven.ycraft.cn/repository/maven-public/</url>
+            <id>maven-central</id>
+            <url>https://repo1.maven.org/maven2/</url>
+        </repository>
+
+        <repository>
+            <id>sonatype</id>
+            <url>https://oss.sonatype.org/content/repositories/public/</url>
+        </repository>
+
+        <repository>
+            <id>spigot-repo</id>
+            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
         </repository>
 
         <repository>
             <id>luck-repo</id>
             <url>https://repo.lucko.me/</url>
         </repository>
+
+        <repository>
+            <id>minecraft-libraries</id>
+            <name>Minecraft Libraries</name>
+            <url>https://libraries.minecraft.net/</url>
+        </repository>
+
+        <repository>
+            <id>EasyPlugin</id>
+            <url>https://raw.githubusercontent.com/CarmJos/EasyPlugin/repo/</url>
+        </repository>
+
+        <repository>
+            <id>carm-repo</id>
+            <name>Carm's Repo</name>
+            <url>https://repo.carm.cc/repository/maven-public/</url>
+        </repository>
+
     </repositories>
 
+    <distributionManagement>
+        <downloadUrl>https://github.com/CarmJos/UserPrefix/releases</downloadUrl>
+        <repository>
+            <id>github</id>
+            <name>GitHub Packages</name>
+            <url>https://maven.pkg.github.com/CarmJos/UserPrefix</url>
+        </repository>
+    </distributionManagement>
+
     <dependencies>
 
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-main</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-command</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-gui</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <!--suppress VulnerableLibrariesLocal -->
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-githubchecker</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-placeholderapi</artifactId>
+            <version>${deps.easyplugin.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>mineconfiguration-bukkit</artifactId>
+            <version>${deps.mineconfig.version}</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.cryptomorin.xseries</groupId>
+                    <artifactId>XSeries</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>com.github.cryptomorin</groupId>
+                    <artifactId>XSeries</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
+        <dependency>
+            <groupId>com.github.cryptomorin</groupId>
+            <artifactId>XSeries</artifactId>
+            <version>13.8.0</version>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <dependency>
+            <groupId>com.mojang</groupId>
+            <artifactId>authlib</artifactId>
+            <version>6.0.54</version>
+            <scope>provided</scope>
+        </dependency>
+
         <dependency>
             <groupId>org.spigotmc</groupId>
-            <artifactId>spigot</artifactId>
-            <version>1.17-R0.1-SNAPSHOT</version>
+            <artifactId>spigot-api</artifactId>
+            <version>1.19-R0.1-20220725.090125-47</version>
             <scope>provided</scope>
         </dependency>
 
         <dependency>
             <groupId>me.clip</groupId>
             <artifactId>placeholderapi</artifactId>
-            <version>2.10.9</version>
+            <version>2.12.2</version>
             <scope>provided</scope>
         </dependency>
 
         <dependency>
             <groupId>net.luckperms</groupId>
             <artifactId>api</artifactId>
-            <version>5.3</version>
+            <version>5.5</version>
             <scope>provided</scope>
         </dependency>
 
         <dependency>
-            <groupId>com.comphenix.protocol</groupId>
-            <artifactId>ProtocolLib</artifactId>
-            <version>4.5.0</version>
-            <scope>provided</scope>
+            <groupId>org.bstats</groupId>
+            <artifactId>bstats-bukkit</artifactId>
+            <version>3.2.1</version>
+            <scope>compile</scope>
         </dependency>
 
         <dependency>
-            <groupId>com.comphenix.packetwrapper</groupId>
-            <artifactId>PacketWrapper</artifactId>
-            <version>1.13-R0.1-SNAPSHOT</version>
+            <groupId>org.jetbrains</groupId>
+            <artifactId>annotations</artifactId>
+            <version>26.1.0</version>
             <scope>provided</scope>
         </dependency>
 
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
-            <version>4.13</version>
+            <version>4.13.2</version>
             <scope>test</scope>
         </dependency>
 
@@ -78,43 +232,34 @@
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-surefire-plugin</artifactId>
-                <version>2.22.1</version>
+                <artifactId>maven-clean-plugin</artifactId>
+                <version>3.5.0</version>
                 <configuration>
-                    <useSystemClassLoader>false</useSystemClassLoader>
+                    <filesets>
+                        <fileset>
+                            <directory>${project.basedir}/asset/</directory>
+                            <useDefaultExcludes>true</useDefaultExcludes>
+                            <includes>
+                                <include>**/*</include>
+                            </includes>
+                        </fileset>
+                        <fileset>
+                            <directory>${project.basedir}/api-docs/</directory>
+                            <useDefaultExcludes>true</useDefaultExcludes>
+                            <includes>
+                                <include>**/*</include>
+                            </includes>
+                        </fileset>
+                    </filesets>
                 </configuration>
             </plugin>
-        </plugins>
-        <pluginManagement>
-            <plugins>
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.2.0</version>
-                    <configuration>
-                        <classifier>javadoc</classifier>
-                        <links>
-                            <link>https://javadoc.io/doc/org.jetbrains/annotations/</link>
-                        </links>
-                        <detectJavaApiLink>true</detectJavaApiLink>
-                        <encoding>UTF-8</encoding>
-                    </configuration>
-                    <executions>
-                        <execution>
-                            <id>attach-javadocs</id>
-                            <goals>
-                                <goal>jar</goal>
-                            </goals>
-                        </execution>
-                    </executions>
-                </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                    <version>3.8.1</version>
+                <version>3.15.0</version>
                 <configuration>
-                        <source>1.8</source>
-                        <target>1.8</target>
+                    <source>${project.jdk.version}</source>
+                    <target>${project.jdk.version}</target>
                     <encoding>UTF-8</encoding>
                     <compilerArgument>-parameters</compilerArgument>
                 </configuration>
@@ -122,24 +267,56 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
-                    <version>3.2.0</version>
+                <version>3.5.0</version>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-source-plugin</artifactId>
+                <version>3.4.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>jar-no-fork</goal>
+                        </goals>
+                    </execution>
+                </executions>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.2.3</version>
+                <version>3.6.2</version>
                 <executions>
                     <execution>
                         <phase>package</phase>
                         <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>
+                    <minimizeJar>true</minimizeJar>
+                    <relocations>
+                        <relocation>
+                            <pattern>org.bstats</pattern>
+                            <shadedPattern>${project.package}.bstats</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>cc.carm.lib</pattern>
+                            <shadedPattern>${project.package}.lib</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>org.json</pattern>
+                            <shadedPattern>${project.package}.lib.json</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>com.cryptomorin.xseries</pattern>
+                            <shadedPattern>${project.package}.lib.xseries</shadedPattern>
+                        </relocation>
+                    </relocations>
                     <filters>
                         <filter>
                             <artifact>*:*</artifact>
@@ -151,16 +328,42 @@
                     </filters>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+                <version>3.12.0</version>
+                <configuration>
+                    <classifier>javadoc</classifier>
+                    <links>
+                        <link>https://javadoc.io/doc/org.jetbrains/annotations/</link>
+                        <link>https://hub.spigotmc.org/javadocs/bukkit/</link>
+                        <link>https://carmjos.github.io/EasyPlugin/</link>
+                        <link>https://carmjos.github.io/MineConfiguration/</link>
+                    </links>
+                    <detectJavaApiLink>true</detectJavaApiLink>
+                    <encoding>UTF-8</encoding>
+                    <charset>UTF-8</charset>
+                    <docencoding>UTF-8</docencoding>
+                    <locale>zh_CN</locale>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>attach-javadocs</id>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
-                    <version>2.22.1</version>
+                <version>3.5.6</version>
                 <configuration>
                     <useSystemClassLoader>false</useSystemClassLoader>
                 </configuration>
             </plugin>
         </plugins>
-        </pluginManagement>
         <resources>
             <resource>
                 <directory>src/main/resources</directory>

renovate.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:base","mergeConfidence:all-badges"
+  ],
+   "packageRules": [
+    {
+      "description": "Automerge non-major updates",
+      "matchUpdateTypes": ["minor", "patch"],
+      "automerge": true
+    }
+  ]
+}

src/main/java/cc/carm/plugin/userprefix/Main.java

@@ -1,86 +1,159 @@
 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.lib.easyplugin.EasyPlugin;
+import cc.carm.lib.easyplugin.gui.GUI;
+import cc.carm.lib.easyplugin.gui.paged.AutoPagedGUI;
+import cc.carm.lib.easyplugin.updatechecker.GHUpdateChecker;
+import cc.carm.lib.easyplugin.utils.MessageUtils;
+import cc.carm.plugin.userprefix.command.AdminCommand;
+import cc.carm.plugin.userprefix.command.UserCommand;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import cc.carm.plugin.userprefix.folia.FoliaScheduler;
 import cc.carm.plugin.userprefix.hooker.UserPrefixExpansion;
+import cc.carm.plugin.userprefix.listener.ChatListener;
 import cc.carm.plugin.userprefix.listener.UserListener;
-import cc.carm.plugin.userprefix.listener.processor.UserNodeUpdateProcessor;
-import cc.carm.plugin.userprefix.manager.ServiceManager;
-import net.luckperms.api.event.user.UserDataRecalculateEvent;
+import cc.carm.plugin.userprefix.listener.UserPermListener;
 import cc.carm.plugin.userprefix.manager.ConfigManager;
 import cc.carm.plugin.userprefix.manager.PrefixManager;
-import cc.carm.plugin.userprefix.util.ColorParser;
+import cc.carm.plugin.userprefix.manager.ServiceManager;
+import cc.carm.plugin.userprefix.manager.UserManager;
+import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
+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.event.Listener;
-import org.bukkit.plugin.java.JavaPlugin;
+import org.bukkit.plugin.Plugin;
 
-public class Main extends JavaPlugin {
+public class Main extends EasyPlugin {
 
     private static Main instance;
 
+    protected FoliaScheduler foliaScheduler;
+    protected boolean onFolia;
+
+    protected ConfigManager configManager;
+    protected PrefixManager prefixManager;
+    protected UserManager userManager;
+
     @Override
-    public void onEnable() {
+    protected boolean initialize() {
         instance = this;
 
-        log(getName() + " " + getDescription().getVersion() + " &7开始加载...");
-        long startTime = System.currentTimeMillis();
+        try {
+            Class.forName("io.papermc.paper.threadedregions.RegionizedServer");
+            this.onFolia = true;
+        } catch (ClassNotFoundException e) {
+            this.onFolia = false;
+        }
+        this.foliaScheduler = new FoliaScheduler(this, this.onFolia);
 
-        log("加载配置文件...");
-        ConfigManager.initConfig();
-        PrefixManager.init();
+        log("加载插件配置...");
+        this.configManager = new ConfigManager(getDataFolder());
+        this.prefixManager = new PrefixManager();
+
+        log("加载前缀配置...");
+        int loaded = prefixManager.loadPrefixes();
+        log("   成功加载了 " + loaded + " 个前缀配置。");
+
+        log("加载用户管理器...");
+        this.userManager = new UserManager();
 
         log("注册指令...");
-        Bukkit.getPluginCommand("UserPrefix").setExecutor(new UserPrefixCommand());
-        Bukkit.getPluginCommand("UserPrefixAdmin").setExecutor(new UserPrefixAdminCommand());
+        registerCommand("UserPrefix", new UserCommand());
+        registerCommand("UserPrefixAdmin", new AdminCommand(this));
 
         log("注册监听器...");
-        regListener(new UserListener());
-        ServiceManager.getService().getEventBus().subscribe(this, UserDataRecalculateEvent.class, UserNodeUpdateProcessor::process);
+        registerListener(new UserListener());
+        registerListener(new ChatListener());
+        ServiceManager.getService().getEventBus().subscribe(
+                this, UserDataRecalculateEvent.class,
+                UserPermListener::process
+        );
 
-        if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
+        log("初始化GUI管理器...");
+        GUI.initialize(this);
+        AutoPagedGUI.defaultNextPage = (PluginConfig.GUI.BOTTOMS.NEXT_PAGE::get);
+        AutoPagedGUI.defaultPreviousPage = (PluginConfig.GUI.BOTTOMS.PREV_PAGE::get);
+
+        if (MessageUtils.hasPlaceholderAPI()) {
             log("注册变量...");
-            new UserPrefixExpansion(getInstance()).register();
+            new UserPrefixExpansion(this, getName()).register();
         } else {
-            log("未安装 PlaceholderAPI 放弃注册变量...");
+            log("未安装 PlaceholderAPI ，跳过变量注册...");
+            log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
         }
 
+        if (PluginConfig.METRICS.getNotNull()) {
+            log("启用统计数据...");
+            Metrics metrics = new Metrics(this, 13776);
+            metrics.addCustomChart(new SingleLineChart("active_prefixes", () -> prefixManager.getPrefixes().size()));
+            metrics.addCustomChart(new SimplePie("custom_storage", () -> PluginConfig.CUSTOM_STORAGE.ENABLE.getNotNull() ? "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();
+            }));
+        }
 
-        log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+        if (PluginConfig.CHECK_UPDATE.getNotNull()) {
+            log("开始检查更新...");
+            this.foliaScheduler.runAsync(GHUpdateChecker.runner(this));
+        } else {
+            log("已禁用检查更新，跳过。");
+        }
+
+        if (PluginConfig.FUNCTIONS.NAME_PREFIX.ENABLE.getNotNull() && this.isOnFolia()) {
+            log("插件正运行在 Folia 服务端上，头顶前缀功能不可用");
+        }
+        Bukkit.getOnlinePlayers().forEach(userManager::initPlayer);  // 适配热重载
+
+        log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
+        log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
+        return true;
     }
 
     @Override
-    public void onDisable() {
-        log(getName() + " " + getDescription().getVersion() + " 开始卸载...");
-        long startTime = System.currentTimeMillis();
+    protected void shutdown() {
 
-        log("卸载监听器...");
-        Bukkit.getServicesManager().unregisterAll(this);
+        log("关闭已被打开的GUI...");
+        Bukkit.getOnlinePlayers().stream().filter(GUI::hasOpenedGUI).forEach(player -> {
+            player.closeInventory();
+            GUI.removeOpenedGUI(player);
+            PrefixSelectGUI.removeOpening(player);
+        });
 
-        log("卸载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+        log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
+        log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
     }
 
-    /**
-     * 注册监听器
-     *
-     * @param listener 监听器
-     */
-    public static void regListener(Listener listener) {
-        Bukkit.getPluginManager().registerEvents(listener, getInstance());
+    public boolean isOnFolia() {
+        return this.onFolia;
     }
 
-    public static void log(String message) {
-        Bukkit.getConsoleSender().sendMessage(ColorParser.parseColor("[" + getInstance().getName() + "] " + message));
+    public FoliaScheduler getFoliaScheduler() {
+        return this.foliaScheduler;
     }
 
-    public static void debug(String message) {
-        if (PrefixConfig.DEBUG.get()) {
-            log("[DEBUG] " + ColorParser.parseColor(message));
-        }
+    @Override
+    public boolean isDebugging() {
+        return PluginConfig.DEBUG.getNotNull();
     }
 
-    public static JavaPlugin getInstance() {
+    public static void info(String... message) {
+        getInstance().log(message);
+    }
+
+    public static void debugging(String... message) {
+        getInstance().debug(message);
+    }
+
+    public static void severe(String... message) {
+        getInstance().error(message);
+    }
+
+    public static Main getInstance() {
         return instance;
     }
-
 }

src/main/java/cc/carm/plugin/userprefix/UserPrefixAPI.java

@@ -0,0 +1,26 @@
+package cc.carm.plugin.userprefix;
+
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import cc.carm.plugin.userprefix.manager.ConfigManager;
+import cc.carm.plugin.userprefix.manager.PrefixManager;
+import cc.carm.plugin.userprefix.manager.UserManager;
+
+public class UserPrefixAPI {
+
+    public static PrefixManager getPrefixManager() {
+        return Main.getInstance().prefixManager;
+    }
+
+    public static ConfigManager getConfigManager() {
+        return Main.getInstance().configManager;
+    }
+
+    public static UserManager getUserManager() {
+        return Main.getInstance().userManager;
+    }
+
+    public static PrefixConfig getDefaultPrefix(){
+        return getPrefixManager().getDefaultPrefix();
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/command/AdminCommand.java

@@ -0,0 +1,38 @@
+package cc.carm.plugin.userprefix.command;
+
+import cc.carm.lib.easyplugin.command.CommandHandler;
+import cc.carm.plugin.userprefix.command.admin.ListCommand;
+import cc.carm.plugin.userprefix.command.admin.ReloadCommand;
+import cc.carm.plugin.userprefix.command.admin.SetCommand;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import org.bukkit.command.CommandSender;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+public class AdminCommand extends CommandHandler {
+
+
+    public AdminCommand(@NotNull JavaPlugin plugin) {
+        super(plugin);
+        registerSubCommand(new ListCommand(this, "list", "l"));
+        registerSubCommand(new SetCommand(this, "set"));
+        registerSubCommand(new ReloadCommand(this, "reload"));
+    }
+
+    @Override
+    public Void noArgs(CommandSender sender) {
+        return help(sender);
+    }
+
+    @Override
+    public Void noPermission(CommandSender sender) {
+        PluginMessages.COMMAND_USAGE.NO_PERM.sendTo(sender);
+        return null;
+    }
+
+    public static Void help(CommandSender sender) {
+        PluginMessages.COMMAND_USAGE.ADMIN.sendTo(sender);
+        return null;
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/command/UserCommand.java

@@ -1,19 +1,30 @@
 package cc.carm.plugin.userprefix.command;
 
+import cc.carm.plugin.userprefix.conf.PluginMessages;
 import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
+import org.bukkit.Bukkit;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandExecutor;
 import org.bukkit.command.CommandSender;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
 
-public class UserPrefixCommand implements CommandExecutor {
+public class UserCommand implements CommandExecutor {
 
 
     @Override
     public boolean onCommand(@NotNull CommandSender sender, @NotNull Command command, @NotNull String s, @NotNull String[] strings) {
         if (sender instanceof Player) {
             PrefixSelectGUI.open((Player) sender);
+        } else {
+            if (strings.length != 1) {
+                PluginMessages.COMMAND_USAGE.CONSOLE.sendTo(sender);
+            } else {
+                Player player = Bukkit.getPlayer(strings[0]);
+                if (player != null) {
+                    PrefixSelectGUI.open(player);
+                }
+            }
         }
         return true;
     }

src/main/java/cc/carm/plugin/userprefix/command/UserPrefixAdminCommand.java

@@ -1,61 +0,0 @@
-package cc.carm.plugin.userprefix.command;
-
-import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
-import cc.carm.plugin.userprefix.manager.PrefixManager;
-import cc.carm.plugin.userprefix.manager.UserManager;
-import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
-import cc.carm.plugin.userprefix.util.ColorParser;
-import org.bukkit.Bukkit;
-import org.bukkit.command.Command;
-import org.bukkit.command.CommandExecutor;
-import org.bukkit.command.CommandSender;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-
-public class UserPrefixAdminCommand implements CommandExecutor {
-
-
-    @Override
-    public boolean onCommand(@NotNull CommandSender sender, @NotNull Command command, @NotNull String s, @NotNull String[] args) {
-        if (args.length == 1) {
-            String aim = args[0];
-            if (aim.equalsIgnoreCase("list")) {
-                sender.sendMessage(ColorParser.parseColor("&3&l用户前缀系统 &f前缀列表"));
-                for (ConfiguredPrefix value : PrefixManager.getPrefixes().values()) {
-                    sender.sendMessage(ColorParser.parseColor("&8#" + value.getWeight() + " &f" + value.getIdentifier()));
-                    sender.sendMessage(ColorParser.parseColor("&8- &7显示名 &r" + value.getName() + " &7权限&r " + value.getPermission()));
-                    sender.sendMessage(ColorParser.parseColor("&8- &7内容示例&r " + value.getContent() + sender.getName()));
-                }
-                return true;
-            } else if (aim.equalsIgnoreCase("reload")) {
-                long s1 = System.currentTimeMillis();
-                PrefixSelectGUI.closeAll(); // 关掉所有正在显示的前缀列表
-                PrefixManager.loadConfiguredPrefixes(); //重载配置文件
-                for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
-                    UserManager.checkPrefix(onlinePlayer, false);
-                    /*
-                     * 这里关掉loadOthers(为其他玩家更新)了。
-                     * 因为每个玩家更新的时候会为其他人更新自己，
-                     * 全部走完一遍后，所有玩家都会加载最新的前缀内容。
-                     */
-                    UserManager.updatePrefixView(onlinePlayer, false);
-                }
-                sender.sendMessage(ColorParser.parseColor("&a&l重载完成！&7共耗时 &f" + (System.currentTimeMillis() - s1) + " ms&7。"));
-                return true;
-            }
-            return help(sender);
-        }
-        return help(sender);
-    }
-
-    public static boolean help(CommandSender sender) {
-        sender.sendMessage(ColorParser.parseColor("&3&l用户前缀系统 &f帮助"));
-        sender.sendMessage(ColorParser.parseColor("&8#&f list"));
-        sender.sendMessage(ColorParser.parseColor("&8- &7查看当前前缀列表。"));
-        sender.sendMessage(ColorParser.parseColor("&8#&f reload"));
-        sender.sendMessage(ColorParser.parseColor("&8- &7重载前缀配置。"));
-        return true;
-    }
-
-
-}

src/main/java/cc/carm/plugin/userprefix/command/admin/ListCommand.java

@@ -0,0 +1,34 @@
+package cc.carm.plugin.userprefix.command.admin;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.command.AdminCommand;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import org.bukkit.command.CommandSender;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Optional;
+
+public class ListCommand extends SubCommand<AdminCommand> {
+
+    public ListCommand(@NotNull AdminCommand parent, String name, String... aliases) {
+        super(parent, name, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) {
+        PluginMessages.LIST.HEADER.sendTo(sender);
+        for (PrefixConfig value : UserPrefixAPI.getPrefixManager().getPrefixes().values()) {
+            PluginMessages.LIST.VALUE.sendTo(sender,
+                    value.getWeight(), value.getIdentifier(),
+                    value.getName(), Optional.ofNullable(value.getPermission()).orElse("~"),
+                    value.getContent(sender), sender.getName()
+            );
+        }
+        return null;
+    }
+
+
+}

src/main/java/cc/carm/plugin/userprefix/command/admin/ReloadCommand.java

@@ -0,0 +1,43 @@
+package cc.carm.plugin.userprefix.command.admin;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.command.AdminCommand;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
+import org.bukkit.Bukkit;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+public class ReloadCommand extends SubCommand<AdminCommand> {
+
+    public ReloadCommand(@NotNull AdminCommand parent, String name, String... aliases) {
+        super(parent, name, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) {
+        long s1 = System.currentTimeMillis();
+        PrefixSelectGUI.closeAll(); // 关掉所有正在显示的前缀列表
+        try {
+            UserPrefixAPI.getConfigManager().reload(); // 重载配置文件
+            int num = UserPrefixAPI.getPrefixManager().loadPrefixes(); //加载重载后了的前缀配置
+            for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
+                UserPrefixAPI.getUserManager().checkPrefix(onlinePlayer, false);
+                /*
+                 * 这里关掉loadOthers(为其他玩家更新)了。
+                 * 因为每个玩家更新的时候会为其他人更新自己，
+                 * 全部走完一遍后，所有玩家都会加载最新的前缀内容。
+                 */
+                UserPrefixAPI.getUserManager().updatePrefixView(onlinePlayer, false);
+            }
+            PluginMessages.RELOAD.SUCCESS.sendTo(sender, System.currentTimeMillis() - s1, num);
+        } catch (Exception e) {
+            PluginMessages.RELOAD.FAILED.sendTo(sender, e.getMessage());
+            e.printStackTrace();
+        }
+        return null;
+    }
+}

src/main/java/cc/carm/plugin/userprefix/command/admin/SetCommand.java

@@ -0,0 +1,54 @@
+package cc.carm.plugin.userprefix.command.admin;
+
+import cc.carm.lib.easyplugin.command.SubCommand;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.command.AdminCommand;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import org.bukkit.Bukkit;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+public class SetCommand extends SubCommand<AdminCommand> {
+
+    public SetCommand(@NotNull AdminCommand parent, String name, String... aliases) {
+        super(parent, name, aliases);
+    }
+
+    @Override
+    public Void execute(JavaPlugin plugin, CommandSender sender, String[] args) {
+        if (args.length < 2) return getParent().noArgs(sender);
+
+        Player target = Bukkit.getPlayer(args[0]);
+        if (target == null) {
+            PluginMessages.NOT_ONLINE.sendTo(sender, args[0]);
+            return null;
+        }
+
+
+        PrefixConfig prefixConfig;
+        String prefixInput = args[1];
+        if (prefixInput.equalsIgnoreCase("default")) {
+            prefixConfig = UserPrefixAPI.getDefaultPrefix();
+        } else {
+            prefixConfig = UserPrefixAPI.getPrefixManager().getPrefix(prefixInput);
+        }
+
+        if (prefixConfig == null) {
+            PluginMessages.SET.PREFIX_NOT_FOUND.sendTo(sender, prefixInput);
+            return null;
+        }
+
+        if (!prefixConfig.checkPermission(target)) {
+            PluginMessages.SET.NO_PERM.sendTo(sender, target.getName(), prefixConfig.getName());
+            return null;
+        }
+
+        UserPrefixAPI.getUserManager().setPrefix(target, prefixConfig, true);
+        PluginMessages.SET.SUCCESS.sendTo(sender, target.getName(), prefixConfig.getName());
+        return null;
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/conf/PluginConfig.java

@@ -0,0 +1,213 @@
+package cc.carm.plugin.userprefix.conf;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.adapter.ValueType;
+import cc.carm.lib.configuration.annotation.ConfigPath;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.configuration.value.standard.ConfiguredList;
+import cc.carm.lib.configuration.value.standard.ConfiguredValue;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredSound;
+import cc.carm.lib.mineconfiguration.bukkit.value.item.ConfiguredItem;
+import cc.carm.plugin.userprefix.conf.gui.GUIItems;
+import cc.carm.plugin.userprefix.folia.MajorUtil;
+import org.bukkit.Material;
+import org.bukkit.inventory.ItemFlag;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class PluginConfig implements Configuration {
+
+    @HeaderComments({"开发者查错模式"})
+    public static final ConfiguredValue<Boolean> DEBUG = ConfiguredValue.of(Boolean.class, false);
+
+    @HeaderComments({
+            "统计数据设定",
+            " 该选项用于帮助开发者统计插件版本与使用情况，且绝不会影响性能与使用体验。",
+            " 当然，您也可以选择在这里关闭，或在plugins/bStats下的配置文件中关闭。"
+    })
+    public static final ConfiguredValue<Boolean> METRICS = ConfiguredValue.of(Boolean.class, true);
+
+    @HeaderComments({
+            "检查更新设定",
+            "该选项用于插件判断是否要检查更新，若您不希望插件检查更新并提示您，可以选择关闭。",
+            "检查更新为异步操作，绝不会影响性能与使用体验。"
+    })
+    public static final ConfiguredValue<Boolean> CHECK_UPDATE = ConfiguredValue.of(Boolean.class, true);
+
+    @HeaderComments({"自定义存储位置设定", "可以规定到远程文件夹中去加载前缀配置"})
+    public static final class CUSTOM_STORAGE implements Configuration {
+
+        @HeaderComments({"是否启用自定义存储位置"})
+        public static final ConfiguredValue<Boolean> ENABLE = ConfiguredValue.of(Boolean.class, false);
+
+        @HeaderComments({
+                "目标存储路径，必须指向一个文件夹。",
+                "默认存储位置为 “插件文件夹”/prefixes",
+                "支持绝对文件路径，如 \"/etc/minecraft/configurations/prefixes/\""
+        })
+        public static final ConfiguredValue<String> PATH = ConfiguredValue.of(String.class, "prefixes/");
+
+    }
+
+    @HeaderComments("功能设定")
+    public static class FUNCTIONS implements Configuration {
+
+        @ConfigPath("on-name-prefix")
+        @HeaderComments({"头顶与TabList前缀功能，该方法用到了玩家名计分板接口，如有冲突请关掉哦~"})
+        public static final class NAME_PREFIX implements Configuration {
+
+            @HeaderComments("是否开启本功能")
+            public static final ConfiguredValue<Boolean> ENABLE = ConfiguredValue.of(Boolean.class, true);
+
+            @HeaderComments("是否按降序排列，即权重越高的前缀显示在越上面；若为false则按升序排列。")
+            public static final ConfiguredValue<Boolean> ORDER_DESC = ConfiguredValue.of(Boolean.class, true);
+
+        }
+
+        @ConfigPath("auto-prefix-use")
+        @HeaderComments("自动使用前缀，即当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个")
+        public static final ConfiguredValue<Boolean> AUTO_USE = ConfiguredValue.of(Boolean.class, true);
+
+
+        @HeaderComments({
+                "聊天功能设定",
+                "- 我不推荐使用本插件的聊天功能，而是建议使用其他的聊天插件。",
+                "- 本插件仅仅提供了**最基本**的格式变量支持，不包含其他任何功能。",
+                "- 注意聊天格式需要遵守Bukkit原格式，即不得缺失 “%1$s” 和 “%2$s” 。",
+                "- 本插件的聊天功能不影响其他插件对聊天事件的操作。"
+        })
+        public static final class CHAT implements Configuration {
+
+            @HeaderComments("是否开启本功能")
+            public static final ConfiguredValue<Boolean> ENABLE = ConfiguredValue.of(Boolean.class, false);
+            @HeaderComments({
+                    "聊天的格式，注意 “%1$s” 和 “%2$s” 不可缺少。",
+                    "- %1$s -> 玩家名", "- %2$s -> 聊天内容"
+            })
+            public static final ConfiguredValue<String> FORMAT = ConfiguredValue.of(String.class, "<%1$s> %2$s");
+
+        }
+
+    }
+
+    @HeaderComments({"前缀GUI界面设定"})
+    public static class GUI implements Configuration {
+
+        @HeaderComments("GUI的标题")
+        public static final ConfiguredValue<String> TITLE = ConfiguredValue.of(String.class, "&f&l我的前缀 &8| 列表");
+
+        @HeaderComments("GUI中的基本按钮物品")
+        public static final class BOTTOMS implements Configuration {
+
+            @HeaderComments("前往下一页的物品 (只有存在下一页时才会显示)")
+            public static final ConfiguredItem NEXT_PAGE = ConfiguredItem.create()
+                    .defaultType(Material.ARROW)
+                    .defaultName("下一页")
+                    .defaultLore("&7&o右键可前往最后一页哦")
+                    .build();
+
+            @ConfigPath("previous-page")
+            @HeaderComments({"前往上一页时的物品 (只有当前页不是第一页时才会显示)"})
+            public static final ConfiguredItem PREV_PAGE = ConfiguredItem.create()
+                    .defaultType(Material.ARROW)
+                    .defaultName("上一页")
+                    .defaultLore("&7&o右键可前往第一页哦")
+                    .build();
+
+        }
+
+        @HeaderComments("GUI中的其他按钮物品 (若与现有物品位置冲突，将被覆盖）")
+        public static final ConfiguredValue<GUIItems> ITEMS = ConfiguredValue
+                .builderOf(GUIItems.class).fromSection()
+                .defaults(GUIItems::defaults)
+                .serialize(GUIItems::serialize)
+                .parse(GUIItems::parse)
+                .build();
+
+    }
+
+    @HeaderComments({"相关的声音，留空则不播放声音", "格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】"})
+    public static final class SOUNDS implements Configuration {
+
+        public static final ConfiguredSound GUI_OPEN = ConfiguredSound.of("BLOCK_NOTE_BLOCK_PLING", 0.5F, 0.8F);
+        public static final ConfiguredSound GUI_CLICK = ConfiguredSound.of("UI_BUTTON_CLICK");
+        public static final ConfiguredSound PREFIX_CHANGE = ConfiguredSound.of("ENTITY_VILLAGER_YES");
+        public static final ConfiguredSound PREFIX_EXPIRED = ConfiguredSound.of("ENTITY_VILLAGER_NO");
+
+    }
+
+    @HeaderComments({"默认前缀配置"})
+    public static final class DEFAULT_PREFIX implements Configuration {
+
+        @HeaderComments("默认前缀的显示名称，用于在消息提示中显示。")
+        public static final ConfiguredValue<String> NAME = ConfiguredValue.of(String.class, "默认前缀");
+
+        @HeaderComments({"默认前缀的描述信息。"})
+        public static final ConfiguredList<String> DESCRIPTION = ConfiguredList.builderOf(String.class).fromString()
+                .defaults("&7这是一个默认前缀", "&7您可以在前缀列表中选择其他前缀")
+                .build();
+
+        @HeaderComments({"默认前缀的权重，默认为0。"})
+        public static final ConfiguredValue<Integer> WEIGHT = ConfiguredValue.of(Integer.class, 0);
+
+        @HeaderComments({"默认前缀的内容，即用于显示的实际前缀"})
+        public static final ConfiguredValue<List<String>> CONTENT = ConfiguredValue
+                .builderOf(ValueType.ofList(String.class))
+                .from(Object.class)
+                .parse(obj -> {
+                    if (obj instanceof List<?>) {
+                        List<?> list = (List<?>) obj;
+                        return list.stream()
+                                .map(Object::toString)
+                                .collect(Collectors.toList());
+                    } else return Collections.singletonList(String.valueOf(obj));
+                })
+                .serialize(list -> {
+                    if (list.isEmpty()) {
+                        return "";
+                    } else if (list.size() == 1) {
+                        return list.get(0);
+                    } else {
+                        return list;
+                    }
+                })
+                .defaults(Collections.singletonList("&r"))
+                .build();
+
+
+        @HeaderComments({"默认前缀的切换周期，单位为毫秒。（小于0则表示不进行切换，等于0则代表所及选取）"})
+        public static final ConfiguredValue<Long> PERIOD = ConfiguredValue.of(-1L);
+
+        @HeaderComments({"选择默认前缀时执行的操作"})
+        public static final ConfiguredList<String> ACTIONS = ConfiguredList.builderOf(String.class).fromString()
+                .defaults("[CONSOLE] " + "say %player_name% 选择了默认前缀")
+                .build();
+
+        @HeaderComments({"默认前缀的显示物品"})
+        public static final class ITEM implements Configuration {
+
+            @HeaderComments({"当未选择默认前缀时显示的物品"})
+            public static final ConfiguredItem NOT_USING = ConfiguredItem.create()
+                    .defaultType(Material.NAME_TAG)
+                    .defaultName("&f默认玩家前缀 &f(点击切换)")
+                    .defaultLore("", "{&f&o  }#description#{1,1}", "&a➥ 点击切换到该前缀")
+                    .build();
+
+            @HeaderComments({"当选择了默认前缀时显示的物品"})
+            public static final ConfiguredItem USING = ConfiguredItem.create()
+                    .defaultType(Material.NAME_TAG)
+                    .defaultEnchant(MajorUtil.getEnchantProtection(), 1) // 附魔改过名
+                    .defaultFlags(ItemFlag.HIDE_ENCHANTS)
+                    .defaultName("&f默认玩家前缀")
+                    .defaultLore("", "{&f&o  }#description#{1,1}", "&a✔ 您正在使用该前缀")
+                    .build();
+
+        }
+
+
+    }
+
+
+}

src/main/java/cc/carm/plugin/userprefix/conf/PluginMessages.java

@@ -0,0 +1,94 @@
+package cc.carm.plugin.userprefix.conf;
+
+import cc.carm.lib.configuration.Configuration;
+import cc.carm.lib.configuration.annotation.HeaderComments;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredMessage;
+
+public class PluginMessages implements Configuration {
+
+    public static final class COMMAND_USAGE implements Configuration {
+
+        public static final ConfiguredMessage<String> CONSOLE = ConfiguredMessage.asString().defaults(
+                "&f请输入 &b/prefix <玩家ID> &f为指定玩家打开前缀GUI。"
+        ).build();
+
+        public static final ConfiguredMessage<String> ADMIN = ConfiguredMessage.asString().defaults(
+                "&3&l用户前缀系统 &f帮助",
+                "&8# &f/upa list",
+                "&8- &7查看当前前缀列表。",
+                "&8# &f/upa set &b<玩家ID> &b<前缀ID>",
+                "&8- &7为玩家设定指定前缀。",
+                "&8- &7&o注意：玩家必须拥有指定前缀的权限。",
+                "&8# &f/upa reload",
+                "&8- &7重载前缀配置。"
+        ).build();
+
+        public static final ConfiguredMessage<String> NO_PERM = ConfiguredMessage.asString()
+                .defaults("&c&l抱歉！&f但您没有权限使用该指令。")
+                .build();
+
+    }
+
+    public static final ConfiguredMessage<String> NOT_ONLINE = ConfiguredMessage.asString()
+            .defaults("&7玩家 &b%(player) &7并不在线。")
+            .params("player").build();
+
+    public static final ConfiguredMessage<String> SELECTED = ConfiguredMessage.asString()
+            .defaults("&7您选择了 &f%(name) &7作为当前显示的前缀。")
+            .params("name").build();
+
+    public static final ConfiguredMessage<String> EXPIRED = ConfiguredMessage.asString()
+            .defaults(
+                    "&7您先前使用的前缀 &f%(oldName) &7已到期。",
+                    "&7现在已为您重新调整为 &f%(newName) &7。"
+            ).params("oldName", "newName").build();
+
+    public static final ConfiguredMessage<String> REMOVED = ConfiguredMessage.asString()
+            .defaults("&7您先前使用的前缀已被移除，现在已为您重新调整为 &f%(newName) &7。")
+            .params("newName").build();
+
+    public static final class RELOAD implements Configuration {
+
+        public static final ConfiguredMessage<String> SUCCESS = ConfiguredMessage.asString()
+                .defaults("&a&l重载完成！&7耗时 &f%(time)ms&7，共加载了 &b%(count) &7个前缀。")
+                .params("time", "count").build();
+
+        public static final ConfiguredMessage<String> FAILED = ConfiguredMessage.asString()
+                .defaults("&c&l重载出错！&7错误提示为 &8“&r%(error)&8”。")
+                .params("error").build();
+    }
+
+    public static final class SET implements Configuration {
+
+        public static final ConfiguredMessage<String> SUCCESS = ConfiguredMessage.asString()
+                .defaults("&a&l设置成功！&7成功设定玩家 &b%(player) &f的前缀为 &r%(prefix) &f。")
+                .params("player", "prefix").build();
+
+        public static final ConfiguredMessage<String> PREFIX_NOT_FOUND = ConfiguredMessage.asString()
+                .defaults("&c&l无法设置！&7不存在ID为 &b%(prefix) &7的前缀。")
+                .params("prefix").build();
+
+        public static final ConfiguredMessage<String> NO_PERM = ConfiguredMessage.asString()
+                .defaults("&c&l无法设置！&7玩家 &b%(player) &7并没有前缀 &r%(prefix) &7的前缀。")
+                .params("player", "prefix")
+                .build();
+
+    }
+
+
+    @HeaderComments("管理员使用的 “/upa list” 指令的格式")
+    public static final class LIST implements Configuration {
+
+        public static final ConfiguredMessage<String> HEADER = ConfiguredMessage.asString()
+                .defaults("&3&l用户前缀系统 &f前缀列表").build();
+
+        public static final ConfiguredMessage<String> VALUE = ConfiguredMessage.asString().defaults(
+                "&8#%(weight) &f%(identifier)",
+                "&8- &7显示名 &r%(name) &7权限 &r%(permission)",
+                "&8- &7内容示例&r %(content) %(sender_name)"
+        ).params("weight", "identifier", "name", "permission", "content", "sender_name").build();
+
+    }
+
+
+}

src/main/java/cc/carm/plugin/userprefix/conf/gui/GUIItems.java

@@ -0,0 +1,59 @@
+package cc.carm.plugin.userprefix.conf.gui;
+
+import cc.carm.lib.configuration.source.section.ConfigureSection;
+import cc.carm.lib.easyplugin.gui.configuration.GUIActionConfiguration;
+import cc.carm.lib.easyplugin.gui.configuration.GUIActionType;
+import cc.carm.lib.easyplugin.gui.configuration.GUIConfiguration;
+import cc.carm.lib.easyplugin.gui.configuration.GUIItemConfiguration;
+import cc.carm.lib.mineconfiguration.bukkit.source.BukkitSection;
+import cc.carm.plugin.userprefix.Main;
+import org.bukkit.Material;
+
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+public class GUIItems {
+
+    protected final Map<String, GUIItemConfiguration> items;
+
+    public GUIItems(Map<String, GUIItemConfiguration> items) {
+        this.items = items;
+    }
+
+    public Map<String, GUIItemConfiguration> getItems() {
+        return items;
+    }
+
+    public Map<String, Object> serialize() {
+        return items.entrySet().stream().collect(Collectors.toMap(
+                Map.Entry::getKey,
+                entry -> entry.getValue().serialize(), (a, b) -> b,
+                LinkedHashMap::new
+        ));
+    }
+
+    public static GUIItems parse(ConfigureSection section) {
+        if (!(section instanceof BukkitSection)) {
+            Main.severe("Unknown configure source, it should never happened!");
+            Main.severe("Required: " + BukkitSection.class.getSimpleName());
+            Main.severe("Found: " + section.getClass().getSimpleName());
+            return new GUIItems(new LinkedHashMap<>());
+        }
+        BukkitSection craft = (BukkitSection) section;
+        return new GUIItems(GUIConfiguration.readItems(craft.data()));
+    }
+
+    public static GUIItems defaults() {
+        LinkedHashMap<String, GUIItemConfiguration> map = new LinkedHashMap<>();
+        map.put("back", new GUIItemConfiguration(
+                Material.BARRIER, 1, 0, "&c&l返回",
+                Collections.singletonList("&f点击即可返回上一菜单"),
+                Collections.singletonList(GUIActionConfiguration.of(GUIActionType.CHAT, "/menu")),
+                Collections.singletonList(49)
+        ));
+        return new GUIItems(map);
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/conf/prefix/PrefixConfig.java

@@ -0,0 +1,202 @@
+package cc.carm.plugin.userprefix.conf.prefix;
+
+import cc.carm.lib.easyplugin.gui.configuration.GUIActionConfiguration;
+import cc.carm.lib.easyplugin.gui.configuration.GUIActionType;
+import cc.carm.lib.easyplugin.utils.ColorParser;
+import cc.carm.lib.easyplugin.utils.MessageUtils;
+import cc.carm.lib.mineconfiguration.bukkit.value.item.PreparedItem;
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.manager.ServiceManager;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Random;
+
+public class PrefixConfig {
+
+    static final Random RANDOM = new Random();
+
+    protected final @NotNull String identifier;
+
+    protected final @NotNull String name;
+    protected final @NotNull List<String> content;
+    protected final @NotNull List<String> description;
+
+    protected final long period; // 内容变更周期，单位为毫秒
+
+    protected final int weight;
+
+    protected final @Nullable String permission;
+
+    protected final @NotNull List<GUIActionConfiguration> actions;
+
+    protected final @NotNull ItemStack itemHasPermission;
+    protected final @Nullable ItemStack itemNoPermission;
+    protected final @Nullable ItemStack itemWhenUsing;
+
+    public PrefixConfig(@NotNull String identifier, @NotNull String name,
+                        @NotNull String content, int weight, @Nullable String permission,
+                        @NotNull List<GUIActionConfiguration> actions,
+                        @NotNull ItemStack itemHasPermission,
+                        @Nullable ItemStack itemWhenUsing,
+                        @Nullable ItemStack itemNoPermission) {
+        this(
+                identifier, name, new ArrayList<>(),
+                content, weight, permission, actions,
+                itemHasPermission, itemWhenUsing, itemNoPermission
+        );
+    }
+
+    public PrefixConfig(@NotNull String identifier,
+                        @NotNull String name, @NotNull List<String> description,
+                        @NotNull String content, int weight, @Nullable String permission,
+                        @NotNull List<GUIActionConfiguration> actions,
+                        @NotNull ItemStack itemHasPermission,
+                        @Nullable ItemStack itemWhenUsing,
+                        @Nullable ItemStack itemNoPermission) {
+        this(
+                identifier, name, description,
+                Collections.singletonList(content), 0, weight, permission, actions,
+                itemHasPermission, itemWhenUsing, itemNoPermission
+        );
+    }
+
+    public PrefixConfig(@NotNull String identifier,
+                        @NotNull String name, @NotNull List<String> description,
+                        @NotNull List<String> content, long period,
+                        int weight, @Nullable String permission,
+                        @NotNull List<GUIActionConfiguration> actions,
+                        @NotNull ItemStack itemHasPermission,
+                        @Nullable ItemStack itemWhenUsing,
+                        @Nullable ItemStack itemNoPermission) {
+        this.identifier = identifier;
+        this.name = name;
+        this.description = description;
+        this.content = content;
+        this.period = period;
+        this.weight = weight;
+        this.permission = permission;
+        this.actions = actions;
+        this.itemHasPermission = itemHasPermission;
+        this.itemNoPermission = itemNoPermission;
+        this.itemWhenUsing = itemWhenUsing;
+    }
+
+    @NotNull
+    public String getIdentifier() {
+        return identifier;
+    }
+
+    @NotNull
+    public String getName() {
+        return ColorParser.parse(name);
+    }
+
+    @NotNull
+    public List<String> getDescription() {
+        return ColorParser.parse(description);
+    }
+
+    @NotNull
+    public String getContent(CommandSender viewer) {
+        if (content.isEmpty()) return "?";
+        if (period < 0 || content.size() == 1) {
+            return ColorParser.parse(MessageUtils.setPlaceholders(viewer, content.get(0)));
+        }
+        if (period == 0) {
+            // PERIOD 为0时，随机返回一个内容
+            int index = RANDOM.nextInt(content.size());
+            return ColorParser.parse(MessageUtils.setPlaceholders(viewer, content.get(index)));
+        } else {
+            // 可变化的内容，则基于偏移量与时间戳计算目标index
+            long curr = System.currentTimeMillis();
+            long offset = curr % period; // 计算偏移量
+            int index = (int) (offset / (period / content.size())); // 计算索引
+            return ColorParser.parse(MessageUtils.setPlaceholders(viewer, content.get(index)));
+        }
+    }
+
+    public int getWeight() {
+        return weight;
+    }
+
+    @Nullable
+    public String getPermission() {
+        return permission;
+    }
+
+    @NotNull
+    public ItemStack getItemHasPermission(@Nullable Player player) {
+        return getItem(player, this.itemHasPermission);
+    }
+
+    @Nullable
+    public ItemStack getItemNoPermission(@Nullable Player player) {
+        return getItem(player, this.itemNoPermission);
+    }
+
+    @Nullable
+    public ItemStack getItemWhenUsing(@Nullable Player player) {
+        return getItem(player, this.itemWhenUsing);
+    }
+
+    @Contract("_,!null->!null")
+    protected @Nullable ItemStack getItem(@Nullable Player player, @Nullable ItemStack item) {
+        PreparedItem prepared = PreparedItem.of(item);
+
+        prepared.parser((p, s) -> ColorParser.parse(MessageUtils.setPlaceholders(p, s)));
+
+        if (!getDescription().isEmpty()) {
+            prepared.insert("description", getDescription());
+            prepared.placeholder("description", String.join("\n", getDescription()));
+        }
+
+        prepared.placeholder("name", getName());
+        prepared.placeholder("identifier", getIdentifier());
+        prepared.placeholder("content", getContent(player));
+        prepared.placeholder("permission", getPermission());
+        prepared.placeholder("weight", String.valueOf(getWeight()));
+        prepared.placeholder("hasPermission", String.valueOf(checkPermission(player)));
+        prepared.placeholder("public", String.valueOf(isPublic()));
+        prepared.placeholder("visible", String.valueOf(isVisible(player)));
+
+        return prepared.get(player);
+    }
+
+
+    public boolean isPublic() {
+        return getPermission() == null;
+    }
+
+    public void executeActions(@NotNull Player player) {
+        this.actions.forEach(action -> {
+            if (action.getActionType() == GUIActionType.CONSOLE) { // 控制台执行命令必须在全局调度器中执行
+                Main.getInstance().getFoliaScheduler().runGlobal(false, () -> action.executeAction(player));
+            } else {
+                action.executeAction(player);
+            }
+        });
+    }
+
+    public boolean isVisible(Player player) {
+        return this.itemNoPermission != null || checkPermission(player);
+    }
+
+    /**
+     * 判断某玩家是否有权限使用该前缀
+     *
+     * @param player 玩家
+     * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
+     */
+    public boolean checkPermission(Player player) {
+        return permission == null || ServiceManager.hasPermission(player, permission);
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/configuration/PrefixConfig.java

@@ -1,37 +0,0 @@
-package cc.carm.plugin.userprefix.configuration;
-
-import cc.carm.plugin.userprefix.configuration.values.ConfigSound;
-import cc.carm.plugin.userprefix.configuration.values.ConfigValue;
-import cc.carm.plugin.userprefix.configuration.values.ConfigValueList;
-
-public class PrefixConfig {
-
-    public static ConfigValue<Boolean> DEBUG = new ConfigValue<>("debug", Boolean.class, false);
-
-    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 Messages {
-
-        public static ConfigValueList<String> SELECTED = new ConfigValueList<>("messages.selected", String.class);
-        public static ConfigValueList<String> EXPIRED = new ConfigValueList<>("messages.expired", String.class);
-        public static ConfigValueList<String> HELP = new ConfigValueList<>("messages.help", String.class);
-
-
-    }
-
-    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");
-
-    }
-
-
-}

src/main/java/cc/carm/plugin/userprefix/configuration/values/ConfigSound.java

@@ -1,60 +0,0 @@
-package cc.carm.plugin.userprefix.configuration.values;
-
-import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.manager.ConfigManager;
-import org.bukkit.Sound;
-import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.entity.Player;
-
-public class ConfigSound {
-    FileConfiguration source;
-    String configSection;
-
-    Sound defaultValue;
-
-    public ConfigSound(String configSection) {
-        this(configSection, null);
-    }
-
-    public ConfigSound(String configSection, Sound defaultValue) {
-        this.source = ConfigManager.getConfig();
-        this.configSection = configSection;
-        this.defaultValue = defaultValue;
-    }
-
-    public void set(Sound value, float volume) {
-        this.source.set(this.configSection, value.name() + ":" + volume);
-        this.save();
-    }
-
-    public void set(Sound value, float volume, float pitch) {
-        this.source.set(this.configSection, value.name() + ":" + volume + ":" + pitch);
-        this.save();
-    }
-
-    public void play(Player player) {
-        Sound finalSound = defaultValue;
-        float pitch = 1;
-        float volume = 1;
-        String soundString = this.source.getString(this.configSection);
-        if (soundString != null) {
-            String[] args = soundString.contains(":") ? soundString.split(":") : new String[]{soundString};
-            try {
-                if (args.length >= 1) finalSound = Sound.valueOf(args[0]);
-                if (args.length >= 2) volume = Float.parseFloat(args[1]);
-                if (args.length >= 3) volume = Float.parseFloat(args[2]);
-            } catch (Exception exception) {
-                Main.log("声音 " + this.configSection + " 配置错误，不存在 " + soundString + " ，请检查。");
-            }
-        }
-        if (finalSound != null) {
-            player.playSound(player.getLocation(), finalSound, volume, pitch);
-        }
-
-    }
-
-    public void save() {
-        ConfigManager.saveConfig();
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/configuration/values/ConfigValue.java

@@ -1,37 +0,0 @@
-package cc.carm.plugin.userprefix.configuration.values;
-
-import cc.carm.plugin.userprefix.manager.ConfigManager;
-import org.bukkit.configuration.file.FileConfiguration;
-
-public class ConfigValue<V> {
-    FileConfiguration source;
-    String configSection;
-    Class<V> clazz;
-    V defaultValue;
-
-    public ConfigValue(String configSection, Class<V> clazz) {
-        this(configSection, clazz, null);
-    }
-
-    public ConfigValue(String configSection, Class<V> clazz, V defaultValue) {
-        this.source = ConfigManager.getConfig();
-        this.configSection = configSection;
-        this.clazz = clazz;
-        this.defaultValue = defaultValue;
-    }
-
-    public V get() {
-        Object val = this.source.get(this.configSection, this.defaultValue);
-        return this.clazz.isInstance(val) ? this.clazz.cast(val) : this.defaultValue;
-    }
-
-    public void set(V value) {
-        this.source.set(this.configSection, value);
-        this.save();
-    }
-
-    public void save() {
-        ConfigManager.saveConfig();
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/configuration/values/ConfigValueList.java

@@ -1,45 +0,0 @@
-package cc.carm.plugin.userprefix.configuration.values;
-
-import cc.carm.plugin.userprefix.manager.ConfigManager;
-import org.bukkit.configuration.file.FileConfiguration;
-
-import java.util.ArrayList;
-import java.util.List;
-
-public class ConfigValueList<V> {
-    FileConfiguration source;
-    String configSection;
-    Class<V> clazz;
-
-    public ConfigValueList(String configSection, Class<V> clazz) {
-        this.source = ConfigManager.getConfig();
-        this.configSection = configSection;
-        this.clazz = clazz;
-    }
-
-    public ArrayList<V> get() {
-        List<?> list = this.source.getList(this.configSection);
-        if (list == null) {
-            return new ArrayList(0);
-        } else {
-            ArrayList<V> result = new ArrayList();
-
-            for (Object object : list) {
-                if (this.clazz.isInstance(object)) {
-                    result.add(this.clazz.cast(object));
-                }
-            }
-
-            return result;
-        }
-    }
-
-    public void set(ArrayList<V> value) {
-        this.source.set(this.configSection, value);
-        this.save();
-    }
-
-    public void save() {
-        ConfigManager.saveConfig();
-    }
-}

src/main/java/cc/carm/plugin/userprefix/event/UserPrefixChangeEvent.java

@@ -0,0 +1,72 @@
+package cc.carm.plugin.userprefix.event;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.Cancellable;
+import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Optional;
+import java.util.function.Consumer;
+
+public class UserPrefixChangeEvent extends UserPrefixEvent implements Cancellable {
+
+    public static HandlerList handler = new HandlerList();
+
+    private boolean cancelled;
+
+    private final @Nullable PrefixConfig before;
+    private @NotNull PrefixConfig after;
+
+    public UserPrefixChangeEvent(@NotNull Player who,
+                                 @Nullable PrefixConfig before,
+                                 @NotNull PrefixConfig after) {
+        super(who);
+        this.before = before;
+        this.after = after;
+    }
+
+    public @Nullable PrefixConfig getBefore() {
+        return before;
+    }
+
+    public @NotNull PrefixConfig getAfter() {
+        return after;
+    }
+
+    public void setAfter(@NotNull PrefixConfig 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 PrefixConfig before,
+                            @NotNull PrefixConfig after,
+                            @Nullable Consumer<@Nullable PrefixConfig> finish) {
+        UserPrefixChangeEvent event = new UserPrefixChangeEvent(who, before, after);
+        Main.getInstance().getFoliaScheduler().runGlobal(true, () -> {
+            Bukkit.getPluginManager().callEvent(event);
+            Optional.ofNullable(finish).ifPresent(f -> f.accept(event.getAfter()));
+        });
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/event/UserPrefixEvent.java

@@ -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);
+	}
+
+}

src/main/java/cc/carm/plugin/userprefix/event/UserPrefixExpireEvent.java

@@ -0,0 +1,37 @@
+package cc.carm.plugin.userprefix.event;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
+
+public class UserPrefixExpireEvent extends UserPrefixEvent {
+
+    public static HandlerList handler = new HandlerList();
+
+
+    public final @NotNull PrefixConfig expiredPrefix;
+
+    public UserPrefixExpireEvent(@NotNull Player who,
+                                 @NotNull PrefixConfig expiredPrefix) {
+        super(who);
+        this.expiredPrefix = expiredPrefix;
+    }
+
+    public @NotNull PrefixConfig getExpiredPrefix() {
+        return expiredPrefix;
+    }
+
+    @NotNull
+    @Override
+    public HandlerList getHandlers() {
+        return handler;
+    }
+
+    public static void call(@NotNull Player player, @NotNull PrefixConfig currentPrefix) {
+        Main.getInstance().getFoliaScheduler().runGlobal(true, () -> Bukkit.getPluginManager().callEvent(new UserPrefixExpireEvent(player, currentPrefix)));
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/folia/FoliaScheduler.java

@@ -0,0 +1,121 @@
+package cc.carm.plugin.userprefix.folia;
+
+import cc.carm.plugin.userprefix.Main;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Entity;
+import org.bukkit.plugin.Plugin;
+
+import java.lang.reflect.InvocationTargetException;
+import java.util.function.Consumer;
+
+public class FoliaScheduler {
+    private final Main plugin;
+    private final boolean folia;
+
+    public FoliaScheduler(Main plugin, boolean folia) {
+        this.plugin = plugin;
+        this.folia = folia;
+    }
+
+    public void runAsync(Runnable task) {
+        if (this.folia) {
+            this.runAsyncFolia(task);
+        } else {
+            this.runAsyncBukkit(task);
+        }
+    }
+
+    private void runAsyncBukkit(Runnable task) {
+        Bukkit.getScheduler().runTaskAsynchronously(this.plugin, task);
+    }
+
+    private void runAsyncFolia(Runnable task) {
+//        AsyncScheduler asyncScheduler = Bukkit.getAsyncScheduler();
+//        asyncScheduler.runNow(this.plugin, t -> task.run());
+
+        try {
+            Object asyncScheduler = Bukkit.class.getMethod("getAsyncScheduler")
+                    .invoke(null);
+            asyncScheduler.getClass().getMethod("runNow", Plugin.class, Consumer.class)
+                    .invoke(asyncScheduler, this.plugin, (Consumer<?>) t -> task.run());
+        } catch (IllegalAccessException | NoSuchMethodException e) {
+            Main.severe("unexpected exception during reflection (#runAsyncFolia), it should never happen!");
+            e.printStackTrace();
+        } catch (InvocationTargetException e) {
+            throw (RuntimeException) e.getTargetException();
+        }
+    }
+
+    /**
+     * Folia 上在实体所在的调度器上执行任务，或在 Bukkit 上同步执行任务
+     *
+     * @param entity 实体
+     * @param forceSync 若为 true，Bukkit 下强制同步运行；若为 false，Bukkit 下直接执行
+     * @param task 任务
+     * @see FoliaScheduler#runBukkit(boolean, Runnable)
+     * @see FoliaScheduler#runOnEntityFolia(Entity, Runnable)
+     */
+    public void runOnEntity(Entity entity, boolean forceSync, Runnable task) {
+        if (this.folia) {
+            this.runOnEntityFolia(entity, task);
+        } else {
+            this.runBukkit(forceSync, task);
+        }
+    }
+
+    private void runOnEntityFolia(Entity entity, Runnable task) {
+//        EntityScheduler entityScheduler = entity.getScheduler();
+//        entityScheduler.run(this.plugin, t -> task.run(), null);
+        try {
+            Object entityScheduler = Entity.class.getMethod("getScheduler")
+                    .invoke(entity);
+            entityScheduler.getClass().getMethod("run", Plugin.class, Consumer.class, Runnable.class)
+                    .invoke(entityScheduler, this.plugin, (Consumer<?>) t -> task.run(), null);
+        } catch (IllegalAccessException | NoSuchMethodException e) {
+            Main.severe("unexpected exception during reflection (#runOnEntityFolia), it should never happen!");
+            e.printStackTrace();
+        } catch (InvocationTargetException e) {
+            throw (RuntimeException) e.getTargetException();
+        }
+    }
+
+    /**
+     * Folia 上在全局调度器上执行任务，或在 Bukkit 上同步执行任务
+     *
+     * @param forceSync 若为 true，Bukkit 下强制同步运行；若为 false，Bukkit 下直接执行
+     * @param task 任务
+     * @see FoliaScheduler#runBukkit(boolean, Runnable)
+     * @see FoliaScheduler#runGlobalFolia(Runnable)
+     */
+    public void runGlobal(boolean forceSync, Runnable task) {
+        if (this.folia) {
+            this.runGlobalFolia(task);
+        } else {
+            this.runBukkit(forceSync, task);
+        }
+    }
+
+    private void runGlobalFolia(Runnable task) {
+//        GlobalRegionScheduler globalRegionScheduler = Bukkit.getGlobalRegionScheduler();
+//        globalRegionScheduler.execute(this.plugin, task);
+        try {
+            Object globalRegionScheduler = Bukkit.class.getMethod("getGlobalRegionScheduler")
+                    .invoke(null);
+            globalRegionScheduler.getClass().getMethod("execute", Plugin.class, Runnable.class)
+                    .invoke(globalRegionScheduler, this.plugin, task);
+        } catch (IllegalAccessException | NoSuchMethodException e) {
+            Main.severe("unexpected exception during reflection (#runGlobalFolia), it should never happen!");
+            e.printStackTrace();
+        } catch (InvocationTargetException e) {
+            throw (RuntimeException) e.getTargetException();
+        }
+    }
+
+    private void runBukkit(boolean forceSync, Runnable task) {
+        if (forceSync) {
+            Bukkit.getScheduler().runTask(this.plugin, task);
+        } else {
+            task.run();
+        }
+    }
+}

src/main/java/cc/carm/plugin/userprefix/folia/MajorUtil.java

@@ -0,0 +1,23 @@
+package cc.carm.plugin.userprefix.folia;
+
+import cc.carm.plugin.userprefix.Main;
+import org.bukkit.enchantments.Enchantment;
+
+public interface MajorUtil {
+    static Enchantment getEnchantProtection() {
+        Class<Enchantment> enchantmentClass = Enchantment.class;
+        try {
+            return (Enchantment) enchantmentClass.getField("PROTECTION_ENVIRONMENTAL").get(null);
+        } catch (NoSuchFieldException e1) {
+            try {
+                return (Enchantment) enchantmentClass.getField("PROTECTION").get(null);
+            } catch (NoSuchFieldException | IllegalAccessException e2) {
+                Main.severe("unexpected exception during reflection (#getEnchantProtection), it should never happen!");
+                throw new RuntimeException(e2);
+            }
+        } catch (IllegalAccessException e) {
+            Main.severe("unexpected exception during reflection (#getEnchantProtection), it should never happen!");
+            throw new RuntimeException(e);
+        }
+    }
+}

src/main/java/cc/carm/plugin/userprefix/hooker/UserNameTag.java

@@ -1,21 +1,29 @@
-package cc.carm.plugin.userprefix.nametag;
+package cc.carm.plugin.userprefix.hooker;
 
 import org.bukkit.Bukkit;
 import org.bukkit.entity.Player;
 import org.bukkit.scoreboard.Scoreboard;
 import org.bukkit.scoreboard.Team;
+import org.jetbrains.annotations.Range;
 
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Set;
 import java.util.UUID;
 
+/**
+ * 用户头顶标签。
+ *
+ * @author LSeng, Tony, Carm
+ */
 public class UserNameTag {
 
+    public static final int MAX_ORDER = 999;
+
     private final Player viewer;
     private Team team;
     private final Scoreboard sb;
-    private int order = 99999;
+    private int order = MAX_ORDER;
     private final Map<UUID, Integer> targetOrders = new HashMap<>();
     private final Map<UUID, String> previousTeamNames = new HashMap<>();
 
@@ -35,7 +43,7 @@ public class UserNameTag {
     /**
      * 设置自己的前缀
      *
-     * @param prefix
+     * @param prefix 前缀内容
      */
     public void setPrefix(String prefix) {
         team.setPrefix(prefix);
@@ -45,8 +53,8 @@ public class UserNameTag {
     /**
      * 设置某个玩家的前缀
      *
-     * @param target
-     * @param prefix
+     * @param target 目标
+     * @param prefix 前缀内容
      */
     public void setPrefix(Player target, String prefix) {
         if (target == viewer) {
@@ -63,11 +71,9 @@ public class UserNameTag {
     /**
      * 设置名字在TabList中的顺序
      *
-     * @param order
+     * @param order 顺序 (0~999)
      */
-    public void setOrder(int order) {
-        if (order < 0 || order > 99999)
-            throw new IllegalArgumentException("order must be in 0~99999");
+    public void setOrder(@Range(from = 0, to = 999) int order) {
         this.order = order;
         targetOrders.put(viewer.getUniqueId(), order);
         update(viewer);
@@ -78,16 +84,13 @@ public class UserNameTag {
      *
      * @param order 顺序
      */
-    public void setOrder(Player target, int order) {
-        if (order < 0 || order > 99999)
-            throw new IllegalArgumentException("order must be in 0~99999");
+    public void setOrder(Player target, @Range(from = 0, to = 999) int order) {
         Team targetTeam = checkTeam(target);
         String teamName = order + UUID.randomUUID().toString().substring(0, 10);
         targetTeam.setDisplayName(teamName);
         targetOrders.put(target.getUniqueId(), order);
         update(viewer);
-        if (viewer != target)
-            update(target);
+        if (viewer != target) update(target);
     }
 
     public void update(Player target) {
@@ -110,7 +113,7 @@ public class UserNameTag {
                 team = newTeam;
             }
         } else {
-            int order = targetOrders.getOrDefault(target.getUniqueId(), 99999);
+            int order = targetOrders.getOrDefault(target.getUniqueId(), 999);
             String previousTeamName = previousTeamNames.get(target.getUniqueId());
             if (previousTeamName == null) {
                 return;
@@ -138,7 +141,7 @@ public class UserNameTag {
     }
 
     private Team checkTeam(Player target) {
-        int order = targetOrders.getOrDefault(target.getUniqueId(), 99999);
+        int order = targetOrders.getOrDefault(target.getUniqueId(), 999);
         String name = order + target.getUniqueId().toString().substring(0, 10);
         Team targetTeam = this.sb.getTeam(name);
         if (targetTeam == null) {

src/main/java/cc/carm/plugin/userprefix/hooker/UserPrefixExpansion.java

@@ -1,89 +1,82 @@
 package cc.carm.plugin.userprefix.hooker;
 
-import me.clip.placeholderapi.expansion.PlaceholderExpansion;
-import cc.carm.plugin.userprefix.manager.PrefixManager;
-import cc.carm.plugin.userprefix.manager.UserManager;
-import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
+import cc.carm.lib.easyplugin.papi.EasyPlaceholder;
+import cc.carm.lib.easyplugin.papi.expansion.SubExpansion;
+import cc.carm.lib.easyplugin.papi.handler.PlaceholderHandler;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import org.bukkit.OfflinePlayer;
 import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
-import java.util.ArrayList;
-import java.util.List;
+import java.util.Collections;
+import java.util.function.BiFunction;
+import java.util.function.Function;
 
-public class UserPrefixExpansion extends PlaceholderExpansion {
+public class UserPrefixExpansion extends EasyPlaceholder {
 
-    JavaPlugin plugin;
+    public UserPrefixExpansion(@NotNull JavaPlugin plugin, @NotNull String rootIdentifier) {
+        super(plugin, rootIdentifier);
+
+        handle("version", (player, args) -> getVersion());
+
+        handle("identifier", handlePrefix(PrefixConfig::getIdentifier), "id");
+        handle("prefix", handlePrefix(PrefixConfig::getContent));
+        handle("name", handlePrefix(PrefixConfig::getName));
+        handle("description", handlePrefix(p -> String.join("\n", p.getDescription())));
+        handle("weight", handlePrefix(PrefixConfig::getWeight));
+        handle("amount", handlePlayer(
+                (player) -> UserPrefixAPI.getUserManager().getUsablePrefixes(player).size() + 1)
+        );
+
+        handle("has", handlePlayer((player, args) -> {
+            if (args.length < 1) return "参数不足";
+            PrefixConfig prefix = UserPrefixAPI.getPrefixManager().getPrefix(args[0]);
+            if (prefix == null) return "该前缀不存在";
+            return prefix.checkPermission(player);
+        }), Collections.singletonList("<前缀ID>"));
 
-    public UserPrefixExpansion(JavaPlugin plugin) {
-        this.plugin = plugin;
     }
 
-    @Override
-    public @NotNull List<String> getPlaceholders() {
-        List<String> placeholders = new ArrayList<>();
-        placeholders.add("%UserPrefix_prefix%");
-        placeholders.add("%UserPrefix_weight%");
-        placeholders.add("%UserPrefix_identifier%");
-        placeholders.add("%UserPrefix_name%");
-        placeholders.add("%UserPrefix_has_<Identifier>%");
-        return placeholders;
+    public PlaceholderHandler handlePrefix(Function<PrefixConfig, Object> handler) {
+        return handlePlayer((player, args) -> handler.apply(UserPrefixAPI.getUserManager().getPrefix(player)));
     }
 
+    public PlaceholderHandler handlePrefix(BiFunction<PrefixConfig, Player, Object> handler) {
+        return handlePlayer((player, args) -> handler.apply(UserPrefixAPI.getUserManager().getPrefix(player), player));
+    }
+
+    /**
+     * This is required or else PlaceholderAPI will unregister the Expansion on reload
+     */
     @Override
-    public boolean canRegister() {
+    public boolean persist() {
         return true;
     }
 
-    @Override
-    public String getAuthor() {
-        return plugin.getDescription().getAuthors().toString();
+    public PlaceholderHandler handlePlayer(BiFunction<Player, String[], Object> handler) {
+        return (player, args) -> {
+            if (player == null || !player.isOnline()) return "Loading...";
+            return handler.apply((Player) player, args);
+        };
+    }
+
+    public PlaceholderHandler handlePlayer(Function<Player, Object> handler) {
+        return handlePlayer((player, args) -> handler.apply(player));
     }
 
     @Override
-    public String getIdentifier() {
-        return "UserPrefix";
-    }
-
-    @Override
-    public String getVersion() {
-        return plugin.getDescription().getVersion();
-    }
-
-    @Override
-    public String onPlaceholderRequest(Player player, @NotNull String identifier) {
-        if (player == null) return "加载中...";
-        String[] args = identifier.split("_");
-
-
-        if (args.length < 1) {
+    public String onErrorParams(@Nullable OfflinePlayer player) {
         return "参数不足";
     }
 
-        switch (args[0].toLowerCase()) {
-            case "identifier": {
-                return UserManager.getPrefix(player).getIdentifier();
-            }
-            case "prefix": {
-                return UserManager.getPrefix(player).getContent();
-            }
-            case "name": {
-                return UserManager.getPrefix(player).getName();
-            }
-            case "weight": {
-                return Integer.toString(UserManager.getPrefix(player).getWeight());
-            }
-            case "has": {
-                if (args.length < 2) return "参数不足";
-                ConfiguredPrefix prefix = PrefixManager.getPrefix(args[1]);
-                if (prefix == null) return "该前缀不存在";
-                return Boolean.toString(UserManager.isPrefixUsable(player, prefix));
-            }
-            case "version": {
-                return getVersion().replace("-SNAPSHOT", "");
-            }
-        }
-        return null;
+    @Override
+    public String onException(@Nullable OfflinePlayer player, @NotNull SubExpansion<?> expansion,
+                              @NotNull Exception exception) {
+        exception.printStackTrace();
+        return "参数错误";
     }
 
 }

src/main/java/cc/carm/plugin/userprefix/listener/ChatListener.java

@@ -0,0 +1,30 @@
+package cc.carm.plugin.userprefix.listener;
+
+import cc.carm.lib.easyplugin.utils.MessageUtils;
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.AsyncPlayerChatEvent;
+
+public class ChatListener implements Listener {
+
+    @EventHandler
+    public void onChat(AsyncPlayerChatEvent event) {
+        if (!PluginConfig.FUNCTIONS.CHAT.ENABLE.getNotNull()) return;
+
+        String format = PluginConfig.FUNCTIONS.CHAT.FORMAT.get();
+        if (format == null || format.length() < 1) return;
+
+        try {
+            event.setFormat(MessageUtils.setPlaceholders(event.getPlayer(), format));
+        } catch (Exception exception) {
+            Main.severe("请检查配置文件中聊天相关是否配置正确。");
+            Main.severe("Please check the chat configuration.");
+            exception.printStackTrace();
+        }
+
+    }
+
+
+}

src/main/java/cc/carm/plugin/userprefix/listener/UserListener.java

@@ -1,9 +1,6 @@
 package cc.carm.plugin.userprefix.listener;
 
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
-import cc.carm.plugin.userprefix.manager.UserManager;
-import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
-import org.bukkit.entity.Player;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.player.PlayerJoinEvent;
@@ -11,29 +8,14 @@ import org.bukkit.event.player.PlayerQuitEvent;
 
 public class UserListener implements Listener {
 
-
     @EventHandler
     public void onJoin(PlayerJoinEvent event) {
-        Player player = event.getPlayer();
-
-        UserManager.checkPrefix(player, false);
-
-
-        if (PrefixConfig.Functions.NAME_PREFIX.get()) {
-            UserManager.createNameTag(event.getPlayer());
-            UserManager.updatePrefixView(event.getPlayer(), true);
+        UserPrefixAPI.getUserManager().initPlayer(event.getPlayer());
     }
 
-
-    }
-
-
     @EventHandler
     public void onLeave(PlayerQuitEvent event) {
-        PrefixSelectGUI.removeOpening(event.getPlayer());
-        UserManager.unloadNameTag(event.getPlayer().getUniqueId());
-        UserManager.checkingPlayers.remove(event.getPlayer().getUniqueId());
+        UserPrefixAPI.getUserManager().unloadPlayer(event.getPlayer());
     }
 
-
 }

src/main/java/cc/carm/plugin/userprefix/listener/UserPermListener.java

@@ -0,0 +1,25 @@
+package cc.carm.plugin.userprefix.listener;
+
+import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
+import net.luckperms.api.event.user.UserDataRecalculateEvent;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+
+public class UserPermListener {
+
+    public static void process(UserDataRecalculateEvent event) {
+        Player player = Bukkit.getPlayer(event.getUser().getUniqueId());
+        if (player == null) return;
+        UserPrefixAPI.getUserManager().checkPrefix(player, true);
+        if (PrefixSelectGUI.openingUsers.contains(player)) {
+            Main.getInstance().getFoliaScheduler().runOnEntity(player, true, () -> {
+                // 玩家权限更新，同步关闭其GUI，以令其重新打开刷新自己的前缀。
+                player.closeInventory();
+                PrefixSelectGUI.removeOpening(player);
+            });
+        }
+    }
+
+}

src/main/java/cc/carm/plugin/userprefix/listener/processor/UserNodeUpdateProcessor.java

@@ -1,29 +0,0 @@
-package cc.carm.plugin.userprefix.listener.processor;
-
-import net.luckperms.api.event.user.UserDataRecalculateEvent;
-import net.luckperms.api.model.user.User;
-import cc.carm.plugin.userprefix.manager.UserManager;
-import org.bukkit.Bukkit;
-import org.bukkit.entity.Player;
-
-public class UserNodeUpdateProcessor {
-
-//    public static void process(NodeRemoveEvent event) {
-//        if (event.getTarget() instanceof User) {
-//            if (!(event.getNode() instanceof PermissionNode)) return;
-//            User user = (User) event.getTarget();
-//            Player player = Bukkit.getPlayer(user.getUniqueId());
-//            if (player == null) return;
-//            UserManager.checkPrefix(player, true);
-//        }
-//    }
-
-    public static void process(UserDataRecalculateEvent event) {
-        User user = event.getUser();
-        Player player = Bukkit.getPlayer(user.getUniqueId());
-        if (player == null) return;
-        UserManager.checkPrefix(player, true);
-
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/manager/ConfigManager.java

@@ -1,31 +1,51 @@
 package cc.carm.plugin.userprefix.manager;
 
-import cc.carm.plugin.userprefix.Main;
-import org.bukkit.configuration.file.FileConfiguration;
+import cc.carm.lib.configuration.source.ConfigurationHolder;
+import cc.carm.lib.easyplugin.utils.JarResourceUtils;
+import cc.carm.lib.mineconfiguration.bukkit.MineConfiguration;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+
+import java.io.File;
+import java.io.IOException;
 
 public class ConfigManager {
 
-    private static FileConfiguration config;
+    private final ConfigurationHolder<?> configProvider;
+    private final ConfigurationHolder<?> messageProvider;
 
-    public static void initConfig() {
-        Main.getInstance().saveDefaultConfig();
-        Main.getInstance().reloadConfig();
-
-        config = Main.getInstance().getConfig();
+    public ConfigManager(File dataFolder) {
+        firstInitialize(dataFolder);
+        this.configProvider = MineConfiguration.from(new File(dataFolder, "config.yml"), null);
+        this.messageProvider = MineConfiguration.from(new File(dataFolder, "messages.yml"), null);
+        this.configProvider.initialize(PluginConfig.class);
+        this.messageProvider.initialize(PluginMessages.class);
     }
 
-    public static FileConfiguration getConfig() {
-        return config;
+    protected void firstInitialize(File dataFolder) {
+        File configFile = new File(dataFolder, "config.yml");
+        if (!configFile.exists()) {
+            try {
+                JarResourceUtils.copyFolderFromJar("i18n", dataFolder, JarResourceUtils.CopyOption.COPY_IF_NOT_EXIST);
+                JarResourceUtils.copyFolderFromJar("prefixes", dataFolder, JarResourceUtils.CopyOption.COPY_IF_NOT_EXIST);
+            } catch (IOException e) {
+                e.printStackTrace();
+            }
         }
 
-    public static void reloadConfig() {
-        Main.getInstance().reloadConfig();
-        config = Main.getInstance().getConfig();
     }
 
-    public static void saveConfig() {
-        Main.getInstance().saveConfig();
+    public ConfigurationHolder<?> getConfigProvider() {
+        return configProvider;
     }
 
+    public ConfigurationHolder<?> getMessageProvider() {
+        return messageProvider;
+    }
+
+    public void reload() throws Exception {
+        getConfigProvider().reload();
+        getMessageProvider().reload();
+    }
 
 }

src/main/java/cc/carm/plugin/userprefix/manager/PrefixManager.java

@@ -1,124 +1,116 @@
 package cc.carm.plugin.userprefix.manager;
 
+import cc.carm.lib.easyplugin.gui.configuration.GUIActionConfiguration;
+import cc.carm.lib.easyplugin.utils.ItemStackFactory;
 import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
-import cc.carm.plugin.userprefix.util.ItemStackFactory;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import com.cryptomorin.xseries.XItemStack;
 import org.bukkit.Material;
 import org.bukkit.configuration.ConfigurationSection;
-import org.bukkit.enchantments.Enchantment;
-import org.bukkit.inventory.ItemFlag;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.bukkit.entity.Player;
 import org.bukkit.inventory.ItemStack;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
-import java.util.Comparator;
-import java.util.HashMap;
-import java.util.List;
+import java.io.File;
+import java.util.*;
 import java.util.stream.Collectors;
 
 public class PrefixManager {
 
-    public static ConfiguredPrefix defaultPrefix;
-    public static HashMap<String, ConfiguredPrefix> prefixes = new HashMap<>();
+    protected static final String FOLDER_NAME = "prefixes";
 
+    protected @NotNull Map<String, PrefixConfig> prefixes = new HashMap<>();
+    protected PrefixConfig defaultPrefix;
 
-    public static void init() {
+    public int loadPrefixes() {
+        loadDefaultPrefix();
         loadConfiguredPrefixes();
-        Main.log("共加载了 " + prefixes.size() + " 个前缀。");
+        return prefixes.size();
     }
 
-    public static void loadConfiguredPrefixes() {
-        loadDefaultPrefix();
+    @SuppressWarnings("ResultOfMethodCallIgnored")
+    public void loadConfiguredPrefixes() {
 
-        ConfigurationSection prefixesSection = ConfigManager.getConfig().getConfigurationSection("prefixes");
-        if (prefixesSection == null || prefixesSection.getKeys(false).isEmpty()) {
-            Main.log("配置文件中暂无任何前缀配置，请检查。");
+        File prefixDataFolder = getStorageFolder();
+        if (!prefixDataFolder.isDirectory() || !prefixDataFolder.exists()) {
+            prefixDataFolder.mkdir();
+        }
+
+        String[] filesList = prefixDataFolder.list();
+        if (filesList == null || filesList.length < 1) {
+            Main.severe("配置文件夹中暂无任何前缀配置问，请检查。");
+            Main.severe("There's no configured prefix.");
+            Main.severe("Path: " + prefixDataFolder.getAbsolutePath());
             return;
         }
-        HashMap<String, ConfiguredPrefix> dataPrefixes = new HashMap<>();
-        for (String prefixIdentifier : prefixesSection.getKeys(false)) {
-            ConfigurationSection configuredPrefixSection = prefixesSection.getConfigurationSection(prefixIdentifier);
-            if (configuredPrefixSection == null) continue;
 
-            String name = configuredPrefixSection.getString("name", "前缀名配置错误");
-            String content = configuredPrefixSection.getString("content", "&r");
-            String permission = configuredPrefixSection.getString("permission");
-            int weight = configuredPrefixSection.getInt("weight", 1);
+        List<File> files = Arrays.stream(filesList)
+                .map(s -> new File(prefixDataFolder, s))
+                .filter(File::isFile)
+                .collect(Collectors.toList());
 
-            ItemStack itemHasPermission = configuredPrefixSection.getItemStack("itemHasPermission",
-                    new ItemStackFactory(Material.STONE).setDisplayName(name).addLore(" ").addLore("§a➥ 点击切换到该前缀").toItemStack()
-            );
-            ItemStack itemNoPermission = configuredPrefixSection.getItemStack("itemNoPermission", itemHasPermission);
-            ItemStack itemUsing = configuredPrefixSection.getItemStack("itemUsing", itemHasPermission);
+        HashMap<String, PrefixConfig> loaded = new HashMap<>();
 
-
-            Main.log("完成前缀加载 " + prefixIdentifier + " : " + name);
-
-            dataPrefixes.put(prefixIdentifier, new ConfiguredPrefix(prefixIdentifier, name, content, weight, permission, itemHasPermission, itemNoPermission, itemUsing));
+        if (files.size() > 0) {
+            for (File file : files) {
+                try {
+                    PrefixConfig prefix = addPrefix(file);
+                    Main.debugging("完成前缀加载 " + prefix.getIdentifier() + " : " + prefix.getName());
+                    loaded.put(prefix.getIdentifier(), prefix);
+                } catch (Exception ex) {
+                    Main.severe("在加载前缀 " + file.getAbsolutePath() + " 时出错，请检查配置！");
+                    Main.severe("Error occurred when loading prefix #" + file.getAbsolutePath() + " !");
+                    ex.printStackTrace();
+                }
+            }
         }
 
-        prefixes = dataPrefixes;
+        this.prefixes = loaded;
     }
 
-    public static void loadDefaultPrefix() {
-        ConfigurationSection defaultPrefixSection = ConfigManager.getConfig().getConfigurationSection("defaultPrefix");
-        if (defaultPrefixSection != null) {
-            String name = defaultPrefixSection.getString("name", "默认前缀");
-            String content = defaultPrefixSection.getString("content", "&r");
-            ItemStack itemNotUsing = defaultPrefixSection.getItemStack(
-                    "itemNotUsing",
-                    new ItemStackFactory(Material.NAME_TAG)
-                            .setDisplayName("&f默认前缀")
-                            .addLore(" ")
-                            .addLore("§a➥ 点击切换到该前缀")
-                            .toItemStack()
-            );
-            ItemStack itemUsing = defaultPrefixSection.getItemStack("itemUsing",
-                    new ItemStackFactory(Material.NAME_TAG)
-                            .setDisplayName("&f默认前缀")
-                            .addLore(" ")
-                            .addLore("§a✔ 您正在使用该前缀")
-                            .addEnchant(Enchantment.DURABILITY, 1, false)
-                            .addFlag(ItemFlag.HIDE_ENCHANTS)
-                            .toItemStack()
-            );
-            defaultPrefix = new ConfiguredPrefix("default", name, content, 0, null, itemNotUsing, null, itemUsing);
-        } else {
-            defaultPrefix = new ConfiguredPrefix("default", "默认前缀", "&r", 0, null,
-                    new ItemStackFactory(Material.NAME_TAG)
-                            .setDisplayName("&f默认前缀")
-                            .addLore(" ")
-                            .addLore("§a➥ 点击切换到该前缀")
-                            .toItemStack(),
+    public void loadDefaultPrefix() {
+        this.defaultPrefix = new PrefixConfig(
+                "default",
+                PluginConfig.DEFAULT_PREFIX.NAME.getNotNull(),
+                PluginConfig.DEFAULT_PREFIX.DESCRIPTION.getNotNull(),
+                PluginConfig.DEFAULT_PREFIX.CONTENT.resolve(),
+                PluginConfig.DEFAULT_PREFIX.PERIOD.resolve(),
+                PluginConfig.DEFAULT_PREFIX.WEIGHT.getNotNull(),
                 null,
-                    new ItemStackFactory(Material.NAME_TAG)
-                            .setDisplayName("&f默认前缀")
-                            .addLore(" ")
-                            .addLore("§a✔ 您正在使用该前缀")
-                            .addEnchant(Enchantment.DURABILITY, 1, false)
-                            .addFlag(ItemFlag.HIDE_ENCHANTS)
-                            .toItemStack()
+                readActions(PluginConfig.DEFAULT_PREFIX.ACTIONS.get()),
+                PluginConfig.DEFAULT_PREFIX.ITEM.NOT_USING.getNotNull(),
+                PluginConfig.DEFAULT_PREFIX.ITEM.USING.get(), null
         );
+        Main.debugging("  完成默认前缀加载 " + defaultPrefix.getName());
     }
 
-        Main.log("完成默认前缀加载 " + defaultPrefix.getName());
-    }
-
-    public static List<ConfiguredPrefix> getVisiblePrefix() {
-        return PrefixManager.getPrefixes().values().stream()
-                .filter(ConfiguredPrefix::isVisibleNoPermission)
-                .sorted(Comparator.comparingInt(ConfiguredPrefix::getWeight))
+    public List<PrefixConfig> getVisiblePrefix(Player player) {
+        return getPrefixes().values().stream()
+                .filter(c -> c.isVisible(player))
+                .sorted(Comparator.comparingInt(PrefixConfig::getWeight))
                 .collect(Collectors.toList());
     }
 
-    public static ConfiguredPrefix getDefaultPrefix() {
+    @NotNull
+    public PrefixConfig getDefaultPrefix() {
         return defaultPrefix;
     }
 
-    public static HashMap<String, ConfiguredPrefix> getPrefixes() {
+    @NotNull
+    public Map<String, PrefixConfig> getPrefixes() {
         return prefixes;
     }
 
-    public static ConfiguredPrefix getPrefix(String identifier) {
-        if (identifier == null || identifier.equalsIgnoreCase("default")) {
+    @Nullable
+    public PrefixConfig getPrefix(String identifier) {
+        if (identifier == null) {
+            return null;
+        } else if (identifier.equalsIgnoreCase("default")) {
             return getDefaultPrefix();
         } else {
             return getPrefixes().get(identifier);
@@ -126,4 +118,63 @@ public class PrefixManager {
     }
 
 
+    protected File getStorageFolder() {
+        if (PluginConfig.CUSTOM_STORAGE.ENABLE.getNotNull()) {
+            return new File(PluginConfig.CUSTOM_STORAGE.PATH.getNotNull());
+        } else {
+            return new File(Main.getInstance().getDataFolder() + File.separator + FOLDER_NAME);
+        }
+    }
+
+    public static @NotNull PrefixConfig addPrefix(@NotNull File file) throws Exception {
+        FileConfiguration conf = YamlConfiguration.loadConfiguration(file);
+        String identifier = conf.getString("identifier");
+        if (identifier == null)
+            throw new Exception("配置文件 " + file.getAbsolutePath() + " 中没有配置前缀的唯一标识。");
+
+        String name = conf.getString("name");
+        if (name == null) throw new Exception("配置文件 " + file.getAbsolutePath() + " 中没有配置前缀的显示名称。");
+
+
+        List<String> content = new ArrayList<>();
+        if (conf.isList("content")) {
+            content = conf.getStringList("content");
+        } else {
+            String single = conf.getString("content");
+            if (single != null) content.add(single);
+        }
+
+
+        return new PrefixConfig(
+                identifier, name,
+                conf.getStringList("description"),
+                content,
+                conf.getLong("period", -1L),
+                conf.getInt("weight", 1),
+                conf.getString("permission"),
+                readActions(conf.getStringList("actions")),
+                readItem(
+                        conf.getConfigurationSection("item.has-perm"),
+                        new ItemStackFactory(Material.STONE)
+                                .setDisplayName(name)
+                                .addLore("§a➥ 点击切换到该前缀")
+                                .toItemStack()
+                ),
+                readItem(conf.getConfigurationSection("item.using"), null),
+                readItem(conf.getConfigurationSection("item.no-perm"), null)
+        );
+    }
+
+
+    @Contract("_,!null->!null")
+    protected static ItemStack readItem(@Nullable ConfigurationSection section,
+                                        @Nullable ItemStack defaultValue) throws Exception {
+        if (section == null) return defaultValue;
+        else return XItemStack.deserialize(section);
+    }
+
+    protected static List<GUIActionConfiguration> readActions(@NotNull List<String> strings) {
+        return strings.stream().map(GUIActionConfiguration::deserialize).filter(Objects::nonNull).collect(Collectors.toList());
+    }
+
 }

src/main/java/cc/carm/plugin/userprefix/manager/ServiceManager.java

@@ -42,4 +42,8 @@ public class ServiceManager {
         return user.getCachedData().getPermissionData().checkPermission(permission).asBoolean();
     }
 
+    public static boolean hasPermission(Player player, String permission) {
+        return hasPermission(getUser(player), permission);
+    }
+
 }

src/main/java/cc/carm/plugin/userprefix/manager/UserManager.java

@@ -1,68 +1,106 @@
 package cc.carm.plugin.userprefix.manager;
 
+import cc.carm.lib.easyplugin.gui.GUI;
 import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
-import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
-import cc.carm.plugin.userprefix.nametag.UserNameTag;
-import cc.carm.plugin.userprefix.util.MessageUtil;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import cc.carm.plugin.userprefix.event.UserPrefixChangeEvent;
+import cc.carm.plugin.userprefix.event.UserPrefixExpireEvent;
+import cc.carm.plugin.userprefix.hooker.UserNameTag;
+import cc.carm.plugin.userprefix.ui.PrefixSelectGUI;
 import net.luckperms.api.model.user.User;
 import net.luckperms.api.node.NodeType;
 import net.luckperms.api.node.types.MetaNode;
 import org.bukkit.Bukkit;
 import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.util.*;
 import java.util.stream.Collectors;
 
 public class UserManager {
 
-    public static HashMap<UUID, UserNameTag> nameTags = new HashMap<>();
+    // LuckPerms竟然会把所有的metaKey全部转换为小写... 那我这里就直接写成小写吧~
+    public static final @NotNull String META_KEY = "userprefix";
 
-    public static HashSet<UUID> checkingPlayers = new HashSet<>();
+    protected final HashMap<UUID, UserNameTag> nameTags = new HashMap<>();
 
-    public static UserNameTag getNameTag(Player player) {
+    protected final HashSet<UUID> checkingPlayers = new HashSet<>();
+
+    @Nullable
+    public UserNameTag getNameTag(Player player) {
+        if (this.isNamePrefixEnabled()) {
+            if (nameTags.containsKey(player.getUniqueId())) {
                 return nameTags.get(player.getUniqueId());
+            } else {
+                return createNameTag(player);
+            }
+        } else {
+            return null;
+        }
     }
 
-    public static UserNameTag createNameTag(Player player) {
+    @NotNull
+    public 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 void initPlayer(Player player) {
+        checkPrefix(player, false);
+        if (this.isNamePrefixEnabled()) {
+            createNameTag(player);
+            updatePrefixView(player, true);
+        }
+    }
+
+    public void unloadPlayer(Player player) {
+        PrefixSelectGUI.removeOpening(player);
+        unloadNameTag(player.getUniqueId());
+        checkingPlayers.remove(player.getUniqueId());
+        GUI.removeOpenedGUI(player); // 清空打开过的GUI缓存 (用于记录物品点击的
+    }
+
     /**
      * 更新前缀显示效果
      *
      * @param player     玩家
      * @param loadOthers 是否为玩家更新其他人的前缀(一般用于加入游戏)
      */
-    public static void updatePrefixView(Player player, boolean loadOthers) {
-        ConfiguredPrefix playerPrefix = UserManager.getPrefix(player);
-
+    public void updatePrefixView(Player player, boolean loadOthers) {
+        if (!this.isNamePrefixEnabled()) return; //未启用的情况下，不需要进行任何操作。
         UserNameTag tag = getNameTag(player);
+        if (tag == null) return;  //未启用的情况下，不需要进行任何操作。
 
-        tag.setPrefix(playerPrefix.getContent());
-        tag.setOrder(playerPrefix.getWeight());
+        PrefixConfig playerPrefix = getPrefix(player);
+        boolean descOrder = PluginConfig.FUNCTIONS.NAME_PREFIX.ORDER_DESC.getNotNull();
 
-        Main.debug("为玩家 " + player.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());
+        tag.setPrefix(playerPrefix.getContent(player));
+        tag.setOrder(descOrder ? 999 - playerPrefix.getWeight() : playerPrefix.getWeight());
+
+        Main.debugging("为玩家 " + 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());
+                onlinePlayerTag.setPrefix(player, playerPrefix.getContent(onlinePlayer));
+                onlinePlayerTag.setOrder(player, descOrder ? 999 - playerPrefix.getWeight() : playerPrefix.getWeight());
+                Main.debugging("为玩家 " + onlinePlayer.getName() + " 设置了 " + player.getName() + "的前缀为 #" + playerPrefix.getWeight() + " " + playerPrefix.getName());
 
             }
 
             if (loadOthers) {
-                ConfiguredPrefix onlinePlayerPrefix = UserManager.getPrefix(onlinePlayer);
-                if (onlinePlayerPrefix != null) {
-                    tag.setPrefix(onlinePlayer, onlinePlayerPrefix.getContent());
-                    tag.setOrder(onlinePlayer, onlinePlayerPrefix.getWeight());
-                    Main.debug("为玩家 " + player.getName() + " 设置了 " + player.getName() + "的前缀为 #" + onlinePlayerPrefix.getWeight() + " " + onlinePlayerPrefix.getName());
-                }
+                PrefixConfig onlinePlayerPrefix = getPrefix(onlinePlayer);
+                tag.setPrefix(onlinePlayer, onlinePlayerPrefix.getContent(player));
+                tag.setOrder(onlinePlayer, descOrder ? 999 - onlinePlayerPrefix.getWeight() : onlinePlayerPrefix.getWeight());
+                Main.debugging("为玩家 " + player.getName() + " 设置了 " + onlinePlayer.getName() + "的前缀为 #" + onlinePlayerPrefix.getWeight() + " " + onlinePlayerPrefix.getName());
             }
         }
     }
@@ -73,27 +111,46 @@ public class UserManager {
      * @param player     玩家
      * @param updateView 是否更新头顶与TabList中的前缀
      */
-    public static void checkPrefix(Player player, boolean updateView) {
-        if (checkingPlayers.contains(player.getUniqueId())) 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);
+    public void checkPrefix(Player player, boolean updateView) {
+        if (checkingPlayers.contains(player.getUniqueId())) {
+            /*
+             * 这里为了避免极短时间内的重复触发导致多次判断且结果相同误导玩家，
+             * 故没有采用同步锁，而是采用添加到一个临时Set中，对Set中玩家跳过判断。
+             */
+            return;
         }
-        checkingPlayers.remove(player.getUniqueId());
+        checkingPlayers.add(player.getUniqueId());
+        String currentPrefixData = getPrefixData(player);
+
+        if (!isPrefixUsable(player, currentPrefixData)) {
+            PrefixConfig currentPrefix = UserPrefixAPI.getPrefixManager().getPrefix(currentPrefixData);
+            PrefixConfig newPrefix = getHighestPrefix(player);
+
+            if (currentPrefix != null) {
+                //当前前缀不为空，则代表属于前缀过期的情况
+                UserPrefixExpireEvent.call(player, currentPrefix);
+
+                // 发送消息
+                PluginMessages.EXPIRED.sendTo(player, currentPrefix.getName(), newPrefix.getName());
+
+                // 播放声音
+                PluginConfig.SOUNDS.PREFIX_EXPIRED.playTo(player);
+            } else {
+                // 当前前缀为空，则代表是旧的前缀不存在了，
+                PluginMessages.REMOVED.sendTo(player, newPrefix.getName());
             }
 
-    public static void unloadNameTag(UUID uuid) {
+            UserPrefixChangeEvent.call(player, currentPrefix, newPrefix, (after) -> {
+                if (after != null) setPrefix(player, after, updateView);
+                checkingPlayers.remove(player.getUniqueId());
+            });
+
+        } else {
+            checkingPlayers.remove(player.getUniqueId());
+        }
+    }
+
+    public void unloadNameTag(UUID uuid) {
         nameTags.remove(uuid);
     }
 
@@ -104,12 +161,14 @@ public class UserManager {
      * @param player 玩家
      * @return 前缀配置
      */
-    public static ConfiguredPrefix getPrefix(Player player) {
+    @NotNull
+    public PrefixConfig getPrefix(Player player) {
         String identifier = getPrefixData(player);
         if (identifier == null || !isPrefixUsable(player, identifier)) {
             return getHighestPrefix(player);
         } else {
-            return PrefixManager.getPrefix(identifier);
+            PrefixConfig prefix = UserPrefixAPI.getPrefixManager().getPrefix(identifier);
+            return prefix == null ? UserPrefixAPI.getDefaultPrefix() : prefix;
         }
     }
 
@@ -120,8 +179,9 @@ public class UserManager {
      * @param prefix     前缀配置
      * @param updateView 是否更新头顶上、TabList的前缀
      */
-    public static void setPrefix(Player player, ConfiguredPrefix prefix, boolean updateView) {
+    public void setPrefix(Player player, PrefixConfig prefix, boolean updateView) {
         setPrefixData(player, prefix.getIdentifier());
+        prefix.executeActions(player);
         if (updateView) updatePrefixView(player, false);
     }
 
@@ -131,11 +191,12 @@ public class UserManager {
      * @param player 玩家
      * @return 可用前缀列表
      */
-    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());
+    @NotNull
+    public List<PrefixConfig> getUsablePrefixes(Player player) {
+        return UserPrefixAPI.getPrefixManager().getPrefixes().values().stream()
+                .filter(prefix -> prefix.checkPermission(player)) //过滤出玩家可用的前缀
+                .sorted(Comparator.comparingInt(PrefixConfig::getWeight)) // 以前缀排序
+                .collect(Collectors.toList()); // 返回集合
     }
 
 
@@ -146,13 +207,15 @@ public class UserManager {
      * @param player 玩家
      * @return 权限内容
      */
-    public static ConfiguredPrefix getHighestPrefix(Player player) {
-        if (PrefixConfig.Functions.AUTO_USE.get()) {
-            // 关闭了自动选择，就直接给默认的前缀，让玩家自己去设置吧
-            return PrefixManager.getDefaultPrefix();
+    @NotNull
+    public PrefixConfig getHighestPrefix(Player player) {
+        if (!PluginConfig.FUNCTIONS.AUTO_USE.getNotNull()) {
+            // 关闭了自动选择，就直接给默认的前缀，让玩家自己去设置吧~
+            return UserPrefixAPI.getDefaultPrefix();
         }
-        List<ConfiguredPrefix> prefixes = getUsablePrefixes(player);
-        return prefixes.stream().max(Comparator.comparingInt(ConfiguredPrefix::getWeight)).orElseGet(PrefixManager::getDefaultPrefix);
+        return getUsablePrefixes(player).stream()
+                .max(Comparator.comparingInt(PrefixConfig::getWeight)) // 取权重最大
+                .orElseGet(UserPrefixAPI::getDefaultPrefix); // 啥都没有？ 返回默认前缀。
     }
 
     /**
@@ -162,33 +225,26 @@ public class UserManager {
      * @param prefixIdentifier 前缀标识
      * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
      */
-    public static boolean isPrefixUsable(Player player, String prefixIdentifier) {
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    public 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);
+        PrefixConfig prefix = UserPrefixAPI.getPrefixManager().getPrefix(prefixIdentifier);
+        return prefix != null && prefix.checkPermission(player);
     }
 
-    /**
-     * 判断一个前缀对某玩家是否可用
-     *
-     * @param player           玩家
-     * @param configuredPrefix 前缀配置
-     * @return 若前缀标识不存在，则返回false；若前缀为默认前缀，或该前缀无权限，或玩家有该前缀的权限，则返回true。
-     */
-    public static boolean isPrefixUsable(Player player, ConfiguredPrefix configuredPrefix) {
-        return configuredPrefix.getPermission() == null || ServiceManager.hasPermission(ServiceManager.getUser(player), configuredPrefix.getPermission());
-    }
 
     /**
      * 得到用户当前正在使用的前缀Identifier。
      * 该方法通过LuckPerms的MetaData实现，因此可以通过指令去操作。
      *
      * @param player 玩家
-     * @return 正在使用的前缀Identifier(若不存在则返回null)
+     * @return 正在使用的前缀Identifier(若不存在则返回null, 代表未设置前缀)
      */
-    public static String getPrefixData(Player player) {
-        return ServiceManager.getAPI().getMetaData(player).getMetaValue("userprefix", String::valueOf).orElse(null);
+    @Nullable
+    public String getPrefixData(Player player) {
+        return ServiceManager.getAPI().getMetaData(player)
+                .getMetaValue(META_KEY, String::valueOf)
+                .orElse(null);
     }
 
     /**
@@ -198,13 +254,13 @@ public class UserManager {
      * @param player           玩家
      * @param prefixIdentifier 前缀的标识
      */
-    public static void setPrefixData(Player player, String prefixIdentifier) {
+    public void setPrefixData(Player player, String prefixIdentifier) {
         User user = ServiceManager.getUser(player);
-        clearPrefixData(player);
-        // LuckPerms竟然会把所有的metaKey全部转换为小写... 那我这里就直接写成小写吧~
-        MetaNode node = MetaNode.builder("userprefix", prefixIdentifier).build();
-        user.data().add(node);
-        ServiceManager.getService().getUserManager().saveUser(user);
+        clearPrefixData(player); // 清除掉旧的数据，LuckPerms不会去覆盖一个Meta，需要手动清除。
+        if (prefixIdentifier != null) {
+            user.data().add(MetaNode.builder(META_KEY, prefixIdentifier).build());
+            ServiceManager.getService().getUserManager().saveUser(user); // 保存数据
+        }
     }
 
     /**
@@ -212,11 +268,12 @@ public class UserManager {
      *
      * @param player 玩家
      */
-    public static void clearPrefixData(Player player) {
+    public void clearPrefixData(Player player) {
         User user = ServiceManager.getUser(player);
-        // LuckPerms竟然会把所有的metaKey全部转换为小写... 那我这里就直接写成小写吧~
-        user.data().clear(NodeType.META.predicate(mn -> mn.getMetaKey().equals("userprefix")));
+        user.data().clear(NodeType.META.predicate(mn -> mn.getMetaKey().equals(META_KEY)));
     }
 
-
+    private boolean isNamePrefixEnabled() {
+        return PluginConfig.FUNCTIONS.NAME_PREFIX.ENABLE.getNotNull() && !Main.getInstance().isOnFolia();
+    }
 }

src/main/java/cc/carm/plugin/userprefix/model/ConfiguredPrefix.java

@@ -1,97 +0,0 @@
-package cc.carm.plugin.userprefix.model;
-
-import cc.carm.plugin.userprefix.util.ColorParser;
-import org.bukkit.inventory.ItemStack;
-
-public class ConfiguredPrefix {
-
-    String identifier;
-
-    String name;
-    String content;
-
-    int weight;
-
-    String permission;
-
-    ItemStack itemHasPermission;
-    ItemStack itemNoPermission;
-    ItemStack itemWhenUsing;
-
-    public ConfiguredPrefix(String identifier, String name, String content, int weight, String permission, ItemStack itemHasPermission, ItemStack itemNoPermission, ItemStack itemWhenUsing) {
-        this.identifier = identifier;
-        this.name = name;
-        this.content = content;
-        this.weight = weight;
-        this.permission = permission;
-        this.itemHasPermission = itemHasPermission;
-        this.itemNoPermission = itemNoPermission;
-        this.itemWhenUsing = itemWhenUsing;
-    }
-
-    public String getIdentifier() {
-        return identifier;
-    }
-
-    public String getName() {
-        return name;
-    }
-
-    public void setName(String name) {
-        this.name = name;
-    }
-
-    public String getContent() {
-        return ColorParser.parseColor(content);
-    }
-
-    public void setContent(String content) {
-        this.content = content;
-    }
-
-    public int getWeight() {
-        return weight;
-    }
-
-    public void setWeight(int weight) {
-        this.weight = weight;
-    }
-
-    public String getPermission() {
-        return permission;
-    }
-
-    public void setPermission(String permission) {
-        this.permission = permission;
-    }
-
-    public ItemStack getItemHasPermission() {
-        return itemHasPermission;
-    }
-
-    public void setItemHasPermission(ItemStack itemHasPermission) {
-        this.itemHasPermission = itemHasPermission;
-    }
-
-    public ItemStack getItemNoPermission() {
-        return itemNoPermission;
-    }
-
-    public void setItemNoPermission(ItemStack itemNoPermission) {
-        this.itemNoPermission = itemNoPermission;
-    }
-
-    public ItemStack getItemWhenUsing() {
-        return itemWhenUsing;
-    }
-
-    public void setItemWhenUsing(ItemStack itemWhenUsing) {
-        this.itemWhenUsing = itemWhenUsing;
-    }
-
-    public boolean isVisibleNoPermission() {
-        return this.itemNoPermission != null;
-    }
-
-
-}

src/main/java/cc/carm/plugin/userprefix/ui/PrefixSelectGUI.java

@@ -1,33 +1,35 @@
 package cc.carm.plugin.userprefix.ui;
 
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
-import cc.carm.plugin.userprefix.util.MessageUtil;
-import cc.carm.plugin.userprefix.util.gui.GUIType;
-import cc.carm.plugin.userprefix.manager.PrefixManager;
-import cc.carm.plugin.userprefix.manager.UserManager;
-import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
-import cc.carm.plugin.userprefix.util.gui.AutoPagedGUI;
-import cc.carm.plugin.userprefix.util.gui.GUIItem;
+import cc.carm.lib.easyplugin.gui.GUIItem;
+import cc.carm.lib.easyplugin.gui.GUIType;
+import cc.carm.lib.easyplugin.gui.paged.AutoPagedGUI;
+import cc.carm.plugin.userprefix.UserPrefixAPI;
+import cc.carm.plugin.userprefix.conf.PluginConfig;
+import cc.carm.plugin.userprefix.conf.PluginMessages;
+import cc.carm.plugin.userprefix.conf.prefix.PrefixConfig;
+import cc.carm.plugin.userprefix.event.UserPrefixChangeEvent;
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.ClickType;
 
 import java.util.ArrayList;
 import java.util.HashSet;
 import java.util.List;
+import java.util.Optional;
 
 public class PrefixSelectGUI extends AutoPagedGUI {
 
     public static HashSet<Player> openingUsers = new HashSet<>();
 
-    Player player;
+   protected final Player player;
 
     public PrefixSelectGUI(Player player) {
-        super(GUIType.SIXBYNINE, "&f&l我的前缀 &8| 列表", 10, 43);
+        super(GUIType.SIX_BY_NINE, PluginConfig.GUI.TITLE.get(), 10, 43);
         this.player = player;
 
         setPreviousPageSlot(18);
         setNextPageSlot(26);
 
+        loadExtraIcons();
         loadItems();
     }
 
@@ -35,34 +37,53 @@ public class PrefixSelectGUI extends AutoPagedGUI {
         return player;
     }
 
+    public void loadExtraIcons() {
+        PluginConfig.GUI.ITEMS.getNotNull().getItems().values().forEach(v -> v.setupItems(player, this));
+    }
+
     public void loadItems() {
-        List<ConfiguredPrefix> prefixList = new ArrayList<>();
-        prefixList.add(PrefixManager.getDefaultPrefix());
-        prefixList.addAll(PrefixManager.getVisiblePrefix());
+        List<PrefixConfig> prefixList = new ArrayList<>();
+        prefixList.add(UserPrefixAPI.getPrefixManager().getDefaultPrefix());
+        prefixList.addAll(UserPrefixAPI.getPrefixManager().getVisiblePrefix(player)); //只需要读取看得见的
 
-        ConfiguredPrefix usingPrefix = UserManager.getPrefix(getPlayer());
+        PrefixConfig usingPrefix = UserPrefixAPI.getUserManager().getPrefix(getPlayer());
 
-        for (ConfiguredPrefix prefix : prefixList) {
+        for (PrefixConfig prefix : prefixList) {
             if (prefix.getIdentifier().equals(usingPrefix.getIdentifier())) {
-                addItem(new GUIItem(prefix.getItemWhenUsing() != null ? prefix.getItemWhenUsing() : prefix.getItemHasPermission()));
-            } else if (UserManager.isPrefixUsable(player, prefix)) {
-                addItem(new GUIItem(prefix.getItemHasPermission()) {
+                addItem(new GUIItem(Optional
+                        .ofNullable(prefix.getItemWhenUsing(player))
+                        .orElse(prefix.getItemHasPermission(player))
+                ));
+            } else if (prefix.checkPermission(player)) {
+                addItem(new GUIItem(prefix.getItemHasPermission(player)) {
+
                     @Override
-                    public void onClick(ClickType type) {
-                        if (UserManager.isPrefixUsable(player, prefix)) { //再次检查，防止打开GUI后、选择前的时间段内权限消失
+                    public void onClick(Player clicker, ClickType type) {
                         player.closeInventory();
-                            UserManager.setPrefix(player, prefix, true);
+                        //再次检查，防止打开GUI后、选择前的时间段内权限消失
+                        if (prefix.checkPermission(player)) {
 
-                            PrefixConfig.Sounds.PREFIX_CHANGE.play(player);
-                            MessageUtil.sendWithPlaceholders(player, PrefixConfig.Messages.SELECTED.get(),
-                                    new String[]{"%(name)"},
-                                    new Object[]{prefix.getName()});
+                            // 发送消息与提示
+                            PluginConfig.SOUNDS.PREFIX_CHANGE.playTo(player);
+                            PluginMessages.SELECTED.sendTo(player, prefix.getName());
 
+                            UserPrefixChangeEvent.call(player, usingPrefix, prefix, config -> {
+                                if (config == null) return;
+                                UserPrefixAPI.getUserManager().setPrefix(player, config, true);
+                            });
+
+                        } else {
+                            PluginConfig.SOUNDS.GUI_CLICK.playTo(player);
                         }
                     }
                 });
             } else {
-                addItem(new GUIItem(prefix.getItemNoPermission()));
+                addItem(new GUIItem(prefix.getItemNoPermission(player)) {
+                    @Override
+                    public void onClick(Player clicker, ClickType type) {
+                        PluginConfig.SOUNDS.GUI_CLICK.playTo(player);
+                    }
+                });
             }
         }
 
@@ -71,7 +92,7 @@ public class PrefixSelectGUI extends AutoPagedGUI {
 
     @Override
     public void onClose() {
-        openingUsers.remove(player);
+        removeOpening(player);
     }
 
     public static void removeOpening(Player player) {
@@ -82,10 +103,12 @@ public class PrefixSelectGUI extends AutoPagedGUI {
         for (Player player : new HashSet<>(openingUsers)) {
             player.closeInventory();
         }
+        openingUsers.clear();
     }
 
     public static void open(Player player) {
-        PrefixConfig.Sounds.GUI_OPEN.play(player);
+//        player.closeInventory(); // 防止冲突
+        PluginConfig.SOUNDS.GUI_OPEN.playTo(player);
         new PrefixSelectGUI(player).openGUI(player);
         openingUsers.add(player);
     }

src/main/java/cc/carm/plugin/userprefix/util/ColorParser.java

@@ -1,10 +0,0 @@
-
-package cc.carm.plugin.userprefix.util;
-
-public class ColorParser {
-
-    public static String parseColor(final String text) {
-        return text.replaceAll("&", "§").replace("§§", "&");
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/util/ItemStackFactory.java

@@ -1,141 +0,0 @@
-package cc.carm.plugin.userprefix.util;
-
-
-import org.bukkit.Material;
-import org.bukkit.enchantments.Enchantment;
-import org.bukkit.inventory.ItemFlag;
-import org.bukkit.inventory.ItemStack;
-import org.bukkit.inventory.meta.ItemMeta;
-import org.bukkit.inventory.meta.SkullMeta;
-
-import java.util.ArrayList;
-import java.util.Iterator;
-import java.util.List;
-
-public class ItemStackFactory {
-    ItemStack item;
-
-    private ItemStackFactory() {
-    }
-
-    public ItemStackFactory(ItemStack is) {
-        this.item = is.clone();
-    }
-
-    public ItemStackFactory(Material type) {
-        this(type, 1);
-    }
-
-    public ItemStackFactory(Material type, int amount) {
-        this(type, amount, (short) 0);
-    }
-
-    public ItemStackFactory(Material type, int amount, short data) {
-        this.item = new ItemStack(type, amount, data);
-    }
-
-    public ItemStackFactory(Material type, int amount, int data) {
-        this(type, amount, (short) data);
-    }
-
-    public ItemStack toItemStack() {
-        return this.item;
-    }
-
-    public ItemStackFactory setType(Material type) {
-        this.item.setType(type);
-        return this;
-    }
-
-    public ItemStackFactory setDurability(int i) {
-        this.item.setDurability((short) i);
-        return this;
-    }
-
-    public ItemStackFactory setAmount(int a) {
-        this.item.setAmount(a);
-        return this;
-    }
-
-    public ItemStackFactory setDisplayName(String name) {
-        ItemMeta im = this.item.getItemMeta();
-        im.setDisplayName(name.replace("&", "§").replace("§§", "&&"));
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory setLore(List<String> lores) {
-        ItemMeta im = this.item.getItemMeta();
-        List<String> lores_ = new ArrayList();
-        Iterator var4 = lores.iterator();
-
-        while (var4.hasNext()) {
-            String lore = (String) var4.next();
-            lores_.add(lore.replace("&", "§").replace("§§", "&&"));
-        }
-
-        im.setLore(lores_);
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory addLore(String name) {
-        ItemMeta im = this.item.getItemMeta();
-        Object lores;
-        if (im.hasLore()) {
-            lores = im.getLore();
-        } else {
-            lores = new ArrayList();
-        }
-
-        ((List) lores).add(name.replace("&", "§").replace("§§", "&&"));
-        im.setLore((List) lores);
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory addEnchant(Enchantment ench, int level, boolean ignoreLevelRestriction) {
-        ItemMeta im = this.item.getItemMeta();
-        im.addEnchant(ench, level, ignoreLevelRestriction);
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory removeEnchant(Enchantment ench) {
-        ItemMeta im = this.item.getItemMeta();
-        im.removeEnchant(ench);
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory addFlag(ItemFlag flag) {
-        ItemMeta im = this.item.getItemMeta();
-        im.addItemFlags(new ItemFlag[]{flag});
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory removeFlag(ItemFlag flag) {
-        ItemMeta im = this.item.getItemMeta();
-        im.removeItemFlags(new ItemFlag[]{flag});
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory setUnbreakable(boolean unbreakable) {
-        ItemMeta im = this.item.getItemMeta();
-        im.setUnbreakable(unbreakable);
-        this.item.setItemMeta(im);
-        return this;
-    }
-
-    public ItemStackFactory setSkullOwner(String name) {
-        if (this.item.getType() == Material.PLAYER_HEAD || this.item.getType() == Material.PLAYER_WALL_HEAD) {
-            SkullMeta im = (SkullMeta) this.item.getItemMeta();
-            im.setOwner(name);
-            this.item.setItemMeta(im);
-        }
-
-        return this;
-    }
-}

src/main/java/cc/carm/plugin/userprefix/util/MessageUtil.java

@@ -1,63 +0,0 @@
-package cc.carm.plugin.userprefix.util;
-
-import me.clip.placeholderapi.PlaceholderAPI;
-import org.bukkit.entity.Player;
-
-import java.util.*;
-
-public class MessageUtil {
-
-    public static void send(Player player, List<String> messages) {
-        for (String s : messages) {
-            player.sendMessage(ColorParser.parseColor(s));
-        }
-    }
-
-    public static void send(Player player, String... messages) {
-        send(player, Arrays.asList(messages));
-    }
-
-    public static void sendWithPlaceholders(Player player, String... messages) {
-        sendWithPlaceholders(player, Arrays.asList(messages));
-    }
-
-    public static void sendWithPlaceholders(Player player, List<String> messages) {
-        send(player, PlaceholderAPI.setPlaceholders(player, messages));
-    }
-
-    public static void sendWithPlaceholders(Player player, List<String> messages, String param, Object value) {
-        sendWithPlaceholders(player, messages, new String[]{param}, new Object[]{value});
-    }
-
-    public static void sendWithPlaceholders(Player player, List<String> messages, String[] params, Object[] values) {
-        sendWithPlaceholders(player, setCustomParams(messages, params, values));
-    }
-
-    public static List<String> setCustomParams(List<String> messages, String param, Object value) {
-        return setCustomParams(messages, new String[]{param}, new Object[]{value});
-    }
-
-    public static List<String> setCustomParams(List<String> messages, String[] params, Object[] values) {
-        if (params.length != values.length) return messages;
-        HashMap<String, Object> paramsMap = new HashMap<>();
-        for (int i = 0; i < params.length; i++) {
-            paramsMap.put(params[i], values[i]);
-        }
-        return setCustomParams(messages, paramsMap);
-    }
-
-
-    public static List<String> setCustomParams(List<String> messages, HashMap<String, Object> params) {
-        List<String> list = new ArrayList<>();
-        for (String message : messages) {
-            String afterMessage = message;
-            for (Map.Entry<String, Object> entry : params.entrySet()) {
-                afterMessage = afterMessage.replace(entry.getKey(), entry.getValue().toString());
-            }
-            list.add(afterMessage);
-        }
-        return list;
-    }
-
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/AutoPagedGUI.java

@@ -1,105 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-import cc.carm.plugin.userprefix.configuration.PrefixConfig;
-import cc.carm.plugin.userprefix.util.ItemStackFactory;
-import org.bukkit.Material;
-import org.bukkit.entity.Player;
-import org.bukkit.event.inventory.ClickType;
-import org.bukkit.inventory.ItemStack;
-
-public class AutoPagedGUI extends CommonPagedGUI {
-
-    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 a, int b) {
-        super(type, name, a, b);
-    }
-
-    public void setPreviousPageUI(ItemStack lastPageUI) {
-        this.previousPageUI = lastPageUI;
-    }
-
-    public void setNextPageUI(ItemStack nextPageUI) {
-        this.nextPageUI = nextPageUI;
-    }
-
-    public void setNoPreviousPageUI(ItemStack noPreviousPageUI) {
-        this.noPreviousPageUI = noPreviousPageUI;
-    }
-
-    public void setNoNextPageUI(ItemStack noNextPageUI) {
-        this.noNextPageUI = noNextPageUI;
-    }
-
-    public void setPreviousPageSlot(int slot) {
-        this.previousPageSlot = 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 ? new ItemStackFactory(Material.ARROW)
-                        .setDisplayName("&f上一页")
-                        .addLore("&7&o右键可前往第一页哦")
-                        .toItemStack() : previousPageUI) {
-                    @Override
-                    public void ClickAction(ClickType type, Player u) {
-                        if (type == ClickType.RIGHT) {
-                            goFirstPage();
-                        } else {
-                            goPreviousPage();
-                        }
-                        PrefixConfig.Sounds.GUI_CLICK.play(u);
-                        openGUI(u);
-//                        u.playSound(u.getLocation(), Sound.ENTITY_CHICKEN_EGG, 0.5f, 1);
-                    }
-                });
-            } else {
-//                setItem(previousPageSlot, new GUIItem(noPreviousPageUI == null ? new ItemStackFactory(Material.GRAY_STAINED_GLASS_PANE)
-//                        .setDisplayName("已经是第一页啦")
-//                        .toItemStack() : noPreviousPageUI));
-            }
-
-        if (previousPageSlot >= 0)
-            if (hasNextPage()) {
-                setItem(nextPageSlot, new GUIItem(nextPageUI == null ? new ItemStackFactory(Material.ARROW)
-                        .setDisplayName("下一页")
-                        .addLore("&7&o右键可前往最后一页哦")
-                        .toItemStack() : nextPageUI) {
-                    @Override
-                    public void ClickAction(ClickType type, Player u) {
-                        if (type == ClickType.RIGHT) {
-                            goLastPage();
-                        } else {
-                            goNextPage();
-                        }
-                        PrefixConfig.Sounds.GUI_CLICK.play(u);
-                        openGUI(u);
-//                        u.playSound(u.getLocation(), Sound.ENTITY_CHICKEN_EGG, 0.5f, 1);
-                    }
-                });
-            } else {
-//                setItem(nextPageSlot, new GUIItem(noNextPageUI == null ? new ItemStackFactory(Material.GRAY_STAINED_GLASS_PANE)
-//                        .setDisplayName("已经是最后一页啦")
-//                        .toItemStack() : noNextPageUI));
-            }
-
-        super.openGUI(user);
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/CommonPagedGUI.java

@@ -1,170 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-
-import org.bukkit.entity.Player;
-
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.List;
-
-public class CommonPagedGUI extends PagedGUI {
-
-    private int[] range;
-
-    int a;
-    int b;
-
-    int lineA;
-    int columnA;
-    int lineB;
-    int columnB;
-
-    private CommonPagedGUI(GUIType type, String name) {
-        super(type, name);
-    }
-
-    public CommonPagedGUI(GUIType type, String Name, int[] range) {
-        super(type, Name);
-        Arrays.sort(range);
-        this.range = range;
-
-    }
-
-    public CommonPagedGUI(GUIType type, String Name, int a, int b) {
-        super(type, Name);
-        this.a = a;
-        this.b = b;
-        toRange(a, b);
-    }
-	
-	/*
-	int[] matrix = new int[]{
-	0,	1,	2,	3,	4,	5,	6,	7,	8,
-	9,	10,	11,	12,	13,	14,	15,	16,	17,
-	18,	19,	20,	21,	22,	23,	24,	25,	26,
-	27,	28,	29,	30,	31,	32,	33,	34,	35,
-	36,	37,	38,	39,	40,	41,	42,	43,	44,
-	45,	46,	47,	48,	49,	50,	51,	52,	53
-	}
-	*/
-
-    private void toRange(int a, int b) {
-        if (a > b) {
-            a = a ^ b;
-            b = a ^ b;
-            a = a ^ b;
-        }
-
-        lineA = getLine(a);
-        columnA = getColumn(a);
-        lineB = getLine(b);
-        columnB = getColumn(b);
-
-        if (lineB > this.items.length / 9)
-            throw new IndexOutOfBoundsException("页面内容范围超过了GUI的大小");
-
-        int[] range = new int[(lineB - lineA + 1) * (columnB - columnA + 1)];
-
-        for (int i = 0, l = 0; i < this.items.length; i++) {
-            int li = getLine(i);
-            int ci = getColumn(i);
-            if (li >= lineA && li <= lineB && ci >= columnA && ci <= columnB) {
-                range[l] = i;
-                l++;
-            }
-        }
-
-        this.range = range;
-    }
-
-    int getLine(int i) {
-        return i / 9 + 1;
-    }
-
-    int getColumn(int i) {
-        return i % 9 + 1;
-    }
-
-    @Override
-    public boolean hasPreviousPage() {
-        return page > 1;
-    }
-
-    @Override
-    public boolean hasNextPage() {
-        return page < getLastPageNumber();
-    }
-
-
-    /**
-     * 前往第一页
-     */
-    public void goFirstPage() {
-        if (hasPreviousPage())
-            this.page = 1;
-        else
-            throw new IndexOutOfBoundsException();
-    }
-
-
-    /**
-     * 前往最后一页
-     */
-    public void goLastPage() {
-        if (hasNextPage())
-            this.page = getLastPageNumber();
-        else
-            throw new IndexOutOfBoundsException();
-    }
-
-
-    /**
-     * 得到最后一页的页码
-     *
-     * @return 最后一页的页码
-     */
-    public int getLastPageNumber() {
-        return (this.container.size() / range.length) + 1;
-    }
-
-    /**
-     * 得到第一页的页码
-     *
-     * @return 第一页页码(默认为1)
-     */
-    public int getFirstPageNumber() {
-        return 1;
-    }
-
-
-    @Override
-    public void openGUI(Player player) {
-        if (container.isEmpty()) {
-            super.openGUI(player);
-            return;
-        }
-        List<GUIItem> list = new ArrayList<>();
-        int start = (page - 1) * range.length;
-        for (int i = start; i < start + range.length; i++) {
-            if (i < container.size()) {
-                list.add(container.get(i));
-            } else {
-                break;
-            }
-        }
-        int i = 0;
-        for (int index : range) {
-            setItem(index, null);
-        }
-        for (int index : range) {
-            if (i < list.size()) {
-                setItem(index, list.get(i));
-                i++;
-            } else {
-                break;
-            }
-        }
-        super.openGUI(player);
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/GUI.java

@@ -1,378 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-import cc.carm.plugin.userprefix.Main;
-import cc.carm.plugin.userprefix.util.ColorParser;
-import org.bukkit.Bukkit;
-import org.bukkit.Material;
-import org.bukkit.entity.HumanEntity;
-import org.bukkit.entity.Player;
-import org.bukkit.event.EventHandler;
-import org.bukkit.event.HandlerList;
-import org.bukkit.event.Listener;
-import org.bukkit.event.inventory.InventoryClickEvent;
-import org.bukkit.event.inventory.InventoryCloseEvent;
-import org.bukkit.event.inventory.InventoryDragEvent;
-import org.bukkit.event.inventory.InventoryType;
-import org.bukkit.inventory.Inventory;
-import org.bukkit.inventory.ItemStack;
-
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-public class GUI {
-
-    private static final HashMap<Player, GUI> openedGUIs = new HashMap<>();
-
-    GUIType type;
-    String name;
-    public GUIItem[] items;
-    public Inventory inv;
-
-    boolean setCancelledIfClickOnTarget = true;
-    boolean setCancelledIfClickOnSelf = true;
-    boolean setCancelledIfClickOnOuter = true;
-
-    Map<String, Object> flags;
-
-    public Listener listener;
-
-    public GUI(GUIType type, String name) {
-        this.type = type;
-        this.name = ColorParser.parseColor(name);
-        switch (type) {
-            case ONEBYNINE:
-                this.items = new GUIItem[9];
-                break;
-            case TWOBYNINE:
-                this.items = new GUIItem[18];
-                break;
-            case THREEBYNINE:
-                this.items = new GUIItem[27];
-                break;
-            case FOURBYNINE:
-                this.items = new GUIItem[36];
-                break;
-            case FIVEBYNINE:
-                this.items = new GUIItem[45];
-                break;
-            default:
-            case SIXBYNINE:
-                this.items = new GUIItem[54];
-                break;
-
-            case HOPPER:
-                this.items = new GUIItem[InventoryType.HOPPER.getDefaultSize()];
-                break;
-            case BEACON:
-                this.items = new GUIItem[InventoryType.BEACON.getDefaultSize()];
-                break;
-            case DISPENSER:
-                this.items = new GUIItem[InventoryType.DISPENSER.getDefaultSize()];
-                break;
-            case DROPPER:
-                this.items = new GUIItem[InventoryType.DROPPER.getDefaultSize()];
-                break;
-            case FURNACE:
-                this.items = new GUIItem[InventoryType.FURNACE.getDefaultSize()];
-                break;
-            case WORKBENCH:
-                this.items = new GUIItem[InventoryType.WORKBENCH.getDefaultSize()];
-                break;
-            case CRAFTING:
-                this.items = new GUIItem[InventoryType.CRAFTING.getDefaultSize()];
-                break;
-            case ENCHANTING:
-                this.items = new GUIItem[InventoryType.ENCHANTING.getDefaultSize()];
-                break;
-            case BREWING:
-                this.items = new GUIItem[InventoryType.BREWING.getDefaultSize()];
-                break;
-            case PLAYER:
-                this.items = new GUIItem[InventoryType.PLAYER.getDefaultSize()];
-                break;
-            case MERCHANT:
-                this.items = new GUIItem[InventoryType.MERCHANT.getDefaultSize()];
-                break;
-            case ENDER_CHEST:
-                this.items = new GUIItem[InventoryType.ENDER_CHEST.getDefaultSize()];
-                break;
-
-            case CREATIVE:
-                this.items = new GUIItem[InventoryType.CREATIVE.getDefaultSize()];
-                break;
-            case CANCEL:
-                this.items = null;
-        }
-    }
-
-
-    public final void setItem(int index, GUIItem item) {
-        if (item == null) {
-            this.items[index] = new GUIItem(new ItemStack(Material.AIR));
-        } else {
-            this.items[index] = item;
-        }
-    }
-
-    /**
-     * 批量添加GUI Item
-     *
-     * @param item
-     * @param index
-     */
-    public void setItem(GUIItem item, int... index) {
-        for (int i : index) {
-            setItem(i, item);
-        }
-    }
-
-    public GUIItem getItem(int index) {
-        return this.items[index];
-    }
-
-    /**
-     * 更新玩家箱子的视图
-     */
-    public void updateView() {
-        if (this.inv != null) {
-            List<HumanEntity> viewers = this.inv.getViewers();
-            for (int index = 0; index < this.items.length; index++) {
-                if (items[index] == null) {
-                    inv.setItem(index, new ItemStack(Material.AIR));
-                } else {
-                    inv.setItem(index, items[index].display);
-                }
-            }
-            for (HumanEntity p : viewers) {
-                ((Player) p).updateInventory();
-            }
-        }
-    }
-
-    /**
-     * 设置是否取消点击GUI内物品的事件
-     * 如果不取消，玩家可以从GUI中拿取物品。
-     *
-     * @param b 是否取消
-     */
-    public void setCancelledIfClickOnTarget(boolean b) {
-        this.setCancelledIfClickOnTarget = b;
-    }
-
-    /**
-     * 设置是否取消点击自己背包内物品的事件
-     * 如果不取消，玩家可以从自己的背包中拿取物品。
-     *
-     * @param b 是否取消
-     */
-    public void setCancelledIfClickOnSelf(boolean b) {
-        this.setCancelledIfClickOnSelf = b;
-    }
-
-    /**
-     * 设置是否取消点击GUI外的事件
-     * 如果不取消，玩家可以把物品从GUI或背包中丢出去
-     *
-     * @param b 是否取消
-     */
-    public void setCancelledIfClickOnOuter(boolean b) {
-        this.setCancelledIfClickOnOuter = b;
-    }
-
-    public void addFlag(String flag, Object obj) {
-        if (this.flags == null) this.flags = new HashMap<>();
-        this.flags.put(flag, obj);
-    }
-
-    public Object getFlag(String flag) {
-        if (this.flags == null) return null;
-        else
-            return this.flags.get(flag);
-    }
-
-    public void setFlag(String flag, Object obj) {
-        if (this.flags == null) this.flags = new HashMap<>();
-        this.flags.replace(flag, obj);
-    }
-
-    public void removeFlag(String flag) {
-        if (this.flags == null) this.flags = new HashMap<>();
-        this.flags.remove(flag);
-    }
-
-    public void rawClickListener(InventoryClickEvent event) {
-    }
-
-    public void openGUI(Player player) {
-        Inventory inv;
-        if (this.type == GUIType.CANCEL) {
-            throw new NullPointerException("被取消或不存在的GUI");
-        }
-        switch (type) {
-            default:
-            case ONEBYNINE:
-            case TWOBYNINE:
-            case THREEBYNINE:
-            case FOURBYNINE:
-            case FIVEBYNINE:
-            case SIXBYNINE:
-                inv = Bukkit.createInventory(null, this.items.length, this.name);
-                break;
-            case HOPPER:
-                inv = Bukkit.createInventory(null, InventoryType.HOPPER, this.name);
-                break;
-            case BEACON:
-                inv = Bukkit.createInventory(null, InventoryType.BEACON, this.name);
-                break;
-            case DISPENSER:
-                inv = Bukkit.createInventory(null, InventoryType.DISPENSER, this.name);
-                break;
-            case DROPPER:
-                inv = Bukkit.createInventory(null, InventoryType.DROPPER, this.name);
-                break;
-            case FURNACE:
-                inv = Bukkit.createInventory(null, InventoryType.FURNACE, this.name);
-                break;
-            case WORKBENCH:
-                inv = Bukkit.createInventory(null, InventoryType.WORKBENCH, this.name);
-                break;
-            case CRAFTING:
-                inv = Bukkit.createInventory(null, InventoryType.CRAFTING, this.name);
-                break;
-            case ENCHANTING:
-                inv = Bukkit.createInventory(null, InventoryType.ENCHANTING, this.name);
-                break;
-            case BREWING:
-                inv = Bukkit.createInventory(null, InventoryType.BREWING, this.name);
-                break;
-            case PLAYER:
-                inv = Bukkit.createInventory(null, InventoryType.PLAYER, this.name);
-                break;
-            case CREATIVE:
-                inv = Bukkit.createInventory(null, InventoryType.CREATIVE, this.name);
-                break;
-            case MERCHANT:
-                inv = Bukkit.createInventory(null, InventoryType.MERCHANT, this.name);
-                break;
-            case ENDER_CHEST:
-                inv = Bukkit.createInventory(null, InventoryType.ENDER_CHEST, this.name);
-                break;
-        }
-
-        for (int index = 0; index < this.items.length; index++) {
-            if (items[index] == null) {
-                inv.setItem(index, new ItemStack(Material.AIR));
-            } else {
-                inv.setItem(index, items[index].display);
-            }
-        }
-        setOpenedGUI(player, this);
-        this.inv = inv;
-        player.openInventory(inv);
-
-        if (listener == null)
-            Bukkit.getPluginManager().registerEvents(listener = new Listener() {
-                @EventHandler
-                public void onInventoryClickEvent(InventoryClickEvent event) {
-                    rawClickListener(event);
-                    if (!(event.getWhoClicked() instanceof Player)) {
-                        return;
-                    }
-                    Player p = (Player) event.getWhoClicked();
-                    if (event.getSlot() != -999) {
-                        try {
-                            if (getOpenedGUI(p) == GUI.this && event.getClickedInventory() != null && event.getClickedInventory().equals(GUI.this.inv) && GUI.this.items[event.getSlot()] != null)
-                                GUI.this.items[event.getSlot()].realRawClickAction(event);
-                        } catch (ArrayIndexOutOfBoundsException e) {
-                            e.printStackTrace();
-                            System.err.print("err cause by GUI(" + GUI.this.toString() + "), name=" + name);
-                            return;
-                        }
-                    } else {
-                        if (setCancelledIfClickOnOuter) event.setCancelled(true);
-                    }
-                    if (hasOpenedGUI(p) && /*player.openedGUI.inv.equals(event.getClickedInventory())*/ getOpenedGUI(p) == GUI.this && event.getClickedInventory() != null) {
-                        if (event.getClickedInventory().equals(GUI.this.inv)) {
-                            if (setCancelledIfClickOnTarget) event.setCancelled(true);
-
-                            if (event.getSlot() != -999 && GUI.this.items[event.getSlot()] != null) {
-                                if (GUI.this.items[event.getSlot()].isActionActive()) {
-                                    GUI.this.items[event.getSlot()].onClick(event.getClick());
-                                    GUI.this.items[event.getSlot()].ClickAction(event.getClick(), player);
-                                    GUI.this.items[event.getSlot()].rawClickAction(event);
-                                    if (!GUI.this.items[event.getSlot()].actions.isEmpty()) {
-                                        for (GUIItem.GUIClickAction action : GUI.this.items[event.getSlot()].actions) {
-                                            action.run(event.getClick(), player);
-                                        }
-                                    }
-                                }
-                                if (!GUI.this.items[event.getSlot()].actionsIgnoreActive.isEmpty()) {
-                                    for (GUIItem.GUIClickAction action : GUI.this.items[event.getSlot()].actionsIgnoreActive) {
-                                        action.run(event.getClick(), player);
-                                    }
-                                }
-                            }
-                        } else if (event.getClickedInventory().equals(p.getInventory())) {
-                            if (setCancelledIfClickOnSelf) event.setCancelled(true);
-                        }
-                    }
-                }
-
-                @EventHandler
-                public void onDrag(InventoryDragEvent e) {
-                    if (e.getWhoClicked() instanceof Player) {
-                        Player p = (Player) e.getWhoClicked();
-                        if (e.getInventory().equals(inv) || e.getInventory().equals(p.getInventory())) {
-                            GUI.this.onDrag(e);
-                        }
-                    }
-                }
-
-                @EventHandler
-                public void onInventoryCloseEvent(InventoryCloseEvent event) {
-                    if (event.getPlayer() instanceof Player && event.getInventory().equals(inv)) {
-                        Player p = (Player) event.getPlayer();
-                        if (event.getInventory().equals(inv)) {
-                            HandlerList.unregisterAll(this);
-                            listener = null;
-                            onClose();
-                        }
-                    }
-                }
-            }, Main.getInstance());
-
-    }
-
-    /**
-     * 拖动GUI内物品是执行的代码
-     *
-     * @param event InventoryDragEvent
-     */
-    public void onDrag(InventoryDragEvent event) {
-    }
-
-    /**
-     * 关闭GUI时执行的代码
-     */
-    public void onClose() {
-    }
-
-
-    public static void setOpenedGUI(Player player, GUI gui) {
-        openedGUIs.put(player, gui);
-    }
-
-    public static boolean hasOpenedGUI(Player player) {
-        return openedGUIs.containsKey(player);
-    }
-
-    public static GUI getOpenedGUI(Player player) {
-        return openedGUIs.get(player);
-    }
-
-    public static void removeOpenedGUI(Player player) {
-        openedGUIs.remove(player);
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/GUIItem.java

@@ -1,96 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-import org.bukkit.entity.Player;
-import org.bukkit.event.inventory.ClickType;
-import org.bukkit.event.inventory.InventoryClickEvent;
-import org.bukkit.inventory.ItemStack;
-
-import java.util.HashSet;
-import java.util.Set;
-
-public class GUIItem {
-
-    ItemStack display;
-    boolean actionActive = true;
-
-    public Set<GUIClickAction> actions = new HashSet<>();
-    public Set<GUIClickAction> actionsIgnoreActive = new HashSet<>();
-
-    public GUIItem(ItemStack display) {
-        this.display = display;
-    }
-
-    public final ItemStack getDisplay() {
-        return this.display;
-    }
-
-    public final void setDisplay(ItemStack display) {
-        this.display = display;
-    }
-
-    public final boolean isActionActive() {
-        return this.actionActive;
-    }
-
-    public final void setActionActive(boolean b) {
-        actionActive = b;
-    }
-
-    /**
-     * 玩家点击GUI后执行的代码
-     *
-     * @param type   点击的类型
-     * @param player 点击GUI的玩家
-     */
-    @Deprecated
-    public void ClickAction(ClickType type, Player player) {
-
-    }
-
-    /**
-     * 玩家点击GUI后执行的代码
-     *
-     * @param type 点击的类型
-     */
-    public void onClick(ClickType type) {
-
-    }
-
-    public void addClickAction(GUIClickAction action) {
-        actions.add(action);
-    }
-
-    public void addActionIgnoreActive(GUIClickAction action) {
-        actionsIgnoreActive.add(action);
-    }
-
-    public void customAction() {
-
-    }
-
-    public void rawClickAction(InventoryClickEvent event) {
-
-    }
-
-    public void realRawClickAction(InventoryClickEvent event) {
-
-    }
-
-    public void customAction(Object obj) {
-
-    }
-
-    /**
-     * 玩家点击GUI后执行的代码
-     *
-     * @param player 点击GUI的玩家
-     */
-    public void customAction(Player player) {
-
-    }
-
-    public abstract static class GUIClickAction {
-        public abstract void run(ClickType type, Player player);
-    }
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/GUIType.java

@@ -1,30 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-/**
- * @author LSeng
- */
-public enum GUIType {
-
-    ONEBYNINE,
-    TWOBYNINE,
-    THREEBYNINE,
-    FOURBYNINE,
-    FIVEBYNINE,
-    SIXBYNINE,
-    DISPENSER,
-    DROPPER,
-    FURNACE,
-    WORKBENCH,
-    CRAFTING,
-    ENCHANTING,
-    BREWING,
-    PLAYER,
-    CREATIVE,
-    MERCHANT,
-    ENDER_CHEST,
-    BEACON,
-    HOPPER,
-    UNKNOWN,
-    CANCEL;
-
-}

src/main/java/cc/carm/plugin/userprefix/util/gui/PagedGUI.java

@@ -1,75 +0,0 @@
-package cc.carm.plugin.userprefix.util.gui;
-
-
-import java.util.ArrayList;
-import java.util.List;
-
-public abstract class PagedGUI extends GUI {
-
-    List<GUIItem> container = new ArrayList<>();
-    public int page = 1;
-
-    public PagedGUI(GUIType type, String name) {
-        super(type, name);
-    }
-
-    public int addItem(GUIItem i) {
-        container.add(i);
-        return container.size() - 1;
-    }
-
-    /**
-     * 从GUI中移除一个物品
-     *
-     * @param item 物品
-     */
-    public void removeItem(GUIItem item) {
-        container.remove(item);
-    }
-
-    /**
-     * 从GUI中移除一个物品
-     *
-     * @param slot 物品格子数
-     */
-    public void removeItem(int slot) {
-        container.remove(slot);
-    }
-
-    public List<GUIItem> getItemsContainer() {
-        return new ArrayList<>(container);
-    }
-
-    /**
-     * 前往上一页
-     */
-    public void goPreviousPage() {
-        if (hasPreviousPage())
-            page--;
-        else
-            throw new IndexOutOfBoundsException();
-    }
-
-
-    /**
-     * 前往下一页
-     */
-    public void goNextPage() {
-        if (hasNextPage())
-            page++;
-        else
-            throw new IndexOutOfBoundsException();
-    }
-
-
-    /**
-     * @return 是否有上一页
-     */
-    public abstract boolean hasPreviousPage();
-
-    /**
-     * @return 是否有下一页
-     */
-    public abstract boolean hasNextPage();
-
-}

src/main/resources/PLUGIN_INFO

@@ -0,0 +1,6 @@
+&f  __  __            &3___          ____
+&f / / / /__ ___ ____&3/ _ \_______ / _(_)_ __
+&f/ /_/ (_-</ -_) __&3/ ___/ __/ -_) _/ /\ \ /
+&f\____/___/\__/_/ &3/_/  /_/  \__/_//_//_\_\
+&8| &fUser&3Prefix &8(&fv${project.version}&8) &7by &bYourCraft
+&8| &7更多详情信息请参阅 &f${project.url} &7。

src/main/resources/config.yml

@@ -1,102 +0,0 @@
-version: ${project.version}
-
-debug: false
-
-functions:
-  OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
-  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
-
-messages:
-  selected:
-    - "&7您选择了 &f%(name) &7作为当前显示的前缀。"
-  expired:
-    - "&7您先前使用的前缀 &f%(oldName) &7已到期。"
-    - "&7现在已为您重新调整为 &f%(newName) &7。"
-  help:
-    - "&7输入 &b/prefix &7打开前缀选择菜单。"
-
-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✔ 您正在使用该前缀"
-
-prefixes:
-  VIP:
-    name: "&b&lPro&b" # [必须] 名字(切换的时候左下角会弹提示 用的就是这个名字)
-    content: "§b§lPro §b" # [必须] 显示在名字前面的内容
-    weight: 1 # [必须] 权重，用于GUI里面的排序(越大显示在越后面)和自动前缀显示
-    permission: "yc.pro" # [非必须] 检测的权限，如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
-    itemHasPermission: #  [必须] 当有权限的时候会显示这个Item
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a➥ 点击切换到该前缀"
-    itemUsing: # [非必需] 当有权限的时候会显示这个Item,如果没有这个配置就自动显示“itemHasPermission”的。
-      ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro §b会员前缀"
-        enchants:
-          PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
-        lore:
-          - "§7Pro会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - ""
-          - "§a✔ 您正在使用该前缀"
-    itemNoPermission: # [非必需] 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
-      ==: org.bukkit.inventory.ItemStack
-      type: INK_SACK
-      damage: 8
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lPro+ §b会员前缀 §c(未拥有)"
-        lore:
-          - "§7Pro+会员专属称号"
-          - ""
-          - "§f尊贵的Pro会员专属称号。"
-          - "§f您将获得多种特权与更好的游戏体验。"
-          - "§f您可以输入 §b/vip §f指令查看详细特权！"
-          - ""
-          - "§e✯ 加入Pro+会员以使用该前缀！"
-

src/main/resources/i18n/en_US/example-prefix.yml

@@ -0,0 +1,71 @@
+# 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
+# Supports multiple lines for content rotation.
+content: "&b&lPro &b"
+
+# Period [Unnecessary]
+# Set the rotation period of the prefix content, in milliseconds.
+# If set to -1, it will not rotate.
+# If set to 0, it will randomly select a line each time the prefix is fetched
+# If set to a value greater than 0, it will rotate the content every specified milliseconds.
+period: -1
+
+# 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"
+
+# Actions when select [Unnecessary]
+#  Please check https://github.com/CarmJos/UserPrefix/tree/master/.documentation/ACTIONS.md
+actions:
+  - "[CONSOLE] say %player_name% selected PRO ！"
+
+# Display item configuration
+# More details please see https://github.com/CryptoMorin/XSeries/wiki/XItemStack
+item:
+  # itemHasPermission  [Necessary]
+  # This Item will be displayed when player has permission
+  has-perm:
+    material: DIAMOND
+    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".
+  using:
+    material: DIAMOND
+    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.
+  no-perm:
+    material: INK_SACK
+    data: 8
+    name: "&b&lVIP &c(Buy it!)"
+    lore:
+      - ""
+      - "&e✯ Buy the VIP to use it!"

src/main/resources/i18n/es_ES/ejemplo-prefijo.yml

@@ -0,0 +1,68 @@
+
+# Nombre [Necesario]
+# Uso en mensajes.
+name: "&b&lPro&b"
+
+# Contenido [Necesario]
+# Uso en Placeholders
+# Soporta múltiples líneas para la rotación de contenido.
+content: "&b&lPro &b"
+
+# Periodo [Innecesario]
+# Establece el periodo de rotación del contenido del prefijo, en milisegundos.
+# Si se establece en -1, no rotará.
+# Si se establece en 0, seleccionará aleatoriamente una línea cada vez que se
+# obtenga el prefijo.
+# Si se establece en un valor mayor que 0, rotará el contenido cada los mil
+# segundos especificados.
+period: -1
+
+# Weight [Necesario]
+# utilizado para ordenar en la GUI y TabList
+# En GUI : el más grande se muestra en la parte posterior
+# En TabList : el más grande se muestra en la parte superior
+weight: 1
+
+# Permisos [Innecesario]
+# Si no hay permiso para la detección, todo el mundo puede utilizarlo,
+# lo que significa que no es necesario configurar "itemNoPermission"
+# (porque es imposible mostrar elementos sin permiso en absoluto)
+permission: "yc.vip"
+
+# Acciones al seleccionar [Innecesario]
+#  Por favor, compruebe https://github.com/CarmJos/UserPrefix/tree/master/.documentation/ACTIONS.md
+actions:
+  - "[CONSOLE] say %player_name% Has seleccionado La etiqueta PRO！"
+
+item:
+  # itemHasPermission  [Necesario]
+  # Este elemento se mostrará cuando el jugador tenga permiso
+  has-perm:
+    material: DIAMOND
+    name: "&b&lVIP Prefix"
+    lore:
+      - ""
+      - "&a➥ Pulsa para utilizar"
+
+  # itemUsing [Innecesario]
+  # Este elemento se mostrará cuando se seleccione el prefijo.
+  # Si no existe tal configuración, se mostrará automáticamente "itemHasPermission".
+  using:
+    material: DIAMOND
+    name: "&b&lPrefix VIP"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #Añade un encantamiento para que parezca que está seleccionado
+    lore:
+      - ""
+      - "&a✔ Seleccionado"
+
+  # itemNoPermission [Innecesario]
+  # Si el jugador no tiene el permiso,este item sera mostrado.
+  # Si este elemento no está configurado, no se mostrará en la GUI cuando el jugador no tenga permiso para usarlo.
+  no-perm:
+    material: INK_SACK
+    data: 8
+    name: "&b&lVIP &c(¡Cómpralo!)"
+    lore:
+      - ""
+      - "&e✯ Necesitas Comprar el VIP para utilizarlo!"

src/main/resources/plugin.yml

@@ -1,12 +1,25 @@
-main: cc.carm.plugin.userprefix.Main
-name: UserPrefix
+main: ${project.package}.Main
+name: ${project.name}
 version: ${project.version}
 authors:
   - Carm
+  - ${project.organization.name}
+  - SakuraGame
+website: ${project.url}
+description: ${project.description}
+api-version: 1.13
+folia-supported: true
+
 depend:
   - LuckPerms
 softdepend:
   - PlaceholderAPI
+
+permissions:
+  "UserPrefix.admin":
+    description: "用户前缀系统的管理命令权限。"
+    default: op
+
 commands:
   UserPrefix:
     aliases:
@@ -15,6 +28,5 @@ commands:
   UserPrefixAdmin:
     aliases:
       - upa
-      - prefixAdmin
     permission: "UserPrefix.admin"
     description: "用户前缀系统管理指令，可以查看前缀列表与重载配置文件。"

src/main/resources/prefixes/example-prefix.yml

@@ -0,0 +1,82 @@
+# 唯一标识 [必须]
+# 将用于记录玩家所选的前缀，以及用于数据的缓存。
+# 必须 必须 必须 保持唯一！
+identifier: "pro"
+
+# 名字 [必须]
+# 切换的时候左下角会弹提示 用的就是这个名字
+name: "&b&lPro &b会员"
+
+# 内容 [必须]
+# 显示在名字前面的内容
+# 支持多行内容以实现前缀内容的轮换
+content: "&b&lPro &b"
+
+# 轮换周期 [非必须]
+# 设置前缀内容的轮换周期，单位为毫秒。
+# 若数值为-1，则表示不轮换。
+# 若数值为0，则每次获取前缀时都会随机选择一行内容。
+# 若数值大于0，则表示每隔指定毫秒数轮换一次内容
+period: -1
+
+# 权重 [必须]
+# 用于GUI、TabList的排序和自动前缀显示
+# 在GUI中，权重越高的会显示在越后面
+# 在TabList中，显示顺序可以在 config.yml 中自定义
+weight: 1
+
+
+# 检测的权限 [非必须]
+# 如果没有就是人人都能用，也代表不用配置“itemNoPermission”了(因为压根不可能显示没权限时候的物品)
+permission: "yc.pro"
+
+# 选择这个前缀时执行的操作 [非必须]
+#  用于在玩家选择/取消选择前缀时执行相应动作，以便于实现一些特殊的功能。
+#  具体操作类型详见介绍，前缀操作不支持限定点击类型。
+#  https://github.com/CarmJos/UserPrefix/tree/master/.documentation/ACTIONS.md
+actions:
+  - "[CONSOLE] say %player_name% 选择了 Pro会员前缀 ！"
+
+description: # 描述 [非必须]
+  - "&f尊贵的Pro会员专属称号。"
+  - "&f您将获得多种特权与更好的游戏体验。"
+  - "&f您可以输入 &b/vip &f指令查看详细特权！"
+
+# 该前缀的GUI物品配置
+# 物品配置方式详见 https://github.com/CryptoMorin/XSeries/wiki/XItemStack
+item:
+
+  # 有权限时显示的物品  [必须]
+  # 当用户有权限且未选中时，会显示该物品
+  has-perm:
+    material: DIAMOND
+    name: "%(name)"
+    lore:
+      - "&7Pro会员专属称号"
+      - "#desciption#{1,1}"
+      - "&a➥ 点击切换到该前缀"
+
+  # 正在使用时显示的物品 [非必需]
+  # 当用户正在使用时会显示这个物品，不配置即自动加载“itemHasPermission”
+  using:
+    material: DIAMOND
+    name: "%(name)"
+    flags:
+      - HIDE_ENCHANTS # 隐藏附魔显示
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #加一个附魔这样看上去就像是选中了的
+    lore:
+      - "&7Pro会员专属称号"
+      - "#desciption#{1,1}"
+      - "&a✔ 您正在使用该前缀"
+
+  # 没有权限时显示的物品 [非必需]
+  # 如果没有权限就会显示这个item。如果不配置该物品，则玩家没有使用权限时不会显示在GUI里面。
+  no-perm:
+    material: INK_SACK
+    data: 8
+    name: "%(name) &c(未拥有)"
+    lore:
+      - "&7Pro 会员专属称号"
+      - "#desciption#{1,1}"
+      - "&e✯ 加入Pro会员以使用该前缀！"

src/test/java/ColorParseTest.java

@@ -0,0 +1,14 @@
+import cc.carm.lib.easyplugin.utils.ColorParser;
+import org.junit.Test;
+
+public class ColorParseTest {
+
+
+    @Test
+    public void onTest() {
+        String testString = "&f爱的人永远不爱我，为何付出得到的只有&(#aaaaaa)背叛。";
+
+        System.out.println(ColorParser.parseHexColor(testString));
+    }
+
+}