chore(update): 适配上游版本更新。

Bumps [maven-javadoc-plugin](https://github.com/apache/maven-javadoc-plugin) from 3.4.1 to 3.5.0.
- [Release notes](https://github.com/apache/maven-javadoc-plugin/releases)
- [Commits](https://github.com/apache/maven-javadoc-plugin/compare/maven-javadoc-plugin-3.4.1...maven-javadoc-plugin-3.5.0)

---
updated-dependencies:
- dependency-name: org.apache.maven.plugins:maven-javadoc-plugin
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/workflows/javadoc.yml

@@ -30,7 +30,7 @@ jobs:
           rm -rf docs
           mkdir -vp docs
           cp -vrf target/site/apidocs/* docs/
-          cp -vrf .documentation/javadoc/JAVADOC-README.md docs/README.md
+          cp -vrf .doc/javadoc/JAVADOC-README.md docs/README.md
 
       - name: "Generate Sitemap"
         id: sitemap

README.md

@@ -20,44 +20,35 @@ EasyConfiguration for MineCraft!
 
 ## 项目结构
 
-### **MineConfiguration-Common**
+### **MineConfiguration-Common** [`common`](common)
 
-全部版本的共用部分，包括
+全部版本的共用部分(均已被打包至下行包中)，包括
 
 - `ConfigMessage` (实现类为 `ConfiguredMessage<M>`)
 - `ConfigMessageList` (实现类为 `ConfiguredMessageList<M>`)
 
 如要使用，请访问对应实现类的builder() 方法来快速创建。
 
-### MineConfiguration-Bukkit
+### **MineConfiguration-Bukkit** [`platform/bukkit`](platform/bukkit)
 
-#### MineConfiguration-Bukkit-Base
-
-Bukkit系通用依赖，不包含实现部分，请使用 **MineConfiguration-Bukkit-General** 或 **MineConfiguration-Bukkit-Native** 。
+适用于Bukkit的版本，同时支持其他以Bukkit为基础的服务端 *(如Spigot、Paper、CatServer)* 。
 
 相较于基础版本，额外提供了以下功能：
 
 - `ConfiguredSerializable<T extends ConfigurationSerializable>`
-- `ConfiguredItem` (快捷读取简单的物品配置文件)
-- `ConfiguredSound` (快捷读取音效配置文件)
+- `ConfiguredItem` (快捷读\写\使用简单的物品配置文件)
+- `ConfiguredSound` (快捷读\写\使用音效配置文件)
+- `ConfiguredTitle` (快速读\写\使用标题文字配置文件)
 
 以上类型可以通过 `CraftConfigValue.builder()` 来创建，部分类型提供了 `of(...);` 方法来快速创建。
 
-#### **MineConfiguration-Bukkit** _(推荐)_
-
-适用于Bukkit的版本，包含以Bukkit为基础的其他服务端 *(如Spigot、Paper、CatServer)* 。
-
-#### **MineConfiguration-Spigot**
-
-适用于 Spigot(1.18+) 的版本，适配了1.18及以后版本Spigot原生自带的配置文件注释功能，随Spigot更新而优化，安全稳定。
-
-### **MineConfiguration-Bungee**
+### **MineConfiguration-Bungee** [`platform/bungee`](platform/bungee)
 
 适用于BungeeCord的版本，可用JSON与YAML格式。其中JSON格式**不支持配置文件注释**。
 
 ## 开发
 
-请详见 [EasyConfiguration](https://github.com/CarmJos/EasyConfiguration)
+其他功能请详见 [EasyConfiguration](https://github.com/CarmJos/EasyConfiguration)
 的 [开发介绍](https://github.com/CarmJos/EasyConfiguration/tree/master/.documentation) 。
 
 ### 依赖方式
@@ -113,7 +104,7 @@ Bukkit系通用依赖，不包含实现部分，请使用 **MineConfiguration-Bu
             <version>[LATEST RELEASE]</version>
             <scope>compile</scope>
         </dependency>
-        
+
         <dependency>
             <groupId>cc.carm.lib</groupId>
             <artifactId>mineconfiguration-spigot</artifactId>

common/pom.xml

@@ -5,21 +5,33 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>2.1.0</version>
+        <version>2.3.3</version>
     </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>mineconfiguration-common</artifactId>
 
+    <name>MineConfiguration-Common</name>
+    <description>轻松(做)配置，全部版本的共用部分。</description>
+
     <dependencies>
 
         <dependency>
             <groupId>cc.carm.lib</groupId>
             <artifactId>easyconfiguration-core</artifactId>
-            <version>3.2.0</version>
+            <version>${deps.easyconfifuration.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-color</artifactId>
+            <version>${deps.easyplugin.version}</version>
             <scope>compile</scope>
         </dependency>
 

common/src/main/java/cc/carm/lib/mineconfiguration/common/utils/ColorParser.java

@@ -1,44 +0,0 @@
-package cc.carm.lib.mineconfiguration.common.utils;
-
-import java.util.Arrays;
-import java.util.List;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-import java.util.stream.Collectors;
-
-public class ColorParser {
-
-    public static Pattern HEX_PATTERN = Pattern.compile("&\\(&?#([0-9a-fA-F]{6})\\)");
-
-    public static String parse(String text) {
-        return parseBaseColor(parseHexColor(text));
-    }
-
-    public static String[] parse(String... texts) {
-        return parse(Arrays.asList(texts)).toArray(new String[0]);
-    }
-
-    public static List<String> parse(List<String> texts) {
-        return texts.stream().map(ColorParser::parse).collect(Collectors.toList());
-    }
-
-    public static String parseBaseColor(final String text) {
-        return text.replaceAll("&", "§").replace("§§", "&");
-    }
-
-    public static String parseHexColor(String text) {
-        Matcher matcher = HEX_PATTERN.matcher(text);
-        while (matcher.find()) {
-            text = matcher.replaceFirst(buildHexColor(matcher.group(1)).toLowerCase());
-            matcher.reset(text);
-        }
-        return text;
-    }
-
-    private static String buildHexColor(String hexCode) {
-        return Arrays.stream(hexCode.split(""))
-                .map(s -> '§' + s)
-                .collect(Collectors.joining("", '§' + "x", ""));
-    }
-
-}

common/src/main/java/cc/carm/lib/mineconfiguration/common/value/BaseMessage.java

@@ -0,0 +1,147 @@
+package cc.carm.lib.mineconfiguration.common.value;
+
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageValueBuilder;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
+
+import java.util.Map;
+import java.util.Optional;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+public interface BaseMessage<R, M> {
+
+    /**
+     * 得到所有的接收者
+     *
+     * @return 全部可能的接收者
+     */
+    @Unmodifiable
+    @NotNull Iterable<R> getAllReceivers();
+
+    /**
+     * 得到消息中的通过 {@link MessageValueBuilder#params(String...)}已定变量名(按定义顺序)
+     *
+     * @return 已定变量
+     */
+    @NotNull String[] getParams();
+
+    /**
+     * 向接收者发送消息的根方法。
+     *
+     * @param receiver 接收者
+     * @param message  消息内容
+     */
+    @ApiStatus.OverrideOnly
+    void apply(@NotNull R receiver, @NotNull M message);
+
+    /**
+     * 为某位接收者解析此消息。
+     *
+     * @param sender       接收者
+     * @param placeholders 消息中的变量与对应参数
+     * @return 解析变量后的消息内容
+     */
+    @Nullable M parse(@Nullable R sender, @NotNull Map<String, Object> placeholders);
+
+    /**
+     * 为某位接收者解析此消息。
+     *
+     * @param sender 接收者
+     * @param values 已定变量的对应参数
+     * @return 解析变量后的消息内容
+     */
+    default @Nullable M parse(@Nullable R sender, @Nullable Object... values) {
+        return parse(sender, ParamsUtils.buildParams(getParams(), values));
+    }
+
+    /**
+     * 向某位接收者发送消息
+     *
+     * @param receiver 消息的接收者
+     * @param values   已定变量的对应参数
+     */
+    default void send(@Nullable R receiver, @Nullable Object... values) {
+        send(receiver, ParamsUtils.buildParams(getParams(), values));
+    }
+
+    /**
+     * 向某位接收者发送消息
+     *
+     * @param receiver     消息的接收者
+     * @param placeholders 消息中的变量与对应参数
+     */
+    default void send(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
+        if (receiver == null) return;
+        M parsed = parse(receiver, placeholders);
+        if (parsed == null) return;
+        apply(receiver, parsed);
+    }
+
+    /**
+     * 向全部接收者(包括后台)发送不同参数的消息
+     *
+     * @param eachValues 每位接收者将收到已定变量的对应参数(按定义顺序)
+     */
+    default void sendToEach(@NotNull Function<@NotNull R, Object[]> eachValues) {
+        sendToEach(null, eachValues);
+    }
+
+    /**
+     * 向特定接收者发送不同参数的消息
+     *
+     * @param limiter    接收者限定器，为空则不限定接收者。
+     * @param eachValues 每位接收者将收到已定变量的对应参数(按定义顺序)
+     */
+    default void sendToEach(@Nullable Predicate<R> limiter,
+                            @NotNull Function<@NotNull R, Object[]> eachValues) {
+        Predicate<R> predicate = Optional.ofNullable(limiter).orElse(r -> true);
+        for (R r : getAllReceivers()) {
+            if (predicate.test(r)) {
+                send(r, ParamsUtils.buildParams(getParams(), eachValues.apply(r)));
+            }
+        }
+    }
+
+
+    /**
+     * 广播此消息(包括后台)
+     *
+     * @param values 已定变量的对应参数(按定义顺序)
+     */
+    default void sendToAll(@Nullable Object... values) {
+        broadcast(values);
+    }
+
+    /**
+     * 广播此消息(包括后台)
+     *
+     * @param placeholders 消息中的变量与对应参数
+     */
+    default void sendToAll(@NotNull Map<String, Object> placeholders) {
+        broadcast(placeholders);
+    }
+
+
+    /**
+     * 广播此消息(包括后台)
+     *
+     * @param values 已定变量的对应参数(按定义顺序)
+     */
+    default void broadcast(@Nullable Object... values) {
+        broadcast(ParamsUtils.buildParams(getParams(), values));
+    }
+
+    /**
+     * 广播此消息(包括后台)
+     *
+     * @param placeholders 消息中的变量与对应参数
+     */
+    default void broadcast(@NotNull Map<String, Object> placeholders) {
+        getAllReceivers().forEach(r -> send(r, placeholders));
+    }
+
+}

common/src/main/java/cc/carm/lib/mineconfiguration/common/value/ConfigMessage.java

@@ -1,10 +1,9 @@
 package cc.carm.lib.mineconfiguration.common.value;
 
-import cc.carm.lib.mineconfiguration.common.data.AbstractText;
-import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import cc.carm.lib.configuration.core.function.ConfigValueParser;
 import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import cc.carm.lib.configuration.core.value.type.ConfiguredValue;
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -15,11 +14,11 @@ import java.util.function.BiFunction;
 import java.util.function.Function;
 
 public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
-        extends ConfiguredValue<T> {
+        extends ConfiguredValue<T> implements BaseMessage<R, M> {
 
     protected final @NotNull String[] params;
     protected final @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable M> messageParser;
-    protected final @NotNull BiConsumer<@NotNull R, @NotNull M> messageConsumer;
+    protected final @NotNull BiConsumer<@NotNull R, @NotNull M> sendFunction;
 
     protected final @NotNull Function<String, T> textBuilder;
 
@@ -27,44 +26,35 @@ public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
                          @Nullable List<String> headerComments, @Nullable String inlineComments,
                          @NotNull Class<T> textClazz, @NotNull T defaultMessage, @NotNull String[] params,
                          @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable M> messageParser,
-                         @NotNull BiConsumer<@NotNull R, @NotNull M> messageConsumer,
+                         @NotNull BiConsumer<@NotNull R, @NotNull M> sendFunction,
                          @NotNull Function<String, T> textBuilder) {
-        super(provider, sectionPath, headerComments, inlineComments, textClazz, defaultMessage,
+        super(
+                provider, sectionPath, headerComments, inlineComments, textClazz, defaultMessage,
                 ConfigValueParser.castToString().andThen((s, d) -> textBuilder.apply(s)), AbstractText::getMessage
         );
         this.params = params;
         this.messageParser = messageParser;
-        this.messageConsumer = messageConsumer;
+        this.sendFunction = sendFunction;
         this.textBuilder = textBuilder;
     }
 
-    public @Nullable M parse(@Nullable R sender, @Nullable Object... values) {
-        return parse(sender, ParamsUtils.buildParams(params, values));
+    @Override
+    public String[] getParams() {
+        return params;
     }
 
+    @Override
+    public void apply(@NotNull R receiver, @NotNull M message) {
+        sendFunction.accept(receiver, message);
+    }
+
+    @Override
     public @Nullable M parse(@Nullable R sender, @NotNull Map<String, Object> placeholders) {
         T value = get();
         if (value == null || value.getMessage().isEmpty()) return null;
         else return value.parse(this.messageParser, sender, placeholders);
     }
 
-    public void send(@Nullable R receiver, @Nullable Object... values) {
-        send(receiver, ParamsUtils.buildParams(params, values));
-    }
-
-    public void send(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
-        if (receiver == null) return;
-        M parsed = parse(receiver, placeholders);
-        if (parsed == null) return;
-        messageConsumer.accept(receiver, parsed);
-    }
-
-    public void broadcast(@Nullable Object... values) {
-        broadcast(ParamsUtils.buildParams(params, values));
-    }
-
-    public abstract void broadcast(@NotNull Map<String, Object> placeholders);
-
     public void set(@Nullable String value) {
         this.set(value == null ? null : buildText(value));
     }
@@ -72,4 +62,5 @@ public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
     protected T buildText(String value) {
         return textBuilder.apply(value);
     }
+    
 }

common/src/main/java/cc/carm/lib/mineconfiguration/common/value/ConfigMessageList.java

@@ -4,7 +4,6 @@ import cc.carm.lib.configuration.core.function.ConfigDataFunction;
 import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import cc.carm.lib.configuration.core.value.type.ConfiguredList;
 import cc.carm.lib.mineconfiguration.common.data.AbstractText;
-import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -16,7 +15,8 @@ import java.util.function.BiFunction;
 import java.util.function.Function;
 import java.util.stream.Collectors;
 
-public abstract class ConfigMessageList<M, T extends AbstractText<R>, R> extends ConfiguredList<T> {
+public abstract class ConfigMessageList<M, T extends AbstractText<R>, R>
+        extends ConfiguredList<T> implements BaseMessage<R, List<M>> {
 
     protected final @NotNull String[] params;
     protected final @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable M> messageParser;
@@ -40,38 +40,34 @@ public abstract class ConfigMessageList<M, T extends AbstractText<R>, R> extends
         this.textBuilder = textBuilder;
     }
 
-    public @Nullable List<M> parse(@Nullable R sender, @Nullable Object... values) {
-        return parse(sender, ParamsUtils.buildParams(params, values));
+    @Override
+    public String[] getParams() {
+        return params;
     }
 
-    public @Nullable List<M> parse(@Nullable R sender, @NotNull Map<String, Object> placeholders) {
+    @Override
+    public void apply(@NotNull R receiver, @NotNull List<M> message) {
+        sendFunction.accept(receiver, message);
+    }
+
+    /**
+     * 为某位接收者解析消息
+     *
+     * @param receiver     消息的接收者
+     * @param placeholders 消息中的变量与对应参数
+     */
+    @Override
+    public @Nullable List<M> parse(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
         List<T> list = get();
         if (list.isEmpty()) return null;
 
         List<String> messages = list.stream().map(T::getMessage).collect(Collectors.toList());
         if (String.join("", messages).isEmpty()) return null;
 
-        return list.stream().map(value -> value.parse(this.messageParser, sender, placeholders))
+        return list.stream().map(value -> value.parse(this.messageParser, receiver, placeholders))
                 .collect(Collectors.toList());
     }
 
-    public void send(@Nullable R receiver, @Nullable Object... values) {
-        send(receiver, ParamsUtils.buildParams(params, values));
-    }
-
-    public void send(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
-        if (receiver == null) return;
-        List<M> parsed = parse(receiver, placeholders);
-        if (parsed == null) return;
-        sendFunction.accept(receiver, parsed);
-    }
-
-    public void broadcast(@Nullable Object... values) {
-        broadcast(ParamsUtils.buildParams(params, values));
-    }
-
-    public abstract void broadcast(@NotNull Map<String, Object> placeholders);
-
     public void setMessages(@NotNull String... values) {
         setMessages(values.length == 0 ? null : Arrays.asList(values));
     }
@@ -82,7 +78,6 @@ public abstract class ConfigMessageList<M, T extends AbstractText<R>, R> extends
         } else {
             set(buildText(values));
         }
-
     }
 
     protected List<T> buildText(List<String> values) {

platform/bukkit/base/pom.xml

@@ -1,38 +0,0 @@
-<?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>mineconfiguration-bukkit-parent</artifactId>
-        <groupId>cc.carm.lib</groupId>
-        <version>2.1.0</version>
-    </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>
-    </properties>
-    <artifactId>mineconfiguration-bukkit-base</artifactId>
-    <packaging>jar</packaging>
-
-    <dependencies>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>mineconfiguration-common</artifactId>
-            <version>${project.parent.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-    </dependencies>
-
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-            </plugin>
-        </plugins>
-    </build>
-
-</project>

platform/bukkit/general/pom.xml

@@ -1,41 +0,0 @@
-<?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>mineconfiguration-bukkit-parent</artifactId>
-        <groupId>cc.carm.lib</groupId>
-        <version>2.1.0</version>
-    </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>
-    </properties>
-
-    <artifactId>mineconfiguration-bukkit</artifactId>
-    <packaging>jar</packaging>
-
-    <name>MineConfiguration-Bukkit</name>
-
-    <dependencies>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>mineconfiguration-bukkit-base</artifactId>
-            <version>${project.parent.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-    </dependencies>
-
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-            </plugin>
-        </plugins>
-    </build>
-
-</project>

platform/bukkit/pom.xml

@@ -5,25 +5,32 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>2.1.0</version>
+        <version>2.3.3</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>mineconfiguration-bukkit-parent</artifactId>
-    <packaging>pom</packaging>
-    <modules>
-        <module>base</module>
-        <module>general</module>
-    </modules>
+    <artifactId>mineconfiguration-bukkit</artifactId>
+    <packaging>jar</packaging>
 
-    <name>MineConfiguration-Bukkit-Parent</name>
+    <name>MineConfiguration-Bukkit</name>
+    <description>轻松(做)配置，适用于Bukkit系服务端的版本。</description>
 
     <dependencies>
 
+        <dependency>
+            <groupId>${project.parent.groupId}</groupId>
+            <artifactId>mineconfiguration-common</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <!--suppress VulnerableLibrariesLocal -->
         <dependency>
             <groupId>org.bukkit</groupId>
             <artifactId>bukkit</artifactId>
@@ -49,4 +56,13 @@
 
     </dependencies>
 
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-javadoc-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
 </project>

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/CraftConfigValue.java

@@ -25,7 +25,7 @@ public abstract class CraftConfigValue<T> extends CachedConfigValue<T> {
     public CraftConfigProvider getBukkitProvider() {
         ConfigurationProvider<?> provider = getProvider();
         if (provider instanceof CraftConfigProvider) return (CraftConfigProvider) getProvider();
-        else throw new IllegalStateException("Provider is not a SpigotConfigProvider");
+        else throw new IllegalStateException("Provider is not a CraftConfigProvider");
     }
 
     public CraftSectionWrapper getBukkitConfig() {

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/MineConfiguration.java

@@ -38,4 +38,5 @@ public class MineConfiguration {
     public static BukkitConfigProvider from(Plugin plugin, String fileName, String source) {
         return from(new File(plugin.getDataFolder(), fileName), source);
     }
+
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/utils/ProtocolLibHelper.java

@@ -7,11 +7,12 @@ import com.comphenix.protocol.events.PacketContainer;
 import com.comphenix.protocol.wrappers.EnumWrappers;
 import com.comphenix.protocol.wrappers.WrappedChatComponent;
 import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
 
 public class ProtocolLibHelper {
 
     @SuppressWarnings("deprecation")
-    public static void sendTitle(Player player, long fadeIn, long stay, long fadeOut, String line1, String line2) throws Exception {
+    public static void sendTitle(@NotNull Player player, long fadeIn, long stay, long fadeOut, String line1, String line2) throws Exception {
         ProtocolManager pm = ProtocolLibrary.getProtocolManager();
 
         if (line1 != null) {
@@ -35,7 +36,6 @@ public class ProtocolLibHelper {
                 .write(1, Math.toIntExact(stay))
                 .write(2, Math.toIntExact(fadeOut));
         pm.sendServerPacket(player, timePacket, false);
-
     }
 
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/utils/TextParser.java

@@ -1,6 +1,6 @@
 package cc.carm.lib.mineconfiguration.bukkit.utils;
 
-import cc.carm.lib.mineconfiguration.common.utils.ColorParser;
+import cc.carm.lib.easyplugin.utils.ColorParser;
 import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.bukkit.Bukkit;
 import org.bukkit.command.CommandSender;

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/value/ConfiguredMessage.java

@@ -1,17 +1,18 @@
 package cc.carm.lib.mineconfiguration.bukkit.value;
 
+import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
+import cc.carm.lib.mineconfiguration.bukkit.builder.message.CraftMessageValueBuilder;
 import cc.carm.lib.mineconfiguration.bukkit.data.TextConfig;
 import cc.carm.lib.mineconfiguration.common.value.ConfigMessage;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.mineconfiguration.bukkit.builder.message.CraftMessageValueBuilder;
 import org.bukkit.Bukkit;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.List;
-import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 
@@ -43,10 +44,11 @@ public class ConfiguredMessage<M> extends ConfigMessage<M, TextConfig, CommandSe
     }
 
     @Override
-    public void broadcast(@NotNull Map<String, Object> placeholders) {
-        Bukkit.getOnlinePlayers().forEach(pl -> send(pl, placeholders));
-        send(Bukkit.getConsoleSender(), placeholders);
+    public @NotNull Collection<CommandSender> getAllReceivers() {
+        List<CommandSender> senders = new ArrayList<>();
+        senders.add(Bukkit.getConsoleSender());
+        senders.addAll(Bukkit.getOnlinePlayers());
+        return senders;
     }
 
-
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/value/ConfiguredMessageList.java

@@ -1,17 +1,18 @@
 package cc.carm.lib.mineconfiguration.bukkit.value;
 
+import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
+import cc.carm.lib.mineconfiguration.bukkit.builder.message.CraftMessageListBuilder;
 import cc.carm.lib.mineconfiguration.bukkit.data.TextConfig;
 import cc.carm.lib.mineconfiguration.common.value.ConfigMessageList;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.mineconfiguration.bukkit.builder.message.CraftMessageListBuilder;
 import org.bukkit.Bukkit;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.List;
-import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 
@@ -38,9 +39,11 @@ public class ConfiguredMessageList<M> extends ConfigMessageList<M, TextConfig, C
         super(provider, sectionPath, headerComments, inlineComments, TextConfig.class, messages, params, messageParser, sendFunction, TextConfig::of);
     }
 
-    public void broadcast(@NotNull Map<String, Object> placeholders) {
-        Bukkit.getOnlinePlayers().forEach(pl -> send(pl, placeholders));
-        send(Bukkit.getConsoleSender(), placeholders);
+    @Override
+    public @NotNull Collection<CommandSender> getAllReceivers() {
+        List<CommandSender> senders = new ArrayList<>();
+        senders.add(Bukkit.getConsoleSender());
+        senders.addAll(Bukkit.getOnlinePlayers());
+        return senders;
     }
-
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/value/ConfiguredTitle.java

@@ -87,15 +87,15 @@ public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
         }
     }
 
-    public void sendAll(Object... values) {
-        sendAll(this.params, values);
+    public void sendToAll(Object... values) {
+        sendToAll(this.params, values);
     }
 
-    public void sendAll(@NotNull String[] params, @NotNull Object[] values) {
-        sendAll(ParamsUtils.buildParams(params, values));
+    public void sendToAll(@NotNull String[] params, @NotNull Object[] values) {
+        sendToAll(ParamsUtils.buildParams(params, values));
     }
 
-    public void sendAll(@NotNull Map<String, Object> placeholders) {
+    public void sendToAll(@NotNull Map<String, Object> placeholders) {
         TitleConfig config = get();
         if (config == null) return;
 

platform/bungee/pom.xml

@@ -5,19 +5,22 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>2.1.0</version>
+        <version>2.3.3</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>mineconfiguration-bungee</artifactId>
     <packaging>jar</packaging>
 
     <name>MineConfiguration-Bungee</name>
-    
+    <description>轻松(做)配置，适用于BungeeCord的版本，可用JSON与YAML格式。</description>
+
     <dependencies>
 
         <dependency>

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/builder/message/BungeeMessageBuilder.java

@@ -1,8 +1,8 @@
 package cc.carm.lib.mineconfiguration.bungee.builder.message;
 
+import cc.carm.lib.easyplugin.utils.ColorParser;
 import cc.carm.lib.mineconfiguration.bungee.data.MessageText;
 import cc.carm.lib.mineconfiguration.common.builder.message.MessageConfigBuilder;
-import cc.carm.lib.mineconfiguration.common.utils.ColorParser;
 import net.md_5.bungee.api.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/value/ConfiguredMessage.java

@@ -1,17 +1,18 @@
 package cc.carm.lib.mineconfiguration.bungee.value;
 
+import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import cc.carm.lib.mineconfiguration.bungee.BungeeConfigValue;
 import cc.carm.lib.mineconfiguration.bungee.builder.message.BungeeMessageValueBuilder;
 import cc.carm.lib.mineconfiguration.bungee.data.MessageText;
 import cc.carm.lib.mineconfiguration.common.value.ConfigMessage;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import net.md_5.bungee.api.CommandSender;
 import net.md_5.bungee.api.ProxyServer;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.List;
-import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 
@@ -43,9 +44,11 @@ public class ConfiguredMessage<M> extends ConfigMessage<M, MessageText, CommandS
     }
 
     @Override
-    public void broadcast(@NotNull Map<String, Object> placeholders) {
-        ProxyServer.getInstance().getPlayers().forEach(pl -> send(pl, placeholders));
-        send(ProxyServer.getInstance().getConsole(), placeholders);
+    public @NotNull Collection<CommandSender> getAllReceivers() {
+        List<CommandSender> senders = new ArrayList<>();
+        senders.add(ProxyServer.getInstance().getConsole());
+        senders.addAll(ProxyServer.getInstance().getPlayers());
+        return senders;
     }
 
 

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/value/ConfiguredMessageList.java

@@ -10,6 +10,8 @@ import net.md_5.bungee.api.ProxyServer;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.List;
 import java.util.Map;
 import java.util.function.BiConsumer;
@@ -38,9 +40,11 @@ public class ConfiguredMessageList<M> extends ConfigMessageList<M, MessageText,
         super(provider, sectionPath, headerComments, inlineComments, MessageText.class, messages, params, messageParser, sendFunction, MessageText::of);
     }
 
-    public void broadcast(@NotNull Map<String, Object> placeholders) {
-        ProxyServer.getInstance().getPlayers().forEach(pl -> send(pl, placeholders));
-        send(ProxyServer.getInstance().getConsole(), placeholders);
+    @Override
+    public @NotNull Collection<CommandSender> getAllReceivers() {
+        List<CommandSender> senders = new ArrayList<>();
+        senders.add(ProxyServer.getInstance().getConsole());
+        senders.addAll(ProxyServer.getInstance().getPlayers());
+        return senders;
     }
-
 }

platform/spigot/pom.xml

@@ -1,67 +0,0 @@
-<?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>
-        <groupId>cc.carm.lib</groupId>
-        <artifactId>mineconfiguration-parent</artifactId>
-        <version>2.1.0</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>
-    </properties>
-
-    <artifactId>mineconfiguration-spigot</artifactId>
-    <packaging>jar</packaging>
-
-    <name>MineConfiguration-Spigot</name>
-
-    <dependencies>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>mineconfiguration-bukkit-base</artifactId>
-            <version>${project.parent.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>org.spigotmc</groupId>
-            <artifactId>spigot-api</artifactId>
-            <version>1.18.2-R0.1-SNAPSHOT</version>
-            <scope>provided</scope>
-        </dependency>
-
-
-        <!--PlaceholderAPI for general placeholder's support-->
-        <dependency>
-            <groupId>me.clip</groupId>
-            <artifactId>placeholderapi</artifactId>
-            <version>2.11.2</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <!--ProtocolLib for general packet's function support-->
-        <dependency>
-            <groupId>com.comphenix.protocol</groupId>
-            <artifactId>ProtocolLib</artifactId>
-            <version>4.8.0</version>
-            <scope>provided</scope>
-        </dependency>
-
-    </dependencies>
-
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-            </plugin>
-        </plugins>
-    </build>
-
-
-</project>

platform/spigot/src/main/java/cc/carm/lib/mineconfiguration/spigot/MineConfiguration.java

@@ -1,42 +0,0 @@
-package cc.carm.lib.mineconfiguration.spigot;
-
-import cc.carm.lib.mineconfiguration.spigot.source.SpigotConfigProvider;
-import org.bukkit.plugin.Plugin;
-
-import java.io.File;
-import java.io.IOException;
-
-public class MineConfiguration {
-
-    public static SpigotConfigProvider from(File file, String source) {
-        SpigotConfigProvider provider = new SpigotConfigProvider(file);
-        try {
-            provider.initializeFile(source);
-            provider.initializeConfig();
-        } catch (IOException e) {
-            e.printStackTrace();
-        }
-        return provider;
-    }
-
-    public static SpigotConfigProvider from(File file) {
-        return from(file, file.getName());
-    }
-
-    public static SpigotConfigProvider from(String fileName) {
-        return from(fileName, fileName);
-    }
-
-    public static SpigotConfigProvider from(String fileName, String source) {
-        return from(new File(fileName), source);
-    }
-
-    public static SpigotConfigProvider from(Plugin plugin, String fileName) {
-        return from(plugin, fileName, fileName);
-    }
-
-    public static SpigotConfigProvider from(Plugin plugin, String fileName, String source) {
-        return from(new File(plugin.getDataFolder(), fileName), source);
-    }
-
-}

platform/spigot/src/main/java/cc/carm/lib/mineconfiguration/spigot/source/SpigotConfigProvider.java

@@ -1,32 +0,0 @@
-package cc.carm.lib.mineconfiguration.spigot.source;
-
-import cc.carm.lib.configuration.core.ConfigInitializer;
-import cc.carm.lib.configuration.core.source.ConfigurationComments;
-import cc.carm.lib.mineconfiguration.bukkit.source.CraftConfigProvider;
-import org.bukkit.configuration.file.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.io.File;
-
-public class SpigotConfigProvider extends CraftConfigProvider {
-
-    public SpigotConfigProvider(@NotNull File file) {
-        super(file);
-    }
-
-    protected SpigotYAMLComments comments = null;
-
-    @Override
-    public void initializeConfig() {
-        this.configuration = YamlConfiguration.loadConfiguration(file);
-        this.comments = new SpigotYAMLComments(configuration);
-        this.initializer = new ConfigInitializer<>(this);
-    }
-
-    @Override
-    public @Nullable ConfigurationComments getComments() {
-        return this.comments;
-    }
-
-}

platform/spigot/src/main/java/cc/carm/lib/mineconfiguration/spigot/source/SpigotYAMLComments.java

@@ -1,48 +0,0 @@
-package cc.carm.lib.mineconfiguration.spigot.source;
-
-import cc.carm.lib.configuration.core.source.ConfigurationComments;
-import org.bukkit.configuration.file.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.util.Collections;
-import java.util.List;
-
-public class SpigotYAMLComments extends ConfigurationComments {
-
-    protected final YamlConfiguration configuration;
-
-    public SpigotYAMLComments(YamlConfiguration configuration) {
-        this.configuration = configuration;
-    }
-
-    @Override
-    public void setHeaderComments(@Nullable String path, @Nullable List<String> comments) {
-        if (path == null) {
-            this.configuration.options().setHeader(comments);
-        } else {
-            this.configuration.setComments(path, comments);
-        }
-    }
-
-    @Override
-    public void setInlineComment(@NotNull String path, @Nullable String comment) {
-        if (comment == null) {
-            this.configuration.setInlineComments(path, null);
-        } else {
-            this.configuration.setComments(path, Collections.singletonList(comment));
-        }
-    }
-
-    @Override
-    public @Nullable @Unmodifiable List<String> getHeaderComment(@Nullable String path) {
-        if (path == null) return Collections.unmodifiableList(this.configuration.options().getHeader());
-        else return this.configuration.getComments(path);
-    }
-
-    @Override
-    public @Nullable String getInlineComment(@NotNull String path) {
-        return String.join(" ", this.configuration.getInlineComments(path));
-    }
-}

pom.xml

@@ -9,18 +9,19 @@
         <maven.compiler.target>${project.jdk.version}</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
+
+        <deps.easyconfifuration.version>3.3.3</deps.easyconfifuration.version>
+        <deps.easyplugin.version>1.5.2</deps.easyplugin.version>
     </properties>
 
     <groupId>cc.carm.lib</groupId>
     <artifactId>mineconfiguration-parent</artifactId>
-    <version>2.1.0</version>
+    <version>2.3.3</version>
     <packaging>pom</packaging>
     <modules>
         <module>common</module>
-
         <module>platform/bungee</module>
         <module>platform/bukkit</module>
-        <module>platform/spigot</module>
     </modules>
 
     <name>MineConfiguration</name>
@@ -38,7 +39,7 @@
     </developers>
 
     <scm>
-        <connection>scm:git:git@github.com:CarmJos/Easy.MineConfiguration</connection>
+        <connection>scm:git:git@github.com:CarmJos/MineConfiguration</connection>
         <developerConnection>scm:git:git@github.com:CarmJos/MineConfiguration.git</developerConnection>
         <url>https://github.com/CarmJos/MineConfiguration</url>
         <tag>HEAD</tag>
@@ -107,7 +108,7 @@
         <dependency>
             <groupId>org.jetbrains</groupId>
             <artifactId>annotations</artifactId>
-            <version>23.0.0</version>
+            <version>24.0.0</version>
             <scope>provided</scope>
         </dependency>
 
@@ -171,7 +172,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-jar-plugin</artifactId>
-                <version>3.2.2</version>
+                <version>3.3.0</version>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
@@ -194,7 +195,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.4.1</version>
+                    <version>3.5.0</version>
                     <configuration>
                         <classifier>javadoc</classifier>
                         <detectJavaApiLink>false</detectJavaApiLink>
@@ -223,7 +224,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.3.0</version>
+                    <version>3.4.1</version>
                     <executions>
                         <execution>
                             <phase>package</phase>