diff --git a/readme.md b/readme.md
index 49c9236..d0f29c4 100644
--- a/readme.md
+++ b/readme.md
@@ -66,6 +66,35 @@ settings:
   network:
     max-joins-per-second: true
 ```
+
+### Projectile suspension
+
+Projectiles can be suspended in bubble columns indefinitely. They can also be transported into unloaded chunks in mass.
+If anyone loads the chunk with amassed projectiles, server can crash due to loading too many things at once. This can
+be stopped by limiting how much time projectiles can exist in the world and how many of them are saved and loaded with 
+a chunk. If the timeout is applied to ender pearls, it will prevent usage of ender pearl suspension contraption.
+
+`paper-world-defaults.yml`
+```yaml
+chunks:
+  entity-per-chunk-save-limit:
+    arrow: 8
+    ender_pearl: 8
+    experience_orb: 8
+    fireball: 8
+    small_fireball: 8
+    snowball: 8
+```
+
+`pufferfish.yml`
+```yaml
+entity_timeouts:
+  ARROW: 200
+  EGG: 200
+  ENDER_PEARL: 200
+  SNOWBALL: 200
+```
+
 ### Treasure search
 
 When new treasure map is generated, usually via cartographer villager or opening a chest with treasure map in it, the