loader = YamlConfigurationLoader.builder()
+ .url(url).build()
+ final ConfigurationNode node = loader.load()
+ assertEquals(expected, node)
+ }
+
+ @Test
+ void testWriteBasicFile(final @TempDir Path tempDir) throws ConfigurateException, IOException {
+ final Path target = tempDir.resolve("write-basic.yml")
+ final ConfigurationNode node = BasicConfigurationNode.root { n ->
+ n.node("mapping", "first").set("hello")
+ n.node("mapping", "second").set("world")
+
+ n.node("list").act { c ->
+ c.appendListNode().set(1)
+ c.appendListNode().set(2)
+ c.appendListNode().set(3)
+ c.appendListNode().set(4)
+ }
+ }
+
+ final YamlConfigurationLoader loader = YamlConfigurationLoader.builder()
+ .path(target)
+ .nodeStyle(NodeStyle.BLOCK)
+ .build()
+
+ loader.save(node)
+
+ assertEquals(
+ getClass().getResource("write-expected.yml").getText(StandardCharsets.UTF_8.name()).replace("\r\n", "\n"),
+ target.getText(StandardCharsets.UTF_8.name()).replace("\r\n", "\n")
+ )
+ }
+}
diff --git a/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlParserComposerTest.groovy b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlParserComposerTest.groovy
new file mode 100644
index 000000000..983dd1731
--- /dev/null
+++ b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlParserComposerTest.groovy
@@ -0,0 +1,239 @@
+/*
+ * Configurate
+ * Copyright (C) zml and Configurate contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.spongepowered.configurate.yaml
+
+import static org.assertj.core.api.Assertions.assertThat
+import static org.assertj.core.api.Assertions.assertThatThrownBy
+
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+import org.spongepowered.configurate.ConfigurationNode
+import org.spongepowered.configurate.loader.ParsingException
+
+/**
+ * Tests of the basic functionality of our composer implementation.
+ *
+ * Comment-specific testing is handled in {@link CommentTest}
+ */
+class YamlParserComposerTest implements YamlTest {
+
+ @Test
+ void testEmptyDocument() throws IOException {
+ final ConfigurationNode result = parseString("")
+ assertThat(result.empty()).isTrue()
+ assertThat(result.raw()).isNull()
+ }
+
+ @Test
+ void testDuplicateKeysForbidden() throws IOException {
+ assertThatThrownBy { parseString '{duplicated: 1, duplicated: 2}' }
+ .isInstanceOf(ParsingException)
+ .hasMessageContaining("Duplicate key")
+ }
+
+ // Different types of scalars (folded, block, etc)
+
+ @Test
+ void testLoadPlainScalar() {
+ def result = parseString "hello world"
+ assertThat(result.raw())
+ .isEqualTo("hello world")
+
+ assertThat(result.hint(YamlConfigurationLoader.SCALAR_STYLE))
+ .isEqualTo(ScalarStyle.UNQUOTED)
+ }
+
+ @Test
+ void testLoadDoubleQuotedScalar() {
+ def result = parseString '"hello world"'
+ assertThat(result.raw())
+ .isEqualTo("hello world")
+
+ assertThat(result.hint(YamlConfigurationLoader.SCALAR_STYLE))
+ .isEqualTo(ScalarStyle.DOUBLE_QUOTED)
+ }
+
+ @Test
+ void testLoadSingleQuotedScalar() {
+ def result = parseString "'hello world'"
+ assertThat(result.raw())
+ .isEqualTo("hello world")
+
+ assertThat(result.hint(YamlConfigurationLoader.SCALAR_STYLE))
+ .isEqualTo(ScalarStyle.SINGLE_QUOTED)
+ }
+
+ @Test
+ void testLoadFoldedScalar() {
+ def result = parseString("""\
+ test: >
+ hello
+ world\
+ """.stripIndent(true).trim()).node("test")
+
+ assertThat(result.raw())
+ .isEqualTo("hello world")
+
+ assertThat(result.hint(YamlConfigurationLoader.SCALAR_STYLE))
+ .isEqualTo(ScalarStyle.FOLDED)
+ }
+
+ @Test
+ void testLoadBlockScalar() {
+ def result = parseString("""\
+ test: |
+ hello
+ world
+ """.stripIndent(true).trim()).node("test")
+
+ assertThat(result.raw())
+ .isEqualTo("hello\nworld")
+
+ assertThat(result.hint(YamlConfigurationLoader.SCALAR_STYLE))
+ .isEqualTo(ScalarStyle.LITERAL)
+
+ }
+
+ // More complex data structures
+
+ @Test
+ void testLoadMap() {
+ def result = parseString """\
+ hello:
+ world: yup!
+ two: [one, two, three]
+ "yes":
+ aaa: bbb
+ ccc: ddd
+ """.stripIndent(true)
+
+ assertThat(result.node('hello', 'world').raw())
+ .isEqualTo("yup!")
+
+ assertThat(result.node('hello', 'two', 0).raw())
+ .isEqualTo('one')
+
+ assertThat(result.node('hello', 'two').getList(String))
+ .containsExactly('one', 'two', 'three')
+
+ assertThat(result.node('hello', 'yes', 'aaa').raw())
+ .isEqualTo('bbb')
+
+ assertThat(result.node('hello', 'yes', 'ccc').raw())
+ .isEqualTo('ddd')
+ }
+
+ @Test
+ void testLoadSequence() {
+ def result = parseString """\
+ flow: [a, b, c]
+ block:
+ - d
+ - e
+ - f
+ """.stripIndent(true)
+
+ assertThat(result.node('flow').getList(String))
+ .containsExactly('a', 'b', 'c')
+ assertThat(result.node('flow').hint(YamlConfigurationLoader.NODE_STYLE))
+ .isEqualTo(NodeStyle.FLOW)
+
+ assertThat(result.node('block').getList(String))
+ .containsExactly('d', 'e', 'f')
+ assertThat(result.node('block').hint(YamlConfigurationLoader.NODE_STYLE))
+ .isEqualTo(NodeStyle.BLOCK)
+ }
+
+
+ @Test
+ void testLoadAlias() {
+ def result = parseString """\
+ src: &ref [a, b, c]
+ dest: *ref
+ """.stripIndent(true)
+
+ def src = result.node('src')
+ def dest = result.node('dest')
+
+ // Value transferred
+ assertThat(dest.getList(String))
+ .containsExactly('a', 'b', 'c')
+
+ // Anchor information preserved
+ // TODO: this may be different once proper reference nodes are implemented
+ assertThat(src.hint(YamlConfigurationLoader.ANCHOR_ID))
+ .isEqualTo('ref')
+
+ assertThat(dest.hint(YamlConfigurationLoader.ANCHOR_ID))
+ .isNull()
+ }
+
+ @Test
+ void testCommentsOnNullValuePreserved() {
+ def result = parseString """\
+ # the greetings
+ hello:
+ # - abc
+ # - def
+ """
+
+ assertThat(result.node('hello').comment())
+ .isEqualTo("the greetings")
+ }
+
+ // Test that implicit tags are resolved properly
+
+ @Test
+ void testMergeKey() {
+ def result = parseString """\
+ src: &ref
+ old: merged
+ dest:
+ <<: *ref
+ new: added
+ """.stripIndent(true)
+
+ def src = result.node('src')
+ def dest = result.node('dest')
+
+ // Value transferred
+ assertThat(dest.childrenMap().keySet())
+ .containsExactly('old', 'new')
+ }
+
+ @Test
+ void testYIsNotBoolean() {
+ def result = parseString """\
+ asVal: y
+ y: asKey
+ """
+
+ assertThat(result.node('asVal')).with {
+ extracting { it.virtual() }
+ .is(false)
+ extracting { it.raw() }
+ .isEqualTo("y")
+ }
+ assertThat(result.node("y")).with {
+ extracting { it.virtual() }
+ .is(false)
+ extracting { it.raw() }
+ .isEqualTo('asKey')
+ }
+ }
+
+}
diff --git a/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlTest.groovy b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlTest.groovy
new file mode 100644
index 000000000..3f9a81291
--- /dev/null
+++ b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlTest.groovy
@@ -0,0 +1,100 @@
+/*
+ * Configurate
+ * Copyright (C) zml and Configurate contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.spongepowered.configurate.yaml
+
+import static org.junit.jupiter.api.Assertions.assertNotNull
+
+import org.spongepowered.configurate.CommentedConfigurationNode
+import org.yaml.snakeyaml.LoaderOptions
+import org.yaml.snakeyaml.events.CollectionEndEvent
+import org.yaml.snakeyaml.events.CollectionStartEvent
+import org.yaml.snakeyaml.parser.ParserImpl
+import org.yaml.snakeyaml.reader.StreamReader
+import org.yaml.snakeyaml.scanner.ScannerImpl
+
+trait YamlTest {
+
+ CommentedConfigurationNode parseString(final String input) {
+ // Print events
+ def loaderOpts = new LoaderOptions().tap {
+ processComments = true
+ acceptTabs = true
+ }
+ this.dumpEvents(new StreamReader(input), loaderOpts)
+
+ final YamlParserComposer loader = new YamlParserComposer(new StreamReader(input), loaderOpts, Yaml11Tags.REPOSITORY)
+ final CommentedConfigurationNode result = CommentedConfigurationNode.root()
+ loader.singleDocumentStream(result)
+ return result
+ }
+
+ CommentedConfigurationNode parseResource(final URL url) {
+ // Print events
+ def loaderOpts = new LoaderOptions().tap {
+ processComments = true
+ acceptTabs = true
+ }
+ url.openStream().withReader('UTF-8') {reader ->
+ this.dumpEvents(new StreamReader(reader), loaderOpts)
+ }
+
+ assertNotNull(url, "Expected resource is missing")
+ url.openStream().withReader('UTF-8') { reader ->
+ final YamlParserComposer loader = new YamlParserComposer(new StreamReader(reader), loaderOpts, Yaml11Tags.REPOSITORY)
+ final CommentedConfigurationNode result = CommentedConfigurationNode.root()
+ loader.singleDocumentStream(result)
+ return result
+ }
+ }
+
+ private void dumpEvents(StreamReader reader, LoaderOptions loaderOpts) {
+ def scanner = new ScannerImpl(reader, loaderOpts)
+ def parser = new ParserImpl(scanner)
+ int indentLevel = 0
+ while (true) {
+ if (parser.peekEvent() instanceof CollectionEndEvent) {
+ indentLevel--
+ }
+ indentLevel.times {
+ print " "
+ }
+ if (parser.peekEvent() instanceof CollectionStartEvent) {
+ indentLevel++
+ }
+
+ println parser.getEvent()
+ if (!parser.peekEvent()) break
+ }
+ }
+
+ String dump(final CommentedConfigurationNode input) {
+ return dump(input, null)
+ }
+
+ String dump(final CommentedConfigurationNode input, final NodeStyle preferredStyle) {
+ return YamlConfigurationLoader.builder()
+ .nodeStyle(preferredStyle)
+ .indent(2)
+ .commentsEnabled(true)
+ .buildAndSaveString(input)
+ }
+
+ String normalize(final String input) {
+ return input.stripIndent(true)
+ }
+
+}
diff --git a/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlVisitorTest.groovy b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlVisitorTest.groovy
new file mode 100644
index 000000000..82b9f98b8
--- /dev/null
+++ b/format/yaml/src/test/groovy/org/spongepowered/configurate/yaml/YamlVisitorTest.groovy
@@ -0,0 +1,111 @@
+/*
+ * Configurate
+ * Copyright (C) zml and Configurate contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.spongepowered.configurate.yaml
+
+import static org.junit.jupiter.api.Assertions.assertEquals
+
+import org.junit.jupiter.api.Test
+import org.spongepowered.configurate.CommentedConfigurationNode
+
+/**
+ * Testing YAML emmission.
+ */
+class YamlVisitorTest implements YamlTest {
+
+ @Test
+ void testPlainScalar() {
+ def node = CommentedConfigurationNode.root().set("test")
+
+ assertEquals("test\n", dump(node))
+ }
+
+ @Test
+ void testNumbersAreNonPlainScalar() {
+ def node = CommentedConfigurationNode.root().set("1234")
+
+ assertEquals("\"1234\"\n", dump(node))
+ }
+
+ @Test
+ void testBlockSequence() {
+ final def node = CommentedConfigurationNode.root {
+ appendListNode().set("Hello")
+ appendListNode().set("World")
+ appendListNode().act {
+ it.node("one").set("aaa")
+ it.node("two").set("bbb")
+ }
+ }
+
+ final def expected = normalize("""\
+ - Hello
+ - World
+ - one: aaa
+ two: bbb
+ """)
+ assertEquals(expected, this.dump(node, NodeStyle.BLOCK))
+ }
+
+ @Test
+ void testBlockMapping() {
+ final def node = CommentedConfigurationNode.root {
+ node("meow").set("purr")
+ node("eight").set(1234)
+ node("fun").set(true)
+ }
+
+ final def expected = normalize("""\
+ meow: purr
+ eight: 1234
+ fun: true
+ """)
+ assertEquals(expected, this.dump(node, NodeStyle.BLOCK))
+ }
+
+ @Test
+ void testFlowSequence() {
+ final def node = CommentedConfigurationNode.root {
+ appendListNode().set("Hello")
+ appendListNode().set("World")
+ appendListNode().act {
+ it.node("one").set("aaa")
+ it.node("two").set("bbb")
+ }
+ }
+
+ final def expected = "[Hello, World, {one: aaa, two: bbb}]\n"
+ assertEquals(expected, this.dump(node, NodeStyle.FLOW))
+ }
+
+ @Test
+ void testFlowMapping() {
+ final def node = CommentedConfigurationNode.root {
+ node("meow").set("purr")
+ node("eight").set(1234)
+ node("fun").set(true)
+ }
+
+ final def expected = "{meow: purr, eight: 1234, fun: true}\n"
+ assertEquals(expected, this.dump(node, NodeStyle.FLOW))
+ }
+
+ @Test
+ void testComplex() {
+
+ }
+
+}
diff --git a/format/yaml/src/test/java/org/spongepowered/configurate/yaml/YamlConfigurationLoaderTest.java b/format/yaml/src/test/java/org/spongepowered/configurate/yaml/YamlConfigurationLoaderTest.java
deleted file mode 100644
index 0c74f0165..000000000
--- a/format/yaml/src/test/java/org/spongepowered/configurate/yaml/YamlConfigurationLoaderTest.java
+++ /dev/null
@@ -1,114 +0,0 @@
-/*
- * Configurate
- * Copyright (C) zml and Configurate contributors
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-package org.spongepowered.configurate.yaml;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
-import io.leangen.geantyref.TypeToken;
-import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.io.TempDir;
-import org.spongepowered.configurate.BasicConfigurationNode;
-import org.spongepowered.configurate.CommentedConfigurationNode;
-import org.spongepowered.configurate.ConfigurateException;
-import org.spongepowered.configurate.ConfigurationNode;
-import org.spongepowered.configurate.loader.ConfigurationLoader;
-
-import java.io.BufferedReader;
-import java.io.IOException;
-import java.io.InputStreamReader;
-import java.net.URL;
-import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
-import java.nio.file.Path;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.Map;
-import java.util.stream.Collectors;
-
-/**
- * Basic sanity checks for the loader.
- */
-class YamlConfigurationLoaderTest {
-
- @Test
- void testSimpleLoading() throws ConfigurateException {
- final URL url = this.getClass().getResource("/example.yml");
- final ConfigurationLoader loader = YamlConfigurationLoader.builder()
- .url(url).build();
- final ConfigurationNode node = loader.load();
- assertEquals("unicorn", node.node("test", "op-level").raw());
- assertEquals("dragon", node.node("other", "op-level").raw());
- assertEquals("dog park", node.node("other", "location").raw());
-
-
- final List>> fooList = new ArrayList<>(node.node("foo")
- .getList(new TypeToken>>() {}));
- assertEquals(0, fooList.get(0).get("bar").size());
- }
-
- @Test
- void testReadWithTabs() throws ConfigurateException {
- final ConfigurationNode expected = CommentedConfigurationNode.root(n -> {
- n.node("document").act(d -> {
- d.node("we").raw("support tabs");
- d.node("and").raw("literal tabs\tin strings");
- d.node("with").act(w -> {
- w.appendListNode().raw("more levels");
- w.appendListNode().raw("of indentation");
- });
- });
- });
-
- final URL url = this.getClass().getResource("/tab-example.yml");
- final ConfigurationLoader loader = YamlConfigurationLoader.builder()
- .url(url).build();
- final ConfigurationNode node = loader.load();
- assertEquals(expected, node);
- }
-
- @Test
- void testWriteBasicFile(final @TempDir Path tempDir) throws ConfigurateException, IOException {
- final Path target = tempDir.resolve("write-basic.yml");
- final ConfigurationNode node = BasicConfigurationNode.root(n -> {
- n.node("mapping", "first").set("hello");
- n.node("mapping", "second").set("world");
-
- n.node("list").act(c -> {
- c.appendListNode().set(1);
- c.appendListNode().set(2);
- c.appendListNode().set(3);
- c.appendListNode().set(4);
- });
- });
-
- final YamlConfigurationLoader loader = YamlConfigurationLoader.builder()
- .path(target)
- .nodeStyle(NodeStyle.BLOCK)
- .build();
-
- loader.save(node);
-
- assertEquals(readLines(this.getClass().getResource("write-expected.yml")), Files.readAllLines(target, StandardCharsets.UTF_8));
- }
-
- private static List readLines(final URL source) throws IOException {
- try (BufferedReader reader = new BufferedReader(new InputStreamReader(source.openStream(), StandardCharsets.UTF_8))) {
- return reader.lines().collect(Collectors.toList());
- }
- }
-
-}
diff --git a/format/yaml/src/test/resources/META-INF/groovy/org.codehaus.groovy.runtime.ExtensionModule b/format/yaml/src/test/resources/META-INF/groovy/org.codehaus.groovy.runtime.ExtensionModule
new file mode 100644
index 000000000..6b18e9437
--- /dev/null
+++ b/format/yaml/src/test/resources/META-INF/groovy/org.codehaus.groovy.runtime.ExtensionModule
@@ -0,0 +1,4 @@
+moduleName=Configurate Extensions for YAML Tests
+moduleVersion=test
+extensionClasses=
+staticExtensionClasses=org.spongepowered.configurate.yaml.ConfigurationNodeStaticExtensions
\ No newline at end of file
diff --git a/format/yaml/src/test/resources/example.yml b/format/yaml/src/test/resources/example.yml
deleted file mode 100644
index 165d9b5c1..000000000
--- a/format/yaml/src/test/resources/example.yml
+++ /dev/null
@@ -1,8 +0,0 @@
-test:
- op-level: unicorn
-other:
- op-level: dragon
- location: dog park
-
-foo:
- bar: []
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/comments-complex.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/comments-complex.yml
new file mode 100644
index 000000000..bd9288afa
--- /dev/null
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/comments-complex.yml
@@ -0,0 +1,11 @@
+# Header
+# This file contains a more complex example
+# to test comment reading.
+
+core:
+ users:
+ # comment on list entry
+ - # ambiguous comment
+ first: one
+ # very mapping
+ second: two
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-example.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-example.yml
new file mode 100644
index 000000000..4d3a3a91d
--- /dev/null
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-example.yml
@@ -0,0 +1,1167 @@
+############################################################
+# +------------------------------------------------------+ #
+# | Notes | #
+# +------------------------------------------------------+ #
+############################################################
+
+# This is the config file for EssentialsX.
+# This config was generated for version 2.19.0-dev+227-87a6cf7.
+
+# If you want to use special characters in this document, such as accented letters, you MUST save the file as UTF-8, not ANSI.
+# If you receive an error when Essentials loads, ensure that:
+# - No tabs are present: YAML only allows spaces
+# - Indents are correct: YAML hierarchy is based entirely on indentation
+# - You have "escaped" all apostrophes in your text: If you want to write "don't", for example, write "don''t" instead (note the doubled apostrophe)
+# - Text with symbols is enclosed in single or double quotation marks
+
+# If you need help, you can join the EssentialsX community: https://essentialsx.net/community.html
+
+############################################################
+# +------------------------------------------------------+ #
+# | Essentials (Global) | #
+# +------------------------------------------------------+ #
+############################################################
+
+# A color code between 0-9 or a-f. Set to 'none' to disable.
+# In 1.16+ you can use hex color codes here as well. (For example, #613e1d is brown).
+ops-name-color: '4'
+
+# The character(s) to prefix all nicknames, so that you know they are not true usernames.
+nickname-prefix: '~'
+
+# The maximum length allowed in nicknames. The nickname prefix is included in this.
+max-nick-length: 15
+
+# A list of phrases that cannot be used in nicknames. You can include regular expressions here.
+# Users with essentials.nick.blacklist.bypass will be able to bypass this filter.
+nick-blacklist:
+# - Notch
+# - '^Dinnerbone'
+
+# When this option is enabled, nickname length checking will exclude color codes in player names.
+# ie: "&6Notch" has 7 characters (2 are part of a color code), a length of 5 is used when this option is set to true
+ignore-colors-in-max-nick-length: false
+
+# When this option is enabled, display names for hidden users will not be shown. This prevents players from being
+# able to see that they are online while vanished.
+hide-displayname-in-vanish: true
+
+# Disable this if you have any other plugin, that modifies the displayname of a user.
+change-displayname: true
+
+# When this option is enabled, the (tab) player list will be updated with the displayname.
+# The value of change-displayname (above) has to be true.
+# change-playerlist: true
+
+# When EssentialsChat.jar isn't used, force essentials to add the prefix and suffix from permission plugins to displayname.
+# This setting is ignored if EssentialsChat.jar is used, and defaults to 'true'.
+# The value of change-displayname (above) has to be true.
+# Do not edit this setting unless you know what you are doing!
+# add-prefix-suffix: false
+
+# When this option is enabled, player prefixes will be shown in the playerlist.
+# This feature only works for Minecraft version 1.8 and higher.
+# This value of change-playerlist has to be true
+# add-prefix-in-playerlist: true
+
+# When this option is enabled, player suffixes will be shown in the playerlist.
+# This feature only works for Minecraft version 1.8 and higher.
+# This value of change-playerlist has to be true
+# add-suffix-in-playerlist: true
+
+# If the teleport destination is unsafe, should players be teleported to the nearest safe location?
+# If this is set to true, Essentials will attempt to teleport players close to the intended destination.
+# If this is set to false, attempted teleports to unsafe locations will be cancelled with a warning.
+teleport-safety: true
+
+# This forcefully disables teleport safety checks without a warning if attempting to teleport to unsafe locations.
+# teleport-safety and this option need to be set to true to force teleportation to dangerous locations.
+force-disable-teleport-safety: false
+
+# If a player is teleporting to an unsafe location in creative, adventure, or god mode; they will not be teleported to a
+# safe location. If you'd like players to be teleported to a safe location all of the time, set this option to true.
+force-safe-teleport-location: false
+
+# If a player has any passengers, the teleport will fail. Should their passengers be dismounted before they are teleported?
+# If this is set to true, Essentials will dismount the player's passengers before teleporting.
+# If this is set to false, attempted teleports will be canceled with a warning.
+teleport-passenger-dismount: true
+
+# The delay, in seconds, required between /home, /tp, etc.
+teleport-cooldown: 0
+
+# The delay, in seconds, before a user actually teleports. If the user moves or gets attacked in this timeframe, the teleport is cancelled.
+teleport-delay: 0
+
+# The delay, in seconds, a player can't be attacked by other players after they have been teleported by a command.
+# This will also prevent the player attacking other players.
+teleport-invulnerability: 4
+
+# Whether to make all teleportations go to the center of the block; where the x and z coordinates decimal become .5
+teleport-to-center: true
+
+# The delay, in seconds, required between /heal or /feed attempts.
+heal-cooldown: 60
+
+# Do you want to remove potion effects when healing a player?
+remove-effects-on-heal: true
+
+# Near Radius
+# The default radius with /near
+# Used to use chat radius but we are going to make it separate.
+near-radius: 200
+
+# What to prevent from /item and /give.
+# e.g item-spawn-blacklist: 10,11,46
+item-spawn-blacklist:
+
+# Set this to true if you want permission based item spawn rules.
+# Note: The blacklist above will be ignored then.
+# Example permissions (these go in your permissions manager):
+# - essentials.itemspawn.item-all
+# - essentials.itemspawn.item-[itemname]
+# - essentials.itemspawn.item-[itemid]
+# - essentials.give.item-all
+# - essentials.give.item-[itemname]
+# - essentials.give.item-[itemid]
+# - essentials.unlimited.item-all
+# - essentials.unlimited.item-[itemname]
+# - essentials.unlimited.item-[itemid]
+# - essentials.unlimited.item-bucket # Unlimited liquid placing
+
+# For more information, visit http://wiki.ess3.net/wiki/Command_Reference/ICheat#Item.2FGive
+permission-based-item-spawn: false
+
+# Mob limit on the /spawnmob command per execution.
+spawnmob-limit: 10
+
+# Shall we notify users when using /lightning?
+warn-on-smite: true
+
+# Shall we drop items instead of adding to inventory if the target inventory is full?
+drop-items-if-full: false
+
+# Essentials Mail Notification
+# Should we notify players if they have no new mail?
+notify-no-new-mail: true
+
+# Specifies the duration (in seconds) between each time a player is notified of mail they have.
+# Useful for servers with a lot of mail traffic.
+notify-player-of-mail-cooldown: 60
+
+# The motd and rules are now configured in the files motd.txt and rules.txt.
+
+# When a command conflicts with another plugin, by default, Essentials will try to force the OTHER plugin to take priority.
+# Commands in this list, will tell Essentials to 'not give up' the command to other plugins.
+# In this state, which plugin 'wins' appears to be almost random.
+
+# If you have two plugin with the same command and you wish to force Essentials to take over, you need an alias.
+# To force essentials to take 'god' alias 'god' to 'egod'.
+# See http://wiki.bukkit.org/Commands.yml#aliases for more information.
+
+overridden-commands:
+# - god
+# - info
+
+# Disabling commands here will prevent Essentials handling the command, this will not affect command conflicts.
+# You should not have to disable commands used in other plugins, they will automatically get priority.
+# See http://wiki.bukkit.org/Commands.yml#aliases to map commands to other plugins.
+disabled-commands:
+# - nick
+# - clear
+
+# These commands will be shown to players with socialSpy enabled.
+# You can add commands from other plugins you may want to track or
+# remove commands that are used for something you dont want to spy on.
+# Set - '*' in order to listen on all possible commands.
+socialspy-commands:
+ - msg
+ - w
+ - r
+ - mail
+ - m
+ - t
+ - whisper
+ - emsg
+ - tell
+ - er
+ - reply
+ - ereply
+ - email
+ - action
+ - describe
+ - eme
+ - eaction
+ - edescribe
+ - etell
+ - ewhisper
+ - pm
+
+# Whether the private and public messages from muted players should appear in the social spy.
+# If so, they will be differentiated from those sent by normal players.
+socialspy-listen-muted-players: true
+
+# Whether social spy should spy on private messages or just the commands from the list above.
+# If false, social spy will only monitor commands from the list above.
+socialspy-messages: true
+
+# The following settings listen for when a player changes worlds.
+# If you use another plugin to control speed and flight, you should change these to false.
+
+# When a player changes world, should EssentialsX reset their flight?
+# This will disable flight if the player does not have essentials.fly.
+world-change-fly-reset: true
+
+# When a player changes world, should we reset their speed according to their permissions?
+# This resets the player's speed to the default if they don't have essentials.speed.
+# If the player doesn't have essentials.speed.bypass, this resets their speed to the maximum specified above.
+world-change-speed-reset: true
+
+# Mute Commands
+# These commands will be disabled when a player is muted.
+# Use '*' to disable every command.
+# Essentials already disabled Essentials messaging commands by default.
+# It only cares about the root command, not args after that (it sees /f chat the same as /f)
+mute-commands:
+ - f
+ - kittycannon
+ # - '*'
+
+# If you do not wish to use a permission system, you can define a list of 'player perms' below.
+# This list has no effect if you are using a supported permissions system.
+# If you are using an unsupported permissions system, simply delete this section.
+# Whitelist the commands and permissions you wish to give players by default (everything else is op only).
+# These are the permissions without the "essentials." part.
+
+# To enable this feature, please set use-bukkit-permissions to false.
+player-commands:
+ - afk
+ - afk.auto
+ - back
+ - back.ondeath
+ - balance
+ - balance.others
+ - balancetop
+ - build
+ - chat.color
+ - chat.format
+ - chat.shout
+ - chat.question
+ - clearinventory
+ - compass
+ - depth
+ - delhome
+ - getpos
+ - geoip.show
+ - help
+ - helpop
+ - home
+ - home.others
+ - ignore
+ - info
+ - itemdb
+ - kit
+ - kits.tools
+ - list
+ - mail
+ - mail.send
+ - me
+ - motd
+ - msg
+ - msg.color
+ - nick
+ - near
+ - pay
+ - ping
+ - protect
+ - r
+ - rules
+ - realname
+ - seen
+ - sell
+ - sethome
+ - setxmpp
+ - signs.create.protection
+ - signs.create.trade
+ - signs.break.protection
+ - signs.break.trade
+ - signs.use.balance
+ - signs.use.buy
+ - signs.use.disposal
+ - signs.use.enchant
+ - signs.use.free
+ - signs.use.gamemode
+ - signs.use.heal
+ - signs.use.info
+ - signs.use.kit
+ - signs.use.mail
+ - signs.use.protection
+ - signs.use.repair
+ - signs.use.sell
+ - signs.use.time
+ - signs.use.trade
+ - signs.use.warp
+ - signs.use.weather
+ - spawn
+ - suicide
+ - time
+ - tpa
+ - tpaccept
+ - tpahere
+ - tpdeny
+ - warp
+ - warp.list
+ - world
+ - worth
+ - xmpp
+
+# Use this option to force superperms-based permissions handler regardless of detected installed perms plugin.
+# This is useful if you want superperms-based permissions (with wildcards) for custom permissions plugins.
+# If you wish to use EssentialsX's built-in permissions using the `player-commands` section above, set this to false.
+# Default is true.
+use-bukkit-permissions: true
+
+# When this option is enabled, one-time use kits (ie. delay < 0) will be
+# removed from the /kit list when a player can no longer use it
+skip-used-one-time-kits-from-kit-list: false
+
+# When enabled, armor from kits will automatically be equipped as long as the player's armor slots are empty.
+kit-auto-equip: false
+
+# Determines the functionality of the /createkit command.
+# If this is true, /createkit will give the user a link with the kit code.
+# If this is false, /createkit will add the kit to the kits.yml config file directly.
+# Default is false.
+pastebin-createkit: false
+
+# Determines if /createkit will generate kits using NBT item serialization.
+# If this is true, /createkit will store items as NBT; otherwise, it will use Essentials' human-readable item format.
+# By using NBT serialization, /createkit can store items with complex metadata such as shulker boxes and weapons with custom attributes.
+# WARNING: This option only works on 1.15.2+ Paper servers, and it will bypass any custom serializers from other plugins such as Magic.
+# WARNING: When creating kits via /createkit with this option enabled, you will not be able to downgrade your server with these kit items.
+# This option only affects /createkit - you can still create kits by hand in `kits.yml` using Essentials' human-readable item format.
+# Default is false.
+use-nbt-serialization-in-createkit: false
+
+# Essentials Sign Control
+# See http://wiki.ess3.net/wiki/Sign_Tutorial for instructions on how to use these.
+# To enable signs, remove # symbol. To disable all signs, comment/remove each sign.
+# Essentials colored sign support will be enabled when any sign types are enabled.
+# Color is not an actual sign, it's for enabling using color codes on signs, when the correct permissions are given.
+
+enabledSigns:
+ # - color
+ # - balance
+ # - buy
+ # - sell
+ # - trade
+ # - free
+ # - warp
+ # - kit
+ # - mail
+ # - enchant
+ # - gamemode
+ # - heal
+ # - info
+ # - spawnmob
+ # - repair
+ # - time
+ # - weather
+ # - anvil
+ # - cartography
+ # - disposal
+ # - grindstone
+ # - loom
+ # - smithing
+ # - workbench
+
+# How many times per second can Essentials signs be interacted with per player.
+# Values should be between 1-20, 20 being virtually no lag protection.
+# Lower numbers will reduce the possibility of lag, but may annoy players.
+sign-use-per-second: 4
+
+# Allow item IDs on pre-existing signs on 1.13 and above.
+# You cannot use item IDs on new signs, but this will allow players to interact with signs that
+# were placed before 1.13.
+allow-old-id-signs: false
+
+# List of sign names Essentials should not protect. This feature is especially useful when
+# another plugin provides a sign that EssentialsX provides, but Essentials overrides.
+# For example, if a plugin provides a [kit] sign, and you wish to use theirs instead of
+# Essentials's, then simply add kit below and Essentials will not protect it.
+
+# See https://github.com/drtshock/Essentials/pull/699 for more information.
+unprotected-sign-names:
+ # - kit
+
+# Backup runs a custom batch/bash command at a specified interval.
+# The server will save the world before executing the backup command, and disable
+# saving during the backup to prevent world corruption or other conflicts.
+# Backups can also be triggered manually with /backup.
+backup:
+ # Interval in minutes.
+ interval: 30
+
+ # If true, the backup task will run even if there are no players online.
+ always-run: false
+
+ # Unless you add a valid backup command or script here, this feature will be useless.
+ # Use 'save-all' to simply force regular world saving without backup.
+ # The example command below utilizes rdiff-backup: https://rdiff-backup.net/
+ # command: 'rdiff-backup World1 backups/World1'
+
+# Set this true to enable permission per warp.
+per-warp-permission: false
+
+# Sort output of /list command by groups.
+# You can hide and merge the groups displayed in /list by defining the desired behaviour here.
+# Detailed instructions and examples can be found on the wiki: http://wiki.ess3.net/wiki/List
+list:
+ # To merge groups, list the groups you wish to merge
+ # Staff: owner admin moderator
+ Admins: owner admin
+ # To limit groups, set a max user limit
+ # builder: 20
+ # To hide groups, set the group as hidden
+ # default: hidden
+ # Uncomment the line below to simply list all players with no grouping
+ # Players: '*'
+
+# Displays real names in /list next to players who are using a nickname.
+real-names-on-list: false
+
+# More output to the console.
+debug: false
+
+# Set the locale for all messages.
+# If you don't set this, the default locale of the server will be used.
+# For example, to set language to English, set locale to en, to use the file "messages_en.properties".
+# Don't forget to remove the # in front of the line.
+# For more information, visit http://wiki.ess3.net/wiki/Locale
+# locale: en
+
+# Turn off god mode when people leave the server.
+remove-god-on-disconnect: false
+
+# Auto-AFK
+# After this timeout in seconds, the user will be set as AFK.
+# This feature requires the player to have essentials.afk.auto node.
+# Set to -1 for no timeout.
+auto-afk: 300
+
+# Auto-AFK Kick
+# After this timeout in seconds, the user will be kicked from the server.
+# essentials.afk.kickexempt node overrides this feature.
+# Set to -1 for no timeout.
+auto-afk-kick: -1
+
+# Set this to true, if you want to freeze the player, if the player is AFK.
+# Other players or monsters can't push the player out of AFK mode then.
+# This will also enable temporary god mode for the AFK player.
+# The player has to use the command /afk to leave the AFK mode.
+freeze-afk-players: false
+
+# When the player is AFK, should he be able to pickup items?
+# Enable this, when you don't want people idling in mob traps.
+disable-item-pickup-while-afk: false
+
+# This setting controls if a player is marked as active on interaction.
+# When this setting is false, the player would need to manually un-AFK using the /afk command.
+cancel-afk-on-interact: true
+
+# Should we automatically remove afk status when a player moves?
+# Player will be removed from AFK on chat/command regardless of this setting.
+# Disable this to reduce server lag.
+cancel-afk-on-move: true
+
+# Should we automatically remove afk status when a player sends a chat message?
+cancel-afk-on-chat: true
+
+# Should AFK players be ignored when other players are trying to sleep?
+# When this setting is false, players won't be able to skip the night if some players are AFK.
+# Users with the permission node essentials.sleepingignored will always be ignored.
+sleep-ignores-afk-players: true
+
+# Should vanished players be ignored when other players are trying to sleep?
+# When this setting is false, player's won't be able to skip the night if vanished players are not sleeping.
+# Users with the permission node essentials.sleepingignored will always be ignored.
+sleep-ignores-vanished-player: true
+
+# Set the player's list name when they are AFK. This is none by default which specifies that Essentials
+# should not interfere with the AFK player's list name.
+# You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.
+afk-list-name: "none"
+
+# When a player enters or exits AFK mode, should the AFK notification be broadcast
+# to the entire server, or just to the player?
+# When this setting is false, only the player will be notified upon changing their AFK state.
+broadcast-afk-message: true
+
+# You can disable the death messages of Minecraft here.
+death-messages: true
+
+# How should essentials handle players with the essentials.keepinv permission who have items with
+# curse of vanishing when they die?
+# You can set this to "keep" (to keep the item), "drop" (to drop the item), or "delete" (to delete the item).
+# Defaults to "keep"
+vanishing-items-policy: keep
+
+# How should essentials handle players with the essentials.keepinv permission who have items with
+# curse of binding when they die?
+# You can set this to "keep" (to keep the item), "drop" (to drop the item), or "delete" (to delete the item).
+# Defaults to "keep"
+binding-items-policy: keep
+
+# When players die, should they receive the coordinates they died at?
+send-info-after-death: false
+
+# Should players with permissions be able to join and part silently?
+# You can control this with essentials.silentjoin and essentials.silentquit permissions if it is enabled.
+# In addition, people with essentials.silentjoin.vanish will be vanished on join.
+allow-silent-join-quit: false
+
+# You can set custom join and quit messages here. Set this to "none" to use the default Minecraft message,
+# or set this to "" to hide the message entirely.
+
+# Available placeholders:
+# {PLAYER} - The player's displayname.
+# {USERNAME} - The player's username.
+# {PREFIX} - The player's prefix.
+# {SUFFIX} - The player's suffix.
+# {ONLINE} - The number of players online.
+# {UNIQUE} - The number of unique players to join the server.
+# {UPTIME} - The amount of time the server has been online.
+custom-join-message: "none"
+custom-quit-message: "none"
+
+# You can set a custom join message for users who join with a new username here.
+# This message will only be used if a user has joined before and have since changed their username.
+# This will be displayed INSTEAD OF custom-join-message, so if you intend to keep them similar, make sure they match.
+# Set this to "none" to use the the "custom-join-message" above for every join.
+
+# Available placeholders:
+# {PLAYER} - The player's displayname.
+# {USERNAME} - The player's username.
+# {OLDUSERNAME} - The player's old username.
+# {PREFIX} - The player's prefix.
+# {SUFFIX} - The player's suffix.
+# {ONLINE} - The number of players online.
+# {UNIQUE} - The number of unique players to join the server.
+# {UPTIME} - The amount of time the server has been online.
+custom-new-username-message: "none"
+
+# Should Essentials override the vanilla "Server Full" message with its own from the language file?
+# Set to false to keep the vanilla message.
+use-custom-server-full-message: true
+
+# You can disable join and quit messages when the player count reaches a certain limit.
+# When the player count is below this number, join/quit messages will always be shown.
+# Set this to -1 to always show join and quit messages regardless of player count.
+hide-join-quit-messages-above: -1
+
+# Add worlds to this list, if you want to automatically disable god mode there.
+no-god-in-worlds:
+# - world_nether
+
+# Set to true to enable per-world permissions for teleporting between worlds with essentials commands.
+# This applies to /world, /back, /tp[a|o][here|all], but not warps.
+# Give someone permission to teleport to a world with essentials.worlds.
+# This does not affect the /home command, there is a separate toggle below for this.
+world-teleport-permissions: false
+
+# The number of items given if the quantity parameter is left out in /item or /give.
+# If this number is below 1, the maximum stack size size is given. If over-sized stacks.
+# are not enabled, any number higher than the maximum stack size results in more than one stack.
+default-stack-size: -1
+
+# Over-sized stacks are stacks that ignore the normal max stack size.
+# They can be obtained using /give and /item, if the player has essentials.oversizedstacks permission.
+# How many items should be in an over-sized stack?
+oversized-stacksize: 64
+
+# Allow repair of enchanted weapons and armor.
+# If you set this to false, you can still allow it for certain players using the permission.
+# essentials.repair.enchanted
+repair-enchanted: true
+
+# Allow 'unsafe' enchantments in kits and item spawning.
+# Warning: Mixing and overleveling some enchantments can cause issues with clients, servers and plugins.
+unsafe-enchantments: false
+
+# Do you want Essentials to keep track of previous location for /back in the teleport listener?
+# If you set this to true any plugin that uses teleport will have the previous location registered.
+register-back-in-listener: false
+
+# Delay to wait before people can cause attack damage after logging in.
+login-attack-delay: 5
+
+# Set the max fly speed, values range from 0.1 to 1.0
+max-fly-speed: 0.8
+
+# Set the max walk speed, values range from 0.1 to 1.0
+max-walk-speed: 0.8
+
+# Set the maximum amount of mail that can be sent within a minute.
+mails-per-minute: 1000
+
+# Set the maximum time /mute can be used for in seconds.
+# Set to -1 to disable, and essentials.mute.unlimited can be used to override.
+max-mute-time: -1
+
+# Set the maximum time /tempban can be used for in seconds.
+# Set to -1 to disable, and essentials.tempban.unlimited can be used to override.
+max-tempban-time: -1
+
+# Changes the default /reply functionality. This can be changed on a per-player basis using /rtoggle.
+# If true, /r goes to the person you messaged last, otherwise the first person that messaged you.
+# If false, /r goes to the last person that messaged you.
+last-message-reply-recipient: true
+
+# If last-message-reply-recipient is enabled for a particular player,
+# this specifies the duration, in seconds, that would need to elapse for the
+# reply-recipient to update when receiving a message.
+# Default is 180 (3 minutes)
+last-message-reply-recipient-timeout: 180
+
+# Changes the default /reply functionality.
+# If true, /reply will not check if the person you're replying to has vanished.
+# If false, players will not be able to /reply to players who they can no longer see due to vanish.
+last-message-reply-vanished: false
+
+# Toggles whether or not left clicking mobs with a milk bucket turns them into a baby.
+milk-bucket-easter-egg: true
+
+# Toggles whether or not the fly status message should be sent to players on join
+send-fly-enable-on-join: true
+
+# Set to true to enable per-world permissions for setting time for individual worlds with essentials commands.
+# This applies to /time, /day, /eday, /night, /enight, /etime.
+# Give someone permission to teleport to a world with essentials.time.world..
+world-time-permissions: false
+
+# Specify cooldown for both Essentials commands and external commands as well.
+# All commands do not start with a Forward Slash (/). Instead of /msg, write msg
+
+# Wildcards are supported. E.g.
+# - '*i*': 50
+# adds a 50 second cooldown to all commands that include the letter i
+
+# EssentialsX supports regex by starting the command with a caret ^
+# For example, to target commands starting with ban and not banip the following would be used:
+# '^ban([^ip])( .*)?': 60 # 60 seconds /ban cooldown.
+# Note: If you have a command that starts with ^, then you can escape it using backslash (\). e.g. \^command: 123
+command-cooldowns:
+# feed: 100 # 100 second cooldown on /feed command
+# '*': 5 # 5 Second cooldown on all commands
+
+# Whether command cooldowns should be persistent past server shutdowns
+command-cooldown-persistence: true
+
+# Whether NPC balances should be listed in balance ranking features such as /balancetop.
+# NPC balances can include features like factions from FactionsUUID plugin.
+npcs-in-balance-ranking: false
+
+# Allow bulk buying and selling signs when the player is sneaking.
+# This is useful when a sign sells or buys one item at a time and the player wants to sell a bunch at once.
+allow-bulk-buy-sell: true
+
+# Allow selling of items with custom names with the /sell command.
+# This may be useful to prevent players accidentally selling named items.
+allow-selling-named-items: false
+
+# Delay for the MOTD display for players on join, in milliseconds.
+# This has no effect if the MOTD command or permission are disabled.
+delay-motd: 0
+
+# A list of commands that should have their complementary confirm commands enabled by default.
+# This is empty by default, for the latest list of valid commands see the latest source config.yml.
+default-enabled-confirm-commands:
+# - pay
+# - clearinventory
+
+# Where should Essentials teleport players when they are freed from jail?
+# You can set to "back" to have them teleported to where they were before they were jailed, "spawn" to have them
+# teleport to spawn, or "off" to not have them teleport.
+teleport-when-freed: back
+
+# Whether or not jail time should only be counted while the user is online.
+# If true, a jailed player's time will only decrement when they are online.
+jail-online-time: false
+
+# Set the timeout, in seconds for players to accept a tpa before the request is cancelled.
+# Set to 0 for no timeout.
+tpa-accept-cancellation: 120
+
+# Allow players to set hats by clicking on their helmet slot.
+allow-direct-hat: true
+
+# Allow in-game players to specify a world when running /broadcastworld.
+# If false, running /broadcastworld in-game will always send a message to the player's current world.
+# This doesn't affect running the command from the console, where a world is always required.
+allow-world-in-broadcastworld: true
+
+# Consider water blocks as "safe," therefore allowing players to teleport
+# using commands such as /home or /spawn to a location that is occupied
+# by water blocks
+is-water-safe: false
+
+# Should the usermap try to sanitise usernames before saving them?
+# You should only change this to false if you use Minecraft China.
+safe-usermap-names: true
+
+# Should Essentials output logs when a command block executes a command?
+# Example: CommandBlock at ,, issued server command: /
+log-command-block-commands: true
+
+# Set the maximum speed for projectiles spawned with /fireball.
+max-projectile-speed: 8
+
+# Should EssentialsX check for updates?
+# If set to true, EssentialsX will show notifications when a new version is available.
+# This uses the public GitHub API and no identifying information is sent or stored.
+update-check: true
+
+############################################################
+# +------------------------------------------------------+ #
+# | Homes | #
+# +------------------------------------------------------+ #
+############################################################
+
+# Allows people to set their bed during the day.
+# This setting has no effect in Minecraft 1.15+, as Minecraft will always allow the player to set their bed location during the day.
+update-bed-at-daytime: true
+
+# Set to true to enable per-world permissions for using homes to teleport between worlds.
+# This applies to the /home command only.
+# Give someone permission to teleport to a world with essentials.worlds.
+world-home-permissions: false
+
+# Allow players to have multiple homes.
+# Players need essentials.sethome.multiple before they can have more than 1 home.
+# You can set the default number of multiple homes using the 'default' rank below.
+# To remove the home limit entirely, give people 'essentials.sethome.multiple.unlimited'.
+# To grant different home amounts to different people, you need to define a 'home-rank' below.
+# Create the 'home-rank' below, and give the matching permission: essentials.sethome.multiple.
+# For more information, visit http://wiki.ess3.net/wiki/Multihome
+sethome-multiple:
+ default: 3
+ vip: 5
+ staff: 10
+
+# In this example someone with 'essentials.sethome.multiple' and 'essentials.sethome.multiple.vip' will have 5 homes.
+# Remember, they MUST have both permission nodes in order to be able to set multiple homes.
+
+# Controls whether players need the permission "essentials.home.compass" in order to point
+# the player's compass at their first home.
+
+# Leaving this as false will retain Essentials' original behaviour, which is to always
+# change the compass' direction to point towards their first home.
+compass-towards-home-perm: false
+
+# If no home is set, would you like to send the player to spawn?
+# If set to false, players will not be teleported when they run /home without setting a home first.
+spawn-if-no-home: true
+
+# Should players be asked to provide confirmation for homes which they attempt to overwrite?
+confirm-home-overwrite: false
+
+############################################################
+# +------------------------------------------------------+ #
+# | Economy | #
+# +------------------------------------------------------+ #
+############################################################
+
+# For more information, visit http://wiki.ess3.net/wiki/Essentials_Economy
+
+# You can control the values of items that are sold to the server by using the /setworth command.
+
+# Defines the balance with which new players begin. Defaults to 0.
+starting-balance: 0
+
+# Defines the cost to use the given commands PER USE.
+# Some commands like /repair have sub-costs, check the wiki for more information.
+command-costs:
+ # /example costs $1000 PER USE
+ # example: 1000
+ # /kit tools costs $1500 PER USE
+ # kit-tools: 1500
+
+# Set this to a currency symbol you want to use.
+# Remember, if you want to use special characters in this document,
+# such as accented letters, you MUST save the file as UTF-8, not ANSI.
+currency-symbol: '$'
+
+# Enable this to make the currency symbol appear at the end of the amount rather than at the start.
+# For example, the euro symbol typically appears after the current amount.
+currency-symbol-suffix: false
+
+# Set the maximum amount of money a player can have.
+# The amount is always limited to 10 trillion because of the limitations of a java double.
+max-money: 10000000000000
+
+# Set the minimum amount of money a player can have (must be above the negative of max-money).
+# Setting this to 0, will disable overdrafts/loans completely. Users need 'essentials.eco.loan' perm to go below 0.
+min-money: -10000
+
+# Enable this to log all interactions with trade/buy/sell signs and sell command.
+economy-log-enabled: false
+
+# Enable this to also log all transactions from other plugins through Vault.
+# This can cause the economy log to fill up quickly so should only be enabled for testing purposes!
+economy-log-update-enabled: false
+
+# Minimum acceptable amount to be used in /pay.
+minimum-pay-amount: 0.001
+
+# Enable this to block users who try to /pay another user which ignore them.
+pay-excludes-ignore-list: false
+
+# Whether or not users with a balance less than or equal to $0 should be shown in balance-top.
+# Setting to false will not show people with balances <= 0 in balance-top.
+# NOTE: After reloading the config, you must also run '/baltop force' for this to appear
+show-zero-baltop: true
+
+# The format of currency, excluding symbols. See currency-symbol-format-locale for symbol configuration.
+
+# "#,##0.00" is how the majority of countries display currency.
+# currency-format: "#,##0.00"
+
+# Format currency symbols. Some locales use , and . interchangeably.
+# Some formats do not display properly in-game due to faulty Minecraft font rendering.
+
+# For 1.234,50 use de-DE
+# For 1,234.50 use en-US
+# For 1'234,50 use fr-ch
+# currency-symbol-format-locale: en-US
+
+############################################################
+# +------------------------------------------------------+ #
+# | Help | #
+# +------------------------------------------------------+ #
+############################################################
+
+# Show other plugins commands in help.
+non-ess-in-help: true
+
+# Hide plugins which do not give a permission.
+# You can override a true value here for a single plugin by adding a permission to a user/group.
+# The individual permission is: essentials.help., anyone with essentials.* or '*' will see all help regardless.
+# You can use negative permissions to remove access to just a single plugins help if the following is enabled.
+hide-permissionless-help: true
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsX Chat | #
+# +------------------------------------------------------+ #
+############################################################
+
+# You need to install EssentialsX Chat for this section to work.
+# See https://essentialsx.net/wiki/Module-Breakdown.html for more information.
+chat:
+ # If EssentialsX Chat is installed, this will define how far a player's voice travels, in blocks. Set to 0 to make all chat global.
+ # Note that users with the "essentials.chat.spy" permission will hear everything, regardless of this setting.
+ # Users with essentials.chat.shout can override this by prefixing their message with an exclamation mark (!)
+ # Users with essentials.chat.question can override this by prefixing their message with a question mark (?)
+ # You can add command costs for shout/question by adding chat-shout and chat-question to the command costs section.
+ radius: 0
+
+ # Chat formatting can be done in two ways, you can either define a standard format for all chat.
+ # Or you can give a group specific chat format, to give some extra variation.
+ # For more information of chat formatting, check out the wiki: http://wiki.ess3.net/wiki/Chat_Formatting
+ # Note: Using the {PREFIX} and {SUFFIX} placeholders along with {DISPLAYNAME} may cause double prefixes/suffixes to be shown in chat unless add-prefix-suffix is uncommented and set to false.
+
+ # Available placeholders:
+ # {MESSAGE} - The content of the chat message.
+ # {USERNAME} - The sender's username.
+ # {DISPLAYNAME} - The sender's display name.
+ # {NICKNAME} - The sender's Essentials nickname. If the sender has no nickname, the username is shown.
+ # {PREFIX} - The sender's prefix, supplied by a permissions plugin.
+ # {SUFFIX} - The sender's suffix, supplied by a permissions plugin.
+ # {GROUP} - The sender's primary group name, supplied by a permissions plugin.
+ # {WORLD} - The world alias of the sender's current world. See the world-aliases section below for details.
+ # {WORLDNAME} - The full name of the sender's current world.
+ # {SHORTWORLDNAME} - The first character of the sender's current world.
+ # {TEAMNAME} - The sender's scoreboard team name.
+ # {TEAMPREFIX} - The sender's scoreboard team prefix.
+ # {TEAMSUFFIX} - The sender's scoreboard team suffix.
+
+ format: '<{DISPLAYNAME}> {MESSAGE}'
+ # format: '&7[{GROUP}]&r {DISPLAYNAME}&7:&r {MESSAGE}'
+ # format: '&7{PREFIX}&r {DISPLAYNAME}&r &7{SUFFIX}&r: {MESSAGE}'
+
+ group-formats:
+ # default: '{WORLDNAME} {DISPLAYNAME}&7:&r {MESSAGE}'
+ # admins: '{WORLDNAME} &c[{GROUP}]&r {DISPLAYNAME}&7:&c {MESSAGE}'
+
+ # If you are using group formats make sure to remove the '#' to allow the setting to be read.
+ # Note: Group names are case-sensitive so you must match them up with your permission plugin.
+
+ # You can use permissions to control whether players can use formatting codes in their chat messages.
+ # See https://essentialsx.net/wiki/Color-Permissions.html for more information.
+
+ # World aliases allow you to replace the world name with something different in the chat format.
+ # If you are using world aliases, make sure to remove the '#' at the start to allow the setting to be read.
+ world-aliases:
+ # plots: "&dP&r"
+ # creative: "&eC&r"
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsX Protect | #
+# +------------------------------------------------------+ #
+############################################################
+
+# You need to install EssentialsX Protect for this section to work.
+# See https://essentialsx.net/wiki/Module-Breakdown.html for more information.
+protect:
+ # General physics/behavior modifications. Set these to true to disable behaviours.
+ prevent:
+ lava-flow: false
+ water-flow: false
+ water-bucket-flow: false
+ fire-spread: true
+ lava-fire-spread: true
+ lava-itemdamage: false
+ flint-fire: false
+ lightning-fire-spread: true
+ portal-creation: false
+ tnt-explosion: false
+ tnt-playerdamage: false
+ tnt-itemdamage: false
+ tnt-minecart-explosion: false
+ tnt-minecart-playerdamage: false
+ tnt-minecart-itemdamage: false
+ fireball-explosion: false
+ fireball-fire: false
+ fireball-playerdamage: false
+ fireball-itemdamage: false
+ witherskull-explosion: false
+ witherskull-playerdamage: false
+ witherskull-itemdamage: false
+ wither-spawnexplosion: false
+ wither-blockreplace: false
+ creeper-explosion: false
+ creeper-playerdamage: false
+ creeper-itemdamage: false
+ creeper-blockdamage: false
+ ender-crystal-explosion: false
+ enderdragon-blockdamage: true
+ enderman-pickup: false
+ villager-death: false
+ bed-explosion: false
+ respawn-anchor-explosion: false
+ # Monsters won't follow players.
+ # permission essentials.protect.entitytarget.bypass disables this.
+ entitytarget: false
+
+ # Prevents zombies from breaking down doors
+ zombie-door-break: false
+
+ # Prevents Ravagers from stealing blocks
+ ravager-thief: false
+
+ # Prevents sheep from turning grass to dirt
+ sheep-eat-grass: false
+
+ # Prevent certain transformations.
+ transformation:
+ # Prevent creepers becoming charged when struck by lightning.
+ charged-creeper: false
+
+ # Prevent villagers becoming zombie villagers.
+ zombie-villager: false
+
+ # Prevent zombie villagers being cured.
+ villager: false
+
+ # Prevent villagers becoming witches when struck by lightning.
+ witch: false
+
+ # Prevent pigs becoming zombie pigmen when struck by lightning.
+ zombie-pigman: false
+
+ # Prevent zombies turning into drowneds, and husks turning into zombies.
+ drowned: false
+
+ # Prevent mooshrooms changing colour when struck by lightning.
+ mooshroom: false
+
+ # Prevent the spawning of creatures. If a creature is missing, you can add it following the format below.
+ spawn:
+ creeper: false
+ skeleton: false
+ spider: false
+ giant: false
+ zombie: false
+ slime: false
+ ghast: false
+ pig_zombie: false
+ enderman: false
+ cave_spider: false
+ silverfish: false
+ blaze: false
+ magma_cube: false
+ ender_dragon: false
+ pig: false
+ sheep: false
+ cow: false
+ chicken: false
+ squid: false
+ wolf: false
+ mushroom_cow: false
+ snowman: false
+ ocelot: false
+ iron_golem: false
+ villager: false
+ wither: false
+ bat: false
+ witch: false
+ horse: false
+ phantom: false
+
+ # Maximum height the creeper should explode. -1 allows them to explode everywhere.
+ # Set prevent.creeper-explosion to true, if you want to disable creeper explosions.
+ creeper:
+ max-height: -1
+
+ # Disable various default physics and behaviors.
+ disable:
+ # Should fall damage be disabled?
+ fall: false
+
+ # Users with the essentials.protect.pvp permission will still be able to attack each other if this is set to true.
+ # They will be unable to attack users without that same permission node.
+ pvp: false
+
+ # Should drowning damage be disabled?
+ # (Split into two behaviors; generally, you want both set to the same value.)
+ drown: false
+ suffocate: false
+
+ # Should damage via lava be disabled? Items that fall into lava will still burn to a crisp. ;)
+ lavadmg: false
+
+ # Should arrow damage be disabled?
+ projectiles: false
+
+ # This will disable damage from touching cacti.
+ contactdmg: false
+
+ # Burn, baby, burn! Should fire damage be disabled?
+ firedmg: false
+
+ # Should the damage after hit by a lightning be disabled?
+ lightning: false
+
+ # Should Wither damage be disabled?
+ wither: false
+
+ # Disable weather options?
+ weather:
+ storm: false
+ thunder: false
+ lightning: false
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsX AntiBuild | #
+# +------------------------------------------------------+ #
+############################################################
+
+ # You need to install EssentialsX AntiBuild for this section to work.
+ # See https://essentialsx.net/wiki/Module-Breakdown.html and http://wiki.ess3.net/wiki/AntiBuild for more information.
+
+ # Should people without the essentials.build permission be allowed to build?
+ # Set true to disable building for those people.
+ # Setting to false means EssentialsAntiBuild will never prevent you from building.
+ build: true
+
+ # Should people without the essentials.build permission be allowed to use items?
+ # Set true to disable using for those people.
+ # Setting to false means EssentialsAntiBuild will never prevent you from using items.
+ use: true
+
+ # Should we warn people when they are not allowed to build?
+ warn-on-build-disallow: true
+
+ # For which block types would you like to be alerted?
+ # You can find a list of items at https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html.
+ alert:
+ on-placement: LAVA,TNT,LAVA_BUCKET
+ on-use: LAVA_BUCKET
+ on-break:
+
+ blacklist:
+ # Which blocks should people be prevented from placing?
+ placement: LAVA,TNT,LAVA_BUCKET
+
+ # Which items should people be prevented from using?
+ usage: LAVA_BUCKET
+
+ # Which blocks should people be prevented from breaking?
+ break:
+
+ # Which blocks should not be moved by pistons?
+ piston:
+
+ # Which blocks should not be dispensed by dispensers
+ dispenser:
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsX Spawn + New Players | #
+# +------------------------------------------------------+ #
+############################################################
+
+# You need to install EssentialsX Spawn for this section to work.
+# See https://essentialsx.net/wiki/Module-Breakdown.html for more information.
+newbies:
+ # Should we announce to the server when someone logs in for the first time?
+ # If so, use this format, replacing {DISPLAYNAME} with the player name.
+ # If not, set to ''
+ # announce-format: ''
+ announce-format: '&dWelcome {DISPLAYNAME}&d to the server!'
+
+ # When we spawn for the first time, which spawnpoint do we use?
+ # Set to "none" if you want to use the spawn point of the world.
+ spawnpoint: newbies
+
+ # Do we want to give users anything on first join? Set to '' to disable
+ # This kit will be given regardless of cost and permissions, and will not trigger the kit delay.
+ # kit: ''
+ kit: tools
+
+# What priority should we use for handling respawns?
+# Set this to none, if you want vanilla respawning behaviour.
+# Set this to lowest, if you want Multiverse to handle the respawning.
+# Set this to high, if you want EssentialsSpawn to handle the respawning.
+# Set this to highest, if you want to force EssentialsSpawn to handle the respawning.
+# Note: Changes will not apply until after the server is restarted.
+respawn-listener-priority: high
+
+# What priority should we use for handling spawning on joining the server?
+# See respawn-listener-priority for possible values.
+# Note: Changing this may impact or break spawn-on-join functionality.
+# Note: Changes will not apply until after the server is restarted.
+spawn-join-listener-priority: high
+
+# When users die, should they respawn at their first home or bed, instead of the spawnpoint?
+respawn-at-home: false
+
+# When users die, should they respawn at their bed instead of the spawnpoint?
+# The value of respawn-at-home (above) has to be true.
+respawn-at-home-bed: true
+
+# When users die, should EssentialsSpawn respect users' respawn anchors?
+respawn-at-anchor: false
+
+# Teleport all joining players to the spawnpoint
+spawn-on-join: false
+# The following value of `guests` states that all players in group `guests` will be teleported to spawn when joining.
+# spawn-on-join: guests
+# The following list value states that all players in group `guests` and `admin` are to be teleported to spawn when joining.
+# spawn-on-join:
+# - guests
+# - admin
+
+# End of file <-- No seriously, you're done with configuration.
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-legacy.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-legacy.yml
new file mode 100644
index 000000000..1d77db65c
--- /dev/null
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/essx-legacy.yml
@@ -0,0 +1,726 @@
+############################################################
+# +------------------------------------------------------+ #
+# | Notes | #
+# +------------------------------------------------------+ #
+############################################################
+
+# If you want to use special characters in this document, such as accented letters, you MUST save the file as UTF-8, not ANSI.
+# If you receive an error when Essentials loads, ensure that:
+# - No tabs are present: YAML only allows spaces
+# - Indents are correct: YAML hierarchy is based entirely on indentation
+# - You have "escaped" all apostrophes in your text: If you want to write "don't", for example, write "don''t" instead (note the doubled apostrophe)
+# - Text with symbols is enclosed in single or double quotation marks
+
+# If you have problems join the Essentials help support channel: http://tiny.cc/EssentialsChat
+
+############################################################
+# +------------------------------------------------------+ #
+# | Essentials (Global) | #
+# +------------------------------------------------------+ #
+############################################################
+
+# A color code between 0-9 or a-f. Set to 'none' to disable.
+ops-name-color: '4'
+
+# The character(s) to prefix all nicknames, so that you know they are not true usernames.
+nickname-prefix: '~'
+
+# The maximum length allowed in nicknames. The nickname prefix is included in this.
+max-nick-length: 120
+
+# Disable this if you have any other plugin, that modifies the displayname of a user.
+change-displayname: true
+
+# When this option is enabled, the (tab) player list will be updated with the displayname.
+# The value of change-displayname (above) has to be true.
+# change-playerlist: true
+
+# When EssentialsChat.jar isn't used, force essentials to add the prefix and suffix from permission plugins to displayname.
+# This setting is ignored if EssentialsChat.jar is used, and defaults to 'true'.
+# The value of change-displayname (above) has to be true.
+# Do not edit this setting unless you know what you are doing!
+# add-prefix-suffix: false
+
+# If the teleport destination is unsafe, should players be teleported to the nearest safe location?
+# If this is set to true, Essentials will attempt to teleport players close to the intended destination.
+# If this is set to false, attempted teleports to unsafe locations will be cancelled with a warning.
+teleport-safety: true
+
+# The delay, in seconds, required between /home, /tp, etc.
+teleport-cooldown: 0
+
+# The delay, in seconds, before a user actually teleports. If the user moves or gets attacked in this timeframe, the teleport never occurs.
+teleport-delay: 0
+
+# The delay, in seconds, a player can't be attacked by other players after they have been teleported by a command.
+# This will also prevent the player attacking other players.
+teleport-invulnerability: 4
+
+# The delay, in seconds, required between /heal or /feed attempts.
+heal-cooldown: 60
+
+# What to prevent from /item and /give.
+# e.g item-spawn-blacklist: 10,11,46
+item-spawn-blacklist:
+
+# Set this to true if you want permission based item spawn rules.
+# Note: The blacklist above will be ignored then.
+# Example permissions (these go in your permissions manager):
+# - essentials.itemspawn.item-all
+# - essentials.itemspawn.item-[itemname]
+# - essentials.itemspawn.item-[itemid]
+# - essentials.give.item-all
+# - essentials.give.item-[itemname]
+# - essentials.give.item-[itemid]
+# - essentials.unlimited.item-all
+# - essentials.unlimited.item-[itemname]
+# - essentials.unlimited.item-[itemid]
+# - essentials.unlimited.item-bucket # Unlimited liquid placing
+
+# For more information, visit http://wiki.ess3.net/wiki/Command_Reference/ICheat#Item.2FGive
+permission-based-item-spawn: false
+
+# Mob limit on the /spawnmob command per execution.
+spawnmob-limit: 100
+
+# Shall we notify users when using /lightning?
+warn-on-smite: true
+
+# The motd and rules are now configured in the files motd.txt and rules.txt.
+
+# When a command conflicts with another plugin, by default, Essentials will try to force the OTHER plugin to take priority.
+# Commands in this list, will tell Essentials to 'not give up' the command to other plugins.
+# In this state, which plugin 'wins' appears to be almost random.
+
+# If you have two plugin with the same command and you wish to force Essentials to take over, you need an alias.
+# To force essentials to take 'god' alias 'god' to 'egod'.
+# See http://wiki.bukkit.org/Commands.yml#aliases for more information.
+
+overridden-commands:
+# - god
+# - info
+
+# Disabling commands here will prevent Essentials handling the command, this will not affect command conflicts.
+# You should not have to disable commands used in other plugins, they will automatically get priority.
+# See http://wiki.bukkit.org/Commands.yml#aliases to map commands to other plugins.
+disabled-commands:
+ - bob
+ - sell
+ - worth
+ - formula
+# - clear
+
+# These commands will be shown to players with socialSpy enabled.
+# You can add commands from other plugins you may want to track or
+# remove commands that are used for something you dont want to spy on.
+# Set - '*' in order to listen on all possible commands.
+socialspy-commands:
+ - '*'
+ - -bob
+
+# If you do not wish to use a permission system, you can define a list of 'player perms' below.
+# This list has no effect if you are using a supported permissions system.
+# If you are using an unsupported permissions system, simply delete this section.
+# Whitelist the commands and permissions you wish to give players by default (everything else is op only).
+# These are the permissions without the "essentials." part.
+player-commands:
+ - afk
+ - afk.auto
+ - back
+ - back.ondeath
+ - balance
+ - balance.others
+ - balancetop
+ - build
+ - chat.color
+ - chat.format
+ - chat.shout
+ - chat.question
+ - clearinventory
+ - compass
+ - depth
+ - delhome
+ - getpos
+ - geoip.show
+ - help
+ - helpop
+ - home
+ - home.others
+ - ignore
+ - info
+ - itemdb
+ - kit
+ - kits.tools
+ - list
+ - mail
+ - mail.send
+ - me
+ - motd
+ - msg
+ - msg.color
+ - nick
+ - near
+ - pay
+ - ping
+ - protect
+ - r
+ - rules
+ - realname
+ - seen
+ - sell
+ - sethome
+ - setxmpp
+ - signs.create.protection
+ - signs.create.trade
+ - signs.break.protection
+ - signs.break.trade
+ - signs.use.balance
+ - signs.use.buy
+ - signs.use.disposal
+ - signs.use.enchant
+ - signs.use.free
+ - signs.use.gamemode
+ - signs.use.heal
+ - signs.use.info
+ - signs.use.kit
+ - signs.use.mail
+ - signs.use.protection
+ - signs.use.repair
+ - signs.use.sell
+ - signs.use.time
+ - signs.use.trade
+ - signs.use.warp
+ - signs.use.weather
+ - spawn
+ - suicide
+ - time
+ - tpa
+ - tpaccept
+ - tpahere
+ - tpdeny
+ - warp
+ - warp.list
+ - world
+ - worth
+ - xmpp
+
+# Note: All items MUST be followed by a quantity!
+# All kit names should be lower case, and will be treated as lower in permissions/costs.
+# Syntax: - itemID[:DataValue/Durability] Amount [Enchantment:Level].. [itemmeta:value]...
+# For Item Meta information visit http://wiki.ess3.net/wiki/Item_Meta
+# 'delay' refers to the cooldown between how often you can use each kit, measured in seconds.
+# Set delay to -1 for a one time kit.
+# For more information, visit http://wiki.ess3.net/wiki/Kits
+kits:
+ tools:
+ delay: -1
+ items:
+ - 272 1
+ - 273 1
+ - 274 1
+ - 275 1
+ dtools:
+ delay: 600
+ items:
+ - 278 1 efficiency:1 durability:1 fortune:1 name:&4Gigadrill lore:The_drill_that_&npierces|the_heavens
+ - 277 1 digspeed:3 name:Dwarf lore:Diggy|Diggy|Hole
+ - 298 1 color:255,255,255 name:Top_Hat lore:Good_day,_Good_day
+ - 279:780 1
+ notch:
+ delay: 6000
+ items:
+ - 397:3 1 player:Notch
+ color:
+ delay: 6000
+ items:
+ - 387 1 title:&4Book_&9o_&6Colors author:KHobbits lore:Ingame_color_codes book:Colors
+ firework:
+ delay: 6000
+ items:
+ - 401 1 name:Angry_Creeper color:red fade:green type:creeper power:1
+ - 401 1 name:StarryNight color:yellow,orange fade:blue type:star effect:trail,twinkle power:1
+ - 401 2 name:SolarWind color:yellow,orange fade:red shape:large effect:twinkle color:yellow,orange fade:red shape:ball effect:trail color:red,purple
+ fade:pink shape:star effect:trail power:1
+
+# Essentials Sign Control
+# See http://wiki.ess3.net/wiki/Sign_Tutorial for instructions on how to use these.
+# To enable signs, remove # symbol. To disable all signs, comment/remove each sign.
+# Essentials colored sign support will be enabled when any sign types are enabled.
+# Color is not an actual sign, it's for enabling using color codes on signs, when the correct permissions are given.
+
+enabledSigns:
+ - color
+ - balance
+ - buy
+ - sell
+ # - trade
+ # - free
+ - disposal
+ # - warp
+ # - kit
+ # - mail
+ - enchant
+# - gamemode
+# - heal
+# - info
+# - spawnmob
+# - repair
+# - time
+# - weather
+
+# How many times per second can Essentials signs be interacted with per player.
+# Values should be between 1-20, 20 being virtually no lag protection.
+# Lower numbers will reduce the possibility of lag, but may annoy players.
+sign-use-per-second: 4
+
+# Backup runs a batch/bash command while saving is disabled.
+backup:
+ # Interval in minutes.
+ interval: 30
+ # Unless you add a valid backup command or script here, this feature will be useless.
+ # Use 'save-all' to simply force regular world saving without backup.
+ # command: 'rdiff-backup World1 backups/World1'
+
+# Set this true to enable permission per warp.
+per-warp-permission: false
+
+# Sort output of /list command by groups.
+# You can hide and merge the groups displayed in /list by defining the desired behaviour here.
+# Detailed instructions and examples can be found on the wiki: http://wiki.ess3.net/wiki/List
+list:
+ # To merge groups, list the groups you wish to merge
+ # Staff: owner admin moderator
+ Staff: owner admin
+
+ # To limit groups, set a max user limit
+ # builder: 20
+ # To hide groups, set the group as hidden
+ # default: hidden
+ Pro: Jerry
+
+ # Uncomment the line below to simply list all players with no grouping
+ Players: '*'
+
+# More output to the console.
+debug: false
+
+# Set the locale for all messages.
+# If you don't set this, the default locale of the server will be used.
+# For example, to set language to English, set locale to en, to use the file "messages_en.properties".
+# Don't forget to remove the # in front of the line.
+# For more information, visit http://wiki.ess3.net/wiki/Locale
+# locale: en
+
+# Turn off god mode when people leave the server.
+remove-god-on-disconnect: false
+
+# Auto-AFK
+# After this timeout in seconds, the user will be set as AFK.
+# This feature requires the player to have essentials.afk.auto node.
+# Set to -1 for no timeout.
+auto-afk: 60
+
+# Auto-AFK Kick
+# After this timeout in seconds, the user will be kicked from the server.
+# essentials.afk.kickexempt node overrides this feature.
+# Set to -1 for no timeout.
+auto-afk-kick: -1
+
+# Set this to true, if you want to freeze the player, if the player is AFK.
+# Other players or monsters can't push the player out of AFK mode then.
+# This will also enable temporary god mode for the AFK player.
+# The player has to use the command /afk to leave the AFK mode.
+freeze-afk-players: false
+
+# When the player is AFK, should he be able to pickup items?
+# Enable this, when you don't want people idling in mob traps.
+disable-item-pickup-while-afk: false
+
+# This setting controls if a player is marked as active on interaction.
+# When this setting is false, the player would need to manually un-AFK using the /afk command.
+cancel-afk-on-interact: true
+
+# Should we automatically remove afk status when a player moves?
+# Player will be removed from AFK on chat/command regardless of this setting.
+# Disable this to reduce server lag.
+cancel-afk-on-move: true
+
+# You can disable the death messages of Minecraft here.
+death-messages: true
+
+# Should players with permissions be able to join and part silently?
+# You can control this with essentials.silentjoin and essentials.silentquit permissions if it is enabled.
+# In addition, people with essentials.silentjoin.vanish will be vanished on join.
+allow-silent-join-quit: true
+
+# You can set a custom join message here, set to "none" to disable.
+# You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.
+custom-join-message: ""
+
+# You can set a custom quit message here, set to "none" to disable.
+# You may use color codes, use {USERNAME} the player's name or {PLAYER} for the player's displayname.
+custom-quit-message: ""
+
+# Add worlds to this list, if you want to automatically disable god mode there.
+no-god-in-worlds:
+# - world_nether
+
+# Set to true to enable per-world permissions for teleporting between worlds with essentials commands.
+# This applies to /world, /back, /tp[a|o][here|all], but not warps.
+# Give someone permission to teleport to a world with essentials.worlds.
+# This does not affect the /home command, there is a separate toggle below for this.
+world-teleport-permissions: false
+
+# The number of items given if the quantity parameter is left out in /item or /give.
+# If this number is below 1, the maximum stack size size is given. If over-sized stacks.
+# are not enabled, any number higher than the maximum stack size results in more than one stack.
+default-stack-size: -1
+
+# Over-sized stacks are stacks that ignore the normal max stack size.
+# They can be obtained using /give and /item, if the player has essentials.oversizedstacks permission.
+# How many items should be in an over-sized stack?
+oversized-stacksize: 64
+
+# Allow repair of enchanted weapons and armor.
+# If you set this to false, you can still allow it for certain players using the permission.
+# essentials.repair.enchanted
+repair-enchanted: true
+
+# Allow 'unsafe' enchantments in kits and item spawning.
+# Warning: Mixing and overleveling some enchantments can cause issues with clients, servers and plugins.
+unsafe-enchantments: true
+
+# Do you want Essentials to keep track of previous location for /back in the teleport listener?
+# If you set this to true any plugin that uses teleport will have the previous location registered.
+register-back-in-listener: false
+
+# Delay to wait before people can cause attack damage after logging in.
+login-attack-delay: 5
+
+# Set the max fly speed, values range from 0.1 to 1.0
+max-fly-speed: 0.8
+
+# Set the max walk speed, values range from 0.1 to 1.0
+max-walk-speed: 0.8
+
+# Set the maximum amount of mail that can be sent within a minute.
+mails-per-minute: 1000
+
+# Set the maximum time /tempban can be used for in seconds.
+# Set to -1 to disable, and essentials.tempban.unlimited can be used to override.
+max-tempban-time: -1
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsHome | #
+# +------------------------------------------------------+ #
+############################################################
+
+# Allows people to set their bed at daytime.
+update-bed-at-daytime: true
+
+# Set to true to enable per-world permissions for using homes to teleport between worlds.
+# This applies to the /home only.
+# Give someone permission to teleport to a world with essentials.worlds.
+world-home-permissions: false
+
+# Allow players to have multiple homes.
+# Players need essentials.sethome.multiple before they can have more than 1 home.
+# You can set the default number of multiple homes using the 'default' rank below.
+# To remove the home limit entirely, give people 'essentials.sethome.multiple.unlimited'.
+# To grant different home amounts to different people, you need to define a 'home-rank' below.
+# Create the 'home-rank' below, and give the matching permission: essentials.sethome.multiple.
+# For more information, visit http://wiki.ess3.net/wiki/Multihome
+sethome-multiple:
+ default: 2
+ vip: 2
+ staff: 2
+ buy5: 5
+ buy10: 10
+
+# In this example someone with 'essentials.sethome.multiple' and 'essentials.sethome.multiple.vip' will have 5 homes.
+# Remember, they MUST have both permission nodes in order to be able to set multiple homes.
+
+# Set the timeout, in seconds for players to accept a tpa before the request is cancelled.
+# Set to 0 for no timeout.
+tpa-accept-cancellation: 120
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsEco | #
+# +------------------------------------------------------+ #
+############################################################
+
+# For more information, visit http://wiki.ess3.net/wiki/Essentials_Economy
+
+# Defines the balance with which new players begin. Defaults to 0.
+starting-balance: 0
+
+# worth-# defines the value of an item when it is sold to the server via /sell.
+# These are now defined in worth.yml
+
+# Defines the cost to use the given commands PER USE.
+# Some commands like /repair have sub-costs, check the wiki for more information.
+command-costs:
+# /example costs $1000 PER USE
+# example: 1000
+# /kit tools costs $1500 PER USE
+# kit-tools: 1500
+
+# Set this to a currency symbol you want to use.
+# Remember, if you want to use special characters in this document,
+# such as accented letters, you MUST save the file as UTF-8, not ANSI.
+currency-symbol: '$'
+
+# Set the maximum amount of money a player can have.
+# The amount is always limited to 10 trillion because of the limitations of a java double.
+max-money: 10000000000000
+
+# Set the minimum amount of money a player can have (must be above the negative of max-money).
+# Setting this to 0, will disable overdrafts/loans completely. Users need 'essentials.eco.loan' perm to go below 0.
+min-money: 0
+
+# Enable this to log all interactions with trade/buy/sell signs and sell command.
+economy-log-enabled: false
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsHelp | #
+# +------------------------------------------------------+ #
+############################################################
+
+# Show other plugins commands in help.
+non-ess-in-help: true
+
+# Hide plugins which do not give a permission.
+# You can override a true value here for a single plugin by adding a permission to a user/group.
+# The individual permission is: essentials.help., anyone with essentials.* or '*' will see all help regardless.
+# You can use negative permissions to remove access to just a single plugins help if the following is enabled.
+hide-permissionless-help: true
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsChat | #
+# +------------------------------------------------------+ #
+############################################################
+
+# This section requires the EssentialsChat.jar to work.
+chat:
+ # If EssentialsChat is installed, this will define how far a player's voice travels, in blocks. Set to 0 to make all chat global.
+ # Note that users with the "essentials.chat.spy" permission will hear everything, regardless of this setting.
+ # Users with essentials.chat.shout can override this by prefixing text with an exclamation mark (!)
+ # Users with essentials.chat.question can override this by prefixing text with a question mark (?)
+ # You can add command costs for shout/question by adding chat-shout and chat-question to the command costs section."
+ radius: 0
+
+ # Chat formatting can be done in two ways, you can either define a standard format for all chat.
+ # Or you can give a group specific chat format, to give some extra variation.
+ # For more information of chat formatting, check out the wiki: http://wiki.ess3.net/wiki/Chat_Formatting
+
+ # format: '&7[{GROUP}]&r {DISPLAYNAME}&7:&r {MESSAGE}'
+ format: '{DISPLAYNAME}: {MESSAGE}'
+ group-formats:
+ default: '{DISPLAYNAME}&7:&7 {MESSAGE}'
+ tardis: '{DISPLAYNAME}&7:&7 {MESSAGE}'
+ Helper: '{DISPLAYNAME}&7:&3 {MESSAGE}'
+ Mod: '{DISPLAYNAME}&7:&3 {MESSAGE}'
+ Admin: '{DISPLAYNAME}&7:&c {MESSAGE}'
+ owner: '{DISPLAYNAME}&7:&c {MESSAGE}'
+
+# If you are using group formats make sure to remove the '#' to allow the setting to be read.
+
+############################################################
+# +------------------------------------------------------+ #
+# | EssentialsProtect | #
+# +------------------------------------------------------+ #
+############################################################
+
+# This section requires the EssentialsProtect.jar to work.
+protect:
+ # General physics/behavior modifications.
+ prevent:
+ lava-flow: false
+ water-flow: false
+ water-bucket-flow: false
+ fire-spread: true
+ lava-fire-spread: true
+ flint-fire: false
+ lightning-fire-spread: true
+ portal-creation: false
+ tnt-explosion: false
+ tnt-playerdamage: false
+ tnt-minecart-explosion: false
+ tnt-minecart-playerdamage: false
+ fireball-explosion: false
+ fireball-fire: false
+ fireball-playerdamage: false
+ witherskull-explosion: false
+ witherskull-playerdamage: false
+ wither-spawnexplosion: false
+ wither-blockreplace: false
+ creeper-explosion: false
+ creeper-playerdamage: false
+ creeper-blockdamage: false
+ enderdragon-blockdamage: true
+ enderman-pickup: false
+ villager-death: false
+
+ # Monsters won't follow players.
+ # permission essentials.protect.entitytarget.bypass disables this.
+ entitytarget: false
+
+ # Prevent the spawning of creatures.
+ spawn:
+ creeper: false
+ skeleton: false
+ spider: false
+ giant: false
+ zombie: false
+ slime: false
+ ghast: false
+ pig_zombie: false
+ enderman: false
+ cave_spider: false
+ silverfish: false
+ blaze: false
+ magma_cube: false
+ ender_dragon: false
+ pig: false
+ sheep: false
+ cow: false
+ chicken: false
+ squid: false
+ wolf: false
+ mushroom_cow: false
+ snowman: false
+ ocelot: false
+ iron_golem: false
+ villager: false
+ wither: false
+ bat: false
+ witch: false
+ horse: false
+
+ # Maximum height the creeper should explode. -1 allows them to explode everywhere.
+ # Set prevent.creeper-explosion to true, if you want to disable creeper explosions.
+ creeper:
+ max-height: -1
+
+ # Disable various default physics and behaviors.
+ disable:
+ # Should fall damage be disabled?
+ fall: false
+
+ # Users with the essentials.protect.pvp permission will still be able to attack each other if this is set to true.
+ # They will be unable to attack users without that same permission node.
+ pvp: false
+
+ # Should drowning damage be disabled?
+ # (Split into two behaviors; generally, you want both set to the same value.)
+ drown: false
+ suffocate: false
+
+ # Should damage via lava be disabled? Items that fall into lava will still burn to a crisp. ;)
+ lavadmg: false
+
+ # Should arrow damage be disabled?
+ projectiles: false
+
+ # This will disable damage from touching cacti.
+ contactdmg: false
+
+ # Burn, baby, burn! Should fire damage be disabled?
+ firedmg: false
+
+ # Should the damage after hit by a lightning be disabled?
+ lightning: false
+
+ # Should Wither damage be disabled?
+ wither: false
+
+ # Disable weather options?
+ weather:
+ storm: false
+ thunder: false
+ lightning: false
+
+ ############################################################
+ # +------------------------------------------------------+ #
+ # | EssentialsAntiBuild | #
+ # +------------------------------------------------------+ #
+ ############################################################
+
+ # This section requires the EssentialsAntiBuild.jar to work.
+
+ # Disable various default physics and behaviors
+ # For more information, visit http://wiki.ess3.net/wiki/AntiBuild
+
+ # Should people with build: false in permissions be allowed to build?
+ # Set true to disable building for those people.
+ # Setting to false means EssentialsAntiBuild will never prevent you from building.
+ build: true
+
+ # Should people with build: false in permissions be allowed to use items?
+ # Set true to disable using for those people.
+ # Setting to false means EssentialsAntiBuild will never prevent you from using items.
+ use: true
+
+ # Should we tell people they are not allowed to build?
+ warn-on-build-disallow: true
+
+ # For which block types would you like to be alerted?
+ # You can find a list of IDs in plugins/Essentials/items.csv after loading Essentials for the first time.
+ # 10 = lava :: 11 = still lava :: 46 = TNT :: 327 = lava bucket
+ alert:
+ on-placement: 10,11,46,327
+ on-use: 327
+ on-break:
+
+ blacklist:
+ # Which blocks should people be prevented from placing?
+ placement: 10,11,46,327
+
+ # Which items should people be prevented from using?
+ usage: 327
+
+ # Which blocks should people be prevented from breaking?
+ break:
+
+ # Which blocks should not be pushed by pistons?
+ piston:
+
+ # Which blocks should not be dispensed by dispensers
+ dispenser:
+
+############################################################
+# +------------------------------------------------------+ #
+# | Essentials Spawn / New Players | #
+# +------------------------------------------------------+ #
+############################################################
+
+# This section requires essentialsspawn.jar to work.
+newbies:
+ # Should we announce to the server when someone logs in for the first time?
+ # If so, use this format, replacing {DISPLAYNAME} with the player name.
+ # If not, set to ''
+ # announce-format: ''
+ announce-format: '&dWelcome {DISPLAYNAME}&d to the server!'
+
+ # When we spawn for the first time, which spawnpoint do we use?
+ # Set to "none" if you want to use the spawn point of the world.
+ spawnpoint: newbies
+
+ # Do we want to give users anything on first join? Set to '' to disable
+ # This kit will be given regardless of cost and permissions, and will not trigger the kit delay.
+ # kit: ''
+ kit: tools
+
+# Set this to lowest, if you want Multiverse to handle the respawning.
+# Set this to high, if you want EssentialsSpawn to handle the respawning.
+# Set this to highest, if you want to force EssentialsSpawn to handle the respawning.
+respawn-listener-priority: high
+
+# When users die, should they respawn at their first home or bed, instead of the spawnpoint?
+respawn-at-home: false
+
+# End of file <-- No seriously, you're done with configuration.
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/example.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/example.yml
new file mode 100644
index 000000000..63cee3fcb
--- /dev/null
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/example.yml
@@ -0,0 +1,13 @@
+test:
+ op-level: unicorn
+other: &ptr
+ op-level: dragon
+ location: dog park
+ age: 28
+ big scalar: |
+ Hello world!
+more: *ptr
+
+foo:
+ bar:
+ - {a: "best", no: help}
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/mobcleaner-example.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/mobcleaner-example.yml
new file mode 100644
index 000000000..638fff5b4
--- /dev/null
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/mobcleaner-example.yml
@@ -0,0 +1,138 @@
+# This config was generated for version 1.9.0
+# Find the latest config at https://github.com/JasonHorkles/EntityClearer/blob/main/config.yml
+
+# This plugin uses bStats metrics
+# https://bstats.org/plugin/bukkit/EntityClearer/10915
+# Metrics can be disabled in the bStats config.yml
+
+# Interval in minutes the clear task should run
+interval: 15
+
+# The sound to play when showing the warnings
+# See https://minecraft.fandom.com/wiki/Sounds.json#Java_Edition_values for all sounds
+# Set to '' for no sound
+sound: 'ui.button.click'
+
+# The worlds to check and remove entities from
+# Make sure to add your world(s) if they're not already there
+# See https://papermc.io/javadocs/paper/1.16/org/bukkit/entity/EntityType.html for all entities
+worlds:
+ world:
+ # The entities to be removed from the world
+ entities:
+ - BEE
+ - CAVE_SPIDER
+ - CHICKEN
+ - CREEPER
+ - SHEEP
+ - SKELETON
+ - SLIME
+ - SPIDER
+ - SQUID
+ - WOLF
+ - ZOMBIE
+
+ # Should only entities with a specific spawn reason be removed?
+ # Setting this to false will check for any spawn reason
+ spawn-reason:
+ enabled: false
+ # See https://papermc.io/javadocs/paper/1.16/org/bukkit/event/entity/CreatureSpawnEvent.SpawnReason.html for all spawn reasons
+ reasons:
+ - SPAWNER
+ - SPAWNER_EGG
+ world_nether:
+ entities:
+ - BLAZE
+ - ZOMBIFIED_PIGLIN
+ spawn-reason:
+ enabled: false
+ reasons: []
+# creative:
+# entities:
+# - ARMOR_STAND
+# - ARROW
+# - BOAT
+# - DROPPED_ITEM
+# - MINECART
+# - MINECART_CHEST
+# - MINECART_FURNACE
+# - MINECART_HOPPER
+# - MINECART_TNT
+# spawn-reason:
+# enabled: false
+# reasons: []
+
+nearby-entities:
+ # Should the plugin only remove entities that have multiple entities nearby?
+ # This is useful to only remove large groups of entities while leaving smaller entity groups alone
+ # Using this would prevent every entity from being removed then just respawning again naturally
+ enabled: true
+
+ # Only apply to worlds with the mob spawning gamerule enabled?
+ gamerule-enabled-only: false
+
+ # The distance in blocks that the plugin should check for extra entities
+ x: 3
+ y: 3
+ z: 3
+
+ # How many additional entities must be around the first entity to be removed?
+ count: 4
+
+# Should using the command /clearentities start the countdown or instantly remove the entities?
+countdown-on-command: true
+
+# Should named entities be removed?
+remove-named: false
+
+messages:
+ # Should there be action bar messages?
+ actionbar: true
+
+ # Should there be chat messages?
+ chat: false
+ actionbar-message: "&6&lCommon entities will be removed in &e&l{SECONDS} &6&lsecond{S}!"
+ actionbar-completed-message: "&6&lRemoved &e&l{ENTITIES} &6&lentities!"
+ chat-message: "&cCommon entities will be removed in &7{SECONDS} &csecond{S}!"
+ chat-completed-message: "&cRemoved &7{ENTITIES} ¢ities!"
+
+# When should the warning messages send?
+# Time is in seconds remaining before the clear task
+warning-messages:
+ 60-seconds: false
+ 45-seconds: false
+ 30-seconds: true
+ 15-seconds: false
+ 5-seconds: true
+ 4-seconds: true
+ 3-seconds: true
+ 2-seconds: true
+ 1-second: true
+
+# The command(s) to run after the entity clearing task runs
+commands:
+# - nuke
+
+low-tps:
+ # Should the entity removal task be triggered when the TPS is low?
+ enabled: false
+
+ # Below what TPS should the plugin remove the entities?
+ threshold: 17
+
+ # Should the plugin remove the entities instantly or trigger the countdown?
+ # Warning: If the TPS is too low and remove-instantly is false, the plugin may
+ # not be able to remove the entities before the server crashes
+ remove-instantly: true
+
+ # Should there be a chat message sent to players with the `entityclearer.lowtps`
+ # permission stating that the TPS is low?
+ chat: true
+ chat-message: "&c&lWarning: TPS low &8&l(&7&l{TPS}&8&l)&c&l! Removing entities..."
+
+###############################################
+
+# Debug stuff
+# You shouldn't need to touch this unless specifically asked to do so :)
+print-stack-traces: false
+debug: false
diff --git a/format/yaml/src/test/resources/tab-example.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/tab-example.yml
similarity index 100%
rename from format/yaml/src/test/resources/tab-example.yml
rename to format/yaml/src/test/resources/org/spongepowered/configurate/yaml/tab-example.yml
diff --git a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/write-expected.yml b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/write-expected.yml
index e3ea843b4..3aea74347 100644
--- a/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/write-expected.yml
+++ b/format/yaml/src/test/resources/org/spongepowered/configurate/yaml/write-expected.yml
@@ -2,7 +2,7 @@ mapping:
first: hello
second: world
list:
-- 1
-- 2
-- 3
-- 4
+ - 1
+ - 2
+ - 3
+ - 4
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
index 5f5e74e1b..d37db90db 100644
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@@ -4,6 +4,7 @@ autoValue="1.11.0"
checkerQual="3.49.0"
checkstyle="10.21.3"
geantyref = "1.3.16"
+groovy = "4.0.15"
errorprone="2.36.0"
indra = "3.1.3"
junit="5.12.0"
@@ -46,6 +47,13 @@ slf4j = "org.slf4j:slf4j-api:1.8.0-beta4" # Match version used in MC
guice-compile = "com.google.inject:guice:4.1.0"
guice-runtime = "com.google.inject:guice:5.0.1"
+# Groovy
+groovy = { module = "org.apache.groovy:groovy", version.ref = "groovy" }
+groovy-nio = { module = "org.apache.groovy:groovy-nio", version.ref = "groovy" }
+groovy-templates = { module = "org.apache.groovy:groovy-templates", version.ref = "groovy" }
+groovy-test = { module = "org.apache.groovy:groovy-test", version.ref = "groovy" }
+groovy-test-junit5 = { module = "org.apache.groovy:groovy-test-junit5", version.ref = "groovy" }
+
# Formats
gson = "com.google.code.gson:gson:2.8.0" # Fixed version, to avoid using API not present in older MC
jackson = "com.fasterxml.jackson.core:jackson-core:2.18.2"
@@ -79,6 +87,7 @@ detekt = "io.gitlab.arturbosch.detekt:1.23.8"
dokka = "org.jetbrains.dokka:1.9.20"
gitPublish = "org.ajoberstar.git-publish:5.1.0"
gitpatcher = { id = "ca.stellardrift.gitpatcher", version = "1.1.2" }
+ideaExt = "org.jetbrains.gradle.plugin.idea-ext:1.1.6"
indra-sonatype = { id = "net.kyori.indra.publishing.sonatype", version.ref = "indra" }
indra-git = { id = "net.kyori.indra.git", version.ref = "indra" }
kotlin = "org.jetbrains.kotlin.jvm:1.9.25"
diff --git a/tool/src/main/kotlin/org/spongepowered/configurate/tool/Tool.kt b/tool/src/main/kotlin/org/spongepowered/configurate/tool/Tool.kt
index c3c925a63..b2e9ecc2a 100644
--- a/tool/src/main/kotlin/org/spongepowered/configurate/tool/Tool.kt
+++ b/tool/src/main/kotlin/org/spongepowered/configurate/tool/Tool.kt
@@ -243,6 +243,9 @@ class Yaml : FormatSubcommand("YAML") {
.default(DEFAULT_INDENT)
private val flowStyle by
option("-s", "--style", help = "What node style to use").enum()
+ private val comments by
+ option("-c", "--comments", help = "Whether or not to enable comment handling")
+ .flag("--no-comments", default = false)
override fun createLoader(): ConfigurationLoader {
return YamlConfigurationLoader.builder()
@@ -250,6 +253,7 @@ class Yaml : FormatSubcommand("YAML") {
.headerMode(header)
.indent(indent)
.nodeStyle(flowStyle)
+ .commentsEnabled(comments)
.build()
}
}
diff --git a/vendor/build.gradle.kts b/vendor/build.gradle.kts
new file mode 100644
index 000000000..1d6bf54f2
--- /dev/null
+++ b/vendor/build.gradle.kts
@@ -0,0 +1,90 @@
+import javax.xml.parsers.DocumentBuilderFactory
+
+plugins {
+ id("net.minecraftforge.gitpatcher") version "0.10.+"
+}
+
+patches {
+ submodule = "snakeyaml-upstream"
+ target = file("snakeyaml")
+ patches = file("snakeyaml-patches")
+}
+
+subprojects {
+ apply(plugin = "java-library")
+
+ group = "configurate.thirdparty"
+ version = "version-from-submodule"
+
+ tasks.withType(JavaCompile::class) {
+ options.encoding = "UTF-8"
+ }
+
+ extensions.configure(JavaPluginExtension::class) {
+ toolchain {
+ languageVersion.set(JavaLanguageVersion.of(11))
+ }
+ }
+}
+
+project(":snakeyaml") {
+ val mavenPom = project.file("../snakeyaml-upstream/pom.xml")
+ if (mavenPom.exists()) {
+ val documentBuilder = DocumentBuilderFactory.newInstance().newDocumentBuilder()
+ val document = documentBuilder.parse(mavenPom)
+ val mavenProject = document.getElementsByTagName("project").item(0)
+
+ fun org.w3c.dom.NodeList.element(tagName: String): org.w3c.dom.Element? {
+ for (i in 0..this.length) {
+ val element = this.item(i)
+ if (element is org.w3c.dom.Element && element.tagName == tagName) {
+ return element
+ }
+ }
+ return null
+ }
+
+ dependencies {
+ val dependencies = mavenProject.childNodes.element("dependencies")!!.childNodes
+ for (i in 0..dependencies.length) {
+ val dep = dependencies.item(i)
+ if (dep is org.w3c.dom.Element && dep.tagName == "dependency") {
+ val children = dep.childNodes
+ val group = children.element("groupId")?.textContent
+ val artifact = children.element("artifactId")?.textContent
+ val version = children.element("version")?.textContent
+ val configuration = when (children.element("scope")?.textContent) {
+ "test" -> "testImplementation"
+ "compile" -> "implementation"
+ "runtime" -> "runtime"
+ "provided" -> "compileOnly"
+ else -> null
+ }
+ if (configuration != null) {
+ configuration(group!!, artifact!!, version)
+ }
+ }
+ }
+ }
+ }
+
+ val applyPatches = rootProject.tasks.named("applyPatches")
+ tasks.withType(JavaCompile::class) {
+ options.release.set(7)
+ // dependsOn(applyPatches)
+ }
+ tasks.withType(ProcessResources::class) {
+ // dependsOn(applyPatches)
+ }
+
+ tasks.named("test", Test::class) {
+ environment(
+ "EnvironmentKey1" to "EnvironmentValue1",
+ "environmentEmpty" to ""
+ )
+ filter {
+ // needs classpath provided via expansions, doesn't seem to be easily doable with the maven-style property names
+ excludeTest("org.yaml.snakeyaml.issues.issue318.ContextClassLoaderTest", null)
+ }
+ }
+}
\ No newline at end of file
diff --git a/vendor/snakeyaml-patches/0005-emitter-Do-not-apply-indicator-indent-to-block-seque.patch b/vendor/snakeyaml-patches/0005-emitter-Do-not-apply-indicator-indent-to-block-seque.patch
new file mode 100644
index 000000000..7e8390f86
--- /dev/null
+++ b/vendor/snakeyaml-patches/0005-emitter-Do-not-apply-indicator-indent-to-block-seque.patch
@@ -0,0 +1,51 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: zml
+Date: Sun, 16 Feb 2025 20:09:57 -0800
+Subject: [PATCH] emitter: Do not apply indicator indent to block sequences at
+ root level
+
+This root-level indentation adds extraneous whitespace that looks kinda awkward
+
+diff --git a/src/main/java/org/yaml/snakeyaml/emitter/Emitter.java b/src/main/java/org/yaml/snakeyaml/emitter/Emitter.java
+index 5baf93ae969c0158f5b302ec2f3337f4555107d2..d85f065850ce0d4a076f63fee5ad2e3bf3e74d4e 100644
+--- a/src/main/java/org/yaml/snakeyaml/emitter/Emitter.java
++++ b/src/main/java/org/yaml/snakeyaml/emitter/Emitter.java
+@@ -734,16 +734,18 @@ public final class Emitter implements Emitable {
+ private class ExpectFirstBlockSequenceItem implements EmitterState {
+
+ public void expect() throws IOException {
+- new ExpectBlockSequenceItem(true).expect();
++ new ExpectBlockSequenceItem(true, rootContext).expect();
+ }
+ }
+
+ private class ExpectBlockSequenceItem implements EmitterState {
+
+ private final boolean first;
++ private final boolean suppressIndicatorIndent;
+
+- public ExpectBlockSequenceItem(boolean first) {
++ public ExpectBlockSequenceItem(boolean first, boolean suppressIndicatorIndent) {
+ this.first = first;
++ this.suppressIndicatorIndent = suppressIndicatorIndent;
+ }
+
+ public void expect() throws IOException {
+@@ -757,14 +759,14 @@ public final class Emitter implements Emitable {
+ writeBlockComment();
+ }
+ writeIndent();
+- if (!indentWithIndicator || this.first) {
++ if ((!indentWithIndicator || this.first) && !this.suppressIndicatorIndent) {
+ writeWhitespace(indicatorIndent);
+ }
+ writeIndicator("-", true, false, true);
+- if (indentWithIndicator && this.first) {
++ if (indentWithIndicator && this.first && !this.suppressIndicatorIndent) {
+ indent += indicatorIndent;
+ }
+- states.push(new ExpectBlockSequenceItem(false));
++ states.push(new ExpectBlockSequenceItem(false, this.suppressIndicatorIndent));
+ expectNode(false, false, false);
+ inlineCommentsCollector.collectEvents();
+ writeInlineComments();