修改版本号

Bump junit from 4.13 to 4.13.1

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

.github/workflows/deploy.yml

@@ -0,0 +1,33 @@
+# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
+# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+
+name: Deploy
+
+on:
+  # 支持手动触发构建
+  workflow_dispatch:
+  release:
+    # 创建release的时候触发
+    types: [ published ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: "Set up JDK"
+        uses: actions/setup-java@v2
+        with:
+          java-version: '11'
+          distribution: 'adopt'
+          cache: maven
+          server-id: github
+          server-username: MAVEN_USERNAME
+          server-password: MAVEN_TOKEN
+      - name: "Deploy"
+        run: mvn -B deploy --file pom.xml -DskipTests
+        env:
+          MAVEN_USERNAME: ${{ github.repository_owner }}
+          MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}

.github/workflows/maven.yml

@@ -1,14 +1,12 @@
 # This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
 # For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
 
-name: Maven
+name: Build
 
 on:
   # 支持手动触发构建
   workflow_dispatch:
-  release:
-    # 创建release的时候触发
-    types: [ published ]
+  push:
 
 jobs:
   build:
@@ -24,19 +22,17 @@ jobs:
           distribution: 'adopt'
           cache: maven
           server-id: github
-          # Nexus用户名环境变量
           server-username: MAVEN_USERNAME
-          # Nexus密码环境变量
           server-password: MAVEN_TOKEN
-      - name: "Package & Deploy"
-        run: mvn -B deploy --file pom.xml
+      - name: "Package"
+        run: mvn -B package --file pom.xml
         env:
-          MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
+          MAVEN_USERNAME: ${{ github.repository_owner }}
           MAVEN_TOKEN: ${{secrets.GITHUB_TOKEN}}
-      - name: "Stage"
+      - name: "Target Stage"
         run: mkdir staging && cp target/*.jar staging
       - name: "Upload artifact"
         uses: actions/upload-artifact@v2
         with:
-          name: artifact
+          name: Artifact
           path: staging

.gitignore

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

README-en.md

@@ -114,6 +114,13 @@ version: ${project.version} # DO NOT EDIT IT
 
 debug: false #DEBUG OUT PUT
 
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+  
 GUI:
   title: "&f&lMy Prefixes List" # Title of the GUI
   items:

README.md

@@ -104,6 +104,14 @@ version: 1.0.0-SNAPSHOT # 配置文件版本，一般不会动。
 
 debug: false #debug输出，开发者用的
 
+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！
+
 functions:
   OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
   autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
@@ -293,7 +301,7 @@ itemNoPermission:
 
 感谢您成为开源项目的支持者！
 
-<img height=25% width=25% src="https://raw.githubusercontent.com/CarmJos/CarmJos/main/img/donate-code.jpg" />
+<img height=25% width=25% src="https://raw.githubusercontent.com/CarmJos/CarmJos/main/img/donate-code.jpg"  alt=""/>
 
 ## 开源协议
 
@@ -313,3 +321,13 @@ itemNoPermission:
 > 需要注意的是，分发的时候，需要明确提供源代码和二进制文件，另外，用于某些程序的某些协议有一些问题和限制，你可以看一下 @PierreJoye 写的 Practical Guide to GPL Compliance 一文。使用 GPL 协议，你必须在源代码代码中包含相应信息，以及协议本身。
 > 
 > *以上文字来自 [五种开源协议GPL,LGPL,BSD,MIT,Apache](https://www.oschina.net/question/54100_9455) 。*
+
+```text
+ _    _                   _____              __  _       
+| |  | |                 |  __ \            / _|(_)      
+| |  | | ___   ___  _ __ | |__) |_ __  ___ | |_  _ __  __
+| |  | |/ __| / _ \| '__||  ___/| '__|/ _ \|  _|| |\ \/ /
+| |__| |\__ \|  __/| |   | |    | |  |  __/| |  | | >  < 
+ \____/ |___/ \___||_|   |_|    |_|   \___||_|  |_|/_/\_\
+                                                         
+```

pom.xml

@@ -6,20 +6,20 @@
 
     <groupId>cc.carm.plugin</groupId>
     <artifactId>userprefix</artifactId>
-    <version>2.1.3</version>
+    <version>2.1.8</version>
 
-    <name>用户前缀系统</name>
+    <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>
+        <url>${project.url}/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml</url>
+        <url>${project.url}/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <developers>
@@ -27,13 +27,18 @@
             <id>CarmJos</id>
             <name>Carm Jos</name>
             <email>carm@carm.cc</email>
+            <url>https://work.carm.cc</url>
             <roles>
                 <role>Main Developer</role>
             </roles>
-            <url>https://work.carm.cc</url>
         </developer>
     </developers>
 
+    <organization>
+        <name>YourCraft你的世界</name>
+        <url>https://www.ycraft.cn/</url>
+    </organization>
+
     <licenses>
         <license>
             <name>GNU General Public License v3.0</name>
@@ -51,8 +56,8 @@
     <repositories>
 
         <repository>
-            <id>spigotmc-repo</id>
-            <url>https://hub.spigotmc.org/nexus/content/repositories/public/</url>
+            <id>spigot-repo</id>
+            <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
         </repository>
 
         <repository>
@@ -60,11 +65,6 @@
             <url>https://repo.extendedclip.com/content/repositories/placeholderapi/</url>
         </repository>
 
-        <repository>
-            <id>lss233-repo</id>
-            <url>https://lss233.littleservice.cn/repositories/minecraft</url>
-        </repository>
-
         <repository>
             <id>oss-repo</id>
             <url>https://oss.sonatype.org/content/groups/public/</url>
@@ -83,15 +83,16 @@
         <repository>
             <id>github</id>
             <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/UserPrefix</url>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
         </repository>
     </repositories>
 
     <distributionManagement>
+        <downloadUrl>${project.url}/releases</downloadUrl>
         <repository>
             <id>github</id>
             <name>GitHub Packages</name>
-            <url>https://maven.pkg.github.com/CarmJos/UserPrefix</url>
+            <url>https://maven.pkg.github.com/CarmJos/${project.name}</url>
         </repository>
     </distributionManagement>
 
@@ -100,7 +101,7 @@
 
         <dependency>
             <groupId>org.spigotmc</groupId>
-            <artifactId>spigot</artifactId>
+            <artifactId>spigot-api</artifactId>
             <version>1.17-R0.1-SNAPSHOT</version>
             <scope>provided</scope>
         </dependency>
@@ -122,7 +123,7 @@
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
-            <version>4.13</version>
+            <version>4.13.2</version>
             <scope>test</scope>
         </dependency>
 

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

@@ -15,92 +15,124 @@ import cc.carm.plugin.userprefix.util.ColorParser;
 import cc.carm.plugin.userprefix.util.MessageUtil;
 import net.luckperms.api.event.user.UserDataRecalculateEvent;
 import org.bukkit.Bukkit;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.PluginCommand;
+import org.bukkit.command.TabCompleter;
 import org.bukkit.event.Listener;
 import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 public class Main extends JavaPlugin {
 
-    private static Main instance;
+	private static Main instance;
 
-    @Override
-    public void onEnable() {
-        instance = this;
+	@Override
+	public void onEnable() {
+		instance = this;
+		showPluginName();
+		log(getName() + " " + getDescription().getVersion() + " &7开始加载...");
+		long startTime = System.currentTimeMillis();
 
-        log(getName() + " " + getDescription().getVersion() + " &7开始加载...");
-        long startTime = System.currentTimeMillis();
+		log("加载配置文件...");
+		ConfigManager.initConfig();
+		PrefixManager.init();
 
-        log("加载配置文件...");
-        ConfigManager.initConfig();
-        PrefixManager.init();
+		log("注册指令...");
+		registerCommand("UserPrefix", new UserPrefixCommand());
+		registerCommand("UserPrefixAdmin", new UserPrefixAdminCommand());
 
-        log("注册指令...");
-        Bukkit.getPluginCommand("UserPrefix").setExecutor(new UserPrefixCommand());
-        Bukkit.getPluginCommand("UserPrefixAdmin").setExecutor(new UserPrefixAdminCommand());
+		log("注册监听器...");
+		regListener(new UserListener());
+		regListener(new ChatListener());
+		ServiceManager.getService().getEventBus().subscribe(this, UserDataRecalculateEvent.class, UserNodeUpdateProcessor::process);
 
-        log("注册监听器...");
-        regListener(new UserListener());
-        regListener(new ChatListener());
-        ServiceManager.getService().getEventBus().subscribe(this, UserDataRecalculateEvent.class, UserNodeUpdateProcessor::process);
-
-        if (MessageUtil.hasPlaceholderAPI()) {
-            log("注册变量...");
-            new UserPrefixExpansion(getInstance()).register();
-        } else {
-            log("未安装 PlaceholderAPI 不进行变量注册...");
-            log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
-        }
+		if (MessageUtil.hasPlaceholderAPI()) {
+			log("注册变量...");
+			new UserPrefixExpansion(getInstance()).register();
+		} else {
+			log("未安装 PlaceholderAPI 不进行变量注册...");
+			log("若您想使用变量进行前缀的显示，请安装PlaceholderAPI！");
+		}
 
 
-        log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+		log("加载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
 
-        showAD();
+		showAD();
 
-        if (Bukkit.getOnlinePlayers().size() > 0) {
-            Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
-        }
+		if (Bukkit.getOnlinePlayers().size() > 0) {
+			Bukkit.getOnlinePlayers().forEach(UserManager::initPlayer);  // 适配热重载
+		}
 
-    }
+	}
 
-    @Override
-    public void onDisable() {
-        log(getName() + " " + getDescription().getVersion() + " 开始卸载...");
-        long startTime = System.currentTimeMillis();
+	@Override
+	public void onDisable() {
+		showPluginName();
+		log(getName() + " " + getDescription().getVersion() + " 开始卸载...");
+		long startTime = System.currentTimeMillis();
 
-        log("卸载监听器...");
-        Bukkit.getServicesManager().unregisterAll(this);
+		log("卸载监听器...");
+		Bukkit.getServicesManager().unregisterAll(this);
 
-        log("卸载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
+		log("卸载完成 ，共耗时 " + (System.currentTimeMillis() - startTime) + " ms 。");
 
-        showAD();
+		showAD();
 
-    }
+	}
 
-    /**
-     * 注册监听器
-     *
-     * @param listener 监听器
-     */
-    public static void regListener(Listener listener) {
-        Bukkit.getPluginManager().registerEvents(listener, getInstance());
-    }
+	/**
+	 * 注册监听器
+	 *
+	 * @param listener 监听器
+	 */
+	public static void regListener(Listener listener) {
+		Bukkit.getPluginManager().registerEvents(listener, getInstance());
+	}
 
-    public static void log(String message) {
-        Bukkit.getConsoleSender().sendMessage(ColorParser.parse("[" + getInstance().getName() + "] " + message));
-    }
+	public static void log(String message) {
+		Bukkit.getConsoleSender().sendMessage(ColorParser.parse("[" + getInstance().getName() + "] " + message));
+	}
 
-    public static void debug(String message) {
-        if (PrefixConfig.DEBUG.get()) {
-            log("[DEBUG] " + message);
-        }
-    }
+	public static void debug(String message) {
+		if (PrefixConfig.DEBUG.get()) {
+			log("[DEBUG] " + message);
+		}
+	}
 
-    public static JavaPlugin getInstance() {
-        return instance;
-    }
+	public static JavaPlugin getInstance() {
+		return instance;
+	}
 
-    private void showAD() {
-        log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
-        log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
-    }
+
+	public static void registerCommand(String commandName,
+									   @NotNull CommandExecutor executor) {
+		registerCommand(commandName, executor, null);
+	}
+
+	public static void registerCommand(String commandName,
+									   @NotNull CommandExecutor executor,
+									   @Nullable TabCompleter tabCompleter) {
+		PluginCommand command = Bukkit.getPluginCommand(commandName);
+		if (command == null) return;
+		command.setExecutor(executor);
+		if (tabCompleter != null) command.setTabCompleter(tabCompleter);
+	}
+
+	private void showPluginName() {
+		log("&b _    _                  &f _____              __  _      ");
+		log("&b| |  | |                 &f|  __ \\            / _|(_)    ");
+		log("&b| |  | | ___   ___  _ __ &f| |__) |_ __  ___ | |_  _ __  __");
+		log("&b| |  | |/ __| / _ \\| '__|&f|  ___/| '__|/ _ \\|  _|| |\\ \\/ /");
+		log("&b| |__| |\\__ \\|  __/| |   &f| |    | |  |  __/| |  | | >  < ");
+		log("&b \\____/ |___/ \\___||_|   &f|_|    |_|   \\___||_|  |_|/_/\\_\\");
+		log("&8  ");
+		log("&8> &f" + getDescription().getWebsite());
+	}
+
+	private void showAD() {
+		log("&7感谢您使用 &3&lUserPrefix " + getDescription().getVersion() + "&7!");
+		log("&7本插件由 &b&lYourCraft &7提供长期支持与维护。");
+	}
 
 }

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

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

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

@@ -11,6 +11,14 @@ public class PrefixConfig {
 
     public static ConfigValue<Boolean> DEBUG = new ConfigValue<>("debug", Boolean.class, false);
 
+    public static class CustomStorage {
+
+        public static ConfigValue<Boolean> ENABLE = new ConfigValue<>("custom-storage.enable", Boolean.class, false);
+
+        public static ConfigValue<String> PATH = new ConfigValue<>("custom-storage.path", String.class, "prefixes/");
+
+    }
+
     public static class Functions {
 
         public static ConfigValue<Boolean> NAME_PREFIX = new ConfigValue<>("functions.OnNamePrefix", Boolean.class, true);

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

@@ -32,8 +32,13 @@ public class ConfigValue<V> {
     }
 
     public V get() {
-        Object val = getConfiguration().get(this.configSection, this.defaultValue);
-        return this.clazz.isInstance(val) ? this.clazz.cast(val) : this.defaultValue;
+        if (getConfiguration().contains(this.configSection)) {
+            Object val = getConfiguration().get(this.configSection, this.defaultValue);
+            return this.clazz.isInstance(val) ? this.clazz.cast(val) : this.defaultValue;
+        } else {
+            // 如果没有默认值，就把配置写进去，便于配置
+            return setDefault();
+        }
     }
 
     public void set(V value) {
@@ -45,4 +50,9 @@ public class ConfigValue<V> {
         this.source.save();
     }
 
+    public V setDefault() {
+        set(this.defaultValue);
+        return this.defaultValue;
+    }
+
 }

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

@@ -1,6 +1,7 @@
 package cc.carm.plugin.userprefix.manager;
 
 import cc.carm.plugin.userprefix.Main;
+import cc.carm.plugin.userprefix.configuration.PrefixConfig;
 import cc.carm.plugin.userprefix.model.ConfiguredPrefix;
 import cc.carm.plugin.userprefix.util.ItemStackFactory;
 import org.bukkit.Material;
@@ -37,17 +38,19 @@ public class PrefixManager {
 
     public static void loadConfiguredPrefixes() {
 
-        File prefixDataFolder = new File(Main.getInstance().getDataFolder() + File.separator + FOLDER_NAME);
+        File prefixDataFolder = getStorageFolder();
         if (!prefixDataFolder.isDirectory() || !prefixDataFolder.exists()) {
             prefixDataFolder.mkdir();
         }
 
         String[] filesList = prefixDataFolder.list();
         if (filesList == null || filesList.length < 1) {
-            Main.log("配置文件中暂无任何前缀配置，请检查。");
+            Main.log("配置文件夹中暂无任何前缀配置问，请检查。");
             Main.log("There's no configured prefix.");
+            Main.log("Path: " + prefixDataFolder.getAbsolutePath());
             return;
         }
+
         List<File> files = Arrays.stream(filesList)
                 .map(s -> new File(prefixDataFolder, s))
                 .filter(File::isFile)
@@ -74,7 +77,8 @@ public class PrefixManager {
 
     public static void loadDefaultPrefix() {
         PrefixManager.defaultPrefix = null;
-        ConfigurationSection defaultPrefixSection = ConfigManager.getPluginConfig().getConfig().getConfigurationSection("defaultPrefix");
+        ConfigurationSection defaultPrefixSection = ConfigManager.getPluginConfig()
+                .getConfig().getConfigurationSection("defaultPrefix");
         if (defaultPrefixSection != null) {
             try {
                 String name = defaultPrefixSection.getString("name", "默认前缀");
@@ -150,5 +154,13 @@ public class PrefixManager {
         }
     }
 
+    private static File getStorageFolder() {
+        if (PrefixConfig.CustomStorage.ENABLE.get()) {
+            return new File(PrefixConfig.CustomStorage.PATH.get());
+        } else {
+            return new File(Main.getInstance().getDataFolder() + File.separator + FOLDER_NAME);
+        }
+    }
+
 
 }

src/main/resources/config.yml

@@ -1,7 +1,15 @@
-version: ${project.version}
+version: ${project.version} #配置文件版本，若与插件版本不同请记得检查配置文件内容
 
 debug: false
 
+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！
+
 functions:
   OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
   autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个

src/main/resources/en_US/config.yml

@@ -2,6 +2,13 @@ version: ${project.version} # DO NOT EDIT IT
 
 debug: false #DEBUG OUT PUT
 
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+
 GUI:
   title: "&f&lMy Prefixes List" # Title of the GUI
   items:

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

@@ -29,43 +29,40 @@ itemHasPermission:
   ==: org.bukkit.inventory.ItemStack
   type: DIAMOND
   meta:
-    ==: org.bukkit.inventory.ItemStack
-      type: DIAMOND
-      meta:
-        ==: ItemMeta
-        meta-type: UNSPECIFIC
-        display-name: "§b§lVIP Prefix"
-        lore:
-          - ""
-          - "§a➥ Click to  use"
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP Prefix"
+    lore:
+      - ""
+      - "§a➥ Click to  use"
 
 # itemUsing [Unnecessary]
 # This Item will be displayed when the prefix is selected.
 # If there is no such configuration, it will automatically display "itemHasPermission".
 itemUsing:
   ==: org.bukkit.inventory.ItemStack
-    type: DIAMOND
-    meta:
-      ==: ItemMeta
-      meta-type: UNSPECIFIC
-      display-name: "§b§lVIP Prefix"
-      enchants:
-        PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
-      lore:
-        - ""
-        - "§a✔ Selected"
+  type: DIAMOND
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP Prefix"
+    enchants:
+      PROTECTION_ENVIRONMENTAL: 1 #Add an enchantment so it looks like it’s selected
+    lore:
+      - ""
+      - "§a✔ Selected"
 
 # itemNoPermission [Unnecessary]
 # If player doesn't have the permission,this item will be displayed.
 # If this item is not configured, it will not be displayed in the GUI when the player does not have permission to use it.
 itemNoPermission:
   ==: org.bukkit.inventory.ItemStack
-    type: INK_SACK
-    damage: 8
-    meta:
-      ==: ItemMeta
-      meta-type: UNSPECIFIC
-      display-name: "§b§lVIP §c(Buy it!)"
-      lore:
-        - ""
-        - "§e✯ Buy the VIP to use it!"
+  type: INK_SACK
+  damage: 8
+  meta:
+    ==: ItemMeta
+    meta-type: UNSPECIFIC
+    display-name: "§b§lVIP §c(Buy it!)"
+    lore:
+      - ""
+      - "§e✯ Buy the VIP to use it!"

src/main/resources/plugin.yml

@@ -1,11 +1,13 @@
 main: cc.carm.plugin.userprefix.Main
-name: UserPrefix
+name: ${project.name}
 version: ${project.version}
 authors:
   - Carm
-  - YourCraft
+  - ${project.organization.name}
   - SakuraGame
-website: "https://github.com/CarmJos/UserPrefix"
+website: ${project.url}
+description: ${project.description}
+
 depend:
   - LuckPerms
 softdepend:

topic/mcbbs.source

@@ -67,13 +67,89 @@
 [hr]
 [size=4][b]基础配置文件 [/b][/size][color=#24292f][font=Tahoma][size=4](config.yml)[/size][/font][/color]
 [spoiler]
-[code] version: 1.0.0-SNAPSHOT # 配置文件版本，一般不会动。
+[code]
+version: ${project.version} #配置文件版本，若与插件版本不同请记得检查配置文件内容
 
-debug: false #debug输出，开发者用的
+debug: false
+
+custom-storage:
+  # 自定义存储位置
+  # 默认存储位置为 “插件文件夹”/prefixes
+  # 可以规定到远程文件夹中去寻找前缀相关的设定
+  # 支持绝对文件路径，如 "/etc/minecraft/configurations/prefixes/"
+  enable: false # 是否启用
+  path: "prefixes/" # 一定要指向一个文件夹！
 
 functions:
   OnNamePrefix: true # 是否给头顶上添加前缀，该方法用到了头顶的那个计分板，如有冲突请关掉哦~
-  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个[/code][/spoiler]
+  autoUsePrefix: true # 自动前缀显示 当玩家没有自己选择一个前缀的时候，会自动使用所拥有的的前缀中权重最高的那一个
+  chat:
+    # 聊天功能
+    # - 我不推荐使用本插件的聊天功能，而是建议使用其他的聊天插件。
+    # - 本插件仅仅提供了**最基本**的格式变量支持，不包含其他任何功能。
+    # - 注意聊天格式需要遵守Bukkit原格式，即不得缺失 “%1$s” 和 “%2$s” 。
+    # - 本插件的聊天功能不影响其他插件对聊天事件的操作。
+    enable: false # 是否启用
+    format: "<%UserPrefix_prefix%%1$s> %2$s" #聊天的格式，注意 “%1$s” 和 “%2$s” 不可缺少，分别代表 玩家名 与 消息内容 。
+
+GUI:
+  title: "&f&l我的前缀 &8| 列表"
+  items:
+    # 【必须】 GUI中可能存在的其他物品
+    next-page: # 下一页物品，如果没有下一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f下一页"
+        lore:
+          - ""
+          - "§f右键可前往最后一页哦~"
+    previous-page: # 上一页物品，如果没有上一页则不显示
+      ==: org.bukkit.inventory.ItemStack
+      type: ARROW
+      meta:
+        ==: ItemMeta
+        meta-type: UNSPECIFIC
+        display-name: "§f上一页"
+        lore:
+          - ""
+          - "§f右键可前往第一页哦~"
+
+Sounds: #相关的声音，注释掉则不播放声音 格式为 【声音名:音量:音调】 或 【声音名:音量】 或 【声音名】
+  openGUI: "BLOCK_NOTE_BLOCK_PLING:1:1"
+  guiClick: "UI_BUTTON_CLICK"
+  prefixChange: "ENTITY_VILLAGER_YES"
+  prefixExpired: "ENTITY_VILLAGER_NO"
+
+# 默认前缀的配置
+# 默认前缀的权重为0哦
+defaultPrefix:
+  name: "默认前缀"
+  content: "&b"
+  itemNotUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§f默认玩家前缀 §f(点击切换)"
+      lore:
+        - ""
+        - "§a➥ 点击切换到该前缀"
+  itemUsing:
+    ==: org.bukkit.inventory.ItemStack
+    type: NAME_TAG
+    meta:
+      ==: ItemMeta
+      meta-type: UNSPECIFIC
+      display-name: "§f默认玩家前缀"
+      lore:
+        - ""
+        - "§a✔ 您正在使用该前缀"
+[/code]
+[/spoiler]
 
 [b][size=4][backcolor=transparent]消息配置文件[/backcolor][/size] [/b][size=4](messages.yml)[/size]
 [spoiler][code]selected:
@@ -96,7 +172,7 @@ list-value:
   - "&8- &7显示名 &r%(name) &7权限 &r%(permission)"
   - "&8- &7内容示例&r %(content) %(sender_name)"[/code][/spoiler]
 
-[size=4][backcolor=transparent][b]前缀配置文件[/b][/backcolor] (prefixes/*.yml)[/size]
+[size=4][backcolor=transparent][b]前缀配置文件[/b][/backcolor] (prefixes/*.yml) [自2.1.7可自定义目录][/size]
 [align=left][font=-apple-system, BlinkMacSystemFont, &quot;][size=3][color=#000000]所有前缀均为单独的配置文件，存放于 [u]插件配置目录/prefixes[/u] 下，便于管理。[/color][/size][/font][/align][align=left][font=-apple-system, BlinkMacSystemFont, &quot;][size=3][color=#000000]文件名理论上可以随便取，推荐使用英文，部分符号可能会影响正常读取，请避免使用。[/color][/size][/font][/align][align=left][spoiler][/align][code]# 唯一标识 [必须]
 # 将用于记录玩家所选的前缀，以及用于数据的缓存。
 # 必须 必须 必须 保持唯一！
@@ -177,11 +253,14 @@ itemNoPermission:
 
 [size=5][b]下载地址[/b][/size]
 [hr]
-[size=3][b]最新版本 2.1.0 [/b][/size][attach]1909962[/attach][quote][b][size=3]更新内容[/size][/b]
+[size=3][b]最新版本 [/b][/size][size=3][b]2.1.7 [/b][/size][attach]1919669[/attach][quote][b][size=3]更新内容[/size][/b]
+1. 提供自定义配置文件存储位置的功能，便于多子服共享配置。(custome-storage)
+2. 添加控制台打开玩家菜单时的反馈(来自 @Yuri南城 )。
+3. 支持由控制台为其他玩家打开GUI。
+4. 若出现新配置文件条目，将自动写入默认值，便于配置。[/quote][spoiler][size=3][b]2.1.2 [/b][/size][attach]1912028[/attach][quote][b][size=3]更新内容[/size][/b]
+1. 修复不开启插件自带的头顶前缀功能时出现的报错。[/quote]
+[size=3][b]2.1.0 [/b][/size][attach]1909962[/attach][quote][b][size=3]更新内容[/size][/b]
 1. 添加聊天相关设定，支持聊天前缀。(但不推荐使用哦~)[/quote]
-
-[spoiler]
-
 [size=3][b] 2.0.0 [/b][/size][attach]1905700[/attach]
 [quote][b][size=3]更新内容[/size][/b]
 1. 修复低版本可能无法读取物品的bug。
@@ -233,8 +312,3 @@ itemNoPermission:
 
 
 
-
-
-
-
-

topic/spigot.source

@@ -90,10 +90,17 @@ After installed the [URL='https://github.com/PlaceholderAPI/PlaceholderAPI']Plac
 Notice: The default configuration is based on Chinese. You can find the English Version [URL='https://github.com/CarmJos/UserPrefix/blob/master/src/main/resources/en_US/config.yml']here[/URL].
 
 [code=YAML]
-version: ${project.version} # DO NOT EDIT IT
+version: ${project.version}
 
 debug: false #DEBUG OUT PUT
 
+custom-storage:
+  # Custom storage location
+  # default location is "./prefixes"
+  # Support absolute file path , such as "/etc/minecraft/configurations/prefixes/"
+  enable: false
+  path: "prefixes/" # Must be a folder!
+
 GUI:
   title: "&f&lMy Prefixes List" # Title of the GUI
   items: