feat(send): 提供物品预备方法，方便插入lore、修改附魔、flags等

Bumps [cc.carm.lib:easyplugin-color](https://github.com/CarmJos/EasyPlugin) from 1.5.6 to 1.5.7.
- [Release notes](https://github.com/CarmJos/EasyPlugin/releases)
- [Commits](https://github.com/CarmJos/EasyPlugin/compare/1.5.6...1.5.7)

---
updated-dependencies:
- dependency-name: cc.carm.lib:easyplugin-color
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

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

.doc/javadoc/JAVADOC-README.md

@@ -0,0 +1,9 @@
+# MineConfiguration Javadoc
+
+基于 [Github Pages](https://pages.github.com/) 搭建，请访问 [JavaDoc](https://carmjos.github.io/MineConfiguration) 。
+
+## 如何实现？
+
+若您也想通过 [Github Actions](https://docs.github.com/en/actions/learn-github-actions) 
+自动部署项目的Javadoc到 [Github Pages](https://pages.github.com/) ，
+可以参考我的文章 [《自动部署Javadoc到Github Pages》](https://pages.carm.cc/doc/javadoc-in-github.html) 。

.github/workflows/deploy.yml

@@ -12,7 +12,7 @@ on:
 
 jobs:
   gh-deploy:
-    name: "Publish Project (GitHub)"
+    name: "Deploy Project (GitHub)"
     runs-on: ubuntu-latest
 
     steps:
@@ -37,7 +37,7 @@ jobs:
           MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
 
   central-deploy:
-    name: "Deploy Project (Central Repository)"
+    name: "Deploy Project (Central)"
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
@@ -58,4 +58,4 @@ jobs:
         env:
           MAVEN_USERNAME: ${{ secrets.OSSRH_USER }}
           MAVEN_PASSWORD: ${{ secrets.OSSRH_PASS }}
-          MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}
+          MAVEN_GPG_PASSPHRASE: ${{ secrets.MAVEN_GPG_PASSPHRASE }}

.github/workflows/javadoc.yml

@@ -0,0 +1,74 @@
+name: "Publish Javadoc"
+
+on:
+  # 支持手动触发构建
+  workflow_dispatch:
+  release:
+    # 创建release的时候触发
+    types: [ published ]
+
+
+jobs:
+
+  javadoc-deploy:
+    name: "Deploy Javadoc (Github Pages)"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: "Set up JDK"
+        uses: actions/setup-java@v2
+        with:
+          java-version: '8'
+          distribution: 'adopt'
+          cache: maven
+
+      - name: "Generate Javadoc"
+        run: mvn -B javadoc:aggregate --file pom.xml -DskipTests
+
+      - name: "Copy Javadoc"
+        run: |
+          rm -rf docs
+          mkdir -vp docs
+          cp -vrf target/site/apidocs/* docs/
+          cp -vrf .doc/javadoc/JAVADOC-README.md docs/README.md
+
+      - name: "Generate Sitemap"
+        id: sitemap
+        uses: cicirello/generate-sitemap@v1
+        with:
+          base-url-path: https://${{ github.repository_owner }}.github.io/${{ github.event.repository.name }}
+          path-to-root: docs
+
+      - name: Output stats
+        run: |
+          echo "sitemap-path = ${{ steps.sitemap.outputs.sitemap-path }}"
+          echo "url-count = ${{ steps.sitemap.outputs.url-count }}"
+          echo "excluded-count = ${{ steps.sitemap.outputs.excluded-count }}"
+          ls -l docs
+
+      - name: Configure Git
+        env:
+          DEPLOY_PRI: ${{secrets.DEPLOY_PRI}}
+        run: |
+          sudo timedatectl set-timezone "Asia/Shanghai"
+          mkdir -p ~/.ssh/
+          echo "$DEPLOY_PRI" > ~/.ssh/id_rsa
+          chmod 600 ~/.ssh/id_rsa
+          ssh-keyscan github.com >> ~/.ssh/known_hosts
+          git config --global user.name '${{ github.repository_owner }}'
+          git config --global user.email '${{ github.repository_owner }}@users.noreply.github.com'
+
+      - name: Commit documentation changes
+        run: |
+          echo "Committing changes to git@github.com:${{ github.repository_owner }}/${{ github.event.repository.name }}.git ..."
+          cd docs
+          git init
+          git remote add origin git@github.com:${{ github.repository_owner }}/${{ github.event.repository.name }}.git
+          git checkout -b gh-pages
+          git add -A
+          git commit -m "API Document generated."
+
+      - name: Javadoc Website Push
+        run: |
+          cd docs
+          git push origin HEAD:gh-pages --force

README.md

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

bukkit/pom.xml

@@ -1,78 +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-parent</artifactId>
-        <groupId>cc.carm.lib</groupId>
-        <version>1.3.2</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
-    <properties>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
-    </properties>
-    <artifactId>mineconfiguration-bukkit</artifactId>
-    <packaging>jar</packaging>
-
-    <dependencies>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
-            <version>${easyconfiguration.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>mineconfiguration-craftbukkit</artifactId>
-            <version>${project.parent.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>org.bukkit</groupId>
-            <artifactId>bukkit</artifactId>
-            <version>1.8.8-R0.1-SNAPSHOT</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>me.clip</groupId>
-            <artifactId>placeholderapi</artifactId>
-            <version>2.11.1</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <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-compiler-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-            </plugin>
-        </plugins>
-    </build>
-
-</project>

bukkit/src/main/java/cc/carm/lib/configuration/MineConfiguration.java

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

bukkit/src/main/java/cc/carm/lib/configuration/bukkit/source/BukkitConfigProvider.java

@@ -1,79 +0,0 @@
-package cc.carm.lib.configuration.bukkit.source;
-
-import cc.carm.lib.configuration.core.ConfigInitializer;
-import cc.carm.lib.configuration.craft.source.CraftConfigProvider;
-import cc.carm.lib.configuration.craft.source.CraftSectionWrapper;
-import org.bukkit.configuration.file.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.io.BufferedWriter;
-import java.io.File;
-import java.io.StringWriter;
-import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
-import java.nio.file.Path;
-import java.util.List;
-
-public class BukkitConfigProvider extends CraftConfigProvider {
-
-    protected static final char SEPARATOR = '.';
-
-    protected BukkitYAMLComments bukkitComments = new BukkitYAMLComments();
-
-    public BukkitConfigProvider(@NotNull File file) {
-        super(file);
-    }
-
-    public void initializeConfig() {
-        this.configuration = YamlConfiguration.loadConfiguration(file);
-        this.initializer = new ConfigInitializer<>(this);
-    }
-
-    @Override
-    public @NotNull CraftSectionWrapper getConfiguration() {
-        return CraftSectionWrapper.of(this.configuration);
-    }
-
-    @Override
-    public void reload() throws Exception {
-        configuration.load(getFile());
-    }
-
-    @Override
-    public void save() throws Exception {
-        configuration.save(getFile());
-
-        StringWriter writer = new StringWriter();
-        this.bukkitComments.writeComments(configuration, new BufferedWriter(writer));
-        String value = writer.toString(); // config contents
-
-        Path toUpdatePath = getFile().toPath();
-        if (!value.equals(new String(Files.readAllBytes(toUpdatePath), StandardCharsets.UTF_8))) {
-            Files.write(toUpdatePath, value.getBytes(StandardCharsets.UTF_8));
-        }
-    }
-
-    @Override
-    public void setHeaderComment(@Nullable String path, @Nullable List<String> comments) {
-        this.bukkitComments.setHeaderComments(path, comments);
-    }
-
-    @Override
-    public void setInlineComment(@NotNull String path, @Nullable String comment) {
-        this.bukkitComments.setInlineComment(path, comment);
-    }
-
-    @Override
-    @Nullable
-    @Unmodifiable
-    public List<String> getHeaderComment(@Nullable String path) {
-        return this.bukkitComments.getHeaderComment(path);
-    }
-
-    @Override
-    public @Nullable String getInlineComment(@NotNull String path) {
-        return this.bukkitComments.getInlineComment(path);
-    }
-}

bukkit/src/main/java/cc/carm/lib/configuration/bukkit/source/BukkitYAMLComments.java

@@ -1,148 +0,0 @@
-package cc.carm.lib.configuration.bukkit.source;
-
-import org.bukkit.configuration.ConfigurationSection;
-import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.configuration.file.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.io.BufferedWriter;
-import java.io.IOException;
-import java.util.*;
-import java.util.stream.Collectors;
-import java.util.stream.IntStream;
-
-import static cc.carm.lib.configuration.craft.source.CraftConfigProvider.SEPARATOR;
-
-public class BukkitYAMLComments {
-
-    protected final @NotNull Map<String, List<String>> headerComments = new HashMap<>();
-    protected final @NotNull Map<String, String> inlineComments = new HashMap<>();
-
-    protected @NotNull Map<String, List<String>> getHeaderComments() {
-        return headerComments;
-    }
-
-    protected @NotNull Map<String, String> getInlineComments() {
-        return inlineComments;
-    }
-
-    public void setHeaderComments(@Nullable String path, @Nullable List<String> comments) {
-
-        if (comments == null) {
-            getHeaderComments().remove(path);
-        } else {
-            getHeaderComments().put(path, comments);
-        }
-    }
-
-
-    public void setInlineComment(@NotNull String path, @Nullable String comment) {
-        if (comment == null) {
-            getInlineComments().remove(path);
-        } else {
-            getInlineComments().put(path, comment);
-        }
-    }
-
-    @Nullable
-    @Unmodifiable
-    public List<String> getHeaderComment(@Nullable String path) {
-        return Optional.ofNullable(getHeaderComments().get(path)).map(Collections::unmodifiableList).orElse(null);
-    }
-
-    public @Nullable String getInlineComment(@NotNull String path) {
-        return getInlineComments().get(path);
-    }
-
-    public @Nullable String buildHeaderComments(@Nullable String path, @NotNull String indents) {
-        List<String> comments = getHeaderComment(path);
-        if (comments == null || comments.size() == 0) return null;
-
-        StringJoiner joiner = new StringJoiner("\n");
-        for (String comment : comments) {
-            if (comment.length() == 0) joiner.add(" ");
-            else joiner.add(indents + "# " + comment);
-        }
-        return joiner + "\n";
-    }
-
-    /**
-     * 从一个文件读取配置并写入注释到某个写入器中。
-     * 该方法的部分源代码借鉴自 tchristofferson/ConfigUpdater 项目。
-     *
-     * @param source 源配置文件
-     * @param writer 配置写入器
-     * @throws IOException 当写入发生错误时抛出
-     */
-    public void writeComments(@NotNull YamlConfiguration source, @NotNull BufferedWriter writer) throws IOException {
-        FileConfiguration temp = new YamlConfiguration(); // 该对象用于临时记录配置内容
-
-        String configHeader = buildHeaderComments(null, "");
-        if (configHeader != null) writer.write(configHeader);
-
-        for (String fullKey : source.getKeys(true)) {
-            Object currentValue = source.get(fullKey);
-
-            String indents = getIndents(fullKey);
-            String headerComments = buildHeaderComments(fullKey, indents);
-            String inlineComment = getInlineComment(fullKey);
-
-            if (headerComments != null) writer.write(headerComments);
-
-            String[] splitFullKey = fullKey.split("[" + SEPARATOR + "]");
-            String trailingKey = splitFullKey[splitFullKey.length - 1];
-
-            if (currentValue instanceof ConfigurationSection) {
-                ConfigurationSection section = (ConfigurationSection) currentValue;
-                writer.write(indents + trailingKey + ":");
-                if (inlineComment != null && inlineComment.length() > 0) {
-                    writer.write(" # " + inlineComment);
-                }
-                if (!section.getKeys(false).isEmpty()) {
-                    writer.write("\n");
-                } else {
-                    writer.write(" {}\n");
-                    if (indents.length() == 0) writer.write("\n");
-                }
-                continue;
-            }
-
-            temp.set(trailingKey, currentValue);
-            String yaml = temp.saveToString();
-            temp.set(trailingKey, null);
-
-            yaml = yaml.substring(0, yaml.length() - 1);
-
-            if (inlineComment != null && inlineComment.length() > 0) {
-                if (yaml.contains("\n")) {
-                    // section为多行内容，需要 InlineComment 加在首行末尾
-                    String[] splitLine = yaml.split("\n", 2);
-                    yaml = splitLine[0] + " # " + inlineComment + "\n" + splitLine[1];
-                } else {
-                    // 其他情况下就直接加载后面就好。
-                    yaml += " # " + inlineComment;
-                }
-            }
-
-            writer.write(indents + yaml.replace("\n", "\n" + indents) + "\n");
-            if (indents.length() == 0) writer.write("\n");
-        }
-
-        writer.close();
-    }
-
-    /**
-     * 得到一个键的缩进。
-     * 该方法的源代码来自 tchristofferson/ConfigUpdater 项目。
-     *
-     * @param key 键
-     * @return 该键的缩进文本
-     */
-    protected static String getIndents(String key) {
-        String[] splitKey = key.split("[" + BukkitConfigProvider.SEPARATOR + "]");
-        return IntStream.range(1, splitKey.length).mapToObj(i -> "  ").collect(Collectors.joining());
-    }
-
-}

bungee/src/main/java/cc/carm/lib/configuration/bungee/data/MessageText.java

@@ -1,35 +0,0 @@
-package cc.carm.lib.configuration.bungee.data;
-
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
-import net.md_5.bungee.api.CommandSender;
-import org.jetbrains.annotations.Contract;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.List;
-import java.util.stream.Collectors;
-
-public class MessageText extends AbstractText<CommandSender> {
-
-    public MessageText(@NotNull String message) {
-        super(CommandSender.class, message);
-    }
-
-    @Contract("!null,-> !null")
-    public static @Nullable MessageText of(@Nullable String message) {
-        if (message == null) return null;
-        else return new MessageText(message);
-    }
-
-    public static @NotNull List<MessageText> of(@Nullable List<String> messages) {
-        if (messages == null || messages.isEmpty()) return new ArrayList<>();
-        else return messages.stream().map(MessageText::of).collect(Collectors.toList());
-    }
-
-    public static @NotNull List<MessageText> of(@NotNull String... messages) {
-        return of(Arrays.asList(messages));
-    }
-
-}

bungee/src/main/java/cc/carm/lib/configuration/bungee/source/BungeeConfigProvider.java

@@ -1,74 +0,0 @@
-package cc.carm.lib.configuration.bungee.source;
-
-import cc.carm.lib.configuration.core.ConfigInitializer;
-import cc.carm.lib.configuration.core.source.impl.FileConfigProvider;
-import net.md_5.bungee.config.Configuration;
-import net.md_5.bungee.config.ConfigurationProvider;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.io.File;
-import java.io.IOException;
-import java.util.List;
-
-public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrapper> {
-
-    protected ConfigurationProvider loader;
-    protected Configuration configuration;
-    protected ConfigInitializer<BungeeConfigProvider> initializer;
-
-    public BungeeConfigProvider(@NotNull File file, ConfigurationProvider loader) {
-        super(file);
-        this.loader = loader;
-    }
-
-    public void initializeConfig() throws IOException {
-        this.configuration = getLoader().load(file);
-        this.initializer = new ConfigInitializer<>(this);
-    }
-
-    @Override
-    public @NotNull BungeeSectionWrapper getConfiguration() {
-        return BungeeSectionWrapper.of(configuration);
-    }
-
-    @Override
-    protected void onReload() throws Exception {
-        this.configuration = getLoader().load(file);
-    }
-
-    @Override
-    public void save() throws Exception {
-        getLoader().save(configuration, file);
-    }
-
-    @Override
-    public void setHeaderComment(@Nullable String path, @Nullable List<String> comments) {
-
-    }
-
-    @Override
-    public void setInlineComment(@NotNull String path, @Nullable String comment) {
-
-    }
-
-    @Override
-    public @Nullable @Unmodifiable List<String> getHeaderComment(@Nullable String path) {
-        return null;
-    }
-
-    @Override
-    public @Nullable String getInlineComment(@NotNull String path) {
-        return null;
-    }
-
-    @Override
-    public @NotNull ConfigInitializer<BungeeConfigProvider> getInitializer() {
-        return this.initializer;
-    }
-
-    public ConfigurationProvider getLoader() {
-        return loader;
-    }
-}

bungee/src/main/java/cc/carm/lib/configuration/bungee/source/BungeeSectionWrapper.java

@@ -1,70 +0,0 @@
-package cc.carm.lib.configuration.bungee.source;
-
-import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import net.md_5.bungee.config.Configuration;
-import org.jetbrains.annotations.Contract;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.*;
-import java.util.stream.Collectors;
-
-public class BungeeSectionWrapper implements ConfigurationWrapper {
-
-    private final Configuration section;
-
-    private BungeeSectionWrapper(@NotNull Configuration section) {
-        this.section = section;
-    }
-
-    @Contract("!null->!null")
-    public static @Nullable BungeeSectionWrapper of(@Nullable Configuration section) {
-        return section == null ? null : new BungeeSectionWrapper(section);
-    }
-
-    @Override
-    public @NotNull Set<String> getKeys(boolean deep) {
-        return new LinkedHashSet<>(section.getKeys());
-    }
-
-    @Override
-    public @NotNull Map<String, Object> getValues(boolean deep) {
-        return section.getKeys().stream()
-                .collect(Collectors.toMap(key -> key, section::get, (a, b) -> b, LinkedHashMap::new));
-    }
-
-    @Override
-    public void set(@NotNull String path, @Nullable Object value) {
-        this.section.set(path, value);
-    }
-
-    @Override
-    public boolean contains(@NotNull String path) {
-        return this.section.contains(path);
-    }
-
-    @Override
-    public @Nullable Object get(@NotNull String path) {
-        return this.section.get(path);
-    }
-
-    @Override
-    public boolean isList(@NotNull String path) {
-        return get(path) instanceof List<?>;
-    }
-
-    @Override
-    public @Nullable List<?> getList(@NotNull String path) {
-        return this.section.getList(path);
-    }
-
-    @Override
-    public boolean isConfigurationSection(@NotNull String path) {
-        return get(path) instanceof Configuration;
-    }
-
-    @Override
-    public @Nullable ConfigurationWrapper getConfigurationSection(@NotNull String path) {
-        return of(this.section.getSection(path));
-    }
-}

common/pom.xml

@@ -5,36 +5,41 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.3.2</version>
+        <version>2.8.2</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <properties>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
+        <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>${project.parent.groupId}</groupId>
+            <groupId>cc.carm.lib</groupId>
             <artifactId>easyconfiguration-core</artifactId>
-            <version>${easyconfiguration.version}</version>
+            <version>${deps.easyconfifuration.version}</version>
             <scope>compile</scope>
         </dependency>
 
         <dependency>
-            <groupId>de.themoep</groupId>
-            <artifactId>minedown</artifactId>
-            <version>1.7.1-SNAPSHOT</version>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>easyplugin-color</artifactId>
+            <version>${deps.easyplugin.version}</version>
             <scope>compile</scope>
-            <optional>true</optional>
         </dependency>
 
+        <!--suppress VulnerableLibrariesLocal -->
         <dependency>
             <groupId>net.md-5</groupId>
             <artifactId>bungeecord-chat</artifactId>
-            <version>1.16-R0.4</version>
+            <version>1.20-R0.1</version>
             <scope>provided</scope>
         </dependency>
 
@@ -43,18 +48,6 @@
 
     <build>
         <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>

common/src/main/java/cc/carm/lib/configuration/minecraft/utils/ColorParser.java

@@ -1,44 +0,0 @@
-package cc.carm.lib.configuration.minecraft.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/configuration/minecraft/value/ConfigMessage.java

@@ -1,75 +0,0 @@
-package cc.carm.lib.configuration.minecraft.value;
-
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
-import cc.carm.lib.configuration.minecraft.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 org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
-import java.util.Map;
-import java.util.function.BiConsumer;
-import java.util.function.BiFunction;
-import java.util.function.Function;
-
-public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
-        extends ConfiguredValue<T> {
-
-    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 Function<String, T> textBuilder;
-
-    public ConfigMessage(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                         @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 Function<String, T> textBuilder) {
-        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.textBuilder = textBuilder;
-    }
-
-    public @Nullable M parse(@Nullable R sender, @Nullable Object... values) {
-        return parse(sender, ParamsUtils.buildParams(params, values));
-    }
-
-    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));
-    }
-
-    protected T buildText(String value) {
-        return textBuilder.apply(value);
-    }
-}

common/src/main/java/cc/carm/lib/mineconfiguration/common/AbstractConfiguration.java

@@ -0,0 +1,51 @@
+package cc.carm.lib.mineconfiguration.common;
+
+import cc.carm.lib.configuration.core.ConfigurationRoot;
+import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import org.jetbrains.annotations.NotNull;
+
+public abstract class AbstractConfiguration<P extends ConfigurationProvider<?>> {
+
+    private final P configProvider;
+    private final P messageProvider;
+
+    protected AbstractConfiguration(@NotNull P configProvider, @NotNull P messageProvider) {
+        this.configProvider = configProvider;
+        this.messageProvider = messageProvider;
+    }
+
+    public void initializeConfig(@NotNull ConfigurationRoot configRoot) {
+        this.configProvider.initialize(configRoot);
+    }
+
+    public void initializeMessage(@NotNull ConfigurationRoot messageRoot) {
+        this.messageProvider.initialize(messageRoot);
+    }
+
+    public void initializeConfig(@NotNull Class<? extends ConfigurationRoot> configRoot) {
+        this.configProvider.initialize(configRoot);
+    }
+
+    public void initializeMessage(@NotNull Class<? extends ConfigurationRoot> messageRoot) {
+        this.messageProvider.initialize(messageRoot);
+    }
+
+    public P getConfigProvider() {
+        return configProvider;
+    }
+
+    public P getMessageProvider() {
+        return messageProvider;
+    }
+
+    public void reload() throws Exception {
+        getConfigProvider().reload();
+        getMessageProvider().reload();
+    }
+
+    public void save() throws Exception {
+        getConfigProvider().save();
+        getMessageProvider().save();
+    }
+
+}

common/src/main/java/cc/carm/lib/mineconfiguration/common/builder/message/MessageConfigBuilder.java

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.minecraft.builder.message;
+package cc.carm.lib.mineconfiguration.common.builder.message;
 
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 

common/src/main/java/cc/carm/lib/mineconfiguration/common/builder/message/MessageListBuilder.java

@@ -1,16 +1,18 @@
-package cc.carm.lib.configuration.minecraft.builder.message;
+package cc.carm.lib.mineconfiguration.common.builder.message;
 
 
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.minecraft.value.ConfigMessageList;
 import cc.carm.lib.configuration.core.builder.CommonConfigBuilder;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import cc.carm.lib.mineconfiguration.common.value.ConfigMessageList;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
+import java.util.Optional;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 import java.util.function.Function;
@@ -67,4 +69,11 @@ public abstract class MessageListBuilder<M, R, T extends AbstractText<R>, B exte
     @Override
     public abstract @NotNull ConfigMessageList<M, T, R> build();
 
+    protected @NotNull ValueManifest<List<T>> buildManifest(@NotNull List<T> emptyValue) {
+        return new ValueManifest<>(
+                this.provider, this.path, this.headerComments, this.inlineComment,
+                Optional.ofNullable(this.defaultValue).orElse(emptyValue)
+        );
+    }
+
 }

common/src/main/java/cc/carm/lib/mineconfiguration/common/builder/message/MessageValueBuilder.java

@@ -1,13 +1,15 @@
-package cc.carm.lib.configuration.minecraft.builder.message;
+package cc.carm.lib.mineconfiguration.common.builder.message;
 
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.minecraft.value.ConfigMessage;
 import cc.carm.lib.configuration.core.builder.CommonConfigBuilder;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import cc.carm.lib.mineconfiguration.common.value.ConfigMessage;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.List;
+import java.util.Optional;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
 import java.util.function.Function;
@@ -64,4 +66,10 @@ public abstract class MessageValueBuilder<M, R, T extends AbstractText<R>, B ext
     @Override
     public abstract @NotNull ConfigMessage<M, T, R> build();
 
+    protected @NotNull ValueManifest<T> buildManifest(@NotNull T emptyValue) {
+        return new ValueManifest<>(
+                this.provider, this.path, this.headerComments, this.inlineComment,
+                Optional.ofNullable(this.defaultValue).orElse(emptyValue)
+        );
+    }
 }

common/src/main/java/cc/carm/lib/mineconfiguration/common/data/AbstractText.java

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.minecraft.data;
+package cc.carm.lib.mineconfiguration.common.data;
 
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -28,16 +28,14 @@ public abstract class AbstractText<R> {
         return this.message;
     }
 
-    public <M> @Nullable M parse(@NotNull BiFunction<@Nullable R, @NotNull String, @NotNull M> parser,
-                                 @Nullable R receiver, @Nullable String[] params, @Nullable Object[] values) {
+    public <M> @NotNull M parse(@NotNull BiFunction<@Nullable R, @NotNull String, @NotNull M> parser,
+                                @Nullable R receiver, @Nullable String[] params, @Nullable Object[] values) {
         return parse(parser, receiver, ParamsUtils.buildParams(params, values));
     }
 
-    public <M> @Nullable M parse(@NotNull BiFunction<@Nullable R, @NotNull String, @NotNull M> parser,
-                                 @Nullable R receiver, @NotNull Map<String, Object> placeholders) {
-        String message = getMessage();
-        if (message.isEmpty()) return null; // No further processing
-        else return parser.apply(receiver, ParamsUtils.setPlaceholders(message, placeholders));
+    public <M> @NotNull M parse(@NotNull BiFunction<@Nullable R, @NotNull String, @NotNull M> parser,
+                                @Nullable R receiver, @NotNull Map<String, Object> placeholders) {
+        return parser.apply(receiver, ParamsUtils.setPlaceholders(message, placeholders));
     }
 
 

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

@@ -1,4 +1,4 @@
-package cc.carm.lib.configuration.minecraft.utils;
+package cc.carm.lib.mineconfiguration.common.utils;
 
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

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

@@ -0,0 +1,157 @@
+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 values 变量值
+     * @return 准备好待发送的消息
+     */
+    default @NotNull PreparedMessage<R, M> prepare(@NotNull Object... values) {
+        return new PreparedMessage<>(this, values);
+    }
+
+    /**
+     * 为某位接收者解析此消息。
+     *
+     * @param receiver     接收者
+     * @param placeholders 消息中的变量与对应参数
+     * @return 解析变量后的消息内容
+     */
+    @Nullable M parse(@Nullable R receiver, @NotNull Map<String, Object> placeholders);
+
+    /**
+     * 为某位接收者解析此消息。
+     *
+     * @param receiver 接收者
+     * @param values   已定变量的对应参数
+     * @return 解析变量后的消息内容
+     */
+    default @Nullable M parse(@Nullable R receiver, @Nullable Object... values) {
+        return parse(receiver, 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

@@ -0,0 +1,99 @@
+package cc.carm.lib.mineconfiguration.common.value;
+
+import cc.carm.lib.configuration.core.function.ConfigValueParser;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+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;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.function.BiConsumer;
+import java.util.function.BiFunction;
+import java.util.function.Function;
+
+public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
+        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> sendFunction;
+
+    protected final @NotNull Function<String, T> textBuilder;
+
+    public ConfigMessage(@NotNull ValueManifest<T> manifest,
+                         @NotNull Class<T> textClazz, @NotNull String[] params,
+                         @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable M> messageParser,
+                         @NotNull BiConsumer<@NotNull R, @NotNull M> sendFunction,
+                         @NotNull Function<String, T> textBuilder) {
+        super(
+                manifest, textClazz,
+                ConfigValueParser.castToString().andThen((s, d) -> textBuilder.apply(s)),
+                AbstractText::getMessage
+        );
+        this.params = params;
+        this.messageParser = messageParser;
+        this.sendFunction = sendFunction;
+        this.textBuilder = textBuilder;
+    }
+
+    @Override
+    public String[] getParams() {
+        return params;
+    }
+
+    @Override
+    public void apply(@NotNull R receiver, @NotNull M message) {
+        sendFunction.accept(receiver, message);
+    }
+
+    protected <N> @Nullable N parseTo(@Nullable R sender, @NotNull Map<String, Object> placeholders,
+                                      @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable N> parser) {
+        T value = get();
+        if (value == null || value.getMessage().isEmpty()) return null;
+        else return value.parse(parser, sender, placeholders);
+    }
+
+    public @Nullable String parseString(@Nullable R sender, @NotNull Map<String, Object> placeholders) {
+        return parseTo(sender, placeholders, (r, s) -> s);
+    }
+
+    @Override
+    public @Nullable M parse(@Nullable R sender, @NotNull Map<String, Object> placeholders) {
+        return parseTo(sender, placeholders, this.messageParser);
+    }
+
+    public void set(@Nullable String value) {
+        this.set(value == null ? null : buildText(value));
+    }
+
+    protected T buildText(String value) {
+        return textBuilder.apply(value);
+    }
+
+    public abstract class PreparedMessage<P, N> {
+
+        protected final @NotNull Object[] values;
+
+        protected PreparedMessage(@NotNull Object[] values) {
+            this.values = values;
+        }
+
+        public Object[] getValues() {
+            return values;
+        }
+
+        public abstract void to(P receiver);
+
+        public void to(Collection<P> receivers) {
+            receivers.forEach(this::to);
+        }
+
+        public N get(P receiver) {
+            return null;
+        }
+
+    }
+
+}

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

@@ -1,10 +1,10 @@
-package cc.carm.lib.configuration.minecraft.value;
+package cc.carm.lib.mineconfiguration.common.value;
 
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
 import cc.carm.lib.configuration.core.function.ConfigDataFunction;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
 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 +16,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;
@@ -24,16 +25,15 @@ public abstract class ConfigMessageList<M, T extends AbstractText<R>, R> extends
 
     protected final @NotNull Function<String, T> textBuilder;
 
-    @SuppressWarnings("NullableProblems")
-    public ConfigMessageList(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                             @Nullable List<String> headerComments, @Nullable String inlineComments,
-                             @NotNull Class<T> textClazz, @NotNull List<T> messages, @NotNull String[] params,
+    public ConfigMessageList(@NotNull ValueManifest<List<T>> manifest,
+                             @NotNull Class<T> textClazz, @NotNull String[] params,
                              @NotNull BiFunction<@Nullable R, @NotNull String, @Nullable M> messageParser,
                              @NotNull BiConsumer<@NotNull R, @NotNull List<M>> sendFunction,
                              @NotNull Function<String, @NotNull T> textBuilder) {
         super(
-                provider, sectionPath, headerComments, inlineComments, textClazz, messages,
-                ConfigDataFunction.castToString().andThen(textBuilder::apply), AbstractText::getMessage
+                manifest, textClazz,
+                ConfigDataFunction.castToString().andThen(textBuilder::apply),
+                AbstractText::getMessage
         );
         this.params = params;
         this.messageParser = messageParser;
@@ -41,49 +41,65 @@ 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 @Nullable M parseToLine(@Nullable R receiver, @NotNull Object... values) {
+        return parseToLine(receiver, "\n", ParamsUtils.buildParams(this.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 @Nullable M parseToLine(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
+        return parseToLine(receiver, "\n", placeholders);
     }
 
-    public void broadcast(@Nullable Object... values) {
-        broadcast(ParamsUtils.buildParams(params, values));
-    }
+    public @Nullable M parseToLine(@Nullable R receiver, @NotNull String delimiter, @NotNull Map<String, Object> placeholders) {
+        List<T> list = get();
+        if (list.isEmpty()) return null;
 
-    public abstract void broadcast(@NotNull Map<String, Object> placeholders);
+        List<String> messages = list.stream().map(T::getMessage).collect(Collectors.toList());
+        if (String.join("", messages).isEmpty()) return null;
+
+        String combined = String.join(delimiter, messages);
+        T text = textBuilder.apply(combined);
+
+        return text.parse(this.messageParser, receiver, placeholders);
+    }
 
     public void setMessages(@NotNull String... values) {
         setMessages(values.length == 0 ? null : Arrays.asList(values));
     }
 
     public void setMessages(@Nullable List<String> values) {
-        if (values == null || values.isEmpty()) {
+        if (values == null) {
             set(null);
         } else {
             set(buildText(values));
         }
-
     }
 
     protected List<T> buildText(List<String> values) {

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

@@ -0,0 +1,48 @@
+package cc.carm.lib.mineconfiguration.common.value;
+
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+public class PreparedMessage<R, M> {
+
+    protected final @NotNull BaseMessage<R, M> message;
+    protected final @NotNull Object[] values;
+
+    protected PreparedMessage(@NotNull BaseMessage<R, M> message, @NotNull Object[] values) {
+        this.message = message;
+        this.values = values;
+    }
+
+    /**
+     * 为某位接收者解析此消息。
+     *
+     * @param receiver 接收者
+     * @return 解析变量后的消息内容
+     */
+    public @Nullable M parse(@Nullable R receiver) {
+        return message.parse(receiver, values);
+    }
+
+    /**
+     * 向某位接收者发送消息
+     *
+     * @param receiver 消息的接收者
+     */
+    public void to(@Nullable R receiver) {
+        message.send(receiver, values);
+    }
+
+    /**
+     * 向某位接收者发送消息
+     *
+     * @param receivers 消息的接收者们
+     */
+    public void to(@NotNull Iterable<R> receivers) {
+        receivers.forEach(this::to);
+    }
+
+    public void toAll() {
+        to(message.getAllReceivers());
+    }
+
+}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/data/ItemConfig.java

@@ -1,105 +0,0 @@
-package cc.carm.lib.configuration.craft.data;
-
-import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import cc.carm.lib.configuration.craft.utils.TextParser;
-import org.bukkit.Material;
-import org.bukkit.entity.Player;
-import org.bukkit.inventory.ItemStack;
-import org.bukkit.inventory.meta.ItemMeta;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.*;
-
-public class ItemConfig {
-
-    protected @NotNull Material type;
-    protected short data;
-    protected @Nullable String name;
-    protected @NotNull List<String> lore;
-
-    public ItemConfig(@NotNull Material type, short damage,
-                      @Nullable String name, @NotNull List<String> lore) {
-        this.type = type;
-        this.data = damage;
-        this.name = name;
-        this.lore = lore;
-    }
-
-    public @NotNull Material getType() {
-        return type;
-    }
-
-    public short getData() {
-        return data;
-    }
-
-    public @Nullable String getName() {
-        return name;
-    }
-
-    public @Nullable String getName(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
-        return Optional.ofNullable(getName())
-                .map(name -> TextParser.parseText(player, name, placeholders))
-                .orElse(null);
-    }
-
-    public @NotNull List<String> getLore() {
-        return lore;
-    }
-
-    public @Nullable List<String> getLore(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
-        if (getLore().isEmpty()) return null;
-        else return TextParser.parseList(player, getLore(), placeholders);
-    }
-
-    public final @NotNull ItemStack getItemStack() {
-        return getItemStack(1);
-    }
-
-    public @NotNull ItemStack getItemStack(int amount) {
-        return getItemStack(null, amount, new HashMap<>());
-    }
-
-    public @NotNull ItemStack getItemStack(@Nullable Player player) {
-        return getItemStack(player, new HashMap<>());
-    }
-
-    public @NotNull ItemStack getItemStack(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
-        return getItemStack(player, 1, placeholders);
-    }
-
-    public @NotNull ItemStack getItemStack(@Nullable Player player, int amount, @NotNull Map<String, Object> placeholders) {
-        ItemStack item = new ItemStack(type, amount, data);
-        ItemMeta meta = item.getItemMeta();
-        if (meta == null) return item;
-        Optional.ofNullable(getName(player, placeholders)).ifPresent(meta::setDisplayName);
-        Optional.ofNullable(getLore(player, placeholders)).ifPresent(meta::setLore);
-        item.setItemMeta(meta);
-        return item;
-    }
-
-    public @NotNull Map<String, Object> serialize() {
-        Map<String, Object> map = new LinkedHashMap<>();
-        map.put("type", type.name());
-        if (this.data != 0) map.put("data", data);
-        if (name != null) map.put("name", name);
-        if (!lore.isEmpty()) map.put("lore", lore);
-
-        return map;
-    }
-
-    public static @NotNull ItemConfig deserialize(@NotNull ConfigurationWrapper section) throws Exception {
-        String typeName = section.getString("type");
-        if (typeName == null) throw new NullPointerException("Item type name is null");
-
-        Material type = Material.matchMaterial(typeName);
-        if (type == null) throw new Exception("Invalid material name: " + typeName);
-        else return new ItemConfig(
-                type, section.getShort("data", (short) 0),
-                section.getString("name"),
-                section.getStringList("lore")
-        );
-    }
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/data/TitleConfig.java

@@ -1,68 +0,0 @@
-package cc.carm.lib.configuration.craft.data;
-
-import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import cc.carm.lib.configuration.craft.function.TitleSendConsumer;
-import cc.carm.lib.configuration.craft.utils.TextParser;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Range;
-
-import java.util.LinkedHashMap;
-import java.util.Map;
-import java.util.Optional;
-
-public class TitleConfig {
-
-    public static @NotNull TitleConfig of(@Nullable String line1, @Nullable String line2) {
-        return of(
-                Optional.ofNullable(line1).map(TextConfig::of).orElse(null),
-                Optional.ofNullable(line2).map(TextConfig::of).orElse(null)
-        );
-    }
-
-    public static @NotNull TitleConfig of(@Nullable TextConfig line1, @Nullable TextConfig line2) {
-        return new TitleConfig(line1, line2);
-    }
-
-    protected @Nullable TextConfig line1;
-    protected @Nullable TextConfig line2;
-
-    protected TitleConfig(@Nullable TextConfig line1, @Nullable TextConfig line2) {
-        this.line1 = line1;
-        this.line2 = line2;
-    }
-
-    public void send(@NotNull Player player,
-                     @Range(from = 0L, to = Long.MAX_VALUE) int fadeIn,
-                     @Range(from = 0L, to = Long.MAX_VALUE) int stay,
-                     @Range(from = 0L, to = Long.MAX_VALUE) int fadeOut,
-                     @NotNull Map<String, Object> placeholders,
-                     @Nullable TitleSendConsumer sendConsumer) {
-        if (this.line1 == null && this.line2 == null) return;
-        if (sendConsumer == null) return;
-        sendConsumer.send(
-                player, fadeIn, stay, fadeOut,
-                parseLine(this.line1, player, placeholders),
-                parseLine(this.line2, player, placeholders)
-        );
-    }
-
-    protected @NotNull String parseLine(@Nullable TextConfig text,
-                                        @NotNull Player player, @NotNull Map<String, Object> placeholders) {
-        if (text == null) return "";
-        else return TextParser.parseText(player, text.getMessage(), placeholders);
-    }
-
-    public @NotNull Map<String, Object> serialize() {
-        Map<String, Object> map = new LinkedHashMap<>();
-        if (this.line1 != null) map.put("line1", this.line1.getMessage());
-        if (this.line2 != null) map.put("line2", this.line2.getMessage());
-        return map;
-    }
-
-    public static @NotNull TitleConfig deserialize(@NotNull ConfigurationWrapper section) {
-        return of(section.getString("line1"), section.getString("line2"));
-    }
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/function/TitleSendConsumer.java

@@ -1,26 +0,0 @@
-package cc.carm.lib.configuration.craft.function;
-
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Range;
-
-@FunctionalInterface
-public interface TitleSendConsumer {
-
-    /**
-     * 向目标玩家发送标题文字
-     *
-     * @param player  目标玩家
-     * @param fadeIn  淡入时间 (ticks)
-     * @param stay    保留时间 (ticks)
-     * @param fadeOut 淡出时间 (ticks)
-     * @param line1   第一行文字
-     * @param line2   第二行文字
-     */
-    void send(@NotNull Player player,
-              @Range(from = 0L, to = Integer.MAX_VALUE) int fadeIn,
-              @Range(from = 0L, to = Integer.MAX_VALUE) int stay,
-              @Range(from = 0L, to = Integer.MAX_VALUE) int fadeOut,
-              @NotNull String line1, @NotNull String line2);
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/utils/ProtocolLibHelper.java

@@ -1,41 +0,0 @@
-package cc.carm.lib.configuration.craft.utils;
-
-import com.comphenix.protocol.PacketType;
-import com.comphenix.protocol.ProtocolLibrary;
-import com.comphenix.protocol.ProtocolManager;
-import com.comphenix.protocol.events.PacketContainer;
-import com.comphenix.protocol.wrappers.EnumWrappers;
-import com.comphenix.protocol.wrappers.WrappedChatComponent;
-import org.bukkit.entity.Player;
-
-public class ProtocolLibHelper {
-
-    @SuppressWarnings("deprecation")
-    public static void sendTitle(Player player, long fadeIn, long stay, long fadeOut, String line1, String line2) throws Exception {
-        ProtocolManager pm = ProtocolLibrary.getProtocolManager();
-
-        if (line1 != null) {
-            PacketContainer packet = pm.createPacket(PacketType.Play.Server.TITLE);
-            packet.getTitleActions().write(0, EnumWrappers.TitleAction.TITLE);
-            packet.getChatComponents().write(0, WrappedChatComponent.fromText(line1));
-            pm.sendServerPacket(player, packet, false);
-        }
-
-        if (line2 != null) {
-            PacketContainer packet = pm.createPacket(PacketType.Play.Server.TITLE);
-            packet.getTitleActions().write(0, EnumWrappers.TitleAction.SUBTITLE);
-            packet.getChatComponents().write(0, WrappedChatComponent.fromText(line2));
-            pm.sendServerPacket(player, packet, false);
-        }
-
-        PacketContainer timePacket = pm.createPacket(PacketType.Play.Server.TITLE);
-        timePacket.getTitleActions().write(0, EnumWrappers.TitleAction.TIMES);
-        timePacket.getIntegers()
-                .write(0, Math.toIntExact(fadeIn))
-                .write(1, Math.toIntExact(stay))
-                .write(2, Math.toIntExact(fadeOut));
-        pm.sendServerPacket(player, timePacket, false);
-
-    }
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/value/ConfiguredItem.java

@@ -1,71 +0,0 @@
-package cc.carm.lib.configuration.craft.value;
-
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.core.function.ConfigValueParser;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import cc.carm.lib.configuration.core.value.type.ConfiguredSection;
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.builder.item.ItemConfigBuilder;
-import cc.carm.lib.configuration.craft.data.ItemConfig;
-import org.bukkit.entity.Player;
-import org.bukkit.inventory.ItemStack;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-
-public class ConfiguredItem extends ConfiguredSection<ItemConfig> {
-
-    public static ItemConfigBuilder create() {
-        return CraftConfigValue.builder().createItem();
-    }
-
-    public static ConfiguredItem of() {
-        return CraftConfigValue.builder().ofItem();
-    }
-
-    public static ConfiguredItem of(@Nullable ItemConfig defaultItem) {
-        return CraftConfigValue.builder().ofItem(defaultItem);
-    }
-
-    protected final @NotNull String[] params;
-
-    public ConfiguredItem(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                          @Nullable List<String> headerComments, @Nullable String inlineComments,
-                          @Nullable ItemConfig defaultValue, @NotNull String[] params) {
-        super(provider, sectionPath, headerComments, inlineComments, ItemConfig.class, defaultValue, getItemParser(), ItemConfig::serialize);
-        this.params = params;
-    }
-
-    public static ConfigValueParser<ConfigurationWrapper, ItemConfig> getItemParser() {
-        return (s, d) -> ItemConfig.deserialize(s);
-    }
-
-    public @NotNull String[] getParams() {
-        return params;
-    }
-
-    public @Nullable ItemStack getItem(@Nullable Player player) {
-        return getItem(player, 1);
-    }
-
-    public @Nullable ItemStack getItem(@Nullable Player player, int amount) {
-        return getItem(player, amount, new HashMap<>());
-    }
-
-    public @Nullable ItemStack getItem(@Nullable Player player, int amount, @NotNull Object... values) {
-        return getItem(player, amount, ParamsUtils.buildParams(params, values));
-    }
-
-    public @Nullable ItemStack getItem(@Nullable Player player, int amount, @NotNull String[] params, @NotNull Object[] values) {
-        return getItem(player, amount, ParamsUtils.buildParams(params, values));
-    }
-
-    public @Nullable ItemStack getItem(@Nullable Player player, int amount, @NotNull Map<String, Object> placeholders) {
-        return getOptional().map(item -> item.getItemStack(player, amount, placeholders)).orElse(null);
-    }
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/value/ConfiguredMessage.java

@@ -1,52 +0,0 @@
-package cc.carm.lib.configuration.craft.value;
-
-import cc.carm.lib.configuration.minecraft.value.ConfigMessage;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.builder.message.CraftMessageValueBuilder;
-import cc.carm.lib.configuration.craft.data.TextConfig;
-import org.bukkit.Bukkit;
-import org.bukkit.command.CommandSender;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
-import java.util.Map;
-import java.util.function.BiConsumer;
-import java.util.function.BiFunction;
-
-public class ConfiguredMessage<M> extends ConfigMessage<M, TextConfig, CommandSender> {
-
-    @NotNull
-    public static <M> CraftMessageValueBuilder<@Nullable M> create(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser) {
-        return CraftConfigValue.builder().createMessage().asValue(messageParser);
-    }
-
-    public static CraftMessageValueBuilder<String> asString() {
-        return CraftConfigValue.builder().createMessage().asStringValue();
-    }
-
-    public static ConfiguredMessage<String> ofString() {
-        return asString().build();
-    }
-
-    public static ConfiguredMessage<String> ofString(@NotNull String defaultMessage) {
-        return asString().defaults(defaultMessage).build();
-    }
-
-    public ConfiguredMessage(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                             @Nullable List<String> headerComments, @Nullable String inlineComments,
-                             @NotNull TextConfig defaultMessage, @NotNull String[] params,
-                             @NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser,
-                             @NotNull BiConsumer<@NotNull CommandSender, @NotNull M> sendFunction) {
-        super(provider, sectionPath, headerComments, inlineComments, TextConfig.class, defaultMessage, params, messageParser, sendFunction, TextConfig::of);
-    }
-
-    @Override
-    public void broadcast(@NotNull Map<String, Object> placeholders) {
-        Bukkit.getOnlinePlayers().forEach(pl -> send(pl, placeholders));
-        send(Bukkit.getConsoleSender(), placeholders);
-    }
-
-
-}

craftbukkit/src/main/java/cc/carm/lib/configuration/craft/value/ConfiguredTitle.java

@@ -1,109 +0,0 @@
-package cc.carm.lib.configuration.craft.value;
-
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.core.function.ConfigValueParser;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import cc.carm.lib.configuration.core.value.type.ConfiguredSection;
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.builder.title.TitleConfigBuilder;
-import cc.carm.lib.configuration.craft.data.TitleConfig;
-import cc.carm.lib.configuration.craft.function.TitleSendConsumer;
-import org.bukkit.Bukkit;
-import org.bukkit.entity.Player;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Range;
-
-import java.util.List;
-import java.util.Map;
-
-public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
-
-    public static TitleConfigBuilder create() {
-        return CraftConfigValue.builder().createTitle();
-    }
-
-    public static ConfiguredTitle of(@Nullable String line1, @Nullable String line2) {
-        return create().defaults(line1, line2).build();
-    }
-
-    public static ConfiguredTitle of(@Nullable String line1, @Nullable String line2,
-                                     int fadeIn, int stay, int fadeOut) {
-        return create().defaults(line1, line2).fadeIn(fadeIn).stay(stay).fadeOut(fadeOut).build();
-    }
-
-    protected final @NotNull TitleSendConsumer sendConsumer;
-    protected final @NotNull String[] params;
-
-    protected final int fadeIn;
-    protected final int stay;
-    protected final int fadeOut;
-
-    public ConfiguredTitle(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                           @Nullable List<String> headerComments, @Nullable String inlineComments,
-                           @Nullable TitleConfig defaultValue, @NotNull String[] params,
-                           @NotNull TitleSendConsumer sendConsumer,
-                           int fadeIn, int stay, int fadeOut) {
-        super(provider, sectionPath, headerComments, inlineComments, TitleConfig.class, defaultValue, getTitleParser(), TitleConfig::serialize);
-        this.sendConsumer = sendConsumer;
-        this.params = params;
-        this.fadeIn = fadeIn;
-        this.stay = stay;
-        this.fadeOut = fadeOut;
-    }
-
-    @Range(from = 0L, to = Integer.MAX_VALUE)
-    public int getFadeInTicks() {
-        return fadeIn;
-    }
-
-    @Range(from = 0L, to = Integer.MAX_VALUE)
-    public int getStayTicks() {
-        return stay;
-    }
-
-    @Range(from = 0L, to = Integer.MAX_VALUE)
-    public int getFadeOutTicks() {
-        return fadeOut;
-    }
-
-    public @NotNull TitleSendConsumer getSendConsumer() {
-        return sendConsumer;
-    }
-
-    public void send(@NotNull Player player, Object... values) {
-        send(player, this.params, values);
-    }
-
-    public void send(@NotNull Player player, @NotNull String[] params, @NotNull Object[] values) {
-        send(player, ParamsUtils.buildParams(params, values));
-    }
-
-    public void send(@NotNull Player player, @NotNull Map<String, Object> placeholders) {
-        TitleConfig config = get();
-        if (config != null) {
-            config.send(player, fadeIn, stay, fadeOut, placeholders, sendConsumer);
-        }
-    }
-
-    public void sendAll(Object... values) {
-        sendAll(this.params, values);
-    }
-
-    public void sendAll(@NotNull String[] params, @NotNull Object[] values) {
-        sendAll(ParamsUtils.buildParams(params, values));
-    }
-
-    public void sendAll(@NotNull Map<String, Object> placeholders) {
-        TitleConfig config = get();
-        if (config == null) return;
-
-        Bukkit.getOnlinePlayers().forEach(onlinePlayer -> send(onlinePlayer, placeholders));
-    }
-
-
-    public static ConfigValueParser<ConfigurationWrapper, TitleConfig> getTitleParser() {
-        return (s, d) -> TitleConfig.deserialize(s);
-    }
-}

platform/bukkit/pom.xml

@@ -5,24 +5,23 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.3.2</version>
+        <version>2.8.2</version>
+        <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <properties>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
+        <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-craftbukkit</artifactId>
+    <artifactId>mineconfiguration-bukkit</artifactId>
     <packaging>jar</packaging>
 
-    <dependencies>
+    <name>MineConfiguration-Bukkit</name>
+    <description>轻松(做)配置，适用于Bukkit系服务端的版本。</description>
 
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
-            <version>${easyconfiguration.version}</version>
-            <scope>compile</scope>
-        </dependency>
+    <dependencies>
 
         <dependency>
             <groupId>${project.parent.groupId}</groupId>
@@ -31,24 +30,33 @@
             <scope>compile</scope>
         </dependency>
 
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>yamlcommentwriter</artifactId>
+            <version>${deps.yamlcommentwriter.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>com.github.cryptomorin</groupId>
+            <artifactId>XSeries</artifactId>
+            <version>9.5.0</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <!--suppress VulnerableLibrariesLocal -->
         <dependency>
             <groupId>org.bukkit</groupId>
             <artifactId>bukkit</artifactId>
-            <version>1.8.8-R0.1-SNAPSHOT</version>
+            <version>1.13.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.1</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>com.comphenix.protocol</groupId>
-            <artifactId>ProtocolLib</artifactId>
-            <version>4.8.0</version>
+            <version>2.11.3</version>
             <scope>provided</scope>
         </dependency>
 
@@ -56,18 +64,6 @@
 
     <build>
         <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>

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

@@ -1,14 +1,12 @@
-package cc.carm.lib.configuration.craft;
+package cc.carm.lib.mineconfiguration.bukkit;
 
 import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
 import cc.carm.lib.configuration.core.value.impl.CachedConfigValue;
-import cc.carm.lib.configuration.craft.builder.CraftConfigBuilder;
-import cc.carm.lib.configuration.craft.source.CraftConfigProvider;
-import cc.carm.lib.configuration.craft.source.CraftSectionWrapper;
+import cc.carm.lib.mineconfiguration.bukkit.builder.CraftConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.source.CraftConfigProvider;
+import cc.carm.lib.mineconfiguration.bukkit.source.CraftSectionWrapper;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
 
 public abstract class CraftConfigValue<T> extends CachedConfigValue<T> {
 
@@ -16,16 +14,14 @@ public abstract class CraftConfigValue<T> extends CachedConfigValue<T> {
         return new CraftConfigBuilder();
     }
 
-    public CraftConfigValue(@Nullable CraftConfigProvider provider, @Nullable String sectionPath,
-                            @Nullable List<String> headerComments, @Nullable String inlineComments,
-                            @Nullable T defaultValue) {
-        super(provider, sectionPath, headerComments, inlineComments, defaultValue);
+    protected CraftConfigValue(@NotNull ValueManifest<T> manifest) {
+        super(manifest);
     }
 
     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

@@ -0,0 +1,66 @@
+package cc.carm.lib.mineconfiguration.bukkit;
+
+import cc.carm.lib.configuration.core.ConfigurationRoot;
+import cc.carm.lib.mineconfiguration.bukkit.source.BukkitConfigProvider;
+import cc.carm.lib.mineconfiguration.common.AbstractConfiguration;
+import org.bukkit.plugin.Plugin;
+import org.bukkit.plugin.java.JavaPlugin;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.File;
+import java.io.IOException;
+
+public class MineConfiguration extends AbstractConfiguration<BukkitConfigProvider> {
+
+    public static BukkitConfigProvider from(File file, String source) {
+        BukkitConfigProvider provider = new BukkitConfigProvider(file);
+        try {
+            provider.initializeFile(source);
+            provider.initializeConfig();
+        } catch (IOException e) {
+            e.printStackTrace();
+        }
+        return provider;
+    }
+
+    public static BukkitConfigProvider from(File file) {
+        return from(file, file.getName());
+    }
+
+    public static BukkitConfigProvider from(String fileName) {
+        return from(fileName, fileName);
+    }
+
+    public static BukkitConfigProvider from(String fileName, String source) {
+        return from(new File(fileName), source);
+    }
+
+    public static BukkitConfigProvider from(Plugin plugin, String fileName) {
+        return from(plugin, fileName, fileName);
+    }
+
+    public static BukkitConfigProvider from(Plugin plugin, String fileName, String source) {
+        return from(new File(plugin.getDataFolder(), fileName), source);
+    }
+
+    public MineConfiguration(@NotNull JavaPlugin plugin) {
+        super(from(plugin, "config.yml"), from(plugin, "messages.yml"));
+    }
+
+    public MineConfiguration(@NotNull JavaPlugin plugin,
+                             @NotNull ConfigurationRoot configRoot,
+                             @NotNull ConfigurationRoot messageRoot) {
+        this(plugin);
+        initializeConfig(configRoot);
+        initializeMessage(messageRoot);
+    }
+
+    public MineConfiguration(@NotNull JavaPlugin plugin,
+                             @NotNull Class<? extends ConfigurationRoot> configRoot,
+                             @NotNull Class<? extends ConfigurationRoot> messageRoot) {
+        this(plugin);
+        initializeConfig(configRoot);
+        initializeMessage(messageRoot);
+    }
+
+}

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/AbstractCraftBuilder.java

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.craft.builder;
+package cc.carm.lib.mineconfiguration.bukkit.builder;
 
-import cc.carm.lib.configuration.craft.source.CraftConfigProvider;
+import cc.carm.lib.mineconfiguration.bukkit.source.CraftConfigProvider;
 import cc.carm.lib.configuration.core.builder.AbstractConfigBuilder;
 
 public abstract class AbstractCraftBuilder<T, B extends AbstractCraftBuilder<T, B>>

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/CraftConfigBuilder.java

@@ -1,16 +1,13 @@
-package cc.carm.lib.configuration.craft.builder;
+package cc.carm.lib.mineconfiguration.bukkit.builder;
 
 import cc.carm.lib.configuration.core.builder.ConfigBuilder;
-import cc.carm.lib.configuration.craft.builder.item.ItemConfigBuilder;
-import cc.carm.lib.configuration.craft.builder.message.CraftMessageBuilder;
-import cc.carm.lib.configuration.craft.builder.serializable.SerializableBuilder;
-import cc.carm.lib.configuration.craft.builder.sound.SoundConfigBuilder;
-import cc.carm.lib.configuration.craft.builder.title.TitleConfigBuilder;
-import cc.carm.lib.configuration.craft.data.ItemConfig;
-import cc.carm.lib.configuration.craft.value.ConfiguredItem;
+import cc.carm.lib.mineconfiguration.bukkit.builder.item.ItemConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.builder.message.CraftMessageBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.builder.serializable.SerializableBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.builder.sound.SoundConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.builder.title.TitleConfigBuilder;
 import org.bukkit.configuration.serialization.ConfigurationSerializable;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
 public class CraftConfigBuilder extends ConfigBuilder {
 
@@ -34,12 +31,4 @@ public class CraftConfigBuilder extends ConfigBuilder {
         return new SerializableBuilder<>(valueClass);
     }
 
-    public @NotNull ConfiguredItem ofItem() {
-        return createItem().build();
-    }
-
-    public @NotNull ConfiguredItem ofItem(@Nullable ItemConfig defaultItem) {
-        return createItem().defaults(defaultItem).build();
-    }
-
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/item/ItemConfigBuilder.java

@@ -1,27 +1,32 @@
-package cc.carm.lib.configuration.craft.builder.item;
+package cc.carm.lib.mineconfiguration.bukkit.builder.item;
 
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.craft.builder.AbstractCraftBuilder;
-import cc.carm.lib.configuration.craft.data.ItemConfig;
-import cc.carm.lib.configuration.craft.value.ConfiguredItem;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredItem;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.bukkit.Material;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.List;
-import java.util.Optional;
+import java.util.*;
 import java.util.function.Function;
+import java.util.function.UnaryOperator;
 
-public class ItemConfigBuilder extends AbstractCraftBuilder<ItemConfig, ItemConfigBuilder> {
+public class ItemConfigBuilder extends AbstractCraftBuilder<ItemStack, ItemConfigBuilder> {
 
     protected Material type;
-    protected short data;
-    protected String name;
+    protected short data = 0;
+    protected String name = null;
     protected List<String> lore = new ArrayList<>();
 
-    protected @NotNull String[] params;
+    protected Map<Enchantment, Integer> enchants = new LinkedHashMap<>();
+    protected Set<ItemFlag> flags = new LinkedHashSet<>();
+
+    protected @NotNull String[] params = new String[0];
     protected @NotNull Function<@NotNull String, @NotNull String> paramFormatter = ParamsUtils.DEFAULT_PARAM_FORMATTER;
 
     public ItemConfigBuilder defaults(@NotNull Material type,
@@ -63,7 +68,25 @@ public class ItemConfigBuilder extends AbstractCraftBuilder<ItemConfig, ItemConf
         return this;
     }
 
-    public ItemConfigBuilder formatParam(@NotNull Function<@NotNull String, @NotNull String> paramFormatter) {
+    public ItemConfigBuilder defaultEnchants(@NotNull Map<Enchantment, Integer> enchants) {
+        this.enchants = new LinkedHashMap<>(enchants);
+        return this;
+    }
+
+    public ItemConfigBuilder defaultEnchant(@NotNull Enchantment enchant, int level) {
+        return defaultEnchants(Collections.singletonMap(enchant, level));
+    }
+
+    public ItemConfigBuilder defaultFlags(@NotNull Set<ItemFlag> flags) {
+        this.flags = new LinkedHashSet<>(flags);
+        return this;
+    }
+
+    public ItemConfigBuilder defaultFlags(@NotNull ItemFlag... flags) {
+        return defaultFlags(new LinkedHashSet<>(Arrays.asList(flags)));
+    }
+
+    public ItemConfigBuilder formatParam(@NotNull UnaryOperator<String> paramFormatter) {
         this.paramFormatter = paramFormatter;
         return getThis();
     }
@@ -83,15 +106,30 @@ public class ItemConfigBuilder extends AbstractCraftBuilder<ItemConfig, ItemConf
         return this;
     }
 
-    protected @Nullable ItemConfig buildDefault() {
+    protected @Nullable ItemStack buildDefault() {
         if (this.type == null) return null;
-        else return new ItemConfig(type, data, name, lore);
+
+        ItemStack item = new ItemStack(type, 1, data);
+        ItemMeta meta = item.getItemMeta();
+        if (meta == null) return item;
+
+        Optional.ofNullable(this.name).ifPresent(meta::setDisplayName);
+        Optional.ofNullable(this.lore).ifPresent(meta::setLore);
+        enchants.forEach((enchant, level) -> meta.addEnchant(enchant, level, true));
+        flags.forEach(meta::addItemFlags);
+        item.setItemMeta(meta);
+
+        return item;
     }
 
     @Override
     public @NotNull ConfiguredItem build() {
-        ItemConfig defaultItem = Optional.ofNullable(this.defaultValue).orElse(buildDefault());
-        return new ConfiguredItem(this.provider, this.path, this.headerComments, this.inlineComment, defaultItem, buildParams());
+        return new ConfiguredItem(
+                new ValueManifest<>(
+                        this.provider, this.path, this.headerComments, this.inlineComment,
+                        Optional.ofNullable(this.defaultValue).orElse(buildDefault())
+                ), buildParams()
+        );
     }
 
     protected final String[] buildParams() {

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/message/CraftMessageBuilder.java

@@ -1,8 +1,8 @@
-package cc.carm.lib.configuration.craft.builder.message;
+package cc.carm.lib.mineconfiguration.bukkit.builder.message;
 
-import cc.carm.lib.configuration.minecraft.builder.message.MessageConfigBuilder;
-import cc.carm.lib.configuration.craft.data.TextConfig;
-import cc.carm.lib.configuration.craft.utils.TextParser;
+import cc.carm.lib.mineconfiguration.bukkit.data.TextConfig;
+import cc.carm.lib.mineconfiguration.bukkit.utils.TextParser;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageConfigBuilder;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/message/CraftMessageListBuilder.java

@@ -1,15 +1,14 @@
-package cc.carm.lib.configuration.craft.builder.message;
+package cc.carm.lib.mineconfiguration.bukkit.builder.message;
 
-import cc.carm.lib.configuration.minecraft.builder.message.MessageListBuilder;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.craft.data.TextConfig;
-import cc.carm.lib.configuration.craft.value.ConfiguredMessageList;
+import cc.carm.lib.mineconfiguration.bukkit.data.TextConfig;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredMessageList;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageListBuilder;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.ArrayList;
-import java.util.Optional;
 import java.util.function.BiFunction;
 
 public class CraftMessageListBuilder<M>
@@ -27,8 +26,7 @@ public class CraftMessageListBuilder<M>
     @Override
     public @NotNull ConfiguredMessageList<M> build() {
         return new ConfiguredMessageList<>(
-                this.provider, this.path, this.headerComments, this.inlineComment,
-                Optional.ofNullable(this.defaultValue).orElse(TextConfig.of(new ArrayList<>())),
+                buildManifest(TextConfig.of(new ArrayList<>())),
                 ParamsUtils.formatParams(this.paramFormatter, this.params),
                 this.messageParser, this.sendFunction
         );

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/message/CraftMessageValueBuilder.java

@@ -1,14 +1,13 @@
-package cc.carm.lib.configuration.craft.builder.message;
+package cc.carm.lib.mineconfiguration.bukkit.builder.message;
 
-import cc.carm.lib.configuration.minecraft.builder.message.MessageValueBuilder;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.craft.data.TextConfig;
-import cc.carm.lib.configuration.craft.value.ConfiguredMessage;
+import cc.carm.lib.mineconfiguration.bukkit.data.TextConfig;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredMessage;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageValueBuilder;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.Optional;
 import java.util.function.BiFunction;
 
 public class CraftMessageValueBuilder<M>
@@ -26,8 +25,7 @@ public class CraftMessageValueBuilder<M>
     @Override
     public @NotNull ConfiguredMessage<M> build() {
         return new ConfiguredMessage<>(
-                this.provider, this.path, this.headerComments, this.inlineComment,
-                Optional.ofNullable(this.defaultValue).orElse(TextConfig.of("")),
+                buildManifest(TextConfig.of("")),
                 ParamsUtils.formatParams(this.paramFormatter, this.params),
                 this.messageParser, this.sendHandler
         );

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/serializable/SerializableBuilder.java

@@ -1,7 +1,7 @@
-package cc.carm.lib.configuration.craft.builder.serializable;
+package cc.carm.lib.mineconfiguration.bukkit.builder.serializable;
 
-import cc.carm.lib.configuration.craft.builder.AbstractCraftBuilder;
-import cc.carm.lib.configuration.craft.value.ConfiguredSerializable;
+import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredSerializable;
 import org.bukkit.configuration.serialization.ConfigurationSerializable;
 import org.jetbrains.annotations.NotNull;
 
@@ -21,7 +21,7 @@ public class SerializableBuilder<T extends ConfigurationSerializable>
 
     @Override
     public @NotNull ConfiguredSerializable<T> build() {
-        return new ConfiguredSerializable<>(this.provider, this.path, this.headerComments, this.inlineComment,  this.valueClass, this.defaultValue);
+        return new ConfiguredSerializable<>(buildManifest(), valueClass);
     }
 
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/sound/SoundConfigBuilder.java

@@ -1,8 +1,8 @@
-package cc.carm.lib.configuration.craft.builder.sound;
+package cc.carm.lib.mineconfiguration.bukkit.builder.sound;
 
-import cc.carm.lib.configuration.craft.builder.AbstractCraftBuilder;
-import cc.carm.lib.configuration.craft.data.SoundConfig;
-import cc.carm.lib.configuration.craft.value.ConfiguredSound;
+import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.data.SoundConfig;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredSound;
 import org.bukkit.Sound;
 import org.jetbrains.annotations.NotNull;
 
@@ -40,7 +40,7 @@ public class SoundConfigBuilder extends AbstractCraftBuilder<SoundConfig, SoundC
 
     @Override
     public @NotNull ConfiguredSound build() {
-        return new ConfiguredSound(this.provider, this.path, this.headerComments, this.inlineComment, this.defaultValue);
+        return new ConfiguredSound(buildManifest());
     }
 
 }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/builder/title/TitleConfigBuilder.java

@@ -1,44 +1,30 @@
-package cc.carm.lib.configuration.craft.builder.title;
+package cc.carm.lib.mineconfiguration.bukkit.builder.title;
 
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
-import cc.carm.lib.configuration.craft.builder.AbstractCraftBuilder;
-import cc.carm.lib.configuration.craft.data.TitleConfig;
-import cc.carm.lib.configuration.craft.function.TitleSendConsumer;
-import cc.carm.lib.configuration.craft.utils.ProtocolLibHelper;
-import cc.carm.lib.configuration.craft.value.ConfiguredTitle;
-import org.bukkit.Bukkit;
+import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.data.TitleConfig;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredTitle;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 import org.jetbrains.annotations.Range;
 
 import java.util.List;
 import java.util.function.Function;
+import java.util.function.UnaryOperator;
 
 public class TitleConfigBuilder extends AbstractCraftBuilder<TitleConfig, TitleConfigBuilder> {
 
-    @SuppressWarnings("deprecation")
-    protected static @NotNull TitleSendConsumer DEFAULT_TITLE_CONSUMER = (player, fadeIn, stay, fadeOut, line1, line2) -> {
-        if (Bukkit.getPluginManager().isPluginEnabled("ProtocolLib")) {
-            try {
-                ProtocolLibHelper.sendTitle(player, fadeIn, stay, fadeOut, line1, line2);
-            } catch (Exception ignored) {
-            }
-        } else {
-            player.sendTitle(line1, line2);
-        }
-    };
-
-    protected @NotNull String[] params;
+    protected @NotNull String[] params = new String[0];
 
     protected @Range(from = 0L, to = Integer.MAX_VALUE) int fadeIn = 10;
     protected @Range(from = 0L, to = Integer.MAX_VALUE) int stay = 60;
     protected @Range(from = 0L, to = Integer.MAX_VALUE) int fadeOut = 10;
 
-    protected @NotNull TitleSendConsumer sendConsumer;
+    protected @NotNull ConfiguredTitle.TitleConsumer sendConsumer;
     protected @NotNull Function<@NotNull String, @NotNull String> paramFormatter;
 
     public TitleConfigBuilder() {
-        this.sendConsumer = TitleConfigBuilder.DEFAULT_TITLE_CONSUMER;
+        this.sendConsumer = ConfiguredTitle.DEFAULT_TITLE_CONSUMER;
         this.paramFormatter = ParamsUtils.DEFAULT_PARAM_FORMATTER;
     }
 
@@ -47,7 +33,7 @@ public class TitleConfigBuilder extends AbstractCraftBuilder<TitleConfig, TitleC
         return defaults(TitleConfig.of(line1, line2));
     }
 
-    public @NotNull TitleConfigBuilder whenSend(@NotNull TitleSendConsumer consumer) {
+    public @NotNull TitleConfigBuilder whenSend(@NotNull ConfiguredTitle.TitleConsumer consumer) {
         this.sendConsumer = consumer;
         return this;
     }
@@ -76,7 +62,7 @@ public class TitleConfigBuilder extends AbstractCraftBuilder<TitleConfig, TitleC
         return this;
     }
 
-    public TitleConfigBuilder formatParam(Function<String, String> paramFormatter) {
+    public TitleConfigBuilder formatParam(UnaryOperator<String> paramFormatter) {
         this.paramFormatter = paramFormatter;
         return this;
     }
@@ -89,8 +75,7 @@ public class TitleConfigBuilder extends AbstractCraftBuilder<TitleConfig, TitleC
     @Override
     public @NotNull ConfiguredTitle build() {
         return new ConfiguredTitle(
-                this.provider, this.path, this.headerComments, this.inlineComment,
-                this.defaultValue, ParamsUtils.formatParams(this.paramFormatter, this.params),
+                buildManifest(), ParamsUtils.formatParams(this.paramFormatter, this.params),
                 this.sendConsumer, this.fadeIn, this.stay, this.fadeOut
         );
     }

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/data/ItemConfig.java

@@ -0,0 +1,180 @@
+package cc.carm.lib.mineconfiguration.bukkit.data;
+
+import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
+import cc.carm.lib.mineconfiguration.bukkit.source.CraftSectionWrapper;
+import cc.carm.lib.mineconfiguration.bukkit.utils.TextParser;
+import org.bukkit.Material;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+public class ItemConfig {
+
+    protected @NotNull Material type;
+    protected short data;
+    protected @Nullable String name;
+    protected @NotNull List<String> lore;
+
+    protected @NotNull Map<Enchantment, Integer> enchants;
+    protected @NotNull Set<ItemFlag> flags;
+
+    protected int customModelData = 0;
+
+    public ItemConfig(@NotNull Material type, @Nullable String name) {
+        this(type, name, Collections.emptyList());
+    }
+
+    public ItemConfig(@NotNull Material type, @Nullable String name, @NotNull List<String> lore) {
+        this(type, (short) 0, name, lore);
+    }
+
+    public ItemConfig(@NotNull Material type, short damage,
+                      @Nullable String name, @NotNull List<String> lore) {
+        this(type, damage, name, lore, Collections.emptyMap(), Collections.emptySet());
+    }
+
+    public ItemConfig(@NotNull Material type, short damage,
+                      @Nullable String name, @NotNull List<String> lore,
+                      @NotNull Map<Enchantment, Integer> enchants,
+                      @NotNull Set<ItemFlag> flags) {
+        this.type = type;
+        this.data = damage;
+        this.name = name;
+        this.lore = lore;
+        this.enchants = enchants;
+        this.flags = flags;
+    }
+
+    public @NotNull Material getType() {
+        return type;
+    }
+
+    public short getData() {
+        return data;
+    }
+
+    public @Nullable String getName() {
+        return name;
+    }
+
+    public @Nullable String getName(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
+        return Optional.ofNullable(getName())
+                .map(name -> TextParser.parseText(player, name, placeholders))
+                .orElse(null);
+    }
+
+    public @NotNull List<String> getLore() {
+        return lore;
+    }
+
+    public @Nullable List<String> getLore(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
+        if (getLore().isEmpty()) return null;
+        else return TextParser.parseList(player, getLore(), placeholders);
+    }
+
+    public final @NotNull ItemStack getItemStack() {
+        return getItemStack(1);
+    }
+
+    public @NotNull ItemStack getItemStack(int amount) {
+        return getItemStack(null, amount, new HashMap<>());
+    }
+
+    public @NotNull ItemStack getItemStack(@Nullable Player player) {
+        return getItemStack(player, new HashMap<>());
+    }
+
+    public @NotNull ItemStack getItemStack(@Nullable Player player, @NotNull Map<String, Object> placeholders) {
+        return getItemStack(player, 1, placeholders);
+    }
+
+    public @NotNull ItemStack getItemStack(@Nullable Player player, int amount, @NotNull Map<String, Object> placeholders) {
+        ItemStack item = new ItemStack(type, amount, data);
+        ItemMeta meta = item.getItemMeta();
+        if (meta == null) return item;
+        Optional.ofNullable(getName(player, placeholders)).ifPresent(meta::setDisplayName);
+        Optional.ofNullable(getLore(player, placeholders)).ifPresent(meta::setLore);
+        enchants.forEach((enchant, level) -> meta.addEnchant(enchant, level, true));
+        flags.forEach(meta::addItemFlags);
+        item.setItemMeta(meta);
+        return item;
+    }
+
+    public @NotNull Map<String, Object> serialize() {
+        Map<String, Object> map = new LinkedHashMap<>();
+        map.put("type", type.name());
+        if (this.data != 0) map.put("data", data);
+        if (name != null) map.put("name", name);
+        if (!lore.isEmpty()) map.put("lore", lore);
+
+        Map<String, Integer> enchantments = new LinkedHashMap<>();
+        enchants.forEach((enchant, level) -> {
+            if (level > 0) enchantments.put(enchant.getName(), level);
+        });
+
+        if (!enchantments.isEmpty()) {
+            map.put("enchants", enchantments);
+        }
+
+        if (!flags.isEmpty()) {
+            map.put("flags", flags.stream().map(ItemFlag::name).collect(Collectors.toList()));
+        }
+        return map;
+    }
+
+    public static @NotNull ItemConfig deserialize(@NotNull ConfigurationSection section) throws Exception {
+        return deserialize(CraftSectionWrapper.of(section));
+    }
+
+    public static @NotNull ItemConfig deserialize(@NotNull ConfigurationWrapper<?> section) throws Exception {
+        String typeName = section.getString("type");
+        if (typeName == null) throw new NullPointerException("Item type name is null");
+
+        Material type = Material.matchMaterial(typeName);
+        if (type == null) throw new Exception("Invalid material name: " + typeName);
+
+        short data = section.getShort("data", (short) 0);
+        String name = section.getString("name");
+        List<String> lore = section.getStringList("lore");
+
+        Map<Enchantment, Integer> enchantments = readEnchantments(section.getConfigurationSection("enchants"));
+        Set<ItemFlag> flags = readFlags(section.getStringList("flags"));
+
+        return new ItemConfig(type, data, name, lore, enchantments, flags);
+    }
+
+    private static ItemFlag parseFlag(String flagName) {
+        return Arrays.stream(ItemFlag.values()).filter(flag -> flag.name().equalsIgnoreCase(flagName)).findFirst().orElse(null);
+    }
+
+    private static Set<ItemFlag> readFlags(List<String> flagConfig) {
+        Set<ItemFlag> flags = new LinkedHashSet<>();
+        for (String flagName : flagConfig) {
+            ItemFlag flag = parseFlag(flagName);
+            if (flag != null) flags.add(flag);
+        }
+        return flags;
+    }
+
+    private static Map<Enchantment, Integer> readEnchantments(ConfigurationWrapper<?> section) {
+        Map<Enchantment, Integer> enchantments = new LinkedHashMap<>();
+        if (section == null) return enchantments;
+        section.getKeys(false).forEach(key -> {
+            Enchantment enchantment = Enchantment.getByName(key);
+            int level = section.getInt(key, 0);
+            if (enchantment != null && level > 0) {
+                enchantments.put(enchantment, level);
+            }
+        });
+        return enchantments;
+    }
+
+}

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/data/SoundConfig.java

@@ -1,6 +1,7 @@
-package cc.carm.lib.configuration.craft.data;
+package cc.carm.lib.mineconfiguration.bukkit.data;
 
 import org.bukkit.Bukkit;
+import org.bukkit.Location;
 import org.bukkit.Sound;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.Contract;
@@ -40,6 +41,12 @@ public class SoundConfig {
         player.playSound(player.getLocation(), type, volume, pitch);
     }
 
+    public void playAt(Location location) {
+        if (type == null) return;
+        if (location.getWorld() == null) return;
+        location.getWorld().playSound(location, type, volume, pitch);
+    }
+
     public void playToAll() {
         Bukkit.getOnlinePlayers().forEach(this::playTo);
     }
@@ -85,7 +92,7 @@ public class SoundConfig {
 
     @Contract("null -> null")
     public static @Nullable SoundConfig deserialize(@Nullable String string) throws Exception {
-        if (string == null) return null;
+        if (string == null || string.isEmpty()) return null;
 
         String[] args = string.contains(":") ? string.split(":") : new String[]{string};
         if (args.length < 1) return null;

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/data/TextConfig.java

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.craft.data;
+package cc.carm.lib.mineconfiguration.bukkit.data;
 
-import cc.carm.lib.configuration.minecraft.data.AbstractText;
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.Contract;
 import org.jetbrains.annotations.NotNull;

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/data/TitleConfig.java

@@ -0,0 +1,118 @@
+package cc.carm.lib.mineconfiguration.bukkit.data;
+
+import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
+import cc.carm.lib.mineconfiguration.bukkit.utils.TextParser;
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredTitle;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Range;
+
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Optional;
+
+public class TitleConfig {
+
+    public static @NotNull TitleConfig of(@Nullable String line1, @Nullable String line2) {
+        return of(
+                Optional.ofNullable(line1).map(TextConfig::of).orElse(null),
+                Optional.ofNullable(line2).map(TextConfig::of).orElse(null)
+        );
+    }
+
+    public static @NotNull TitleConfig of(@Nullable TextConfig line1, @Nullable TextConfig line2) {
+        return new TitleConfig(line1, line2);
+    }
+
+    public static @NotNull TitleConfig of(@Nullable String line1, @Nullable String line2,
+                                          int fadeIn, int stay, int fadeOut) {
+        return of(
+                Optional.ofNullable(line1).map(TextConfig::of).orElse(null),
+                Optional.ofNullable(line2).map(TextConfig::of).orElse(null),
+                fadeIn, stay, fadeOut
+        );
+    }
+
+    public static @NotNull TitleConfig of(@Nullable TextConfig line1, @Nullable TextConfig line2,
+                                          int fadeIn, int stay, int fadeOut) {
+        return new TitleConfig(line1, line2, fadeIn, stay, fadeOut);
+    }
+
+    protected @Nullable TextConfig line1;
+    protected @Nullable TextConfig line2;
+
+    protected final int fadeIn;
+    protected final int stay;
+    protected final int fadeOut;
+
+    protected TitleConfig(@Nullable TextConfig line1, @Nullable TextConfig line2) {
+        this(line1, line2, -1, -1, -1);
+    }
+
+    protected TitleConfig(@Nullable TextConfig line1, @Nullable TextConfig line2, int fadeIn, int stay, int fadeOut) {
+        this.line1 = line1;
+        this.line2 = line2;
+        this.fadeIn = fadeIn;
+        this.stay = stay;
+        this.fadeOut = fadeOut;
+    }
+
+    public void send(@NotNull Player player,
+                     @NotNull Map<String, Object> placeholders,
+                     @Nullable ConfiguredTitle.TitleConsumer sendConsumer) {
+        send(
+                player,
+                this.fadeIn < 0 ? 10 : this.fadeIn,
+                this.stay < 0 ? 60 : this.stay,
+                this.fadeOut < 0 ? 10 : this.fadeOut,
+                placeholders,
+                sendConsumer
+        );
+    }
+
+    public void send(@NotNull Player player,
+                     @Range(from = 0L, to = Integer.MAX_VALUE) int fadeIn,
+                     @Range(from = 0L, to = Integer.MAX_VALUE) int stay,
+                     @Range(from = 0L, to = Integer.MAX_VALUE) int fadeOut,
+                     @NotNull Map<String, Object> placeholders,
+                     @Nullable ConfiguredTitle.TitleConsumer sendConsumer) {
+        if (this.line1 == null && this.line2 == null) return;
+        if (sendConsumer == null) return;
+        sendConsumer.send(
+                player, fadeIn, stay, fadeOut,
+                parseLine(this.line1, player, placeholders),
+                parseLine(this.line2, player, placeholders)
+        );
+    }
+
+    protected @NotNull String parseLine(@Nullable TextConfig text,
+                                        @NotNull Player player, @NotNull Map<String, Object> placeholders) {
+        if (text == null) return "";
+        else return TextParser.parseText(player, text.getMessage(), placeholders);
+    }
+
+    public @NotNull Map<String, Object> serialize() {
+        Map<String, Object> map = new LinkedHashMap<>();
+        if (this.line1 != null) map.put("line1", this.line1.getMessage());
+        if (this.line2 != null) map.put("line2", this.line2.getMessage());
+        if (this.fadeIn > 0) map.put("fadeIn", this.fadeIn);
+        if (this.stay > 0) map.put("stay", this.stay);
+        if (this.fadeOut > 0) map.put("fadeOut", this.fadeOut);
+        return map;
+    }
+
+    public static @Nullable TitleConfig deserialize(@NotNull ConfigurationWrapper<?> section) {
+        String line1 = section.getString("line1");
+        String line2 = section.getString("line2");
+        if (line1 == null && line2 == null) return null;
+
+        return of(
+                line1, line2,
+                section.getInt("fadeIn", -1),
+                section.getInt("stay", -1),
+                section.getInt("fadeOut", -1)
+        );
+    }
+
+}

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/source/BukkitConfigProvider.java

@@ -0,0 +1,79 @@
+package cc.carm.lib.mineconfiguration.bukkit.source;
+
+import cc.carm.lib.configuration.core.ConfigInitializer;
+import cc.carm.lib.configuration.core.source.ConfigurationComments;
+import cc.carm.lib.yamlcommentupdater.CommentedYAML;
+import cc.carm.lib.yamlcommentupdater.CommentedYAMLWriter;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.io.File;
+import java.util.List;
+import java.util.Set;
+
+public class BukkitConfigProvider extends CraftConfigProvider implements CommentedYAML {
+
+    protected static final char SEPARATOR = '.';
+
+    protected @NotNull ConfigurationComments comments = new ConfigurationComments();
+
+    public BukkitConfigProvider(@NotNull File file) {
+        super(file);
+    }
+
+    public void initializeConfig() {
+        this.configuration = YamlConfiguration.loadConfiguration(file);
+        this.initializer = new ConfigInitializer<>(this);
+    }
+
+    @Override
+    public @NotNull CraftSectionWrapper getConfiguration() {
+        return CraftSectionWrapper.of(this.configuration);
+    }
+
+    @Override
+    public void save() throws Exception {
+        try {
+            CommentedYAMLWriter.writeWithComments(this, this.file);
+        } catch (Exception ex) {
+            configuration.save(file);
+            throw ex;
+        }
+    }
+
+    @Override
+    public @NotNull ConfigurationComments getComments() {
+        return this.comments;
+    }
+
+    @Override
+    public String serializeValue(@NotNull String key, @NotNull Object value) {
+        FileConfiguration temp = new YamlConfiguration();
+        temp.set(key, value);
+        return temp.saveToString();
+    }
+
+    @Override
+    public Set<String> getKeys(@Nullable String sectionKey, boolean deep) {
+        if (sectionKey == null) return configuration.getKeys(deep);
+
+        ConfigurationSection section = configuration.getConfigurationSection(sectionKey);
+        if (section == null) return null;
+
+        return section.getKeys(deep);
+    }
+
+    @Override
+    public @Nullable Object getValue(@NotNull String key) {
+        return configuration.get(key);
+    }
+
+    @Override
+    public @Nullable List<String> getHeaderComments(@Nullable String key) {
+        return comments.getHeaderComment(key);
+    }
+
+}

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/source/CraftConfigProvider.java

@@ -1,4 +1,4 @@
-package cc.carm.lib.configuration.craft.source;
+package cc.carm.lib.mineconfiguration.bukkit.source;
 
 import cc.carm.lib.configuration.core.ConfigInitializer;
 import cc.carm.lib.configuration.core.source.impl.FileConfigProvider;

platform/bukkit/src/main/java/cc/carm/lib/mineconfiguration/bukkit/source/CraftSectionWrapper.java

@@ -1,4 +1,4 @@
-package cc.carm.lib.configuration.craft.source;
+package cc.carm.lib.mineconfiguration.bukkit.source;
 
 import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
 import org.bukkit.configuration.ConfigurationSection;
@@ -10,61 +10,62 @@ import java.util.Map;
 import java.util.Optional;
 import java.util.Set;
 
-public class CraftSectionWrapper implements ConfigurationWrapper {
+public class CraftSectionWrapper implements ConfigurationWrapper<ConfigurationSection> {
 
-    protected final ConfigurationSection section;
+    protected final ConfigurationSection configuration;
 
-    protected CraftSectionWrapper(ConfigurationSection section) {
-        this.section = section;
+    protected CraftSectionWrapper(ConfigurationSection configuration) {
+        this.configuration = configuration;
     }
 
-    public ConfigurationSection getSourceSection() {
-        return section;
+    @Override
+    public @NotNull ConfigurationSection getSource() {
+        return this.configuration;
     }
 
     @Override
     public @NotNull Set<String> getKeys(boolean deep) {
-        return this.section.getKeys(deep);
+        return this.configuration.getKeys(deep);
     }
 
     @Override
     public @NotNull Map<String, Object> getValues(boolean deep) {
-        return this.section.getValues(deep);
+        return this.configuration.getValues(deep);
     }
 
     @Override
     public void set(@NotNull String path, @Nullable Object value) {
-        this.section.set(path, value);
+        this.configuration.set(path, value);
     }
 
     @Override
     public boolean contains(@NotNull String path) {
-        return this.section.contains(path);
+        return this.configuration.contains(path);
     }
 
     @Override
     public @Nullable Object get(@NotNull String path) {
-        return this.section.get(path);
+        return this.configuration.get(path);
     }
 
     @Override
     public boolean isList(@NotNull String path) {
-        return this.section.isList(path);
+        return this.configuration.isList(path);
     }
 
     @Override
     public @Nullable List<?> getList(@NotNull String path) {
-        return this.section.getList(path);
+        return this.configuration.getList(path);
     }
 
     @Override
     public boolean isConfigurationSection(@NotNull String path) {
-        return this.section.isConfigurationSection(path);
+        return this.configuration.isConfigurationSection(path);
     }
 
     @Override
-    public @Nullable ConfigurationWrapper getConfigurationSection(@NotNull String path) {
-        return Optional.ofNullable(section.getConfigurationSection(path))
+    public @Nullable CraftSectionWrapper getConfigurationSection(@NotNull String path) {
+        return Optional.ofNullable(configuration.getConfigurationSection(path))
                 .map(CraftSectionWrapper::of).orElse(null);
     }
 

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

@@ -1,4 +1,4 @@
-package cc.carm.lib.configuration.craft.utils;
+package cc.carm.lib.mineconfiguration.bukkit.utils;
 
 import me.clip.placeholderapi.PlaceholderAPI;
 import org.bukkit.entity.Player;

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

@@ -1,7 +1,7 @@
-package cc.carm.lib.configuration.craft.utils;
+package cc.carm.lib.mineconfiguration.bukkit.utils;
 
-import cc.carm.lib.configuration.minecraft.utils.ColorParser;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
+import cc.carm.lib.easyplugin.utils.ColorParser;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import org.bukkit.Bukkit;
 import org.bukkit.command.CommandSender;
 import org.bukkit.entity.Player;

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

@@ -0,0 +1,252 @@
+package cc.carm.lib.mineconfiguration.bukkit.value;
+
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.configuration.core.value.type.ConfiguredList;
+import cc.carm.lib.configuration.core.value.type.ConfiguredSection;
+import cc.carm.lib.mineconfiguration.bukkit.builder.item.ItemConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.utils.TextParser;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import com.cryptomorin.xseries.XItemStack;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.enchantments.Enchantment;
+import org.bukkit.entity.Player;
+import org.bukkit.inventory.ItemFlag;
+import org.bukkit.inventory.ItemStack;
+import org.bukkit.inventory.meta.ItemMeta;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.*;
+import java.util.function.BiConsumer;
+import java.util.function.Consumer;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+public class ConfiguredItem extends ConfiguredSection<ItemStack> {
+
+    public static final @NotNull Pattern LORE_INSERT_PATTERN = Pattern.compile("^#(.*)#$");
+
+    public static ItemConfigBuilder create() {
+        return new ItemConfigBuilder();
+    }
+
+    protected final @NotNull String[] params;
+
+    public ConfiguredItem(@NotNull ValueManifest<ItemStack> manifest, @NotNull String[] params) {
+        super(
+                manifest, ItemStack.class,
+                (data, v) -> XItemStack.deserialize((ConfigurationSection) data.getSource()),
+                XItemStack::serialize
+        );
+        this.params = params;
+    }
+
+    public @NotNull String[] getParams() {
+        return params;
+    }
+
+    @Override
+    public @Nullable ItemStack get() {
+        return Optional.ofNullable(super.get()).map(ItemStack::clone).orElse(null);
+    }
+
+    public void modifyItem(Consumer<ItemStack> modifier) {
+        ItemStack item = get();
+        if (item == null) return;
+        modifier.accept(item);
+        set(item);
+    }
+
+    public void modifyMeta(Consumer<ItemMeta> modifier) {
+        modifyItem(item -> {
+            ItemMeta meta = item.getItemMeta();
+            modifier.accept(meta);
+            item.setItemMeta(meta);
+        });
+    }
+
+    public void setName(@Nullable String name) {
+        modifyMeta(meta -> meta.setDisplayName(name));
+    }
+
+    public void setLore(@Nullable List<String> lore) {
+        modifyMeta(meta -> meta.setLore(lore));
+    }
+
+    public void setLore(String... lore) {
+        if (lore.length == 0) setLore((List<String>) null);
+        else setLore(Arrays.asList(lore));
+    }
+
+    public @NotNull PreparedItem prepare(@NotNull Object... values) {
+        return new PreparedItem(this, values);
+    }
+
+    public @Nullable ItemStack get(@Nullable Player player) {
+        return get(player, new HashMap<>());
+    }
+
+    public @Nullable ItemStack get(@Nullable Player player, @NotNull Object... values) {
+        return get(player, ParamsUtils.buildParams(params, values));
+    }
+
+    public @Nullable ItemStack get(@Nullable Player player,
+                                   @NotNull Object[] values,
+                                   @NotNull Map<String, List<String>> inserted) {
+        return get(player, ParamsUtils.buildParams(params, values), inserted);
+    }
+
+
+    public @Nullable ItemStack get(@Nullable Player player, @NotNull String[] params, @NotNull Object[] values) {
+        return get(player, ParamsUtils.buildParams(params, values));
+    }
+
+    public @Nullable ItemStack get(@Nullable Player player,
+                                   @NotNull Map<String, Object> placeholders) {
+        return get(player, placeholders, new HashMap<>());
+    }
+
+    public @Nullable ItemStack get(@Nullable Player player,
+                                   @NotNull Map<String, Object> placeholders,
+                                   @NotNull Map<String, List<String>> inserted) {
+        return get(item -> {
+            ItemMeta meta = item.getItemMeta();
+            if (meta == null) return;
+
+            List<String> lore = insertLore(meta.getLore(), inserted);
+            if (!lore.isEmpty()) {
+                meta.setLore(TextParser.parseList(player, lore, placeholders));
+            }
+
+            String name = meta.getDisplayName();
+            if (!name.isEmpty()) {
+                meta.setDisplayName(TextParser.parseText(player, name, placeholders));
+            }
+
+            item.setItemMeta(meta);
+        });
+    }
+
+    public @Nullable ItemStack get(Consumer<ItemStack> modifier) {
+        return getOptional().map(item -> {
+            modifier.accept(item);
+            return item;
+        }).orElse(null);
+    }
+
+    protected static List<String> insertLore(List<String> original, Map<String, List<String>> inserted) {
+        if (original == null) return Collections.emptyList();
+
+        List<String> finalLore = new ArrayList<>();
+        for (String line : original) {
+            if (line == null) continue;
+
+            Matcher matcher = LORE_INSERT_PATTERN.matcher(line);
+            if (!matcher.matches()) {
+                finalLore.add(line);
+            } else {
+                String path = matcher.group(1);
+                Optional.ofNullable(inserted.get(path)).ifPresent(finalLore::addAll);
+            }
+        }
+
+        return finalLore;
+    }
+
+
+    public static class PreparedItem {
+
+        protected final @NotNull ConfiguredItem itemConfig;
+        protected final @NotNull Map<String, List<String>> insertLore = new HashMap<>();
+
+        protected @NotNull Object[] values;
+
+        protected @NotNull BiConsumer<ItemStack, Player> itemModifier;
+        protected @NotNull BiConsumer<ItemMeta, Player> metaModifier;
+
+        protected PreparedItem(@NotNull ConfiguredItem itemConfig, @NotNull Object[] values) {
+            this.itemConfig = itemConfig;
+            this.values = values;
+            itemModifier = (item, player) -> {
+            };
+            metaModifier = (meta, player) -> {
+            };
+        }
+
+        public PreparedItem modifyMeta(@NotNull BiConsumer<ItemMeta, Player> modifier) {
+            this.metaModifier = this.metaModifier.andThen(modifier);
+            return this;
+        }
+
+        public PreparedItem modifyItem(@NotNull BiConsumer<ItemStack, Player> modifier) {
+            this.itemModifier = this.itemModifier.andThen(modifier);
+            return this;
+        }
+
+        public PreparedItem insertLore(String path, List<String> content) {
+            insertLore.put(path, content);
+            return this;
+        }
+
+        public PreparedItem insertLore(String path, String... content) {
+            return insertLore(path, Arrays.asList(content));
+        }
+
+        public PreparedItem insertLore(String path, ConfiguredList<String> content) {
+            return insertLore(path, content.copy());
+        }
+
+        public PreparedItem insertLore(String path, ConfiguredMessage<String> content, Object... params) {
+            return insertLore(path, content.parse(null, params));
+        }
+
+        public PreparedItem insertLore(String path, ConfiguredMessageList<String> content, Object... params) {
+            return insertLore(path, content.parse(null, params));
+        }
+
+        public PreparedItem values(Object... values) {
+            this.values = values;
+            return this;
+        }
+
+        public PreparedItem amount(int amount) {
+            return modifyItem((item, player) -> item.setAmount(amount));
+        }
+
+        public PreparedItem addEnchantment(Enchantment e) {
+            return addEnchantment(e, 1);
+        }
+
+        public PreparedItem addEnchantment(Enchantment e, int level) {
+            return addEnchantment(e, level, true);
+        }
+
+        public PreparedItem addEnchantment(Enchantment e, int level, boolean ignoreLevelRestriction) {
+            return modifyMeta((meta, player) -> meta.addEnchant(e, level, ignoreLevelRestriction));
+        }
+
+        public PreparedItem addItemFlags(ItemFlag... flags) {
+            return modifyMeta((meta, player) -> meta.addItemFlags(flags));
+        }
+
+        public PreparedItem glow() {
+            return addItemFlags(ItemFlag.HIDE_ENCHANTS).addEnchantment(Enchantment.DURABILITY);
+        }
+
+
+        public @Nullable ItemStack get(Player player) {
+            return Optional.ofNullable(itemConfig.get(player, values, insertLore)).map(item -> {
+                itemModifier.accept(item, player);
+
+                ItemMeta meta = item.getItemMeta();
+                if (meta == null) return item;
+
+                metaModifier.accept(meta, player);
+                item.setItemMeta(meta);
+
+                return item;
+            }).orElse(null);
+        }
+
+    }
+}

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

@@ -0,0 +1,64 @@
+package cc.carm.lib.mineconfiguration.bukkit.value;
+
+import cc.carm.lib.configuration.core.value.ValueManifest;
+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.utils.ParamsUtils;
+import cc.carm.lib.mineconfiguration.common.value.ConfigMessage;
+import com.cryptomorin.xseries.messages.ActionBar;
+import org.bukkit.Bukkit;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+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;
+
+public class ConfiguredMessage<M> extends ConfigMessage<M, TextConfig, CommandSender> {
+
+    @NotNull
+    public static <M> CraftMessageValueBuilder<@Nullable M> create(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser) {
+        return CraftConfigValue.builder().createMessage().asValue(messageParser);
+    }
+
+    public static CraftMessageValueBuilder<String> asString() {
+        return CraftConfigValue.builder().createMessage().asStringValue();
+    }
+
+    public static ConfiguredMessage<String> ofString() {
+        return asString().build();
+    }
+
+    public static ConfiguredMessage<String> ofString(@NotNull String defaultMessage) {
+        return asString().defaults(defaultMessage).build();
+    }
+
+    public ConfiguredMessage(@NotNull ValueManifest<TextConfig> manifest, @NotNull String[] params,
+                             @NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser,
+                             @NotNull BiConsumer<@NotNull CommandSender, @NotNull M> sendFunction) {
+        super(manifest, TextConfig.class, params, messageParser, sendFunction, TextConfig::of);
+    }
+
+    public void sendActionBar(Player player, String... values) {
+        sendActionBar(player, ParamsUtils.buildParams(this.params, values));
+    }
+
+    public void sendActionBar(Player player, Map<String, Object> placeholders) {
+        ActionBar.sendActionBar(player, parseString(player, 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/ConfiguredMessageList.java

@@ -1,17 +1,18 @@
-package cc.carm.lib.configuration.craft.value;
+package cc.carm.lib.mineconfiguration.bukkit.value;
 
-import cc.carm.lib.configuration.minecraft.value.ConfigMessageList;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.builder.message.CraftMessageListBuilder;
-import cc.carm.lib.configuration.craft.data.TextConfig;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+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 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;
 
@@ -30,17 +31,17 @@ public class ConfiguredMessageList<M> extends ConfigMessageList<M, TextConfig, C
         return asStrings().defaults(defaultMessages).build();
     }
 
-    public ConfiguredMessageList(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                                 @Nullable List<String> headerComments, @Nullable String inlineComments,
-                                 @NotNull List<TextConfig> messages, @NotNull String[] params,
+    public ConfiguredMessageList(@NotNull ValueManifest<List<TextConfig>> manifest, @NotNull String[] params,
                                  @NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser,
                                  @NotNull BiConsumer<@NotNull CommandSender, @NotNull List<M>> sendFunction) {
-        super(provider, sectionPath, headerComments, inlineComments, TextConfig.class, messages, params, messageParser, sendFunction, TextConfig::of);
+        super(manifest, TextConfig.class, 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/ConfiguredSerializable.java

@@ -1,12 +1,11 @@
-package cc.carm.lib.configuration.craft.value;
+package cc.carm.lib.mineconfiguration.bukkit.value;
 
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.source.CraftConfigProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
 import org.bukkit.configuration.serialization.ConfigurationSerializable;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.List;
 import java.util.Optional;
 
 public class ConfiguredSerializable<T extends ConfigurationSerializable> extends CraftConfigValue<T> {
@@ -22,10 +21,8 @@ public class ConfiguredSerializable<T extends ConfigurationSerializable> extends
 
     protected final @NotNull Class<T> valueClass;
 
-    public ConfiguredSerializable(@Nullable CraftConfigProvider provider, @Nullable String sectionPath,
-                                  @Nullable List<String> headerComments, @Nullable String inlineComments,
-                                  @NotNull Class<T> valueClass, @Nullable T defaultValue) {
-        super(provider, sectionPath, headerComments, inlineComments, defaultValue);
+    public ConfiguredSerializable(@NotNull ValueManifest<T> manifest, @NotNull Class<T> valueClass) {
+        super(manifest);
         this.valueClass = valueClass;
     }
 
@@ -38,7 +35,7 @@ public class ConfiguredSerializable<T extends ConfigurationSerializable> extends
             } catch (Exception e) {
                 // 出现了解析错误，提示并返回默认值。
                 e.printStackTrace();
-                return useDefault();
+                return getDefaultValue();
             }
         } else return Optional.ofNullable(getCachedValue()).orElse(defaultValue);
     }

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

@@ -1,17 +1,16 @@
-package cc.carm.lib.configuration.craft.value;
+package cc.carm.lib.mineconfiguration.bukkit.value;
 
 import cc.carm.lib.configuration.core.function.ConfigValueParser;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
 import cc.carm.lib.configuration.core.value.type.ConfiguredValue;
-import cc.carm.lib.configuration.craft.CraftConfigValue;
-import cc.carm.lib.configuration.craft.builder.sound.SoundConfigBuilder;
-import cc.carm.lib.configuration.craft.data.SoundConfig;
+import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
+import cc.carm.lib.mineconfiguration.bukkit.builder.sound.SoundConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.data.SoundConfig;
+import org.bukkit.Location;
 import org.bukkit.Sound;
 import org.bukkit.entity.Player;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
-import java.util.List;
 import java.util.Optional;
 
 public class ConfiguredSound extends ConfiguredValue<SoundConfig> {
@@ -44,10 +43,8 @@ public class ConfiguredSound extends ConfiguredValue<SoundConfig> {
         return CraftConfigValue.builder().createSound().defaults(soundName, volume, pitch).build();
     }
 
-    public ConfiguredSound(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                           @Nullable List<String> headerComments, @Nullable String inlineComments,
-                           @Nullable SoundConfig defaultValue) {
-        super(provider, sectionPath, headerComments, inlineComments, SoundConfig.class, defaultValue, getSoundParser(), SoundConfig::serialize);
+    public ConfiguredSound(@NotNull ValueManifest<SoundConfig> manifest) {
+        super(manifest, SoundConfig.class, getSoundParser(), SoundConfig::serialize);
     }
 
     public void setSound(@NotNull Sound sound) {
@@ -70,6 +67,10 @@ public class ConfiguredSound extends ConfiguredValue<SoundConfig> {
         Optional.ofNullable(get()).ifPresent(SoundConfig::playToAll);
     }
 
+    public void playAt(Location location) {
+        Optional.ofNullable(get()).ifPresent(s -> s.playAt(location));
+    }
+
     public static ConfigValueParser<Object, SoundConfig> getSoundParser() {
         return ConfigValueParser.castToString().andThen((s, d) -> SoundConfig.deserialize(s));
     }

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

@@ -0,0 +1,143 @@
+package cc.carm.lib.mineconfiguration.bukkit.value;
+
+import cc.carm.lib.configuration.core.function.ConfigValueParser;
+import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.configuration.core.value.type.ConfiguredSection;
+import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
+import cc.carm.lib.mineconfiguration.bukkit.builder.title.TitleConfigBuilder;
+import cc.carm.lib.mineconfiguration.bukkit.data.TitleConfig;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import com.cryptomorin.xseries.messages.Titles;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Range;
+
+import java.util.Map;
+import java.util.Optional;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
+
+    public static final @NotNull ConfiguredTitle.TitleConsumer DEFAULT_TITLE_CONSUMER = Titles::sendTitle;
+
+    public static TitleConfigBuilder create() {
+        return CraftConfigValue.builder().createTitle();
+    }
+
+    public static ConfiguredTitle of(@Nullable String line1, @Nullable String line2) {
+        return create().defaults(line1, line2).build();
+    }
+
+    public static ConfiguredTitle of(@Nullable String line1, @Nullable String line2,
+                                     int fadeIn, int stay, int fadeOut) {
+        return create().defaults(line1, line2).fadeIn(fadeIn).stay(stay).fadeOut(fadeOut).build();
+    }
+
+    protected final @NotNull ConfiguredTitle.TitleConsumer sendConsumer;
+    protected final @NotNull String[] params;
+
+    protected final int fadeIn;
+    protected final int stay;
+    protected final int fadeOut;
+
+    public ConfiguredTitle(@NotNull ValueManifest<TitleConfig> manifest, @NotNull String[] params,
+                           @NotNull ConfiguredTitle.TitleConsumer sendConsumer,
+                           int fadeIn, int stay, int fadeOut) {
+        super(manifest, TitleConfig.class, getTitleParser(), TitleConfig::serialize);
+        this.sendConsumer = sendConsumer;
+        this.params = params;
+        this.fadeIn = fadeIn;
+        this.stay = stay;
+        this.fadeOut = fadeOut;
+    }
+
+    @Range(from = 0L, to = Integer.MAX_VALUE)
+    public int getFadeInTicks() {
+        return fadeIn;
+    }
+
+    @Range(from = 0L, to = Integer.MAX_VALUE)
+    public int getStayTicks() {
+        return stay;
+    }
+
+    @Range(from = 0L, to = Integer.MAX_VALUE)
+    public int getFadeOutTicks() {
+        return fadeOut;
+    }
+
+    public @NotNull ConfiguredTitle.TitleConsumer getSendConsumer() {
+        return sendConsumer;
+    }
+
+    public void send(@NotNull Player player, Object... values) {
+        send(player, this.params, values);
+    }
+
+    public void send(@NotNull Player player, @NotNull String[] params, @NotNull Object[] values) {
+        send(player, ParamsUtils.buildParams(params, values));
+    }
+
+    public void send(@NotNull Player player, @NotNull Map<String, Object> placeholders) {
+        TitleConfig config = get();
+        if (config != null) {
+            config.send(player, fadeIn, stay, fadeOut, placeholders, sendConsumer);
+        }
+    }
+
+    public void sendToAll(Object... values) {
+        sendToAll(this.params, values);
+    }
+
+    public void sendToAll(@NotNull String[] params, @NotNull Object[] values) {
+        sendToAll(ParamsUtils.buildParams(params, values));
+    }
+
+    public void sendToAll(@NotNull Map<String, Object> placeholders) {
+        TitleConfig config = get();
+        if (config == null) return;
+
+        Bukkit.getOnlinePlayers().forEach(onlinePlayer -> send(onlinePlayer, placeholders));
+    }
+
+    public void sendToEach(@NotNull Function<@NotNull Player, Object[]> eachValues) {
+        sendToEach(null, eachValues);
+    }
+
+    public void sendToEach(@Nullable Predicate<Player> limiter,
+                           @NotNull Function<@NotNull Player, Object[]> eachValues) {
+        Predicate<Player> predicate = Optional.ofNullable(limiter).orElse(r -> true);
+        Bukkit.getOnlinePlayers().stream().filter(predicate)
+                .forEach(r -> send(r, ParamsUtils.buildParams(params, eachValues.apply(r))));
+    }
+
+    public static ConfigValueParser<ConfigurationWrapper<?>, TitleConfig> getTitleParser() {
+        return (s, d) -> TitleConfig.deserialize(s);
+    }
+
+    @FunctionalInterface
+    public interface TitleConsumer {
+
+        /**
+         * 向目标玩家发送标题文字
+         *
+         * @param player  目标玩家
+         * @param fadeIn  淡入时间 (ticks)
+         * @param stay    保留时间 (ticks)
+         * @param fadeOut 淡出时间 (ticks)
+         * @param line1   第一行文字
+         * @param line2   第二行文字
+         */
+        void send(@NotNull Player player,
+                  @Range(from = 0L, to = Integer.MAX_VALUE) int fadeIn,
+                  @Range(from = 0L, to = Integer.MAX_VALUE) int stay,
+                  @Range(from = 0L, to = Integer.MAX_VALUE) int fadeOut,
+                  @NotNull String line1, @NotNull String line2);
+
+    }
+
+}

platform/bungee/pom.xml

@@ -5,22 +5,35 @@
     <parent>
         <artifactId>mineconfiguration-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>1.3.2</version>
+        <version>2.8.2</version>
+        <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <properties>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
+        <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>
             <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
-            <version>${easyconfiguration.version}</version>
+            <artifactId>mineconfiguration-common</artifactId>
+            <version>${project.parent.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>yamlcommentwriter</artifactId>
+            <version>${deps.yamlcommentwriter.version}</version>
             <scope>compile</scope>
         </dependency>
 
@@ -40,29 +53,10 @@
             <scope>provided</scope>
         </dependency>
 
-        <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-compiler-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-javadoc-plugin</artifactId>

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/BungeeConfigValue.java

@@ -1,14 +1,12 @@
-package cc.carm.lib.configuration.bungee;
+package cc.carm.lib.mineconfiguration.bungee;
 
-import cc.carm.lib.configuration.bungee.builder.BungeeConfigBuilder;
-import cc.carm.lib.configuration.bungee.source.BungeeConfigProvider;
-import cc.carm.lib.configuration.bungee.source.BungeeSectionWrapper;
 import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
 import cc.carm.lib.configuration.core.value.impl.CachedConfigValue;
+import cc.carm.lib.mineconfiguration.bungee.builder.BungeeConfigBuilder;
+import cc.carm.lib.mineconfiguration.bungee.source.BungeeConfigProvider;
+import cc.carm.lib.mineconfiguration.bungee.source.BungeeSectionWrapper;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.util.List;
 
 public abstract class BungeeConfigValue<T> extends CachedConfigValue<T> {
 
@@ -16,10 +14,8 @@ public abstract class BungeeConfigValue<T> extends CachedConfigValue<T> {
         return new BungeeConfigBuilder();
     }
 
-    public BungeeConfigValue(@Nullable BungeeConfigProvider provider, @Nullable String configPath,
-                             @Nullable List<String> headerComments, @Nullable String inlineComments,
-                             @Nullable T defaultValue) {
-        super(provider, configPath, headerComments, inlineComments, defaultValue);
+    public BungeeConfigValue(@NotNull ValueManifest<T> manifest) {
+        super(manifest);
     }
 
     public BungeeConfigProvider getBukkitProvider() {

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

@@ -1,15 +1,18 @@
-package cc.carm.lib.configuration;
+package cc.carm.lib.mineconfiguration.bungee;
 
-import cc.carm.lib.configuration.bungee.source.BungeeConfigProvider;
+import cc.carm.lib.configuration.core.ConfigurationRoot;
+import cc.carm.lib.mineconfiguration.bungee.source.BungeeConfigProvider;
+import cc.carm.lib.mineconfiguration.common.AbstractConfiguration;
 import net.md_5.bungee.api.plugin.Plugin;
 import net.md_5.bungee.config.ConfigurationProvider;
 import net.md_5.bungee.config.JsonConfiguration;
 import net.md_5.bungee.config.YamlConfiguration;
+import org.jetbrains.annotations.NotNull;
 
 import java.io.File;
 import java.io.IOException;
 
-public class MineConfiguration {
+public class MineConfiguration extends AbstractConfiguration<BungeeConfigProvider> {
 
     protected static BungeeConfigProvider create(File file, String source, ConfigurationProvider loader) {
         BungeeConfigProvider provider = new BungeeConfigProvider(file, loader);
@@ -94,4 +97,26 @@ public class MineConfiguration {
         return fromJSON(new File(plugin.getDataFolder(), fileName), source);
     }
 
+
+    public MineConfiguration(@NotNull Plugin plugin) {
+        super(from(plugin, "config.yml"), from(plugin, "messages.yml"));
+    }
+
+    public MineConfiguration(@NotNull Plugin plugin,
+                             @NotNull ConfigurationRoot configRoot,
+                             @NotNull ConfigurationRoot messageRoot) {
+        this(plugin);
+        initializeConfig(configRoot);
+        initializeMessage(messageRoot);
+    }
+
+    public MineConfiguration(@NotNull Plugin plugin,
+                             @NotNull Class<? extends ConfigurationRoot> configRoot,
+                             @NotNull Class<? extends ConfigurationRoot> messageRoot) {
+        this(plugin);
+        initializeConfig(configRoot);
+        initializeMessage(messageRoot);
+    }
+
+
 }

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

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.bungee.builder;
+package cc.carm.lib.mineconfiguration.bungee.builder;
 
-import cc.carm.lib.configuration.bungee.source.BungeeConfigProvider;
+import cc.carm.lib.mineconfiguration.bungee.source.BungeeConfigProvider;
 import cc.carm.lib.configuration.core.builder.AbstractConfigBuilder;
 
 public abstract class AbstractBungeeBuilder<T, B extends AbstractBungeeBuilder<T, B>>

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

@@ -1,6 +1,6 @@
-package cc.carm.lib.configuration.bungee.builder;
+package cc.carm.lib.mineconfiguration.bungee.builder;
 
-import cc.carm.lib.configuration.bungee.builder.message.BungeeMessageBuilder;
+import cc.carm.lib.mineconfiguration.bungee.builder.message.BungeeMessageBuilder;
 import cc.carm.lib.configuration.core.builder.ConfigBuilder;
 import org.jetbrains.annotations.NotNull;
 

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

@@ -1,19 +1,20 @@
-package cc.carm.lib.configuration.bungee.builder.message;
+package cc.carm.lib.mineconfiguration.bungee.builder.message;
 
-import cc.carm.lib.configuration.bungee.data.MessageText;
-import cc.carm.lib.configuration.minecraft.builder.message.MessageConfigBuilder;
-import cc.carm.lib.configuration.minecraft.utils.ColorParser;
+import cc.carm.lib.easyplugin.utils.ColorParser;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageConfigBuilder;
 import net.md_5.bungee.api.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.function.BiFunction;
 
-public class BungeeMessageBuilder extends MessageConfigBuilder<CommandSender, MessageText> {
+@SuppressWarnings("deprecation")
+public class BungeeMessageBuilder extends MessageConfigBuilder<CommandSender, TextConfig> {
 
 
     public BungeeMessageBuilder() {
-        super(CommandSender.class, MessageText.class);
+        super(CommandSender.class, TextConfig.class);
     }
 
     @Override

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

@@ -1,9 +1,10 @@
-package cc.carm.lib.configuration.bungee.builder.message;
+package cc.carm.lib.mineconfiguration.bungee.builder.message;
 
-import cc.carm.lib.configuration.bungee.data.MessageText;
-import cc.carm.lib.configuration.bungee.value.ConfiguredMessageList;
-import cc.carm.lib.configuration.minecraft.builder.message.MessageListBuilder;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
+import cc.carm.lib.mineconfiguration.bungee.value.ConfiguredMessageList;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageListBuilder;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import net.md_5.bungee.api.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -13,10 +14,10 @@ import java.util.Optional;
 import java.util.function.BiFunction;
 
 public class BungeeMessageListBuilder<M>
-        extends MessageListBuilder<M, CommandSender, MessageText, BungeeMessageListBuilder<M>> {
+        extends MessageListBuilder<M, CommandSender, TextConfig, BungeeMessageListBuilder<M>> {
 
     public BungeeMessageListBuilder(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> parser) {
-        super(CommandSender.class, MessageText::of, parser);
+        super(CommandSender.class, TextConfig::of, parser);
     }
 
     @Override
@@ -27,8 +28,7 @@ public class BungeeMessageListBuilder<M>
     @Override
     public @NotNull ConfiguredMessageList<M> build() {
         return new ConfiguredMessageList<>(
-                this.provider, this.path, this.headerComments, this.inlineComment,
-                Optional.ofNullable(this.defaultValue).orElse(MessageText.of(new ArrayList<>())),
+                buildManifest(TextConfig.of(new ArrayList<>())),
                 ParamsUtils.formatParams(this.paramFormatter, this.params),
                 this.messageParser, this.sendFunction
         );

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

@@ -1,21 +1,20 @@
-package cc.carm.lib.configuration.bungee.builder.message;
+package cc.carm.lib.mineconfiguration.bungee.builder.message;
 
-import cc.carm.lib.configuration.bungee.data.MessageText;
-import cc.carm.lib.configuration.bungee.value.ConfiguredMessage;
-import cc.carm.lib.configuration.minecraft.builder.message.MessageValueBuilder;
-import cc.carm.lib.configuration.minecraft.utils.ParamsUtils;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
+import cc.carm.lib.mineconfiguration.bungee.value.ConfiguredMessage;
+import cc.carm.lib.mineconfiguration.common.builder.message.MessageValueBuilder;
+import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
 import net.md_5.bungee.api.CommandSender;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.Optional;
 import java.util.function.BiFunction;
 
 public class BungeeMessageValueBuilder<M>
-        extends MessageValueBuilder<M, CommandSender, MessageText, BungeeMessageValueBuilder<M>> {
+        extends MessageValueBuilder<M, CommandSender, TextConfig, BungeeMessageValueBuilder<M>> {
 
     public BungeeMessageValueBuilder(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> parser) {
-        super(CommandSender.class, MessageText::new, parser);
+        super(CommandSender.class, TextConfig::new, parser);
     }
 
     @Override
@@ -26,8 +25,7 @@ public class BungeeMessageValueBuilder<M>
     @Override
     public @NotNull ConfiguredMessage<M> build() {
         return new ConfiguredMessage<>(
-                this.provider, this.path, this.headerComments, this.inlineComment,
-                Optional.ofNullable(this.defaultValue).orElse(MessageText.of("")),
+                buildManifest(TextConfig.of("")),
                 ParamsUtils.formatParams(this.paramFormatter, this.params),
                 this.messageParser, this.sendHandler
         );

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/data/TextConfig.java

@@ -0,0 +1,35 @@
+package cc.carm.lib.mineconfiguration.bungee.data;
+
+import cc.carm.lib.mineconfiguration.common.data.AbstractText;
+import net.md_5.bungee.api.CommandSender;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class TextConfig extends AbstractText<CommandSender> {
+
+    public TextConfig(@NotNull String message) {
+        super(CommandSender.class, message);
+    }
+
+    @Contract("!null,-> !null")
+    public static @Nullable TextConfig of(@Nullable String message) {
+        if (message == null) return null;
+        else return new TextConfig(message);
+    }
+
+    public static @NotNull List<TextConfig> of(@Nullable List<String> messages) {
+        if (messages == null || messages.isEmpty()) return new ArrayList<>();
+        else return messages.stream().map(TextConfig::of).collect(Collectors.toList());
+    }
+
+    public static @NotNull List<TextConfig> of(@NotNull String... messages) {
+        return of(Arrays.asList(messages));
+    }
+
+}

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/source/BungeeConfigProvider.java

@@ -0,0 +1,107 @@
+package cc.carm.lib.mineconfiguration.bungee.source;
+
+import cc.carm.lib.configuration.core.ConfigInitializer;
+import cc.carm.lib.configuration.core.source.ConfigurationComments;
+import cc.carm.lib.configuration.core.source.impl.FileConfigProvider;
+import cc.carm.lib.yamlcommentupdater.CommentedYAML;
+import cc.carm.lib.yamlcommentupdater.CommentedYAMLWriter;
+import net.md_5.bungee.config.Configuration;
+import net.md_5.bungee.config.ConfigurationProvider;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.io.File;
+import java.io.IOException;
+import java.io.StringWriter;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrapper> implements CommentedYAML {
+
+    protected static final char SEPARATOR = '.';
+
+    protected ConfigurationProvider loader;
+    protected Configuration configuration;
+    protected ConfigInitializer<BungeeConfigProvider> initializer;
+
+    protected ConfigurationComments comments = new ConfigurationComments();
+
+    public BungeeConfigProvider(@NotNull File file, @NotNull ConfigurationProvider loader) {
+        super(file);
+        this.loader = loader;
+    }
+
+    public BungeeConfigProvider(@NotNull File file, @NotNull Class<? extends ConfigurationProvider> providerClass) {
+        this(file, ConfigurationProvider.getProvider(providerClass));
+    }
+
+    public void initializeConfig() throws IOException {
+        this.configuration = getLoader().load(file);
+        this.initializer = new ConfigInitializer<>(this);
+    }
+
+    @Override
+    public @NotNull BungeeSectionWrapper getConfiguration() {
+        return BungeeSectionWrapper.of(configuration);
+    }
+
+    @Override
+    protected void onReload() throws Exception {
+        this.configuration = getLoader().load(file);
+    }
+
+    @Override
+    public @NotNull ConfigurationComments getComments() {
+        return this.comments;
+    }
+
+    @Override
+    public void save() throws Exception {
+        try {
+            CommentedYAMLWriter.writeWithComments(this, this.file);
+        } catch (Exception ex) {
+            getLoader().save(configuration, file);
+            throw ex;
+        }
+    }
+
+    @Override
+    public @NotNull ConfigInitializer<BungeeConfigProvider> getInitializer() {
+        return this.initializer;
+    }
+
+    public ConfigurationProvider getLoader() {
+        return loader;
+    }
+
+    @Override
+    public String serializeValue(@NotNull String key, @NotNull Object value) {
+        Configuration tmp = new Configuration();// 该对象用于临时记录配置内容
+        tmp.set(key, value);
+        StringWriter tmpStr = new StringWriter();
+        loader.save(tmp, tmpStr);
+        return tmpStr.toString();
+    }
+
+    @Override
+    public Set<String> getKeys(@Nullable String sectionKey, boolean deep) {
+        if (sectionKey == null) return BungeeSectionWrapper.getAllKeys(this.configuration);
+
+        Configuration section = configuration.getSection(sectionKey);
+        if (section == null) return null;
+
+        return new HashSet<>(section.getKeys());
+    }
+
+    @Override
+    public @Nullable Object getValue(@NotNull String key) {
+        return configuration.get(key);
+    }
+
+    @Override
+    public @Nullable List<String> getHeaderComments(@Nullable String key) {
+        return comments.getHeaderComment(key);
+    }
+
+}

platform/bungee/src/main/java/cc/carm/lib/mineconfiguration/bungee/source/BungeeSectionWrapper.java

@@ -0,0 +1,94 @@
+package cc.carm.lib.mineconfiguration.bungee.source;
+
+import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
+import net.md_5.bungee.config.Configuration;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.*;
+import java.util.stream.Collectors;
+
+import static cc.carm.lib.mineconfiguration.bungee.source.BungeeConfigProvider.SEPARATOR;
+
+public class BungeeSectionWrapper implements ConfigurationWrapper<Configuration> {
+
+    private final Configuration configuration;
+
+    private BungeeSectionWrapper(@NotNull Configuration section) {
+        this.configuration = section;
+    }
+
+    @Contract("!null->!null")
+    public static @Nullable BungeeSectionWrapper of(@Nullable Configuration section) {
+        return section == null ? null : new BungeeSectionWrapper(section);
+    }
+
+    protected static Set<String> getAllKeys(@NotNull Configuration config) {
+        Set<String> keys = new LinkedHashSet<>();
+        for (String key : config.getKeys()) {
+            keys.add(key);
+            Object value = config.get(key);
+            if (value instanceof Configuration) {
+                getAllKeys((Configuration) value).stream()
+                        .map(subKey -> key + SEPARATOR + subKey).forEach(keys::add);
+            }
+        }
+        return keys;
+    }
+
+    @Override
+    public @NotNull Configuration getSource() {
+        return this.configuration;
+    }
+
+    @Override
+    public @NotNull Set<String> getKeys(boolean deep) {
+        if (deep) {
+            return new LinkedHashSet<>(getAllKeys(configuration));
+        } else {
+            return new LinkedHashSet<>(configuration.getKeys());
+        }
+    }
+
+    @Override
+    public @NotNull Map<String, Object> getValues(boolean deep) {
+        return getKeys(deep).stream()
+                .collect(Collectors.toMap(key -> key, configuration::get, (a, b) -> b, LinkedHashMap::new));
+    }
+
+    @Override
+    public void set(@NotNull String path, @Nullable Object value) {
+        this.configuration.set(path, value);
+    }
+
+    @Override
+    public boolean contains(@NotNull String path) {
+        return this.configuration.contains(path);
+    }
+
+    @Override
+    public @Nullable Object get(@NotNull String path) {
+        return this.configuration.get(path);
+    }
+
+    @Override
+    public boolean isList(@NotNull String path) {
+        return get(path) instanceof List<?>;
+    }
+
+    @Override
+    public @Nullable List<?> getList(@NotNull String path) {
+        return this.configuration.getList(path);
+    }
+
+    @Override
+    public boolean isConfigurationSection(@NotNull String path) {
+        return get(path) instanceof Configuration;
+    }
+
+    @Override
+    public @Nullable BungeeSectionWrapper getConfigurationSection(@NotNull String path) {
+        return of(this.configuration.getSection(path));
+    }
+}

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

@@ -1,21 +1,22 @@
-package cc.carm.lib.configuration.bungee.value;
+package cc.carm.lib.mineconfiguration.bungee.value;
 
-import cc.carm.lib.configuration.bungee.BungeeConfigValue;
-import cc.carm.lib.configuration.bungee.builder.message.BungeeMessageValueBuilder;
-import cc.carm.lib.configuration.bungee.data.MessageText;
-import cc.carm.lib.configuration.minecraft.value.ConfigMessage;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.bungee.BungeeConfigValue;
+import cc.carm.lib.mineconfiguration.bungee.builder.message.BungeeMessageValueBuilder;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
+import cc.carm.lib.mineconfiguration.common.value.ConfigMessage;
 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;
 
-public class ConfiguredMessage<M> extends ConfigMessage<M, MessageText, CommandSender> {
+public class ConfiguredMessage<M> extends ConfigMessage<M, TextConfig, CommandSender> {
 
     @NotNull
     public static <M> BungeeMessageValueBuilder<@Nullable M> create(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser) {
@@ -34,18 +35,18 @@ public class ConfiguredMessage<M> extends ConfigMessage<M, MessageText, CommandS
         return asString().defaults(defaultMessage).build();
     }
 
-    public ConfiguredMessage(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                             @Nullable List<String> headerComments, @Nullable String inlineComments,
-                             @NotNull MessageText defaultMessage, @NotNull String[] params,
+    public ConfiguredMessage(@NotNull ValueManifest<TextConfig> manifest, @NotNull String[] params,
                              @NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser,
                              @NotNull BiConsumer<@NotNull CommandSender, @NotNull M> sendFunction) {
-        super(provider, sectionPath, headerComments, inlineComments, MessageText.class, defaultMessage, params, messageParser, sendFunction, MessageText::of);
+        super(manifest, TextConfig.class, params, messageParser, sendFunction, TextConfig::of);
     }
 
     @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

@@ -1,21 +1,22 @@
-package cc.carm.lib.configuration.bungee.value;
+package cc.carm.lib.mineconfiguration.bungee.value;
 
-import cc.carm.lib.configuration.bungee.BungeeConfigValue;
-import cc.carm.lib.configuration.bungee.builder.message.BungeeMessageListBuilder;
-import cc.carm.lib.configuration.bungee.data.MessageText;
-import cc.carm.lib.configuration.minecraft.value.ConfigMessageList;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ValueManifest;
+import cc.carm.lib.mineconfiguration.bungee.BungeeConfigValue;
+import cc.carm.lib.mineconfiguration.bungee.builder.message.BungeeMessageListBuilder;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
+import cc.carm.lib.mineconfiguration.common.value.ConfigMessageList;
 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;
 
-public class ConfiguredMessageList<M> extends ConfigMessageList<M, MessageText, CommandSender> {
+public class ConfiguredMessageList<M> extends ConfigMessageList<M, TextConfig, CommandSender> {
 
     @NotNull
     public static <M> BungeeMessageListBuilder<M> create(@NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser) {
@@ -30,17 +31,17 @@ public class ConfiguredMessageList<M> extends ConfigMessageList<M, MessageText,
         return asStrings().defaults(defaultMessages).build();
     }
 
-    public ConfiguredMessageList(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                                 @Nullable List<String> headerComments, @Nullable String inlineComments,
-                                 @NotNull List<MessageText> messages, @NotNull String[] params,
+    public ConfiguredMessageList(@NotNull ValueManifest<List<TextConfig>> manifest, @NotNull String[] params,
                                  @NotNull BiFunction<@Nullable CommandSender, @NotNull String, @Nullable M> messageParser,
                                  @NotNull BiConsumer<@NotNull CommandSender, @NotNull List<M>> sendFunction) {
-        super(provider, sectionPath, headerComments, inlineComments, MessageText.class, messages, params, messageParser, sendFunction, MessageText::of);
+        super(manifest, TextConfig.class, params, messageParser, sendFunction, TextConfig::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/bungee/src/test/java/ConfigTest.java

@@ -0,0 +1,62 @@
+import cc.carm.lib.configuration.core.ConfigurationRoot;
+import cc.carm.lib.configuration.core.annotation.HeaderComment;
+import cc.carm.lib.configuration.core.annotation.InlineComment;
+import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+import cc.carm.lib.configuration.core.value.ConfigValue;
+import cc.carm.lib.configuration.core.value.type.ConfiguredList;
+import cc.carm.lib.configuration.core.value.type.ConfiguredValue;
+import cc.carm.lib.mineconfiguration.bungee.MineConfiguration;
+import org.junit.Test;
+
+import java.io.File;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.util.List;
+
+public class ConfigTest {
+
+
+    @Test
+    public void test() {
+        File file = new File("target/config.yml");
+        ConfigurationProvider<?> config = MineConfiguration.from(file);
+        config.initialize(Configuration.class);
+
+        try {
+            System.out.println("--------------------------------------------");
+            System.out.println(new String(Files.readAllBytes(file.toPath()), StandardCharsets.UTF_8));
+            System.out.println("--------------------------------------------");
+        } catch (Exception exception) {
+            exception.printStackTrace();
+        }
+    }
+
+
+    @HeaderComment({
+            "MineConfiguration for BungeeCord",
+            "测试实例配置文件", ""
+    })
+    public static class Configuration extends ConfigurationRoot {
+
+        @InlineComment("是否显示DEBUG消息")
+        public static final ConfigValue<Boolean> DEBUG = ConfiguredValue.of(Boolean.class, false);
+
+        @HeaderComment("启动时执行的命令")
+        public static final class START_UP {
+
+            @HeaderComment("延迟执行的时间(单位:秒)")
+            public static final ConfigValue<Integer> DELAY = ConfiguredValue.of(Integer.class, 30);
+
+            @HeaderComment("循环执行的间隔(单位:秒)")
+            public static final ConfigValue<Integer> PERIOD = ConfiguredValue.of(Integer.class, 10);
+
+            @HeaderComment("执行的指令列表")
+            @InlineComment("建议以\"\"包裹")
+            public static final ConfigValue<List<String>> COMMANDS = ConfiguredList.builderOf(String.class)
+                    .fromString().defaults("alert Commands here!").build();
+        }
+
+    }
+
+
+}

pom.xml

@@ -3,27 +3,27 @@
          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">
     <modelVersion>4.0.0</modelVersion>
-    <modules>
-        <module>bungee</module>
-
-        <module>craftbukkit</module>
-        <module>bukkit</module>
-        <module>spigot</module>
-        <module>common</module>
-    </modules>
     <properties>
-        <java.version>1.8</java.version>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
+        <project.jdk.version>8</project.jdk.version>
+        <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>
 
-        <easyconfiguration.version>3.1.0</easyconfiguration.version>
+        <deps.easyconfifuration.version>3.8.0</deps.easyconfifuration.version>
+        <deps.easyplugin.version>1.5.7</deps.easyplugin.version>
+        <deps.yamlcommentwriter.version>1.0.1</deps.yamlcommentwriter.version>
     </properties>
+
     <groupId>cc.carm.lib</groupId>
     <artifactId>mineconfiguration-parent</artifactId>
-    <version>1.3.2</version>
+    <version>2.8.2</version>
     <packaging>pom</packaging>
+    <modules>
+        <module>common</module>
+        <module>platform/bungee</module>
+        <module>platform/bukkit</module>
+    </modules>
 
     <name>MineConfiguration</name>
     <description>EasyConfiguration for MineCraft.</description>
@@ -40,7 +40,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>
@@ -48,8 +48,8 @@
 
     <licenses>
         <license>
-            <name>The MIT License</name>
-            <url>https://opensource.org/licenses/MIT</url>
+            <name>GNU LESSER GENERAL PUBLIC LICENSE</name>
+            <url>https://www.gnu.org/licenses/lgpl-3.0.html</url>
         </license>
     </licenses>
 
@@ -66,9 +66,13 @@
     <repositories>
 
         <repository>
-            <id>carm-repo</id>
-            <name>Carm's Repo</name>
-            <url>https://repo.carm.cc/repository/maven-public/</url>
+            <id>central</id>
+            <url>https://repo1.maven.org/maven2/</url>
+        </repository>
+
+        <repository>
+            <id>sonatype</id>
+            <url>https://s01.oss.sonatype.org/content/groups/public/</url>
         </repository>
 
         <repository>
@@ -77,13 +81,14 @@
         </repository>
 
         <repository>
-            <id>nexus</id>
+            <id>lumine</id>
             <url>https://mvn.lumine.io/repository/maven-public/</url>
         </repository>
 
         <repository>
-            <id>central</id>
-            <url>https://repo1.maven.org/maven2/</url>
+            <id>carm-repo</id>
+            <name>Carm's Repo</name>
+            <url>https://repo.carm.cc/repository/maven-public/</url>
         </repository>
 
     </repositories>
@@ -104,7 +109,7 @@
         <dependency>
             <groupId>org.jetbrains</groupId>
             <artifactId>annotations</artifactId>
-            <version>23.0.0</version>
+            <version>24.0.1</version>
             <scope>provided</scope>
         </dependency>
 
@@ -117,7 +122,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
-                <version>2.22.2</version>
+                <version>3.1.2</version>
                 <configuration>
                     <useSystemClassLoader>false</useSystemClassLoader>
                 </configuration>
@@ -125,7 +130,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-gpg-plugin</artifactId>
-                <version>3.0.1</version>
+                <version>3.1.0</version>
                 <executions>
                     <execution>
                         <id>sign-artifacts</id>
@@ -145,7 +150,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-release-plugin</artifactId>
-                <version>2.5.3</version>
+                <version>3.0.1</version>
                 <configuration>
                     <autoVersionSubmodules>true</autoVersionSubmodules>
                     <useReleaseProfile>false</useReleaseProfile>
@@ -153,6 +158,36 @@
                     <goals>deploy</goals>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.11.0</version>
+                <configuration>
+                    <source>${project.jdk.version}</source>
+                    <target>${project.jdk.version}</target>
+                    <encoding>UTF-8</encoding>
+                    <compilerArgument>-parameters</compilerArgument>
+                </configuration>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.3.0</version>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-source-plugin</artifactId>
+                <version>3.3.0</version>
+                <executions>
+                    <execution>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>jar-no-fork</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
         </plugins>
 
         <pluginManagement>
@@ -161,7 +196,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.4.0</version>
+                    <version>3.5.0</version>
                     <configuration>
                         <classifier>javadoc</classifier>
                         <detectJavaApiLink>false</detectJavaApiLink>
@@ -169,7 +204,6 @@
                         <charset>UTF-8</charset>
                         <docencoding>UTF-8</docencoding>
                         <locale>zh_CN</locale>
-
                         <includeDependencySources>true</includeDependencySources>
                         <dependencySourceIncludes>
                             <dependencySourceInclude>cc.carm.lib:*</dependencySourceInclude>
@@ -188,42 +222,10 @@
                     </executions>
                 </plugin>
 
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-compiler-plugin</artifactId>
-                    <version>3.10.1</version>
-                    <configuration>
-                        <source>${java.version}</source>
-                        <target>${java.version}</target>
-                        <encoding>UTF-8</encoding>
-                        <compilerArgument>-parameters</compilerArgument>
-                    </configuration>
-                </plugin>
-
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-jar-plugin</artifactId>
-                    <version>3.2.2</version>
-                </plugin>
-
-                <plugin>
-                    <groupId>org.apache.maven.plugins</groupId>
-                    <artifactId>maven-source-plugin</artifactId>
-                    <version>3.2.1</version>
-                    <executions>
-                        <execution>
-                            <phase>package</phase>
-                            <goals>
-                                <goal>jar-no-fork</goal>
-                            </goals>
-                        </execution>
-                    </executions>
-                </plugin>
-
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.3.0</version>
+                    <version>3.5.0</version>
                     <executions>
                         <execution>
                             <phase>package</phase>

spigot/pom.xml

@@ -1,79 +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-parent</artifactId>
-        <groupId>cc.carm.lib</groupId>
-        <version>1.3.2</version>
-    </parent>
-    <modelVersion>4.0.0</modelVersion>
-    <properties>
-        <maven.compiler.source>${java.version}</maven.compiler.source>
-        <maven.compiler.target>${java.version}</maven.compiler.target>
-    </properties>
-    <artifactId>mineconfiguration-spigot</artifactId>
-    <packaging>jar</packaging>
-
-    <dependencies>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easyconfiguration-core</artifactId>
-            <version>${easyconfiguration.version}</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <dependency>
-            <groupId>${project.parent.groupId}</groupId>
-            <artifactId>mineconfiguration-craftbukkit</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>
-
-        <dependency>
-            <groupId>me.clip</groupId>
-            <artifactId>placeholderapi</artifactId>
-            <version>2.11.1</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <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-compiler-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-jar-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-            </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-            </plugin>
-        </plugins>
-    </build>
-
-
-</project>

spigot/src/main/java/cc/carm/lib/configuration/MineConfiguration.java

@@ -1,42 +0,0 @@
-package cc.carm.lib.configuration;
-
-import cc.carm.lib.configuration.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);
-    }
-
-}

spigot/src/main/java/cc/carm/lib/configuration/spigot/source/SpigotConfigProvider.java

@@ -1,54 +0,0 @@
-package cc.carm.lib.configuration.spigot.source;
-
-import cc.carm.lib.configuration.core.ConfigInitializer;
-import cc.carm.lib.configuration.craft.source.CraftConfigProvider;
-import org.bukkit.configuration.file.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.Unmodifiable;
-
-import java.io.File;
-import java.util.Collections;
-import java.util.List;
-
-public class SpigotConfigProvider extends CraftConfigProvider {
-
-    public SpigotConfigProvider(@NotNull File file) {
-        super(file);
-    }
-
-    @Override
-    public void initializeConfig() {
-        this.configuration = YamlConfiguration.loadConfiguration(file);
-        this.initializer = new ConfigInitializer<>(this);
-    }
-
-    @Override
-    public void setHeaderComment(@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));
-    }
-}