fix(item): 修复上下空行错误

feat(item): 支持为插入的LORE设置偏移量，以便在上方、下方空行，分割功能。
chore(deps): bump cc.carm.lib:easyplugin-color from 1.5.7 to 1.5.8 (#41 )
2026-06-05 06:51:49 +08:00 · 2023-09-08 23:47:53 +08:00 · 2023-09-08 22:15:28 +08:00 · 2023-09-07 22:23:55 +08:00 · 2023-09-07 03:49:15 +08:00 · 2023-09-07 02:31:57 +08:00
45 changed files with 929 additions and 559 deletions
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>mineconfiguration-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>2.3.2</version>
+        <version>2.8.4</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <properties>
@@ -39,7 +39,7 @@
        <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>

@@ -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();
+    }
+
+}
@@ -1,16 +1,18 @@
 package cc.carm.lib.mineconfiguration.common.builder.message;


+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 cc.carm.lib.configuration.core.builder.CommonConfigBuilder;
 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)
+        );
+    }
+
 }
@@ -1,13 +1,15 @@
 package cc.carm.lib.mineconfiguration.common.builder.message;

+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 cc.carm.lib.configuration.core.builder.CommonConfigBuilder;
 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)
+        );
+    }
 }
@@ -39,23 +39,33 @@ public interface BaseMessage<R, M> {
    void apply(@NotNull R receiver, @NotNull M message);

    /**
-     * 为某位接收者解析此消息。
+     * 填入变量值，返回一个准备好待发送的消息。
     *
-     * @param sender       接收者
-     * @param placeholders 消息中的变量与对应参数
-     * @return 解析变量后的消息内容
+     * @param values 变量值
+     * @return 准备好待发送的消息
     */
-    @Nullable M parse(@Nullable R sender, @NotNull Map<String, Object> placeholders);
+    default @NotNull PreparedMessage<R, M> prepare(@NotNull Object... values) {
+        return new PreparedMessage<>(this, values);
+    }

    /**
     * 为某位接收者解析此消息。
     *
-     * @param sender 接收者
-     * @param values 已定变量的对应参数
+     * @param receiver     接收者
+     * @param placeholders 消息中的变量与对应参数
     * @return 解析变量后的消息内容
     */
-    default @Nullable M parse(@Nullable R sender, @Nullable Object... values) {
-        return parse(sender, ParamsUtils.buildParams(getParams(), values));
+    @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));
    }

    /**
@@ -1,13 +1,13 @@
 package cc.carm.lib.mineconfiguration.common.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.mineconfiguration.common.data.AbstractText;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

-import java.util.List;
+import java.util.Collection;
 import java.util.Map;
 import java.util.function.BiConsumer;
 import java.util.function.BiFunction;
@@ -22,15 +22,15 @@ public abstract class ConfigMessage<M, T extends AbstractText<R>, R>

    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,
+    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(
-                provider, sectionPath, headerComments, inlineComments, textClazz, defaultMessage,
-                ConfigValueParser.castToString().andThen((s, d) -> textBuilder.apply(s)), AbstractText::getMessage
+                manifest, textClazz,
+                ConfigValueParser.castToString().andThen((s, d) -> textBuilder.apply(s)),
+                AbstractText::getMessage
        );
        this.params = params;
        this.messageParser = messageParser;
@@ -48,11 +48,20 @@ public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
        sendFunction.accept(receiver, message);
    }

-    @Override
-    public @Nullable M parse(@Nullable R sender, @NotNull Map<String, Object> placeholders) {
+    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(this.messageParser, sender, placeholders);
+        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) {
@@ -62,5 +71,29 @@ public abstract class ConfigMessage<M, T extends AbstractText<R>, R>
    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;
+        }
+
+    }
+
 }
@@ -1,9 +1,10 @@
 package cc.carm.lib.mineconfiguration.common.value;

 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;

@@ -24,15 +25,15 @@ public abstract class ConfigMessageList<M, T extends AbstractText<R>, R>

    protected final @NotNull Function<String, T> textBuilder;

-    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;
@@ -68,12 +69,33 @@ public abstract class ConfigMessageList<M, T extends AbstractText<R>, R>
                .collect(Collectors.toList());
    }

+    public @Nullable M parseToLine(@Nullable R receiver, @NotNull Object... values) {
+        return parseToLine(receiver, "\n", ParamsUtils.buildParams(this.params, values));
+    }
+
+    public @Nullable M parseToLine(@Nullable R receiver, @NotNull Map<String, Object> placeholders) {
+        return parseToLine(receiver, "\n", placeholders);
+    }
+
+    public @Nullable M parseToLine(@Nullable R receiver, @NotNull String delimiter, @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;
+
+        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));
@@ -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());
+    }
+
+}
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>mineconfiguration-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>2.3.2</version>
+        <version>2.8.4</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -30,11 +30,25 @@
            <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>

@@ -42,15 +56,7 @@
        <dependency>
            <groupId>me.clip</groupId>
            <artifactId>placeholderapi</artifactId>
-            <version>2.11.2</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <!--ProtocolLib for general packet's function support-->
-        <dependency>
-            <groupId>com.comphenix.protocol</groupId>
-            <artifactId>ProtocolLib</artifactId>
-            <version>4.8.0</version>
+            <version>2.11.3</version>
            <scope>provided</scope>
        </dependency>

@@ -1,14 +1,12 @@
 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.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,10 +14,8 @@ 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() {
@@ -1,12 +1,16 @@
 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 {
+public class MineConfiguration extends AbstractConfiguration<BukkitConfigProvider> {

    public static BukkitConfigProvider from(File file, String source) {
        BukkitConfigProvider provider = new BukkitConfigProvider(file);
@@ -39,4 +43,24 @@ public class MineConfiguration {
        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);
+    }
+
 }
@@ -6,11 +6,8 @@ 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 cc.carm.lib.mineconfiguration.bukkit.data.ItemConfig;
-import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredItem;
 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();
-    }
-
 }
@@ -1,19 +1,22 @@
 package cc.carm.lib.mineconfiguration.bukkit.builder.item;

+import cc.carm.lib.configuration.core.value.ValueManifest;
 import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
-import cc.carm.lib.mineconfiguration.bukkit.data.ItemConfig;
 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.*;
 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 = 0;
@@ -83,7 +86,7 @@ public class ItemConfigBuilder extends AbstractCraftBuilder<ItemConfig, ItemConf
        return defaultFlags(new LinkedHashSet<>(Arrays.asList(flags)));
    }

-    public ItemConfigBuilder formatParam(@NotNull Function<@NotNull String, @NotNull String> paramFormatter) {
+    public ItemConfigBuilder formatParam(@NotNull UnaryOperator<String> paramFormatter) {
        this.paramFormatter = paramFormatter;
        return getThis();
    }
@@ -103,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, enchants, flags);
+
+        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() {
@@ -9,7 +9,6 @@ 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
        );
@@ -8,7 +8,6 @@ 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
        );
@@ -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);
    }

 }
@@ -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());
    }

 }
@@ -2,43 +2,29 @@ package cc.carm.lib.mineconfiguration.bukkit.builder.title;

 import cc.carm.lib.mineconfiguration.bukkit.builder.AbstractCraftBuilder;
 import cc.carm.lib.mineconfiguration.bukkit.data.TitleConfig;
-import cc.carm.lib.mineconfiguration.bukkit.function.TitleSendConsumer;
-import cc.carm.lib.mineconfiguration.bukkit.utils.ProtocolLibHelper;
 import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredTitle;
 import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
-import org.bukkit.Bukkit;
 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 = 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
        );
    }
@@ -26,6 +26,8 @@ public class ItemConfig {
    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());
    }
@@ -131,7 +133,7 @@ public class ItemConfig {
    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");
@@ -1,6 +1,7 @@
 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);
    }
@@ -1,8 +1,8 @@
 package cc.carm.lib.mineconfiguration.bukkit.data;

 import cc.carm.lib.configuration.core.source.ConfigurationWrapper;
-import cc.carm.lib.mineconfiguration.bukkit.function.TitleSendConsumer;
 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;
@@ -25,20 +25,58 @@ public class TitleConfig {
        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,
-                     @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) {
+                     @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(
@@ -58,11 +96,23 @@ public class TitleConfig {
        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 @NotNull TitleConfig deserialize(@NotNull ConfigurationWrapper<?> section) {
-        return of(section.getString("line1"), section.getString("line2"));
+    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)
+        );
    }

 }
@@ -1,26 +0,0 @@
-package cc.carm.lib.mineconfiguration.bukkit.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);
-
-}
@@ -2,22 +2,23 @@ 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.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;
+import java.util.Set;

-public class BukkitConfigProvider extends CraftConfigProvider {
+public class BukkitConfigProvider extends CraftConfigProvider implements CommentedYAML {

    protected static final char SEPARATOR = '.';

-    protected @NotNull BukkitYAMLComments comments = new BukkitYAMLComments();
+    protected @NotNull ConfigurationComments comments = new ConfigurationComments();

    public BukkitConfigProvider(@NotNull File file) {
        super(file);
@@ -35,21 +36,44 @@ public class BukkitConfigProvider extends CraftConfigProvider {

    @Override
    public void save() throws Exception {
-        configuration.save(getFile());
-
-        StringWriter writer = new StringWriter();
-        this.comments.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));
+        try {
+            CommentedYAMLWriter.writeWithComments(this, this.file);
+        } catch (Exception ex) {
+            configuration.save(file);
+            throw ex;
        }
    }

    @Override
-    public @Nullable ConfigurationComments getComments() {
+    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);
+    }
+
 }
@@ -1,108 +0,0 @@
-package cc.carm.lib.mineconfiguration.bukkit.source;
-
-import cc.carm.lib.configuration.core.source.ConfigurationComments;
-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.BufferedWriter;
-import java.io.IOException;
-import java.util.List;
-import java.util.StringJoiner;
-import java.util.stream.Collectors;
-import java.util.stream.IntStream;
-
-public class BukkitYAMLComments extends ConfigurationComments {
-
-    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("[" + CraftConfigProvider.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());
-    }
-
-}
@@ -1,41 +0,0 @@
-package cc.carm.lib.mineconfiguration.bukkit.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;
-import org.jetbrains.annotations.NotNull;
-
-public class ProtocolLibHelper {
-
-    @SuppressWarnings("deprecation")
-    public static void sendTitle(@NotNull Player player, long fadeIn, long stay, long fadeOut, String line1, String line2) throws Exception {
-        ProtocolManager pm = ProtocolLibrary.getProtocolManager();
-
-        if (line1 != null) {
-            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);
-    }
-
-}
@@ -1,74 +1,306 @@
 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.ConfiguredList;
 import cc.carm.lib.configuration.core.value.type.ConfiguredSection;
-import cc.carm.lib.mineconfiguration.bukkit.CraftConfigValue;
 import cc.carm.lib.mineconfiguration.bukkit.builder.item.ItemConfigBuilder;
-import cc.carm.lib.mineconfiguration.bukkit.data.ItemConfig;
-import cc.carm.lib.mineconfiguration.bukkit.source.CraftConfigProvider;
+import cc.carm.lib.mineconfiguration.bukkit.utils.TextParser;
 import cc.carm.lib.mineconfiguration.common.utils.ParamsUtils;
+import com.cryptomorin.xseries.XItemStack;
+import org.bukkit.Bukkit;
+import org.bukkit.OfflinePlayer;
+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.bukkit.inventory.meta.SkullMeta;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
+import java.util.*;
+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<ItemConfig> {
+public class ConfiguredItem extends ConfiguredSection<ItemStack> {
+
+    public static final @NotNull Pattern LORE_INSERT_PATTERN = Pattern.compile("^#(.*)#(\\{.*})?$");
+    public static final @NotNull Pattern LORE_OFFSET_PATTERN = Pattern.compile("\\{(-?\\d+)(?:,(-?\\d+))?}");

    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);
+        return new ItemConfigBuilder();
    }

    protected final @NotNull String[] params;

-    public ConfiguredItem(@Nullable CraftConfigProvider provider, @Nullable String sectionPath,
-                          @Nullable List<String> headerComments, @Nullable String inlineComments,
-                          @Nullable ItemConfig defaultValue, @NotNull String[] params) {
+    public ConfiguredItem(@NotNull ValueManifest<ItemStack> manifest, @NotNull String[] params) {
        super(
-                provider, sectionPath, headerComments, inlineComments, ItemConfig.class, defaultValue,
-                getItemParser(), ItemConfig::serialize
+                manifest, ItemStack.class,
+                (data, v) -> XItemStack.deserialize((ConfigurationSection) data.getSource()),
+                XItemStack::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);
+    @Override
+    public @Nullable ItemStack get() {
+        return Optional.ofNullable(super.get()).map(ItemStack::clone).orElse(null);
    }

-    public @Nullable ItemStack getItem(@Nullable Player player, int amount) {
-        return getItem(player, amount, new HashMap<>());
+    public void modifyItem(Consumer<ItemStack> modifier) {
+        ItemStack item = get();
+        if (item == null) return;
+        modifier.accept(item);
+        set(item);
    }

-    public @Nullable ItemStack getItem(@Nullable Player player, int amount, @NotNull Object... values) {
-        return getItem(player, amount, ParamsUtils.buildParams(params, values));
+    public void modifyMeta(Consumer<ItemMeta> modifier) {
+        modifyItem(item -> {
+            ItemMeta meta = item.getItemMeta();
+            modifier.accept(meta);
+            item.setItemMeta(meta);
+        });
    }

-    public @Nullable ItemStack getItem(@Nullable Player player, int amount, @NotNull String[] params, @NotNull Object[] values) {
-        return getItem(player, amount, ParamsUtils.buildParams(params, values));
+    public void setName(@Nullable String name) {
+        modifyMeta(meta -> meta.setDisplayName(name));
    }

-    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);
+    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);
+    }
+
+    public 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);
+                String offset = matcher.group(2);
+                finalLore.addAll(addLoreOffset(inserted.get(path), offset));
+            }
+        }
+
+        return finalLore;
+    }
+
+    public static List<String> addLoreOffset(List<String> lore, String offsetSettings) {
+        if (lore == null || lore.isEmpty()) return Collections.emptyList();
+        if (offsetSettings == null) return lore;
+
+        Matcher offsetMatcher = LORE_OFFSET_PATTERN.matcher(offsetSettings);
+        if (!offsetMatcher.matches()) return lore;
+
+        int upOffset = Optional.ofNullable(offsetMatcher.group(1)).map(Integer::parseInt).orElse(0);
+        int downOffset = Optional.ofNullable(offsetMatcher.group(2)).map(Integer::parseInt).orElse(0);
+
+        return addLoreOffset(lore, upOffset, downOffset);
+    }
+
+    public static List<String> addLoreOffset(List<String> lore, int upOffset, int downOffset) {
+        if (lore == null || lore.isEmpty()) return Collections.emptyList();
+        upOffset = Math.max(0, upOffset);
+        downOffset = Math.max(0, downOffset);
+
+        ArrayList<String> finalLore = new ArrayList<>(lore);
+        for (int i = 0; i < upOffset; i++) finalLore.add(0, " ");
+        for (int i = 0; i < downOffset; i++) finalLore.add(finalLore.size(), " ");
+
+        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);
+        }
+
+        /**
+         * @param owner 玩家名
+         * @return this
+         * @deprecated Use {@link #setSkullOwner(OfflinePlayer)} instead.
+         */
+        @Deprecated
+        public PreparedItem setSkullOwner(String owner) {
+            return modifyItem((item, player) -> {
+                if (!(item.getItemMeta() instanceof SkullMeta)) return;
+                SkullMeta meta = (SkullMeta) item.getItemMeta();
+                meta.setOwner(owner);
+            });
+        }
+
+        public PreparedItem setSkullOwner(UUID owner) {
+            return setSkullOwner(Bukkit.getOfflinePlayer(owner));
+        }
+
+        public PreparedItem setSkullOwner(OfflinePlayer owner) {
+            return modifyItem((item, player) -> {
+                if (!(item.getItemMeta() instanceof SkullMeta)) return;
+                SkullMeta meta = (SkullMeta) item.getItemMeta();
+                meta.setOwningPlayer(owner);
+            });
+        }
+
+        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);
+        }
+
+    }
 }
@@ -1,18 +1,22 @@
 package cc.carm.lib.mineconfiguration.bukkit.value;

-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+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;

@@ -35,12 +39,18 @@ public class ConfiguredMessage<M> extends ConfigMessage<M, TextConfig, CommandSe
        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,
+    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, TextConfig.class, defaultMessage, params, messageParser, sendFunction, TextConfig::of);
+        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
@@ -1,6 +1,6 @@
 package cc.carm.lib.mineconfiguration.bukkit.value;

-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
+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;
@@ -31,12 +31,10 @@ 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);
    }

    @Override
@@ -1,12 +1,11 @@
 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.source.CraftConfigProvider;
 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);
    }
@@ -1,17 +1,16 @@
 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.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));
    }
@@ -1,25 +1,29 @@
 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.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.bukkit.function.TitleSendConsumer;
 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.List;
 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();
    }
@@ -33,19 +37,17 @@ public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
        return create().defaults(line1, line2).fadeIn(fadeIn).stay(stay).fadeOut(fadeOut).build();
    }

-    protected final @NotNull TitleSendConsumer sendConsumer;
+    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(@Nullable ConfigurationProvider<?> provider, @Nullable String sectionPath,
-                           @Nullable List<String> headerComments, @Nullable String inlineComments,
-                           @Nullable TitleConfig defaultValue, @NotNull String[] params,
-                           @NotNull TitleSendConsumer sendConsumer,
+    public ConfiguredTitle(@NotNull ValueManifest<TitleConfig> manifest, @NotNull String[] params,
+                           @NotNull ConfiguredTitle.TitleConsumer sendConsumer,
                           int fadeIn, int stay, int fadeOut) {
-        super(provider, sectionPath, headerComments, inlineComments, TitleConfig.class, defaultValue, getTitleParser(), TitleConfig::serialize);
+        super(manifest, TitleConfig.class, getTitleParser(), TitleConfig::serialize);
        this.sendConsumer = sendConsumer;
        this.params = params;
        this.fadeIn = fadeIn;
@@ -68,7 +70,7 @@ public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
        return fadeOut;
    }

-    public @NotNull TitleSendConsumer getSendConsumer() {
+    public @NotNull ConfiguredTitle.TitleConsumer getSendConsumer() {
        return sendConsumer;
    }

@@ -102,8 +104,40 @@ public class ConfiguredTitle extends ConfiguredSection<TitleConfig> {
        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);
+
+    }
+
 }
@@ -0,0 +1,63 @@
+import cc.carm.lib.mineconfiguration.bukkit.value.ConfiguredItem;
+import org.junit.Test;
+
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Matcher;
+
+public class LoreInsertTest {
+
+
+    @Test
+    public void insert() {
+        List<String> original = Arrays.asList(
+                "测试lore的第一行",
+                "测试lore的第二行",
+                "#click-lore#{1,2}",
+                "测试lore的倒数第二行",
+                "测试lore的倒数第一行"
+        );
+
+        List<String> replace = Arrays.asList("> 插入的点击行1", "> 插入的点击行2");
+        Map<String, List<String>> inserted = new HashMap<>();
+        inserted.put("click-lore", replace);
+
+        System.out.println(ConfiguredItem.insertLore(original, inserted));
+    }
+
+
+    @Test
+    public void parse() {
+        System.out.println(parse("#click-lore#{1,0}"));
+        System.out.println(parse("#click-lore#{1,2}"));
+        System.out.println(parse("#click-lore#{1}"));
+        System.out.println(parse("#click-lore#{我}"));
+    }
+
+    public static String parse(String line) {
+        Matcher matcher = ConfiguredItem.LORE_INSERT_PATTERN.matcher(line);
+        if (!matcher.matches()) {
+            return line;
+        } else {
+            String path = matcher.group(1);
+            String offset = matcher.group(2);
+            return "Path -> " + path + " Offset-> " + offset;
+        }
+    }
+
+    @Test
+    public void offset() {
+
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{1,-5}"));
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{1,2}"));
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{1,0}"));
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{2}"));
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{我}"));
+        System.out.println(ConfiguredItem.addLoreOffset(Arrays.asList("测试lore", "第二行"), "{我，爱你}"));
+
+    }
+
+
+}
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>mineconfiguration-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>2.3.2</version>
+        <version>2.8.4</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -30,6 +30,13 @@
            <scope>compile</scope>
        </dependency>

+        <dependency>
+            <groupId>cc.carm.lib</groupId>
+            <artifactId>yamlcommentwriter</artifactId>
+            <version>${deps.yamlcommentwriter.version}</version>
+            <scope>compile</scope>
+        </dependency>
+
        <dependency>
            <groupId>net.md-5</groupId>
            <artifactId>bungeecord-api</artifactId>
@@ -1,14 +1,12 @@
 package cc.carm.lib.mineconfiguration.bungee;

+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 cc.carm.lib.configuration.core.source.ConfigurationProvider;
-import cc.carm.lib.configuration.core.value.impl.CachedConfigValue;
 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() {
@@ -1,15 +1,18 @@
 package cc.carm.lib.mineconfiguration.bungee;

+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);
+    }
+
+
 }
@@ -1,7 +1,7 @@
 package cc.carm.lib.mineconfiguration.bungee.builder.message;

 import cc.carm.lib.easyplugin.utils.ColorParser;
-import cc.carm.lib.mineconfiguration.bungee.data.MessageText;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
 import cc.carm.lib.mineconfiguration.common.builder.message.MessageConfigBuilder;
 import net.md_5.bungee.api.CommandSender;
 import org.jetbrains.annotations.NotNull;
@@ -10,11 +10,11 @@ import org.jetbrains.annotations.Nullable;
 import java.util.function.BiFunction;

@SuppressWarnings("deprecation")
-public class BungeeMessageBuilder extends MessageConfigBuilder<CommandSender, MessageText> {
+public class BungeeMessageBuilder extends MessageConfigBuilder<CommandSender, TextConfig> {


    public BungeeMessageBuilder() {
-        super(CommandSender.class, MessageText.class);
+        super(CommandSender.class, TextConfig.class);
    }

    @Override
@@ -1,6 +1,7 @@
 package cc.carm.lib.mineconfiguration.bungee.builder.message;

-import cc.carm.lib.mineconfiguration.bungee.data.MessageText;
+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;
@@ -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
        );
@@ -1,6 +1,6 @@
 package cc.carm.lib.mineconfiguration.bungee.builder.message;

-import cc.carm.lib.mineconfiguration.bungee.data.MessageText;
+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;
@@ -8,14 +8,13 @@ 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
        );
@@ -11,24 +11,24 @@ import java.util.Arrays;
 import java.util.List;
 import java.util.stream.Collectors;

-public class MessageText extends AbstractText<CommandSender> {
+public class TextConfig extends AbstractText<CommandSender> {

-    public MessageText(@NotNull String message) {
+    public TextConfig(@NotNull String message) {
        super(CommandSender.class, message);
    }

    @Contract("!null,-> !null")
-    public static @Nullable MessageText of(@Nullable String message) {
+    public static @Nullable TextConfig of(@Nullable String message) {
        if (message == null) return null;
-        else return new MessageText(message);
+        else return new TextConfig(message);
    }

-    public static @NotNull List<MessageText> of(@Nullable List<String> messages) {
+    public static @NotNull List<TextConfig> of(@Nullable List<String> messages) {
        if (messages == null || messages.isEmpty()) return new ArrayList<>();
-        else return messages.stream().map(MessageText::of).collect(Collectors.toList());
+        else return messages.stream().map(TextConfig::of).collect(Collectors.toList());
    }

-    public static @NotNull List<MessageText> of(@NotNull String... messages) {
+    public static @NotNull List<TextConfig> of(@NotNull String... messages) {
        return of(Arrays.asList(messages));
    }

@@ -3,21 +3,21 @@ 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 net.md_5.bungee.config.YamlConfiguration;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;

-import java.io.BufferedWriter;
 import java.io.File;
 import java.io.IOException;
 import java.io.StringWriter;
-import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
-import java.nio.file.Path;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;

-public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrapper> {
+public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrapper> implements CommentedYAML {

    protected static final char SEPARATOR = '.';

@@ -25,7 +25,7 @@ public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrappe
    protected Configuration configuration;
    protected ConfigInitializer<BungeeConfigProvider> initializer;

-    protected BungeeYAMLComments comments = new BungeeYAMLComments();
+    protected ConfigurationComments comments = new ConfigurationComments();

    public BungeeConfigProvider(@NotNull File file, @NotNull ConfigurationProvider loader) {
        super(file);
@@ -52,22 +52,17 @@ public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrappe
    }

    @Override
-    public @Nullable ConfigurationComments getComments() {
+    public @NotNull ConfigurationComments getComments() {
        return this.comments;
    }

    @Override
    public void save() throws Exception {
-        getLoader().save(configuration, file);
-        if (getLoader() instanceof YamlConfiguration) {
-            StringWriter writer = new StringWriter();
-            this.comments.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));
-            }
+        try {
+            CommentedYAMLWriter.writeWithComments(this, this.file);
+        } catch (Exception ex) {
+            getLoader().save(configuration, file);
+            throw ex;
        }
    }

@@ -79,4 +74,34 @@ public class BungeeConfigProvider extends FileConfigProvider<BungeeSectionWrappe
    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);
+    }
+
 }
@@ -1,115 +0,0 @@
-package cc.carm.lib.mineconfiguration.bungee.source;
-
-import cc.carm.lib.configuration.core.source.ConfigurationComments;
-import net.md_5.bungee.config.Configuration;
-import net.md_5.bungee.config.ConfigurationProvider;
-import net.md_5.bungee.config.YamlConfiguration;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-
-import java.io.BufferedWriter;
-import java.io.IOException;
-import java.io.StringWriter;
-import java.util.List;
-import java.util.StringJoiner;
-import java.util.stream.Collectors;
-import java.util.stream.IntStream;
-
-import static cc.carm.lib.mineconfiguration.bungee.source.BungeeConfigProvider.SEPARATOR;
-
-public class BungeeYAMLComments extends ConfigurationComments {
-
-    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 Configuration source, @NotNull BufferedWriter writer) throws IOException {
-        ConfigurationProvider provider = ConfigurationProvider.getProvider(YamlConfiguration.class);
-        Configuration tmp = new Configuration();// 该对象用于临时记录配置内容
-
-        String configHeader = buildHeaderComments(null, "");
-        if (configHeader != null) writer.write(configHeader);
-
-        for (String fullKey : BungeeSectionWrapper.getAllKeys(source)) {
-            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 Configuration) {
-                Configuration section = (Configuration) currentValue;
-                writer.write(indents + trailingKey + ":");
-                if (inlineComment != null && inlineComment.length() > 0) {
-                    writer.write(" # " + inlineComment);
-                }
-                if (!section.getKeys().isEmpty()) {
-                    writer.write("\n");
-                } else {
-                    writer.write(" {}\n");
-                    if (indents.length() == 0) writer.write("\n");
-                }
-                continue;
-            }
-
-            tmp.set(trailingKey, currentValue);
-            StringWriter tmpStr = new StringWriter();
-            provider.save(tmp, tmpStr);
-            String yaml = tmpStr.toString();
-            tmpStr.close();
-            tmp.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(@NotNull String key) {
-        String[] splitKey = key.split("[" + SEPARATOR + "]");
-        return IntStream.range(1, splitKey.length).mapToObj(i -> "  ").collect(Collectors.joining());
-    }
-
-}
@@ -1,9 +1,9 @@
 package cc.carm.lib.mineconfiguration.bungee.value;

-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.MessageText;
+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;
@@ -16,7 +16,7 @@ import java.util.List;
 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) {
@@ -35,12 +35,10 @@ 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
@@ -1,10 +1,10 @@
 package cc.carm.lib.mineconfiguration.bungee.value;

+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.MessageText;
+import cc.carm.lib.mineconfiguration.bungee.data.TextConfig;
 import cc.carm.lib.mineconfiguration.common.value.ConfigMessageList;
-import cc.carm.lib.configuration.core.source.ConfigurationProvider;
 import net.md_5.bungee.api.CommandSender;
 import net.md_5.bungee.api.ProxyServer;
 import org.jetbrains.annotations.NotNull;
@@ -13,11 +13,10 @@ 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) {
@@ -32,12 +31,10 @@ 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);
    }

    @Override
@@ -52,7 +52,7 @@ public class ConfigTest {

            @HeaderComment("执行的指令列表")
            @InlineComment("建议以\"\"包裹")
-            public static final ConfigValue<List<String>> COMMANDS = ConfiguredList.builder(String.class)
+            public static final ConfigValue<List<String>> COMMANDS = ConfiguredList.builderOf(String.class)
                    .fromString().defaults("alert Commands here!").build();
        }

@@ -10,13 +10,14 @@
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>

-        <deps.easyconfifuration.version>3.3.3</deps.easyconfifuration.version>
-        <deps.easyplugin.version>1.4.20</deps.easyplugin.version>
+        <deps.easyconfifuration.version>3.8.0</deps.easyconfifuration.version>
+        <deps.easyplugin.version>1.5.8</deps.easyplugin.version>
+        <deps.yamlcommentwriter.version>1.0.1</deps.yamlcommentwriter.version>
    </properties>

    <groupId>cc.carm.lib</groupId>
    <artifactId>mineconfiguration-parent</artifactId>
-    <version>2.3.2</version>
+    <version>2.8.4</version>
    <packaging>pom</packaging>
    <modules>
        <module>common</module>
@@ -108,7 +109,7 @@
        <dependency>
            <groupId>org.jetbrains</groupId>
            <artifactId>annotations</artifactId>
-            <version>24.0.0</version>
+            <version>24.0.1</version>
            <scope>provided</scope>
        </dependency>

@@ -121,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>
@@ -129,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>
@@ -149,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>
@@ -160,7 +161,7 @@
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.10.1</version>
+                <version>3.11.0</version>
                <configuration>
                    <source>${project.jdk.version}</source>
                    <target>${project.jdk.version}</target>
@@ -177,7 +178,7 @@
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
-                <version>3.2.1</version>
+                <version>3.3.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
@@ -224,7 +225,7 @@
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.4.1</version>
+                    <version>3.5.0</version>
                    <executions>
                        <execution>
                            <phase>package</phase>
Author	SHA1	Message	Date
carm	bb9e24dd96	fix(item): 修复上下空行错误	2023-09-08 23:47:53 +08:00
carm	5bdc5908ef	feat(item): 支持为插入的LORE设置偏移量，以便在上方、下方空行，分割功能。	2023-09-08 22:15:28 +08:00
dependabot[bot]	dde304625e	chore(deps): bump cc.carm.lib:easyplugin-color from 1.5.7 to 1.5.8 (#41 ) Bumps [cc.carm.lib:easyplugin-color](https://github.com/CarmJos/EasyPlugin) from 1.5.7 to 1.5.8. - [Release notes](https://github.com/CarmJos/EasyPlugin/releases) - [Commits](https://github.com/CarmJos/EasyPlugin/compare/1.5.7...1.5.8) --- 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>	2023-09-07 22:23:55 +08:00
carm	24ef0b6dcd	feat(send): 提供物品预备方法，方便插入lore、修改附魔、flags等	2023-09-07 03:49:15 +08:00
carm	a1d6cf1258	feat(send): 提供新消息发送方法，分离玩家参数和消息参数	2023-09-07 02:31:57 +08:00
carm	0f7fc39f87	feat(send): 提供新消息发送方法，分离玩家参数和消息参数	2023-09-06 06:40:52 +08:00
dependabot[bot]	92ecb55a95	chore(deps): bump cc.carm.lib:easyplugin-color from 1.5.6 to 1.5.7 (#40 ) 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>	2023-09-06 01:10:37 +08:00
carm	bfd1624e85	chore(update): 适配上游版本更新。	2023-08-29 12:43:49 +08:00
dependabot[bot]	01d3c245a9	chore(deps): bump net.md-5:bungeecord-chat from 1.16-R0.4 to 1.20-R0.1 (#37 ) Bumps [net.md-5:bungeecord-chat](https://github.com/SpigotMC/BungeeCord) from 1.16-R0.4 to 1.20-R0.1. - [Commits](https://github.com/SpigotMC/BungeeCord/commits) --- updated-dependencies: - dependency-name: net.md-5:bungeecord-chat dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-08-08 14:09:36 +08:00
dependabot[bot]	8721c6085f	chore(deps): bump com.github.cryptomorin:XSeries from 9.4.0 to 9.5.0 (#36 ) Bumps [com.github.cryptomorin:XSeries](https://github.com/CryptoMorin/XSeries) from 9.4.0 to 9.5.0. - [Release notes](https://github.com/CryptoMorin/XSeries/releases) - [Commits](https://github.com/CryptoMorin/XSeries/compare/v9.4.0...v9.5.0) --- updated-dependencies: - dependency-name: com.github.cryptomorin:XSeries dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-08-08 14:09:23 +08:00
dependabot[bot]	eca4d47b8f	chore(deps): bump easyconfiguration-core from 3.7.0 to 3.7.1 (#35 ) Bumps [easyconfiguration-core](https://github.com/CarmJos/EasyConfiguration) from 3.7.0 to 3.7.1. - [Release notes](https://github.com/CarmJos/EasyConfiguration/releases) - [Commits](https://github.com/CarmJos/EasyConfiguration/compare/3.7.0...3.7.1) --- updated-dependencies: - dependency-name: cc.carm.lib:easyconfiguration-core 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>	2023-07-20 08:49:44 +08:00
dependabot[bot]	3750ac7d58	chore(deps): bump easyconfiguration-core from 3.6.0 to 3.7.0 (#34 ) Bumps [easyconfiguration-core](https://github.com/CarmJos/EasyConfiguration) from 3.6.0 to 3.7.0. - [Release notes](https://github.com/CarmJos/EasyConfiguration/releases) - [Commits](https://github.com/CarmJos/EasyConfiguration/compare/3.6.0...3.7.0) --- updated-dependencies: - dependency-name: cc.carm.lib:easyconfiguration-core dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-07-11 17:02:40 +08:00
dependabot[bot]	d3bdc4ad60	chore(deps): bump easyplugin-color from 1.5.4 to 1.5.6 (#33 ) Bumps [easyplugin-color](https://github.com/CarmJos/EasyPlugin) from 1.5.4 to 1.5.6. - [Release notes](https://github.com/CarmJos/EasyPlugin/releases) - [Commits](https://github.com/CarmJos/EasyPlugin/compare/1.5.4...1.5.6) --- 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>	2023-07-02 04:03:39 +08:00
dependabot[bot]	6bb6fb1b95	chore(deps): bump maven-shade-plugin from 3.4.1 to 3.5.0 (#32 ) Bumps [maven-shade-plugin](https://github.com/apache/maven-shade-plugin) from 3.4.1 to 3.5.0. - [Release notes](https://github.com/apache/maven-shade-plugin/releases) - [Commits](https://github.com/apache/maven-shade-plugin/compare/maven-shade-plugin-3.4.1...maven-shade-plugin-3.5.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-shade-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-06-17 21:22:09 +08:00
dependabot[bot]	dd2499512c	chore(deps): bump XSeries from 9.3.1 to 9.4.0 (#31 ) Bumps [XSeries](https://github.com/CryptoMorin/XSeries) from 9.3.1 to 9.4.0. - [Release notes](https://github.com/CryptoMorin/XSeries/releases) - [Commits](https://github.com/CryptoMorin/XSeries/compare/v9.3.1...v9.4.0) --- updated-dependencies: - dependency-name: com.github.cryptomorin:XSeries dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-06-14 09:58:56 +08:00
dependabot[bot]	3aa0542f01	chore(deps): bump maven-surefire-plugin from 3.1.0 to 3.1.2 (#30 ) Bumps [maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.1.0 to 3.1.2. - [Release notes](https://github.com/apache/maven-surefire/releases) - [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.1.0...surefire-3.1.2) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-surefire-plugin 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>	2023-06-09 13:36:34 +08:00
dependabot[bot]	4d9d5f5d84	chore(deps): bump maven-release-plugin from 3.0.0 to 3.0.1 (#29 ) Bumps [maven-release-plugin](https://github.com/apache/maven-release) from 3.0.0 to 3.0.1. - [Release notes](https://github.com/apache/maven-release/releases) - [Commits](https://github.com/apache/maven-release/compare/maven-release-3.0.0...maven-release-3.0.1) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-release-plugin 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>	2023-06-06 12:12:30 +08:00
carm	2b31ee1318	fix(item): 修复物品获取后修改被直接应用到缓存导致重复获取第一次物品的问题。	2023-06-01 02:32:45 +08:00
carm	9d6212e5ea	feat(conf): 为入口类添加了实例方法，方便快捷创建基础配置和消息配置文件。	2023-05-27 00:22:30 +08:00
carm	8f3d574446	feat(conf): 搭配XSeries实现部分配置类的跨版本支持。	2023-05-27 00:12:37 +08:00
dependabot[bot]	437e1d6d61	chore(deps): bump maven-source-plugin from 3.2.1 to 3.3.0 (#28 ) Bumps [maven-source-plugin](https://github.com/apache/maven-source-plugin) from 3.2.1 to 3.3.0. - [Commits](https://github.com/apache/maven-source-plugin/compare/maven-source-plugin-3.2.1...maven-source-plugin-3.3.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-source-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-05-23 21:33:19 +08:00
carm	a04b7c9c06	chore(update): 适配上游版本更新。	2023-05-21 17:30:03 +08:00
carm	74e88a126c	chore(update): 适配上游版本更新。	2023-05-21 17:29:02 +08:00
dependabot[bot]	79a65a94bc	chore(deps): bump maven-gpg-plugin from 3.0.1 to 3.1.0 (#26 ) Bumps [maven-gpg-plugin](https://github.com/apache/maven-gpg-plugin) from 3.0.1 to 3.1.0. - [Commits](https://github.com/apache/maven-gpg-plugin/compare/maven-gpg-plugin-3.0.1...maven-gpg-plugin-3.1.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-gpg-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-05-10 13:28:54 +08:00
dependabot[bot]	6ba08f7a67	chore(deps): bump maven-surefire-plugin from 3.0.0 to 3.1.0 (#27 ) Bumps [maven-surefire-plugin](https://github.com/apache/maven-surefire) from 3.0.0 to 3.1.0. - [Release notes](https://github.com/apache/maven-surefire/releases) - [Commits](https://github.com/apache/maven-surefire/compare/surefire-3.0.0...surefire-3.1.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-surefire-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-05-10 13:28:44 +08:00
dependabot[bot]	166b9fa0a8	chore(deps): bump maven-release-plugin from 2.5.3 to 3.0.0 (#25 ) Bumps [maven-release-plugin](https://github.com/apache/maven-release) from 2.5.3 to 3.0.0. - [Release notes](https://github.com/apache/maven-release/releases) - [Commits](https://github.com/apache/maven-release/compare/maven-release-2.5.3...maven-release-3.0.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-release-plugin dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-03-21 19:12:20 +08:00
dependabot[bot]	6257cdd114	chore(deps): bump placeholderapi from 2.11.2 to 2.11.3 (#24 ) Bumps placeholderapi from 2.11.2 to 2.11.3. --- updated-dependencies: - dependency-name: me.clip:placeholderapi 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>	2023-03-21 19:12:11 +08:00
carm	c28ee7d57b	feat(comments): 适配上游对配置文件保存方式的更新。	2023-03-20 20:28:40 +08:00
carm	3d1639362b	feat(value): 适配Manifest更新	2023-03-15 22:51:06 +08:00
dependabot[bot]	ce205e10fe	chore(deps): bump maven-surefire-plugin from 2.22.2 to 3.0.0 (#23 ) Bumps [maven-surefire-plugin](https://github.com/apache/maven-surefire) from 2.22.2 to 3.0.0. - [Release notes](https://github.com/apache/maven-surefire/releases) - [Commits](https://github.com/apache/maven-surefire/compare/surefire-2.22.2...surefire-3.0.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-surefire-plugin dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-03-15 14:01:38 +08:00
dependabot[bot]	8e4e712936	chore(deps): bump easyplugin-color from 1.5.3 to 1.5.4 (#22 ) Bumps [easyplugin-color](https://github.com/CarmJos/EasyPlugin) from 1.5.3 to 1.5.4. - [Release notes](https://github.com/CarmJos/EasyPlugin/releases) - [Commits](https://github.com/CarmJos/EasyPlugin/compare/1.5.3...1.5.4) --- 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>	2023-03-15 14:01:13 +08:00
dependabot[bot]	c3d9c65a86	chore(deps): bump easyplugin-color from 1.5.2 to 1.5.3 (#21 ) Bumps [easyplugin-color](https://github.com/CarmJos/EasyPlugin) from 1.5.2 to 1.5.3. - [Release notes](https://github.com/CarmJos/EasyPlugin/releases) - [Commits](https://github.com/CarmJos/EasyPlugin/compare/1.5.2...1.5.3) --- 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>	2023-03-08 18:32:44 +08:00
dependabot[bot]	ebddeff78d	chore(deps): bump annotations from 24.0.0 to 24.0.1 (#20 ) Bumps [annotations](https://github.com/JetBrains/java-annotations) from 24.0.0 to 24.0.1. - [Release notes](https://github.com/JetBrains/java-annotations/releases) - [Changelog](https://github.com/JetBrains/java-annotations/blob/master/CHANGELOG.md) - [Commits](https://github.com/JetBrains/java-annotations/commits) --- updated-dependencies: - dependency-name: org.jetbrains:annotations 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>	2023-03-03 12:58:40 +08:00
dependabot[bot]	afcdc2c378	chore(deps): bump maven-compiler-plugin from 3.10.1 to 3.11.0 (#19 ) Bumps [maven-compiler-plugin](https://github.com/apache/maven-compiler-plugin) from 3.10.1 to 3.11.0. - [Release notes](https://github.com/apache/maven-compiler-plugin/releases) - [Commits](https://github.com/apache/maven-compiler-plugin/compare/maven-compiler-plugin-3.10.1...maven-compiler-plugin-3.11.0) --- updated-dependencies: - dependency-name: org.apache.maven.plugins:maven-compiler-plugin dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>	2023-02-28 18:19:42 +08:00
carm	5905b25c73	chore(update): 适配上游版本更新。	2023-02-19 17:31:43 +08:00
carm	31f51c9b96	chore(update): 适配上游版本更新。	2023-02-19 17:28:58 +08:00
carm	eb8f279e0b	chore(update): 适配上游版本更新。	2023-02-19 17:28:45 +08:00
carm	e291c3a109	chore(update): 适配上游版本更新。	2023-02-19 04:22:14 +08:00
carm	433f780608	chore(update): 适配上游版本更新。	2023-02-19 04:22:02 +08:00