From e7097d04a61e8d92664ef5399267a59cf6b82ea4 Mon Sep 17 00:00:00 2001
From: Bukkit/Spigot <noreply+git-bukkit@papermc.io>
Date: Thu, 9 Jul 2020 08:43:22 +1000
Subject: [PATCH] SPIGOT-5970: Update JavaDocs information regarding
 WorldCreator#generatorSettings

By: Martoph <sager1018@gmail.com>
---
 paper-api/src/main/java/org/bukkit/WorldCreator.java | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/paper-api/src/main/java/org/bukkit/WorldCreator.java b/paper-api/src/main/java/org/bukkit/WorldCreator.java
index b562d3792c..6e6945dd4c 100644
--- a/paper-api/src/main/java/org/bukkit/WorldCreator.java
+++ b/paper-api/src/main/java/org/bukkit/WorldCreator.java
@@ -232,10 +232,15 @@ public class WorldCreator {
      * Sets the generator settings of the world that will be created or loaded.
      * <p>
      * Currently only {@link WorldType#FLAT} uses these settings, and expects
-     * them to be in JSON format with a valid biome defined. An example valid
-     * configuration is as follows:
-     * <code>{"layers": [{"block": "stone", "height": 1}, {"block": "grass", "height": 1}], "biome":"plains"}</code>
+     * them to be in JSON format with a valid biome AND structures (1.16 and
+     * above) defined. Note the occurrence of "structures" twice (nested
+     * compound may be empty, both must exist.). An example valid configuration
+     * is as follows:
+     * <code>{"structures": {"structures": {"village": {"salt": 8015723, "spacing": 32, "separation": 8}}}, "layers": [{"block": "stone", "height": 1}, {"block": "grass", "height": 1}], "biome":"plains"}</code>
      *
+     * @see <a href="https://minecraft.gamepedia.com/Custom_dimension">Custom
+     * dimension</a> (scroll to "When the generator ID type is
+     * <code>minecraft:flat</code>)"
      * @param generatorSettings The settings that should be used by the
      * generator
      * @return This object, for chaining