chore(cmd): 令 hasPermission() 判断的参数为 CommandSender 。

base/command/pom.xml

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

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

@@ -38,7 +38,9 @@ public abstract class CommandHandler implements TabExecutor, NamedExecutor {
 
     public abstract void noArgs(CommandSender sender);
 
-    public abstract void unknownCommand(CommandSender sender, String[] args);
+    public void unknownCommand(CommandSender sender, String[] args) {
+        noArgs(sender);
+    }
 
     public abstract void noPermission(CommandSender sender);
 

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

@@ -13,16 +13,11 @@ public abstract class SubCommand implements NamedExecutor {
     private final String name;
     private final List<String> aliases;
 
-    public SubCommand(String name) {
-        this(name, new String[0]);
-    }
-
     public SubCommand(String name, String... aliases) {
         this.name = name;
         this.aliases = Arrays.asList(aliases);
     }
 
-
     @Override
     public String getName() {
         return this.name;

base/gui/pom.xml

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

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.Arrays;
-import java.util.stream.Collectors;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Optional;
 
 public class GUIConfiguration {
 
-    String title;
+    protected String title;
-    int lines;
+    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<>());
+        if (section == null) return new GUIConfiguration("name", 6);
-
-        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<>());
 
         return new GUIConfiguration(
-                title, lines, itemsSection.getKeys(false).stream()
+                section.getString("title", ""),
-                .map(key -> GUIItemConfiguration.readFrom(itemsSection.getConfigurationSection(key)))
+                section.getInt("lines", 6),
-                .filter(Objects::nonNull)
+                readItems(section.getConfigurationSection("items"))
-                .collect(Collectors.toList())
         );
     }
 
+    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

@@ -16,6 +16,7 @@ import java.util.stream.Collectors;
 public class GUIItemConfiguration {
 
     @NotNull Material type;
+    int amount;
     int data;
     @Nullable String name;
     @NotNull List<String> lore;
@@ -23,11 +24,12 @@ public class GUIItemConfiguration {
     @NotNull List<Integer> slots;
     @NotNull List<GUIActionConfiguration> actions;
 
-    public GUIItemConfiguration(@NotNull Material type, int data,
+    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.type = type;
+        this.amount = amount;
         this.data = data;
         this.name = name;
         this.lore = lore;
@@ -36,8 +38,7 @@ public class GUIItemConfiguration {
     }
 
     public void setupItems(Player player, GUI gui) {
-        ItemStackFactory icon = new ItemStackFactory(this.type);
+        ItemStackFactory icon = new ItemStackFactory(this.type, this.amount, this.data);
-        icon.setDurability(this.data);
         if (this.name != null) icon.setDisplayName(this.name);
         icon.setLore(MessageUtils.setPlaceholders(player, this.lore));
 
@@ -51,12 +52,13 @@ public class GUIItemConfiguration {
 
         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("slots", this.slots.get(0));
+            map.put("slot", this.slots.get(0));
         }
         if (!this.actions.isEmpty()) {
             map.put("actions", this.actions.stream().map(GUIActionConfiguration::serialize).collect(Collectors.toList()));
@@ -70,6 +72,7 @@ public class GUIItemConfiguration {
         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");
 
@@ -85,10 +88,9 @@ public class GUIItemConfiguration {
         }
 
         return new GUIItemConfiguration(
-                type, data, name, lore, actions,
+                type, amount, data, name, lore, actions,
                 slots.size() > 0 ? slots : Collections.singletonList(slot)
         );
     }
 
-
 }

base/main/pom.xml

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

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

@@ -45,8 +45,8 @@ public abstract class EasyPlugin extends JavaPlugin {
         this.messageProvider = messageProvider;
     }
 
-    private SchedulerUtils scheduler;
+    protected SchedulerUtils scheduler;
-    private boolean initialized = false;
+    protected boolean initialized = false;
 
     @Override
     public final void onLoad() {
@@ -79,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));
@@ -103,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;
     }
@@ -149,15 +145,16 @@ public abstract class EasyPlugin extends JavaPlugin {
         if (isDebugging()) print("&8[DEBUG] &r", messages);
     }
 
-    public void callEventSync(Event event) {
+    public @NotNull <T extends Event> CompletableFuture<T> callSync(T event) {
-        getScheduler().run(() -> Bukkit.getPluginManager().callEvent(event));
+        CompletableFuture<T> future = new CompletableFuture<>();
+        getScheduler().run(() -> {
+            Bukkit.getPluginManager().callEvent(event);
+            future.complete(event);
+        });
+        return future;
     }
 
-    public void callEventAsync(Event event) {
+    public @NotNull <T extends Event> CompletableFuture<T> callAsync(T event) {
-        getScheduler().runAsync(() -> Bukkit.getPluginManager().callEvent(event));
-    }
-
-    public @NotNull <T extends Event> CompletableFuture<T> callEventFuture(T event) {
         return CompletableFuture.supplyAsync(() -> {
             Bukkit.getPluginManager().callEvent(event);
             return event;

base/storage/pom.xml

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

collection/all/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.7</version>
+        <version>1.4.12</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.7</version>
+        <version>1.4.12</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>

collection/common/pom.xml

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

extension/gh-checker/pom.xml

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

extension/papi/pom.xml

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

extension/vault/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easyplugin-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.4.7</version>
+        <version>1.4.12</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -24,6 +24,7 @@
 
     <dependencies>
 
+        <!--suppress VulnerableLibrariesLocal -->
         <dependency>
             <groupId>com.github.MilkBowl</groupId>
             <artifactId>VaultAPI</artifactId>

pom.xml

@@ -10,17 +10,12 @@
         <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>
-
-        <dep.spigot>1.3.1</dep.spigot>
-        <dep.githubreleases4j>1.3.1</dep.githubreleases4j>
-
-
     </properties>
 
     <groupId>cc.carm.lib</groupId>
     <artifactId>easyplugin-parent</artifactId>
     <packaging>pom</packaging>
-    <version>1.4.7</version>
+    <version>1.4.12</version>
     <modules>
 
         <module>base/main</module>