feat(command): 允许子指令不处理报错，统一交由父CommandHandler处理。

close #6

.github/ISSUE_TEMPLATE/bugs_report.md

@@ -14,6 +14,7 @@ assignees: ''
 ### **问题来源**
 
 描述一下通过哪些操作才发现的问题，如：
+
 1. 使用了 ...
 2. 输入了 ...
 3. 出现了报错 ...
@@ -32,7 +33,6 @@ assignees: ''
 - Java版本: `JDK11` / `OPENJDK8` / `JRE8` / `...`
 - 服务端版本: 请在后台输入 `version` 并复制相关输出。
 
-
 ### **其他补充**
 
 如有其他补充，可以在这里描述。

.github/ISSUE_TEMPLATE/feature_issues.md

@@ -8,13 +8,17 @@ assignees: ''
 ---
 
 ### **功能简述**
+
 简单的描述一下你想要的功能
 
 ### **需求来源**
+
 简单的描述一下为什么需要这个功能。
 
 ### **功能参考**(可选)
+
 如果有相关功能的参考，如文本、截图，请提供给我们。
 
 ### **附加内容**
+
 如果有什么小细节需要重点注意，请在这里告诉我们。

README.md

@@ -27,7 +27,7 @@
 
 ## 内容
 
-项目初创不久，加 * 的仍在开发更新中...
+项目初创不久，加 * 的仍在开发更新中...欢迎各路大佬帮助提供本项目的开发文档~
 
 ### 集合部分 (`/collection`)
 
@@ -37,11 +37,25 @@
 ### 主要部分 (`/base`)
 
 - Main [`easyplugin-main`](base/main)
+  -  主要接口模块，提供了方便的插件入口类与相关工具类。
 - Command [`easyplugin-command`](base/command)
-- ~~Messages*~~ (已独立项目到 [**EasyMessages**](https://github.com/CarmJos/EasyMessages))
-- ~~Configuration~~ (已独立项目到 [**MineConfiguration**](https://github.com/CarmJos/MineConfiguration))
-- ~~Database~~ (已独立项目到 [**EasySQL**](https://github.com/CarmJos/EasySQL))
+  - 指令接口模块，便于快速进行子指令的实现，并提供单独的TabComplete方法。
+  - 随本项目提供了 `SimpleCompleter` 类，用于快速创建补全的内容列表。
 - GUI [`easyplugin-gui`](base/main)
+  - 简单便捷的箱子GUI接口，可以快速实现GUI中不同图标的点击功能。
+  - 随本项目提供了 `AutoPagedGUI` 等翻页GUI抽象类。
+- Storage [`easyplugin-storage`](base/storage)
+  - 抽象存储管理器，便于实现不同的存储类型。 
+  - 随本项目提供了 `FileBasedStorage`、`FolderBasedStorage` 等常用存储抽象方法。
+
+> 以下项目均已独立出单独项目，仅仅是按照包名规则打包到EasyPlugin的子项目中。
+> 
+> 如需使用，**强烈建议自行引用对应的项目**，以支持完整的Javadoc并获取源码内容！
+
+- _Listener_ [`easyplugin-listener`](base/listener) (打包自 [**EasyListener**](https://github.com/CarmJos/EasyListener))
+- _Configuration_ [`easyplugin-conf`](base/conf) (打包自 [**MineConfiguration**](https://github.com/CarmJos/MineConfiguration))
+- _Database_ [`easyplugin-database`](base/database)  (打包自 [**EasySQL**](https://github.com/CarmJos/EasySQL))
+- _Messages*_ [`easyplugin-message`](base/message) (打包自 [**EasyMessages**](https://github.com/CarmJos/EasyMessages))
 
 ### 附属部分 (`/extension`)
 

base/command/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>

base/command/src/main/java/cc/carm/lib/easyplugin/command/CommandHandler.java

@@ -1,4 +1,3 @@
-
 package cc.carm.lib.easyplugin.command;
 
 import org.bukkit.command.Command;
@@ -12,13 +11,14 @@ import org.jetbrains.annotations.Nullable;
 import java.util.*;
 import java.util.stream.Collectors;
 
+@SuppressWarnings("UnusedReturnValue")
 public abstract class CommandHandler implements TabExecutor, NamedExecutor {
 
     protected final @NotNull JavaPlugin plugin;
     protected final @NotNull String cmd;
     protected final @NotNull List<String> aliases;
 
-    protected final @NotNull Map<String, SubCommand> registeredCommands = new HashMap<>();
+    protected final @NotNull Map<String, SubCommand<?>> registeredCommands = new HashMap<>();
     protected final @NotNull Map<String, CommandHandler> registeredHandlers = new HashMap<>();
 
     protected final @NotNull Map<String, String> aliasesMap = new HashMap<>();
@@ -37,11 +37,18 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
         this.aliases = Arrays.asList(aliases);
     }
 
-    public abstract void noArgs(CommandSender sender);
+    public abstract Void noArgs(CommandSender sender);
 
-    public abstract void unknownCommand(CommandSender sender, String[] args);
+    public Void unknownCommand(CommandSender sender, String[] args) {
+        return noArgs(sender);
+    }
 
-    public abstract void noPermission(CommandSender sender);
+    public abstract Void noPermission(CommandSender sender);
+
+    public Void onException(CommandSender sender, SubCommand<?> cmd, Exception ex) {
+        sender.sendMessage("Error occurred when executing " + cmd.getName() + ": " + ex.getLocalizedMessage());
+        return null;
+    }
 
     @Override
     public @NotNull List<String> getAliases() {
@@ -53,7 +60,7 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
         return this.cmd;
     }
 
-    public void registerSubCommand(SubCommand command) {
+    public void registerSubCommand(SubCommand<?> command) {
         String name = command.getName().toLowerCase();
         this.registeredCommands.put(name, command);
         command.getAliases().forEach(alias -> this.aliasesMap.put(alias.toLowerCase(), name));
@@ -81,16 +88,18 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
                 }
             }
 
-            SubCommand subCommand = getSubCommand(input);
-            if (subCommand == null) {
+            SubCommand<?> sub = getSubCommand(input);
+            if (sub == null) {
                 this.unknownCommand(sender, args);
-            } else if (!subCommand.hasPermission(sender)) {
+            } else if (!sub.hasPermission(sender)) {
                 this.noPermission(sender);
             } else {
                 try {
-                    subCommand.execute(this.plugin, sender, this.shortenArgs(args));
-                } catch (ArrayIndexOutOfBoundsException var9) {
+                    sub.execute(this.plugin, sender, this.shortenArgs(args));
+                } catch (ArrayIndexOutOfBoundsException ex) {
                     this.unknownCommand(sender, args);
+                } catch (Exception ex) {
+                    this.onException(sender, sub, ex);
                 }
             }
 
@@ -116,9 +125,9 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
                 return handler.onTabComplete(sender, command, alias, this.shortenArgs(args));
             }
 
-            SubCommand subCommand = getSubCommand(input);
-            if (subCommand != null && subCommand.hasPermission(sender)) {
-                return subCommand.tabComplete(this.plugin, sender, this.shortenArgs(args));
+            SubCommand<?> sub = getSubCommand(input);
+            if (sub != null && sub.hasPermission(sender)) {
+                return sub.tabComplete(this.plugin, sender, this.shortenArgs(args));
             }
 
             return Collections.emptyList();
@@ -143,8 +152,8 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
         else return this.registeredHandlers.get(nameFromAlias);
     }
 
-    protected @Nullable SubCommand getSubCommand(@NotNull String name) {
-        SubCommand fromName = this.registeredCommands.get(name);
+    protected @Nullable SubCommand<?> getSubCommand(@NotNull String name) {
+        SubCommand<?> fromName = this.registeredCommands.get(name);
         if (fromName != null) return fromName;
 
         String nameFromAlias = this.aliasesMap.get(name);

base/command/src/main/java/cc/carm/lib/easyplugin/command/NamedExecutor.java

@@ -1,7 +1,6 @@
 package cc.carm.lib.easyplugin.command;
 
 import org.bukkit.command.CommandSender;
-import org.bukkit.permissions.Permissible;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -16,7 +15,7 @@ public interface NamedExecutor {
 
     List<String> getAliases();
 
-    default boolean hasPermission(Permissible permissible) {
+    default boolean hasPermission(CommandSender sender) {
         return true;
     }
 

base/command/src/main/java/cc/carm/lib/easyplugin/command/SimpleCompleter.java

@@ -1,15 +1,18 @@
 package cc.carm.lib.easyplugin.command;
 
+import com.google.common.collect.ImmutableList;
 import org.bukkit.Bukkit;
 import org.bukkit.Material;
 import org.bukkit.OfflinePlayer;
 import org.bukkit.World;
+import org.bukkit.enchantments.Enchantment;
 import org.bukkit.entity.HumanEntity;
 import org.bukkit.potion.PotionEffectType;
 import org.bukkit.util.StringUtil;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.Arrays;
+import java.util.Collection;
 import java.util.List;
 import java.util.Objects;
 import java.util.stream.Collectors;
@@ -17,14 +20,22 @@ import java.util.stream.Stream;
 
 public class SimpleCompleter {
 
-    public static @NotNull List<String> objects(@NotNull String input, List<?> objects) {
+    public static @NotNull List<String> none() {
+        return ImmutableList.of();
+    }
+
+    public static @NotNull List<String> objects(@NotNull String input, Collection<?> objects) {
         return objects(input, objects.size(), objects);
     }
 
-    public static @NotNull List<String> objects(@NotNull String input, int limit, List<?> objects) {
+    public static @NotNull List<String> objects(@NotNull String input, int limit, Collection<?> objects) {
         return objects(input, limit, objects.stream());
     }
 
+    public static @NotNull List<String> objects(@NotNull String input, Stream<?> stream) {
+        return objects(input, 20, stream);
+    }
+
     public static @NotNull List<String> objects(@NotNull String input, int limit, Stream<?> stream) {
         return stream.filter(Objects::nonNull).map(Object::toString)
                 .filter(s -> StringUtil.startsWithIgnoreCase(s, input))
@@ -39,11 +50,11 @@ public class SimpleCompleter {
         return text(input, limit, Arrays.asList(texts));
     }
 
-    public static @NotNull List<String> text(@NotNull String input, List<String> texts) {
+    public static @NotNull List<String> text(@NotNull String input, Collection<String> texts) {
         return text(input, texts.size(), texts);
     }
 
-    public static @NotNull List<String> text(@NotNull String input, int limit, List<String> texts) {
+    public static @NotNull List<String> text(@NotNull String input, int limit, Collection<String> texts) {
         return objects(input, limit, texts);
     }
 
@@ -87,4 +98,13 @@ public class SimpleCompleter {
         return objects(input, limit, Arrays.stream(PotionEffectType.values()).map(PotionEffectType::getName));
     }
 
+    public static @NotNull List<String> enchantments(@NotNull String input) {
+        return effects(input, 10);
+    }
+
+    @SuppressWarnings("deprecation")
+    public static @NotNull List<String> enchantments(@NotNull String input, int limit) {
+        return objects(input, limit, Arrays.stream(Enchantment.values()).map(Enchantment::getName));
+    }
+
 }

base/command/src/main/java/cc/carm/lib/easyplugin/command/SubCommand.java

@@ -2,26 +2,30 @@ package cc.carm.lib.easyplugin.command;
 
 import org.bukkit.command.CommandSender;
 import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Unmodifiable;
 
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 
 @SuppressWarnings("UnusedReturnValue")
-public abstract class SubCommand implements NamedExecutor {
+public abstract class SubCommand<C extends CommandHandler> implements NamedExecutor {
+
+    private final @NotNull C parent;
 
     private final String name;
     private final List<String> aliases;
 
-    public SubCommand(String name) {
-        this(name, new String[0]);
-    }
-
-    public SubCommand(String name, String... aliases) {
+    public SubCommand(@NotNull C parent, String name, String... aliases) {
+        this.parent = parent;
         this.name = name;
         this.aliases = Arrays.asList(aliases);
     }
 
+    public @NotNull C getParent() {
+        return parent;
+    }
 
     @Override
     public String getName() {
@@ -29,15 +33,15 @@ public abstract class SubCommand implements NamedExecutor {
     }
 
     @Override
+    @Unmodifiable
     public List<String> getAliases() {
         return this.aliases;
     }
 
-    public abstract Void execute(JavaPlugin plugin, CommandSender sender, String[] args);
+    public abstract Void execute(JavaPlugin plugin, CommandSender sender, String[] args) throws Exception;
 
     public List<String> tabComplete(JavaPlugin plugin, CommandSender sender, String[] args) {
         return Collections.emptyList();
     }
 
-
 }

base/conf/pom.xml

@@ -0,0 +1,81 @@
+<?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">
+    <parent>
+        <artifactId>easyplugin-parent</artifactId>
+        <groupId>cc.carm.lib</groupId>
+        <version>1.4.14</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <properties>
+        <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>
+    </properties>
+    <artifactId>easyplugin-conf</artifactId>
+    <packaging>jar</packaging>
+
+    <name>EasyPlugin-Configuration</name>
+    <description>轻松插件配置文件接口模块，基于 MineConfiguration 项目。</description>
+    <url>https://github.com/CarmJos/EasyPlugin</url>
+
+    <dependencies>
+        <dependency>
+            <!-- https://github.com/CarmJos/MineConfiguration -->
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>mineconfiguration-bukkit</artifactId>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+                <configuration>
+                    <relocations>
+                        <relocation>
+                            <pattern>cc.carm.lib.configuration.core</pattern>
+                            <shadedPattern>cc.carm.lib.easyplugin.conf</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>cc.carm.lib.mineconfiguration.common</pattern>
+                            <shadedPattern>cc.carm.lib.easyplugin.conf</shadedPattern>
+                        </relocation>
+                        <relocation>
+                            <pattern>cc.carm.lib.mineconfiguration.bukkit</pattern>
+                            <shadedPattern>cc.carm.lib.easyplugin.conf</shadedPattern>
+                        </relocation>
+                    </relocations>
+                    <filters>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/MANIFEST.MF</exclude>
+                                <exclude>META-INF/*.txt</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

base/database/pom.xml

@@ -0,0 +1,73 @@
+<?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">
+    <parent>
+        <artifactId>easyplugin-parent</artifactId>
+        <groupId>cc.carm.lib</groupId>
+        <version>1.4.14</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <properties>
+        <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>
+    </properties>
+    <artifactId>easyplugin-database</artifactId>
+    <packaging>jar</packaging>
+
+    <name>EasyPlugin-Database</name>
+    <description>轻松插件数据库接口模块，基于 EasySQL 项目。</description>
+    <url>https://github.com/CarmJos/EasyPlugin</url>
+
+    <dependencies>
+        <dependency>
+            <!-- https://github.com/CarmJos/EasySQL -->
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easysql-beecp</artifactId>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+                <configuration>
+                    <relocations>
+                        <relocation>
+                            <pattern>cc.carm.lib.easysql</pattern>
+                            <shadedPattern>cc.carm.lib.easyplugin.database</shadedPattern>
+                        </relocation>
+                    </relocations>
+                    <filters>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/MANIFEST.MF</exclude>
+                                <exclude>META-INF/*.txt</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

base/gui/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/GUI.java

@@ -13,10 +13,7 @@ import org.bukkit.plugin.java.JavaPlugin;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.UUID;
+import java.util.*;
 import java.util.stream.IntStream;
 
 public class GUI {
@@ -56,9 +53,9 @@ public class GUI {
      */
     boolean cancelOnOuter = true;
 
-	Map<String, Object> flags;
+    protected final Map<String, Object> flags = new LinkedHashMap<>();
 
-	GUIListener listener;
+    protected GUIListener listener;
 
     public GUI(GUIType type, String name) {
         this.type = type;
@@ -131,24 +128,15 @@ public class GUI {
         this.cancelOnOuter = 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);
+        this.flags.put(flag, obj);
     }
 
     public void removeFlag(String flag) {
-		if (this.flags == null) this.flags = new HashMap<>();
         this.flags.remove(flag);
     }
 
@@ -156,7 +144,9 @@ public class GUI {
     }
 
     public void openGUI(Player player) {
-		if (this.type == GUIType.CANCEL) { throw new IllegalStateException("被取消或不存在的GUI"); }
+        if (this.type == GUIType.CANCEL) {
+            throw new IllegalStateException("被取消或不存在的GUI");
+        }
 
         Inventory inv = Bukkit.createInventory(null, this.type.getSize(), this.name);
         IntStream.range(0, inv.getSize()).forEach(index -> inv.setItem(index, new ItemStack(Material.AIR)));
@@ -191,6 +181,13 @@ public class GUI {
     public void onClose() {
     }
 
+    public GUIType getGUIType() {
+        return type;
+    }
+
+    public String getGUIName() {
+        return name;
+    }
 
     public static void setOpenedGUI(Player player, GUI gui) {
         getOpenedGUIs().put(player.getUniqueId(), gui);

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/GUIItem.java

@@ -37,12 +37,24 @@ public class GUIItem {
     }
 
     /**
-	 * 玩家点击GUI后执行的代码
+     * 玩家点击该物品后执行的代码
+     * 可以使用 {@link #onClick(Player, ClickType)} 操作点击者
      *
      * @param type 点击的类型
      */
+    @Deprecated
+    @SuppressWarnings("DeprecatedIsStillUsed")
     public void onClick(ClickType type) {
+    }
 
+    /**
+     * 玩家点击GUI后执行的代码
+     *
+     * @param clicker 点击的玩家
+     * @param type    点击的类型
+     */
+    public void onClick(Player clicker, ClickType type) {
+        this.onClick(type); // Deprecated method support
     }
 
     public void addClickAction(GUIClickAction action) {
@@ -58,7 +70,7 @@ public class GUIItem {
     }
 
     /**
-	 * 玩家点击GUI后执行的代码
+     * 自定义点击事件代码 (须自行触发)
      *
      * @param player 点击GUI的玩家
      */

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/GUIListener.java

@@ -45,7 +45,7 @@ public class GUIListener implements Listener {
                 GUIItem clickedItem = getCurrentGUI().getItem(event.getSlot());
                 if (clickedItem != null) {
                     if (clickedItem.isActionActive()) {
-						clickedItem.onClick(event.getClick());
+                        clickedItem.onClick(player, event.getClick());
                         clickedItem.rawClickAction(event);
                         clickedItem.actions.forEach(action -> action.run(event.getClick(), player));
                     }

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/GUIType.java

@@ -14,8 +14,8 @@ public enum GUIType {
     SIX_BY_NINE(6, 54),
     CANCEL(0, 0);
 
-	int lines;
-	int size;
+    private final int lines;
+    private final int size;
 
     GUIType(int lines, int size) {
         this.lines = lines;

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/configuration/GUIActionConfiguration.java

@@ -3,18 +3,39 @@ package cc.carm.lib.easyplugin.gui.configuration;
 import cc.carm.lib.easyplugin.gui.GUIItem;
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.ClickType;
+import org.jetbrains.annotations.Contract;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 public class GUIActionConfiguration {
 
+    public static @NotNull GUIActionConfiguration of(@NotNull GUIActionType actionType,
+                                                     @Nullable ClickType clickType,
+                                                     @Nullable String actionContent) {
+        return new GUIActionConfiguration(actionType, clickType, actionContent);
+    }
 
-	@Nullable ClickType clickType;
-	final @NotNull GUIActionType actionType;
-	final @Nullable String actionContent;
+    public static @NotNull GUIActionConfiguration of(@NotNull GUIActionType actionType,
+                                                     @Nullable String actionContent) {
+        return of(actionType, null, actionContent);
+    }
 
-	public GUIActionConfiguration(@Nullable ClickType clickType,
-								  @NotNull GUIActionType actionType,
+    public static @NotNull GUIActionConfiguration of(@NotNull GUIActionType actionType,
+                                                     @Nullable ClickType clickType) {
+        return of(actionType, clickType, null);
+    }
+
+    public static @NotNull GUIActionConfiguration of(@NotNull GUIActionType actionType) {
+        return of(actionType, null, null);
+    }
+
+    protected final @NotNull GUIActionType actionType;
+
+    protected final @Nullable ClickType clickType;
+    protected final @Nullable String actionContent;
+
+    public GUIActionConfiguration(@NotNull GUIActionType actionType,
+                                  @Nullable ClickType clickType,
                                   @Nullable String actionContent) {
         this.clickType = clickType;
         this.actionType = actionType;
@@ -50,4 +71,36 @@ public class GUIActionConfiguration {
         };
     }
 
+    @Nullable
+    @Contract("null->null")
+    public static GUIActionConfiguration deserialize(@Nullable String actionString) {
+        if (actionString == null) return null;
+
+        int prefixStart = actionString.indexOf("[");
+        int prefixEnd = actionString.indexOf("]");
+        if (prefixStart < 0 || prefixEnd < 0) return null;
+
+        String prefix = actionString.substring(prefixStart + 1, prefixEnd);
+        ClickType clickType = null;
+        GUIActionType actionType;
+        if (prefix.contains(":")) {
+            String[] args = prefix.split(":");
+            clickType = GUIConfiguration.readClickType(args[0]);
+            actionType = GUIActionType.readActionType(args[1]);
+        } else {
+            actionType = GUIActionType.readActionType(prefix);
+        }
+
+        if (actionType == null) return null;
+
+        String content = actionString.substring(prefixEnd + 1).trim();
+        return of(actionType, clickType, content);
+    }
+
+    public @NotNull String serialize() {
+        String prefix = "[" + getActionType().name() + (getClickType() == null ? "" : ":" + getClickType().name()) + "]";
+        String content = getActionContent() == null ? "" : " " + getActionContent();
+        return prefix + content;
+    }
+
 }

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/configuration/GUIConfiguration.java

@@ -6,19 +6,26 @@ import cc.carm.lib.easyplugin.utils.ColorParser;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.entity.Player;
 import org.bukkit.event.inventory.ClickType;
+import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.*;
-import java.util.stream.Collectors;
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Optional;
 
 public class GUIConfiguration {
 
-	String title;
-	int lines;
+    protected String title;
+    protected int lines;
 
-	List<GUIItemConfiguration> guiItems;
+    protected Map<String, GUIItemConfiguration> guiItems;
 
-	public GUIConfiguration(String title, int lines, List<GUIItemConfiguration> guiItems) {
+    public GUIConfiguration(String title, int lines) {
+        this(title, lines, new LinkedHashMap<>(1));
+    }
+
+    public GUIConfiguration(String title, int lines, Map<String, GUIItemConfiguration> guiItems) {
         this.title = title;
         this.lines = lines;
         this.guiItems = guiItems;
@@ -38,31 +45,50 @@ public class GUIConfiguration {
                 .get();
     }
 
-	public List<GUIItemConfiguration> getGuiItems() {
+    public Map<String, GUIItemConfiguration> getGUIItems() {
         return guiItems;
     }
 
     public void setupItems(Player player, GUI gui) {
-		getGuiItems().forEach(itemConfiguration -> itemConfiguration.setupItems(player, gui));
+        getGUIItems().values().forEach(itemConfiguration -> itemConfiguration.setupItems(player, gui));
+    }
+
+    public @NotNull Map<String, Object> serialize() {
+        LinkedHashMap<String, Object> map = new LinkedHashMap<>();
+
+        map.put("title", this.title);
+        map.put("lines", this.lines);
+        if (!this.guiItems.isEmpty()) {
+            LinkedHashMap<String, Object> items = new LinkedHashMap<>();
+            this.guiItems.forEach((key, value) -> items.put(key, value.serialize()));
+            map.put("items", items);
+        }
+        return map;
     }
 
 
     public static GUIConfiguration readConfiguration(@Nullable ConfigurationSection section) {
-		if (section == null) return new GUIConfiguration("name", 6, new ArrayList<>());
-
-		String title = section.getString("title", "");
-		int lines = section.getInt("lines", 6);
-		ConfigurationSection itemsSection = section.getConfigurationSection("items");
-		if (itemsSection == null) return new GUIConfiguration(title, lines, new ArrayList<>());
+        if (section == null) return new GUIConfiguration("name", 6);
 
         return new GUIConfiguration(
-				title, lines, itemsSection.getKeys(false).stream()
-				.map(key -> GUIItemConfiguration.readFrom(itemsSection.getConfigurationSection(key)))
-				.filter(Objects::nonNull)
-				.collect(Collectors.toList())
+                section.getString("title", ""),
+                section.getInt("lines", 6),
+                readItems(section.getConfigurationSection("items"))
         );
     }
 
+    public static Map<String, GUIItemConfiguration> readItems(ConfigurationSection itemsSection) {
+        Map<String, GUIItemConfiguration> items = new LinkedHashMap<>();
+        if (itemsSection == null) return items;
+
+        for (String key : itemsSection.getKeys(false)) {
+            GUIItemConfiguration item = GUIItemConfiguration.readFrom(itemsSection.getConfigurationSection(key));
+            if (item != null) items.put(key, item);
+        }
+
+        return items;
+    }
+
     public static ClickType readClickType(String type) {
         return Arrays.stream(ClickType.values())
                 .filter(click -> click.name().equalsIgnoreCase(type))

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/configuration/GUIItemConfiguration.java

@@ -7,30 +7,29 @@ import cc.carm.lib.easyplugin.utils.MessageUtils;
 import org.bukkit.Material;
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.entity.Player;
-import org.bukkit.event.inventory.ClickType;
 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.Optional;
+import java.util.*;
+import java.util.stream.Collectors;
 
 public class GUIItemConfiguration {
 
-	Material material;
+    @NotNull Material type;
+    int amount;
     int data;
-	String name;
+    @Nullable String name;
     @NotNull List<String> lore;
 
     @NotNull List<Integer> slots;
     @NotNull List<GUIActionConfiguration> actions;
 
-	public GUIItemConfiguration(Material material, int data,
-								String name, @NotNull List<String> lore,
+    public GUIItemConfiguration(@NotNull Material type, int amount, int data,
+                                @Nullable String name, @NotNull List<String> lore,
                                 @NotNull List<GUIActionConfiguration> actions,
                                 @NotNull List<Integer> slots) {
-		this.material = material;
+        this.type = type;
+        this.amount = amount;
         this.data = data;
         this.name = name;
         this.lore = lore;
@@ -39,8 +38,7 @@ public class GUIItemConfiguration {
     }
 
     public void setupItems(Player player, GUI gui) {
-		ItemStackFactory icon = new ItemStackFactory(this.material);
-		icon.setDurability(this.data);
+        ItemStackFactory icon = new ItemStackFactory(this.type, this.amount, this.data);
         if (this.name != null) icon.setDisplayName(this.name);
         icon.setLore(MessageUtils.setPlaceholders(player, this.lore));
 
@@ -49,11 +47,32 @@ public class GUIItemConfiguration {
         this.slots.forEach(slot -> gui.setItem(slot, item));
     }
 
+    public @NotNull Map<String, Object> serialize() {
+        LinkedHashMap<String, Object> map = new LinkedHashMap<>();
+
+        map.put("type", this.type.name());
+        if (this.name != null) map.put("name", this.name);
+        if (this.amount != 1) map.put("amount", this.amount);
+        if (this.data != 0) map.put("data", this.data);
+        if (!this.lore.isEmpty()) map.put("lore", this.lore);
+        if (this.slots.size() > 1) {
+            map.put("slots", this.slots);
+        } else if (slots.size() == 1) {
+            map.put("slot", this.slots.get(0));
+        }
+        if (!this.actions.isEmpty()) {
+            map.put("actions", this.actions.stream().map(GUIActionConfiguration::serialize).collect(Collectors.toList()));
+        }
+        return map;
+    }
+
     @Nullable
     public static GUIItemConfiguration readFrom(@Nullable ConfigurationSection itemSection) {
         if (itemSection == null) return null;
-		Material material = Optional.ofNullable(Material.matchMaterial(itemSection.getString("material", "STONE"))).orElse(Material.STONE);
+        String material = Optional.ofNullable(itemSection.getString("type")).orElse("STONE");
+        Material type = Optional.ofNullable(Material.matchMaterial(material)).orElse(Material.STONE);
         int data = itemSection.getInt("data", 0);
+        int amount = itemSection.getInt("amount", 1);
         String name = itemSection.getString("name");
         List<String> lore = itemSection.getStringList("lore");
 
@@ -63,30 +82,15 @@ public class GUIItemConfiguration {
         List<String> actionsString = itemSection.getStringList("actions");
         List<GUIActionConfiguration> actions = new ArrayList<>();
         for (String actionString : actionsString) {
-			int prefixStart = actionString.indexOf("[");
-			int prefixEnd = actionString.indexOf("]");
-			if (prefixStart < 0 || prefixEnd < 0) continue;
-
-			String prefix = actionString.substring(prefixStart + 1, prefixEnd);
-			ClickType clickType = null;
-			GUIActionType actionType;
-			if (prefix.contains(":")) {
-				String[] args = prefix.split(":");
-				clickType = GUIConfiguration.readClickType(args[0]);
-				actionType = GUIActionType.readActionType(args[1]);
-			} else {
-				actionType = GUIActionType.readActionType(prefix);
-			}
-
-			if (actionType == null) continue;
-			actions.add(new GUIActionConfiguration(clickType, actionType, actionString.substring(prefixEnd + 1).trim()));
+            GUIActionConfiguration action = GUIActionConfiguration.deserialize(actionString);
+            if (action == null) continue;
+            actions.add(action);
         }
 
         return new GUIItemConfiguration(
-				material, data, name, lore, actions,
+                type, amount, data, name, lore, actions,
                 slots.size() > 0 ? slots : Collections.singletonList(slot)
         );
     }
 
-
 }

base/gui/src/main/java/cc/carm/lib/easyplugin/gui/paged/AutoPagedGUI.java

@@ -49,7 +49,7 @@ public class AutoPagedGUI extends CommonPagedGUI {
                 setItem(previousPageSlot, new GUIItem(
                         previousPageUI == null ? getDefaultPreviousPage(user) : previousPageUI) {
                     @Override
-					public void onClick(ClickType type) {
+                    public void onClick(Player clicker, ClickType type) {
                         if (type == ClickType.RIGHT) {
                             goFirstPage();
                         } else {
@@ -68,7 +68,7 @@ public class AutoPagedGUI extends CommonPagedGUI {
                 setItem(nextPageSlot, new GUIItem(
                         nextPageUI == null ? getDefaultNextPage(user) : nextPageUI) {
                     @Override
-					public void onClick(ClickType type) {
+                    public void onClick(Player clicker, ClickType type) {
                         if (type == ClickType.RIGHT) {
                             goLastPage();
                         } else {

base/gui/src/test/java/ActionReadTest.java

@@ -1,4 +1,3 @@
-
 import cc.carm.lib.easyplugin.gui.configuration.GUIActionType;
 import cc.carm.lib.easyplugin.gui.configuration.GUIConfiguration;
 import org.bukkit.event.inventory.ClickType;

base/listener/pom.xml

@@ -0,0 +1,80 @@
+<?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">
+    <parent>
+        <artifactId>easyplugin-parent</artifactId>
+        <groupId>cc.carm.lib</groupId>
+        <version>1.4.14</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <properties>
+        <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>
+    </properties>
+    <artifactId>easyplugin-listener</artifactId>
+
+    <name>EasyPlugin-Listener</name>
+    <description>轻松插件监听器接口模块，基于 EasyListener 项目。</description>
+    <url>https://github.com/CarmJos/EasyPlugin</url>
+
+    <licenses>
+        <license>
+            <name>GNU LESSER GENERAL PUBLIC LICENSE</name>
+            <url>https://www.gnu.org/licenses/lgpl-3.0.html</url>
+        </license>
+    </licenses>
+
+    <dependencies>
+        <dependency>
+            <!-- https://github.com/CarmJos/EasyListener -->
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easylistener</artifactId>
+            <scope>compile</scope>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-shade-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>shade</goal>
+                        </goals>
+                        <configuration>
+                            <createDependencyReducedPom>false</createDependencyReducedPom>
+                        </configuration>
+                    </execution>
+                </executions>
+                <configuration>
+                    <relocations>
+                        <relocation>
+                            <pattern>cc.carm.lib.easylistener</pattern>
+                            <shadedPattern>cc.carm.lib.easyplugin.listener</shadedPattern>
+                        </relocation>
+                    </relocations>
+                    <filters>
+                        <filter>
+                            <artifact>*:*</artifact>
+                            <excludes>
+                                <exclude>META-INF/MANIFEST.MF</exclude>
+                                <exclude>META-INF/*.txt</exclude>
+                            </excludes>
+                        </filter>
+                    </filters>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+
+</project>

base/main/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -56,7 +56,6 @@
         <dependency>
             <groupId>me.clip</groupId>
             <artifactId>placeholderapi</artifactId>
-            <version>2.10.9</version>
             <scope>provided</scope>
         </dependency>
 

base/main/src/main/java/cc/carm/lib/easyplugin/EasyPlugin.java

@@ -9,10 +9,13 @@ import org.bukkit.command.PluginCommand;
 import org.bukkit.command.TabCompleter;
 import org.bukkit.event.Event;
 import org.bukkit.event.Listener;
+import org.bukkit.plugin.PluginDescriptionFile;
 import org.bukkit.plugin.java.JavaPlugin;
+import org.bukkit.plugin.java.JavaPluginLoader;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.io.File;
 import java.lang.reflect.Method;
 import java.util.Arrays;
 import java.util.HashMap;
@@ -22,18 +25,28 @@ import java.util.concurrent.CompletableFuture;
 
 public abstract class EasyPlugin extends JavaPlugin {
 
-    protected EasyPluginMessageProvider messageProvider;
+    protected @NotNull EasyPluginMessageProvider messageProvider;
 
     public EasyPlugin() {
         this(EasyPluginMessageProvider.ZH_CN);
     }
 
-    public EasyPlugin(EasyPluginMessageProvider messageProvider) {
+    public EasyPlugin(@NotNull EasyPluginMessageProvider messageProvider) {
         this.messageProvider = messageProvider;
     }
 
-    private SchedulerUtils scheduler;
-    private boolean initialized = false;
+    protected EasyPlugin(JavaPluginLoader loader, PluginDescriptionFile descriptionFile, File dataFolder, File file) {
+        this(EasyPluginMessageProvider.ZH_CN, loader, descriptionFile, dataFolder, file);
+    }
+
+    protected EasyPlugin(@NotNull EasyPluginMessageProvider messageProvider,
+                         JavaPluginLoader loader, PluginDescriptionFile descriptionFile, File dataFolder, File file) {
+        super(loader, descriptionFile, dataFolder, file);
+        this.messageProvider = messageProvider;
+    }
+
+    protected SchedulerUtils scheduler;
+    protected boolean initialized = false;
 
     @Override
     public final void onLoad() {
@@ -66,7 +79,7 @@ public abstract class EasyPlugin extends JavaPlugin {
 
     @Override
     public final void onDisable() {
-        if (!hasOverride("shutdown") || !isInitialized()) return;
+        if (!hasOverride("shutdown") || !this.initialized) return;
         outputInfo();
 
         log(messageProvider.disabling(this));
@@ -90,10 +103,6 @@ public abstract class EasyPlugin extends JavaPlugin {
         Optional.ofNullable(JarResourceUtils.readResource(this.getResource("PLUGIN_INFO"))).ifPresent(this::log);
     }
 
-    public boolean isInitialized() {
-        return initialized;
-    }
-
     public boolean isDebugging() {
         return false;
     }
@@ -136,19 +145,40 @@ public abstract class EasyPlugin extends JavaPlugin {
         if (isDebugging()) print("&8[DEBUG] &r", messages);
     }
 
-    public void callEventSync(Event event) {
-        getScheduler().run(() -> Bukkit.getPluginManager().callEvent(event));
-    }
-
-    public void callEventAsync(Event event) {
-        getScheduler().runAsync(() -> Bukkit.getPluginManager().callEvent(event));
-    }
-
-    public @NotNull <T extends Event> CompletableFuture<T> callEventFuture(T event) {
-        return CompletableFuture.supplyAsync(() -> {
+    /**
+     * 在主线程唤起一个事件，并支持获取事件的结果。
+     *
+     * @param event 同步事件 (isAsync=false)
+     * @param <T>   事件类型
+     * @return CompletableFuture
+     */
+    public @NotNull <T extends Event> CompletableFuture<T> callSync(T event) {
+        CompletableFuture<T> future = new CompletableFuture<>();
+        getScheduler().run(() -> {
             Bukkit.getPluginManager().callEvent(event);
-            return event;
+            future.complete(event);
         });
+        return future;
+    }
+
+    /**
+     * 在异步线程中唤起一个事件，并支持获取事件的结果。
+     *
+     * @param event 异步事件 (isAsync=true)
+     * @param <T>   事件类型
+     * @return CompletableFuture
+     */
+    public @NotNull <T extends Event> CompletableFuture<T> callAsync(T event) {
+        CompletableFuture<T> future = new CompletableFuture<>();
+        getScheduler().runAsync(() -> {
+            Bukkit.getPluginManager().callEvent(event);
+            future.complete(event);
+        });
+        return future;
+    }
+
+    protected void setMessageProvider(@NotNull EasyPluginMessageProvider provider) {
+        this.messageProvider = provider;
     }
 
     @SuppressWarnings("BooleanMethodIsAlwaysInverted")

base/main/src/main/java/cc/carm/lib/easyplugin/utils/ColorParser.java

@@ -8,7 +8,7 @@ import java.util.stream.Collectors;
 
 public class ColorParser {
 
-    public static final Pattern HEX_PATTERN = Pattern.compile("&\\(&?#([0-9a-fA-F]{6})\\)");
+    public static final Pattern HEX_PATTERN = Pattern.compile("&\\(&?#([\\da-fA-F]{6})\\)");
 
     public static String parse(String text) {
         return parseBaseColor(parseHexColor(text));

base/storage/pom.xml

@@ -0,0 +1,27 @@
+<?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">
+    <parent>
+        <artifactId>easyplugin-parent</artifactId>
+        <groupId>cc.carm.lib</groupId>
+        <version>1.4.14</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <properties>
+        <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>
+    </properties>
+
+    <artifactId>easyplugin-storage</artifactId>
+    <packaging>jar</packaging>
+
+    <name>EasyPlugin-Storage</name>
+    <description>轻松插件存储接口模块，包含存储相关的统一接口。</description>
+    <url>https://github.com/CarmJos/EasyPlugin</url>
+
+
+</project>

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/DataStorage.java

@@ -0,0 +1,40 @@
+package cc.carm.lib.easyplugin.storage;
+
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public interface DataStorage<K, T> {
+
+    /**
+     * 在插件加载存储源时执行。
+     *
+     * @throws Exception 当出现任何错误时抛出
+     */
+    void initialize() throws Exception;
+
+    /**
+     * 在插件被卸载时执行。
+     */
+    void shutdown();
+
+    /**
+     * 用于加载数据的方法。<b>该方法应当异步运行！</b>
+     * <br>
+     * <br>若不存在对应数据，请返回 null 。
+     * <br>若加载出现任何错误，请抛出异常。
+     *
+     * @param key 数据主键
+     * @throws Exception 当出现任何错误时抛出
+     */
+    @Nullable
+    T loadData(@NotNull K key) throws Exception;
+
+    /**
+     * 用于保存数据的方法。 <b>该方法应当被异步运行！</b>
+     *
+     * @param data 数据
+     * @throws Exception 当出现任何错误时抛出
+     */
+    void saveData(@NotNull T data) throws Exception;
+
+}

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/StorageType.java

@@ -0,0 +1,19 @@
+package cc.carm.lib.easyplugin.storage;
+
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+
+public interface StorageType<K, T, S extends DataStorage<K, T>> {
+
+    int getID();
+
+    @NotNull List<String> getAlias();
+
+    @NotNull Class<? extends S> getStorageClass();
+
+    default @NotNull S createStorage() throws Exception {
+        return getStorageClass().newInstance();
+    }
+
+}

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/file/FileBasedStorage.java

@@ -0,0 +1,31 @@
+package cc.carm.lib.easyplugin.storage.file;
+
+import cc.carm.lib.easyplugin.storage.DataStorage;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+
+public abstract class FileBasedStorage<K, T> implements DataStorage<K, T> {
+
+
+    protected final String fileName;
+    protected File dataFile;
+
+    public FileBasedStorage(String fileName) {
+        this.fileName = fileName;
+    }
+
+    protected @NotNull File initializeFile(@NotNull File parentFolder) throws Exception {
+        this.dataFile = new File(parentFolder, fileName);
+        if (!dataFile.exists()) {
+            if (!dataFile.createNewFile()) throw new Exception("无法创建数据文件！");
+        } else if (dataFile.isDirectory()) {
+            throw new Exception("文件路径对应的不是一个文件！");
+        }
+        return dataFile;
+    }
+
+    public File getDataFile() {
+        return dataFile;
+    }
+}

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/file/FolderBasedStorage.java

@@ -0,0 +1,46 @@
+package cc.carm.lib.easyplugin.storage.file;
+
+import cc.carm.lib.easyplugin.storage.DataStorage;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+public abstract class FolderBasedStorage<K, T> implements DataStorage<K, T> {
+
+    protected final @NotNull String folderPath;
+    protected File dataFolder;
+
+    public FolderBasedStorage(@NotNull String folderPath) {
+        this.folderPath = folderPath;
+    }
+
+    protected @NotNull File initializeFolder(@NotNull File parentFolder) throws Exception {
+        this.dataFolder = new File(parentFolder, folderPath);
+        if (!dataFolder.exists()) {
+            if (!dataFolder.mkdir()) {
+                throw new Exception("无法创建数据文件夹！");
+            }
+        } else if (!dataFolder.isDirectory()) {
+            throw new Exception("数据文件夹路径对应的不是一个文件夹！");
+        }
+        return dataFolder;
+    }
+
+    protected @NotNull List<File> listFiles() {
+        if (this.dataFolder == null) return Collections.emptyList();
+        if (!this.dataFolder.isDirectory()) return Collections.emptyList();
+
+        File[] files = this.dataFolder.listFiles();
+        if (files == null) return Collections.emptyList();
+
+        return Arrays.asList(files);
+    }
+
+    public File getDataFolder() {
+        return dataFolder;
+    }
+
+}

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/file/YAMLBasedStorage.java

@@ -0,0 +1,24 @@
+package cc.carm.lib.easyplugin.storage.file;
+
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+
+public abstract class YAMLBasedStorage<K, T> extends FileBasedStorage<K, T> {
+
+    protected FileConfiguration configuration;
+
+    public YAMLBasedStorage(String fileName) {
+        super(fileName);
+    }
+
+    protected @NotNull FileConfiguration initializeConfiguration(@NotNull File parentFolder) throws Exception {
+        return this.configuration = YamlConfiguration.loadConfiguration(initializeFile(parentFolder));
+    }
+
+    public FileConfiguration getConfiguration() {
+        return configuration;
+    }
+}

base/storage/src/main/java/cc/carm/lib/easyplugin/storage/plugin/PluginBasedStorage.java

@@ -0,0 +1,31 @@
+package cc.carm.lib.easyplugin.storage.plugin;
+
+import cc.carm.lib.easyplugin.storage.DataStorage;
+import org.bukkit.Bukkit;
+import org.bukkit.plugin.Plugin;
+
+public abstract class PluginBasedStorage<K, T> implements DataStorage<K, T> {
+
+    protected Plugin dependPlugin;
+
+    public PluginBasedStorage(String dependPluginName) {
+        this(Bukkit.getPluginManager().getPlugin(dependPluginName));
+    }
+
+    public PluginBasedStorage(Plugin dependPlugin) {
+        this.dependPlugin = dependPlugin;
+    }
+
+    @Override
+    public void initialize() throws NullPointerException {
+        if (dependPlugin == null) {
+            throw new NullPointerException("该存储类型依赖的插件不存在，请检查配置文件");
+        }
+    }
+
+    public Plugin getDependPlugin() {
+        return dependPlugin;
+    }
+
+
+}

collection/all/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>

collection/bom/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -52,6 +52,7 @@
 
     <dependencyManagement>
         <dependencies>
+
             <dependency>
                 <groupId>${project.parent.groupId}</groupId>
                 <artifactId>easyplugin-main</artifactId>
@@ -67,6 +68,27 @@
                 <artifactId>easyplugin-gui</artifactId>
                 <version>${project.parent.version}</version>
             </dependency>
+            <dependency>
+                <groupId>${project.parent.groupId}</groupId>
+                <artifactId>easyplugin-storage</artifactId>
+                <version>${project.parent.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>${project.parent.groupId}</groupId>
+                <artifactId>easyplugin-listener</artifactId>
+                <version>${project.parent.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>${project.parent.groupId}</groupId>
+                <artifactId>easyplugin-database</artifactId>
+                <version>${project.parent.version}</version>
+            </dependency>
+            <dependency>
+                <groupId>${project.parent.groupId}</groupId>
+                <artifactId>easyplugin-conf</artifactId>
+                <version>${project.parent.version}</version>
+            </dependency>
+
             <dependency>
                 <groupId>${project.parent.groupId}</groupId>
                 <artifactId>easyplugin-papi</artifactId>
@@ -77,6 +99,13 @@
                 <artifactId>easyplugin-vault</artifactId>
                 <version>${project.parent.version}</version>
             </dependency>
+
+            <dependency>
+                <groupId>${project.parent.groupId}</groupId>
+                <artifactId>easyplugin-githubchecker</artifactId>
+                <version>${project.parent.version}</version>
+            </dependency>
+
         </dependencies>
     </dependencyManagement>
 

collection/common/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -68,6 +68,14 @@
                     <groupId>cc.carm.lib</groupId>
                     <artifactId>easyplugin-vault</artifactId>
                 </exclusion>
+                <exclusion>
+                    <groupId>cc.carm.lib</groupId>
+                    <artifactId>easyplugin-database</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>cc.carm.lib</groupId>
+                    <artifactId>easyplugin-storage</artifactId>
+                </exclusion>
             </exclusions>
 
         </dependency>

extension/gh-checker/pom.xml

@@ -0,0 +1,34 @@
+<?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">
+    <parent>
+        <artifactId>easyplugin-parent</artifactId>
+        <groupId>cc.carm.lib</groupId>
+        <version>1.4.14</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <properties>
+        <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>
+    </properties>
+    <artifactId>easyplugin-githubchecker</artifactId>
+    <packaging>jar</packaging>
+
+    <name>EasyPlugin-GithubChecker</name>
+
+    <dependencies>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>githubreleases4j</artifactId>
+            <scope>compile</scope>
+        </dependency>
+
+    </dependencies>
+
+
+</project>

extension/gh-checker/src/main/java/cc/carm/lib/easyplugin/updatechecker/GHUpdateChecker.java

@@ -0,0 +1,84 @@
+package cc.carm.lib.easyplugin.updatechecker;
+
+import cc.carm.lib.githubreleases4j.GithubReleases4J;
+import org.bukkit.plugin.Plugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.List;
+import java.util.logging.Logger;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class GHUpdateChecker {
+
+    protected static final @NotNull Pattern GH_URL_PATTERN = Pattern.compile("^https?://github.com/([A-Za-z\\d-_]+)/([^/]*?)/?");
+
+    public static @NotNull GHUpdateChecker of(@NotNull Logger logger, @NotNull String owner, @NotNull String repo) {
+        return new GHUpdateChecker(logger, owner, repo);
+    }
+
+    public static @NotNull GHUpdateChecker of(@NotNull Plugin plugin) {
+        return new GHUpdateChecker(plugin.getLogger(), getGithubOwner(plugin), plugin.getName());
+    }
+
+    public static @NotNull Runnable runner(@NotNull Logger logger,
+                                           @NotNull String owner, @NotNull String repo,
+                                           @NotNull String currentVersion) {
+        return of(logger, owner, repo).runner(currentVersion);
+    }
+
+    public static @NotNull Runnable runner(@NotNull Plugin plugin) {
+        return of(plugin).runner(plugin.getDescription().getVersion());
+    }
+
+    protected final @NotNull Logger logger;
+    protected final @NotNull String owner;
+    protected final @NotNull String repo;
+
+    public GHUpdateChecker(@NotNull Logger logger, @NotNull String owner, @NotNull String repo) {
+        this.logger = logger;
+        this.owner = owner;
+        this.repo = repo;
+    }
+
+    public void checkUpdate(@NotNull String currentVersion) {
+        Integer behindVersions = GithubReleases4J.getVersionBehind(owner, repo, currentVersion);
+        String downloadURL = GithubReleases4J.getReleasesURL(owner, repo);
+
+        if (behindVersions == null) {
+            this.logger.severe("检查更新失败，请您定期查看插件是否更新，避免安全问题。");
+            this.logger.severe("下载地址 " + downloadURL);
+        } else if (behindVersions == 0) {
+            this.logger.info("检查完成，当前已是最新版本。");
+        } else if (behindVersions > 0) {
+            this.logger.info("发现新版本! 目前已落后 " + behindVersions + " 个版本。");
+            this.logger.info("最新版下载地址 " + downloadURL);
+        } else {
+            this.logger.severe("检查更新失败! 当前版本未知，请您使用原生版本以避免安全问题。");
+            this.logger.severe("最新版下载地址 " + downloadURL);
+        }
+    }
+
+    public Runnable runner(@NotNull String currentVersion) {
+        return () -> checkUpdate(currentVersion);
+    }
+
+    protected static String getGithubOwner(Plugin plugin) {
+        // 首先，尝试从插件提供的网址中获取OWNER
+        String websiteOwner = getGithubOwner(plugin.getDescription().getWebsite());
+        if (websiteOwner != null && !websiteOwner.isEmpty()) return websiteOwner;
+
+        // 如果插件提供的网址中没有，则尝试获取插件的首位作者名
+        List<String> authors = plugin.getDescription().getAuthors();
+        if (!authors.isEmpty()) return authors.get(0);
+
+        // 再没有的话只能返回插件的名称了
+        return plugin.getName();
+    }
+
+    protected static String getGithubOwner(String url) {
+        Matcher matcher = GH_URL_PATTERN.matcher(url);
+        return matcher.find() ? matcher.group(1) : null;
+    }
+
+}

extension/gh-checker/src/test/java/cc/carm/lib/easyplugin/updatechecker/RegexTest.java

@@ -0,0 +1,16 @@
+package cc.carm.lib.easyplugin.updatechecker;
+
+import org.junit.Test;
+
+public class RegexTest {
+
+
+    @Test
+    public void onTest() {
+        System.out.println(GHUpdateChecker.getGithubOwner("https://github.com/CarmJos/EasyPlugin"));
+        System.out.println(GHUpdateChecker.getGithubOwner("https://github.com/Ghost-chu/QuickShop-Hikari/pulls"));
+        System.out.println(GHUpdateChecker.getGithubOwner("https://github.com/QWQ123/QuickShop"));
+
+    }
+
+}

extension/papi/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -27,7 +27,6 @@
         <dependency>
             <groupId>me.clip</groupId>
             <artifactId>placeholderapi</artifactId>
-            <version>2.10.9</version>
             <scope>provided</scope>
         </dependency>
 

extension/vault/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.6</version>
+        <version>1.4.14</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -24,10 +24,10 @@
 
     <dependencies>
 
+        <!--suppress VulnerableLibrariesLocal -->
         <dependency>
             <groupId>com.github.MilkBowl</groupId>
             <artifactId>VaultAPI</artifactId>
-            <version>1.7</version>
             <scope>provided</scope>
         </dependency>
 

pom.xml

@@ -15,15 +15,20 @@
     <groupId>cc.carm.lib</groupId>
     <artifactId>easyplugin-parent</artifactId>
     <packaging>pom</packaging>
-    <version>1.4.6</version>
+    <version>1.4.14</version>
     <modules>
 
         <module>base/main</module>
-        <module>base/command</module>
+        <module>base/conf</module>
         <module>base/gui</module>
+        <module>base/command</module>
+        <module>base/storage</module>
+        <module>base/listener</module>
+        <module>base/database</module>
 
         <module>extension/papi</module>
         <module>extension/vault</module>
+        <module>extension/gh-checker</module>
 
         <module>collection/all</module>
         <module>collection/bom</module>
@@ -122,6 +127,41 @@
 
     </dependencies>
 
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>me.clip</groupId>
+                <artifactId>placeholderapi</artifactId>
+                <version>2.10.9</version>
+            </dependency>
+            <dependency>
+                <groupId>com.github.MilkBowl</groupId>
+                <artifactId>VaultAPI</artifactId>
+                <version>1.7</version>
+            </dependency>
+            <dependency>
+                <groupId>cc.carm.lib</groupId>
+                <artifactId>githubreleases4j</artifactId>
+                <version>1.3.1</version>
+            </dependency>
+            <dependency>
+                <groupId>cc.carm.lib</groupId>
+                <artifactId>easylistener</artifactId>
+                <version>2.0.1</version>
+            </dependency>
+            <dependency>
+                <groupId>cc.carm.lib</groupId>
+                <artifactId>mineconfiguration-bukkit</artifactId>
+                <version>2.0.2</version>
+            </dependency>
+            <dependency>
+                <groupId>cc.carm.lib</groupId>
+                <artifactId>easysql-beecp</artifactId>
+                <version>0.4.3</version>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
     <build>
         <plugins>
             <plugin>