Repository: PaperMC/docs
Pull request #594: docs: clarify links between Bukkit and Paper spawn rate properties
Author: login: Djaytan
Created: 2025-05-18T20:08:26Z | Merged: 2025-05-19T08:49:58Z



Diff:
diff --git a/src/config/paper/bukkit.yml b/src/config/paper/bukkit.yml
index 30f4c503a..f30e17c19 100644
--- a/src/config/paper/bukkit.yml
+++ b/src/config/paper/bukkit.yml
@@ -82,7 +82,8 @@ spawn-limits:
     default: "5"
     description: >-
       Set the spawn-limits for water underground creatures. This can be
-      overridden by the [Paper world config](/paper/reference/world-configuration#entities_spawning_spawn_limits_underground_water_creature).
+      overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_spawn_limits_underground_water_creature).
   axolotls:
     default: "5"
     description: >-
@@ -103,38 +104,52 @@ ticks-per:
   animal-spawns:
     default: "400"
     description: >-
-      Number of ticks between each animal spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each passive creature (animal) spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_creature).
   monster-spawns:
     default: "1"
     description: >-
-      Number of ticks between each monster spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each hostile monster spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_monster).
   water-spawns:
     default: "1"
     description: >-
-      Number of ticks between each water-animal spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each water creature spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_water_creature).
   water-ambient-spawns:
     default: "1"
     description: >-
-      Number of ticks between each water-ambient mob spawn attempt. Set to -1 to
-      use default.
+      Number of ticks between each ambient water mob spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_water_ambient).
   water-underground-creature-spawns:
     default: "1"
     description: >-
-      Number of ticks between each water-underground-creature spawn attempt. Set
-      to -1 to use default.
+      Number of ticks between each underground water creatures spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_underground_water_creature).
   axolotl-spawns:
     default: "1"
     description: >-
-      Number of ticks between each axolotl spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each axolotl spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_axolotls).
   ambient-spawns:
     default: "1"
     description: >-
-      Number of ticks between each ambient mob spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each ambient mob spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.wiki/w/Spawn_limit).
+      This can be overridden by the
+      [Paper world config](/paper/reference/world-configuration#entities_spawning_ticks_per_spawn_ambient).
   autosave:
     default: "6000"
     description: >-
diff --git a/src/config/paper/paper-world-defaults.yml b/src/config/paper/paper-world-defaults.yml
index 66031e1e0..b0f183bfe 100644
--- a/src/config/paper/paper-world-defaults.yml
+++ b/src/config/paper/paper-world-defaults.yml
@@ -373,37 +373,44 @@ entities:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn ambient mobs (bats).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_ambient_spawns).
       axolotls:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn axolotls.
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_axolotl_spawns).
       creature:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn passive creatures (animals).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_animal_spawns).
       monster:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn hostile monsters.
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_monster_spawns).
       underground_water_creature:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn underground water creatures (glow squid).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_underground_creature_spawns).
       water_ambient:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn ambient water mobs (tropical fish).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_ambient_spawns).
       water_creature:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn water creatures (squid, dolphins).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_spawns).
     despawn-range-shape:
       default: ELLIPSOID
       description: >-


Reviews:
user: login: zlataovce
state: CHANGES_REQUESTED
author_association: MEMBER
submitted_at: 2025-05-18T20:15:03Z
user: login: zlataovce
state: APPROVED
author_association: MEMBER
submitted_at: 2025-05-18T20:44:18Z
user: login: Strokkur424
state: APPROVED
author_association: MEMBER
submitted_at: 2025-05-18T20:57:35Z
user: login: olijeffers0n
state: APPROVED
author_association: MEMBER
submitted_at: 2025-05-19T08:49:47Z

Review comments:
diff_hunk: @@ -103,38 +104,52 @@ ticks-per:
   animal-spawns:
     default: "400"
     description: >-
-      Number of ticks between each animal spawn attempt. Set to -1 to use
-      default.
+      Number of ticks between each passive creature (animal) spawn attempt.
+      Set to -1 to use [the Vanilla default](https://minecraft.fandom.com/wiki/Spawn#Java_Edition).
path: src/config/paper/bukkit.yml
user: login: zlataovce
body: the official wiki is at https://minecraft.wiki
created_at: 2025-05-18T20:13:12Z
author_association: MEMBER
diff_hunk: @@ -373,37 +373,44 @@ entities:
         default: "-1"
         description: |
           Determines how many ticks there are between attempts to spawn ambient mobs (bats).
-          Default (-1) uses Vanilla spawn rate.
+          Default (-1) uses
+          [Bukkit spawn rate](/paper/reference/bukkit-configuration#ticks_per_ambient_spawns).
path: src/config/paper/paper-world-defaults.yml
user: login: zlataovce
body: should say `bukkit.yml spawn rate` to be entirely clear
created_at: 2025-05-18T20:14:56Z
author_association: MEMBER

PR comments:
user: login: github-actions[bot]
created_at: 2025-05-18T20:09:42Z
body: <!-- refined-cf-pages-action:deployment-summary:docs -->

###### built with [Refined Cloudflare Pages Action](https://github.com/AdrianGonz97/refined-cf-pages-action)
## ⚡ Cloudflare Pages Deployment
| Name | Status | Preview | Last Commit |
| :--- | :----- | :------ | :---------- |
| **papermc-docs** | ✅ Ready ([View Log](https://github.com/PaperMC/docs/actions/runs/15099737118)) | [Visit Preview](https://djaytan-docs-clarify-links-b.papermc-docs.pages.dev) | 9a9ac92a3c9b23ba49d1bf09bdf029ed14eef45c |

author_association: NONE
user: login: Djaytan
created_at: 2025-05-18T20:19:32Z
body: Thanks a lot @zlataovce for the quick and great review!

I'm doing the suggested changes right now.
author_association: CONTRIBUTOR