From b53c67af470c6625d6863aeabf2d7a7257608b9f Mon Sep 17 00:00:00 2001 From: Doc Date: Tue, 12 May 2026 08:54:54 -0400 Subject: [PATCH 1/2] feat(paper): update worlds structure reference --- .../docs/paper/admin/how-to/anti-xray.mdx | 12 +++---- .../admin/reference/configuration/index.mdx | 32 +++++++++---------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/src/content/docs/paper/admin/how-to/anti-xray.mdx b/src/content/docs/paper/admin/how-to/anti-xray.mdx index 667accd49..640377319 100644 --- a/src/content/docs/paper/admin/how-to/anti-xray.mdx +++ b/src/content/docs/paper/admin/how-to/anti-xray.mdx @@ -142,7 +142,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your nether world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_nether/paper-world.yml" +```yml title="world/dimensions/minecraft/the_nether/paper-world.yml" anticheat: anti-xray: enabled: true @@ -167,7 +167,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your end world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_the_end/paper-world.yml" +```yml title="world/dimensions/minecraft/the_end/paper-world.yml" anticheat: anti-xray: enabled: false @@ -243,7 +243,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your nether world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_nether/paper-world.yml" +```yml title="world/dimensions/minecraft/the_nether/paper-world.yml" anticheat: anti-xray: enabled: true @@ -281,7 +281,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your end world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_the_end/paper-world.yml" +```yml title="world/dimensions/minecraft/the_end/paper-world.yml" anticheat: anti-xray: enabled: false @@ -357,7 +357,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your nether world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_nether/paper-world.yml" +```yml title="world/dimensions/minecraft/the_nether/paper-world.yml" anticheat: anti-xray: enabled: true @@ -394,7 +394,7 @@ anticheat: Copy and paste into your `paper-world.yml` within your end world folder. See the [Configuration Guide](/paper/reference/configuration) for more information. -```yml title="world_the_end/paper-world.yml" +```yml title="world/dimensions/minecraft/the_end/paper-world.yml" anticheat: anti-xray: enabled: false diff --git a/src/content/docs/paper/admin/reference/configuration/index.mdx b/src/content/docs/paper/admin/reference/configuration/index.mdx index 483e6b162..2335d3756 100644 --- a/src/content/docs/paper/admin/reference/configuration/index.mdx +++ b/src/content/docs/paper/admin/reference/configuration/index.mdx @@ -98,14 +98,14 @@ entities: water_creature: 20 ``` -```yaml title="world_nether/paper-world.yml" +```yaml title="world/dimensions/minecraft/the_nether/paper-world.yml" entities: spawning: spawn-limits: monster: 90 ``` -```yaml title="resource_world/paper-world.yml" +```yaml title="world/dimensions/custom/resource/paper-world.yml" lootables: auto-replenish: false entities: @@ -116,21 +116,21 @@ entities: monster: 2 ``` -This example demonstrates the concept of inheritance. For each world, this is the effective +This example demonstrates the concept of inheritance. For each world in `/world/dimensions/`, this is the effective configuration which will be applied: -| Configuration Key | world | world_nether | world_the_end | resource_world | -|-------------------------------------------------------------|--------|--------------|---------------|----------------| -| `lootables.auto-replenish` | `true` | `true` | `true` | `false` | -| `entities.spawning.spawn-limits.ambient` | `15` | `15` | `15` | `15` | -| `entities.spawning.spawn-limits.axolotls` | `5` | `5` | `5` | `8` | -| `entities.spawning.spawn-limits.creature` | `10` | `10` | `10` | `15` | -| `entities.spawning.spawn-limits.monster` | `70` | `90` | `70` | `2` | -| `entities.spawning.spawn-limits.underground_water_creature` | `5` | `5` | `5` | `5` | -| `entities.spawning.spawn-limits.water_ambient` | `20` | `20` | `20` | `20` | -| `entities.spawning.spawn-limits.water_creature` | `5` | `5` | `5` | `5` | - -Notice that `world_the_end/paper-world.yml` was never modified. Because of this, it inherits all the +| Configuration Key | minecraft/overworld | minecraft/the_nether | minecraft/the_end | custom/resource | +|-------------------------------------------------------------|---------------------|----------------------|-------------------|-----------------| +| `lootables.auto-replenish` | `true` | `true` | `true` | `false` | +| `entities.spawning.spawn-limits.ambient` | `15` | `15` | `15` | `15` | +| `entities.spawning.spawn-limits.axolotls` | `5` | `5` | `5` | `8` | +| `entities.spawning.spawn-limits.creature` | `10` | `10` | `10` | `15` | +| `entities.spawning.spawn-limits.monster` | `70` | `90` | `70` | `2` | +| `entities.spawning.spawn-limits.underground_water_creature` | `5` | `5` | `5` | `5` | +| `entities.spawning.spawn-limits.water_ambient` | `20` | `20` | `20` | `20` | +| `entities.spawning.spawn-limits.water_creature` | `5` | `5` | `5` | `5` | + +Notice that `world/dimensions/minecraft/the_end/paper-world.yml` was never modified. Because of this, it inherits all the configuration options from `config/paper-world-defaults.yml`. Additionally, `auto-replenish` was -only disabled in `resource_world/paper-world.yml` because in `config/paper-world-defaults.yml`, +only disabled in `world/dimensions/custom/resource/paper-world.yml` because in `config/paper-world-defaults.yml`, `auto-replenish` is set to `true`. From bddfa8de8bf74f652326975fbfe819fd8b7730b3 Mon Sep 17 00:00:00 2001 From: Doc Date: Tue, 12 May 2026 09:06:16 -0400 Subject: [PATCH 2/2] feat(paper): update world reference in getting-started.mdx --- .../docs/paper/admin/getting-started/getting-started.mdx | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/src/content/docs/paper/admin/getting-started/getting-started.mdx b/src/content/docs/paper/admin/getting-started/getting-started.mdx index cede419c1..a0989a0e0 100644 --- a/src/content/docs/paper/admin/getting-started/getting-started.mdx +++ b/src/content/docs/paper/admin/getting-started/getting-started.mdx @@ -57,9 +57,7 @@ Updating Paper is simple! See our [Update Tutorial](/paper/updating) for more in ### From Vanilla -Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper (and -CraftBukkit and Spigot) separate out each dimension of a world (nether, the end, etc.) into separate -world folders. +Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper allows dimensions to have independent data (like gamerules). Paper will handle this conversion for you automatically. No additional consideration is required.