diff --git a/README.md b/README.md
index 03cf4b2..b9829df 100644
--- a/README.md
+++ b/README.md
@@ -137,6 +137,15 @@ Slows down incremental world saving spreading the task over time even more for b
to set this higher with more than 20-30 players, because if incremental save can't finish in time bukkit will automatically
save leftover chunks at once and begin the process again.
+
per-player-mob-spawns
+default: false
+optimized: true
+explanation:
+By default mob limits are counted for the entire server which means mobs might end up being distributed unevenly between
+online players. This option enables per-player mob limits, meaning all players can get approximately the same number of
+mobs around them regardless of number of online players. Enabling this option also allows you to lower `spawn-limits` in
+`bukkit.yml` since those are optimized for per-server mob limits.
+
optimize-explosions
default: false
optimized: true