Skip to content

Commit a8a5b46

Browse files
authored
feat(paper): update worlds structure reference (#766)
1 parent f07f553 commit a8a5b46

3 files changed

Lines changed: 23 additions & 25 deletions

File tree

src/content/docs/paper/admin/getting-started/getting-started.mdx

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,7 @@ Updating Paper is simple! See our [Update Tutorial](/paper/updating) for more in
5757

5858
### From Vanilla
5959

60-
Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper (and
61-
CraftBukkit and Spigot) separate out each dimension of a world (nether, the end, etc.) into separate
62-
world folders.
60+
Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper allows dimensions to have independent data (like gamerules).
6361

6462
Paper will handle this conversion for you automatically. No additional consideration is required.
6563

src/content/docs/paper/admin/how-to/anti-xray.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ anticheat:
142142
Copy and paste into your `paper-world.yml` within your nether world folder. See the
143143
[Configuration Guide](/paper/reference/configuration) for more information.
144144

145-
```yml title="world_nether/paper-world.yml"
145+
```yml title="world/dimensions/minecraft/the_nether/paper-world.yml"
146146
anticheat:
147147
anti-xray:
148148
enabled: true
@@ -167,7 +167,7 @@ anticheat:
167167
Copy and paste into your `paper-world.yml` within your end world folder. See the
168168
[Configuration Guide](/paper/reference/configuration) for more information.
169169

170-
```yml title="world_the_end/paper-world.yml"
170+
```yml title="world/dimensions/minecraft/the_end/paper-world.yml"
171171
anticheat:
172172
anti-xray:
173173
enabled: false
@@ -243,7 +243,7 @@ anticheat:
243243
Copy and paste into your `paper-world.yml` within your nether world folder. See the
244244
[Configuration Guide](/paper/reference/configuration) for more information.
245245

246-
```yml title="world_nether/paper-world.yml"
246+
```yml title="world/dimensions/minecraft/the_nether/paper-world.yml"
247247
anticheat:
248248
anti-xray:
249249
enabled: true
@@ -281,7 +281,7 @@ anticheat:
281281
Copy and paste into your `paper-world.yml` within your end world folder. See the
282282
[Configuration Guide](/paper/reference/configuration) for more information.
283283

284-
```yml title="world_the_end/paper-world.yml"
284+
```yml title="world/dimensions/minecraft/the_end/paper-world.yml"
285285
anticheat:
286286
anti-xray:
287287
enabled: false
@@ -357,7 +357,7 @@ anticheat:
357357
Copy and paste into your `paper-world.yml` within your nether world folder. See the
358358
[Configuration Guide](/paper/reference/configuration) for more information.
359359

360-
```yml title="world_nether/paper-world.yml"
360+
```yml title="world/dimensions/minecraft/the_nether/paper-world.yml"
361361
anticheat:
362362
anti-xray:
363363
enabled: true
@@ -394,7 +394,7 @@ anticheat:
394394
Copy and paste into your `paper-world.yml` within your end world folder. See the
395395
[Configuration Guide](/paper/reference/configuration) for more information.
396396

397-
```yml title="world_the_end/paper-world.yml"
397+
```yml title="world/dimensions/minecraft/the_end/paper-world.yml"
398398
anticheat:
399399
anti-xray:
400400
enabled: false

src/content/docs/paper/admin/reference/configuration/index.mdx

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -98,14 +98,14 @@ entities:
9898
water_creature: 20
9999
```
100100

101-
```yaml title="world_nether/paper-world.yml"
101+
```yaml title="world/dimensions/minecraft/the_nether/paper-world.yml"
102102
entities:
103103
spawning:
104104
spawn-limits:
105105
monster: 90
106106
```
107107

108-
```yaml title="resource_world/paper-world.yml"
108+
```yaml title="world/dimensions/custom/resource/paper-world.yml"
109109
lootables:
110110
auto-replenish: false
111111
entities:
@@ -116,21 +116,21 @@ entities:
116116
monster: 2
117117
```
118118

119-
This example demonstrates the concept of inheritance. For each world, this is the effective
119+
This example demonstrates the concept of inheritance. For each world in `/world/dimensions/`, this is the effective
120120
configuration which will be applied:
121121

122-
| Configuration Key | world | world_nether | world_the_end | resource_world |
123-
|-------------------------------------------------------------|--------|--------------|---------------|----------------|
124-
| `lootables.auto-replenish` | `true` | `true` | `true` | `false` |
125-
| `entities.spawning.spawn-limits.ambient` | `15` | `15` | `15` | `15` |
126-
| `entities.spawning.spawn-limits.axolotls` | `5` | `5` | `5` | `8` |
127-
| `entities.spawning.spawn-limits.creature` | `10` | `10` | `10` | `15` |
128-
| `entities.spawning.spawn-limits.monster` | `70` | `90` | `70` | `2` |
129-
| `entities.spawning.spawn-limits.underground_water_creature` | `5` | `5` | `5` | `5` |
130-
| `entities.spawning.spawn-limits.water_ambient` | `20` | `20` | `20` | `20` |
131-
| `entities.spawning.spawn-limits.water_creature` | `5` | `5` | `5` | `5` |
132-
133-
Notice that `world_the_end/paper-world.yml` was never modified. Because of this, it inherits all the
122+
| Configuration Key | minecraft/overworld | minecraft/the_nether | minecraft/the_end | custom/resource |
123+
|-------------------------------------------------------------|---------------------|----------------------|-------------------|-----------------|
124+
| `lootables.auto-replenish` | `true` | `true` | `true` | `false` |
125+
| `entities.spawning.spawn-limits.ambient` | `15` | `15` | `15` | `15` |
126+
| `entities.spawning.spawn-limits.axolotls` | `5` | `5` | `5` | `8` |
127+
| `entities.spawning.spawn-limits.creature` | `10` | `10` | `10` | `15` |
128+
| `entities.spawning.spawn-limits.monster` | `70` | `90` | `70` | `2` |
129+
| `entities.spawning.spawn-limits.underground_water_creature` | `5` | `5` | `5` | `5` |
130+
| `entities.spawning.spawn-limits.water_ambient` | `20` | `20` | `20` | `20` |
131+
| `entities.spawning.spawn-limits.water_creature` | `5` | `5` | `5` | `5` |
132+
133+
Notice that `world/dimensions/minecraft/the_end/paper-world.yml` was never modified. Because of this, it inherits all the
134134
configuration options from `config/paper-world-defaults.yml`. Additionally, `auto-replenish` was
135-
only disabled in `resource_world/paper-world.yml` because in `config/paper-world-defaults.yml`,
135+
only disabled in `world/dimensions/custom/resource/paper-world.yml` because in `config/paper-world-defaults.yml`,
136136
`auto-replenish` is set to `true`.

0 commit comments

Comments
 (0)