From 647457ff18fb393cf46e39fa22d7db6e1f1c7471 Mon Sep 17 00:00:00 2001
From: Privatech <99482159+Privatech38@users.noreply.github.com>
Date: Tue, 24 Mar 2026 19:59:38 +0100
Subject: [PATCH 1/2] Document 26.1 growth particles

---
 src/content/docs/paper/dev/api/particles.mdx | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/content/docs/paper/dev/api/particles.mdx b/src/content/docs/paper/dev/api/particles.mdx
index d9af2c3a0..9b1f1fb43 100644
--- a/src/content/docs/paper/dev/api/particles.mdx
+++ b/src/content/docs/paper/dev/api/particles.mdx
@@ -186,7 +186,9 @@ We could also make the smoke go down if we wanted to:
 - GLOW_SQUID_INK
 - ITEM
 - LARGE_SMOKE
+- PAUSE_MOB_GROWTH
 - POOF
+- RESET_MOB_GROWTH
 - REVERSE_PORTAL
 - SCRAPE
 - SCULK_CHARGE
@@ -765,6 +767,17 @@ The y component of the vector is calculated as `(verticalVelocity - 0.1) * power
 - INSTANT_EFFECT
 - DRAGON_BREATH
 
+### Simple vertical particles
+These particles apply a small, fixed change to vertical velocity (`±0.03`) based on a boolean flag:
+- If the flag is `true`, add `0.03` to the vertical velocity.
+- If the flag is `false`, subtract `0.03` from the vertical velocity.
+
+Only two particles use this behavior:
+
+- `PAUSE_MOB_GROWTH`: sets the flag to `false` (applies `-0.03`).
+- `RESET_MOB_GROWTH`: sets the flag to `true` (applies `+0.03`).
+
+
 ### Splash particles
 The `SPLASH` particle uses the `offsetX` and `offsetZ` arguments to determine the particle's velocity vector, if two conditions are met:
 1. `offsetY` is `0`

From 4fffe1451570487f25f1afffd56566a38085104c Mon Sep 17 00:00:00 2001
From: Privatech <99482159+Privatech38@users.noreply.github.com>
Date: Tue, 24 Mar 2026 22:48:03 +0100
Subject: [PATCH 2/2] Update guide version

---
 src/content/docs/paper/dev/api/particles.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/paper/dev/api/particles.mdx b/src/content/docs/paper/dev/api/particles.mdx
index 9b1f1fb43..f88d3484f 100644
--- a/src/content/docs/paper/dev/api/particles.mdx
+++ b/src/content/docs/paper/dev/api/particles.mdx
@@ -2,7 +2,7 @@
 title: Particles
 description: A comprehensive guide to particle spawning.
 slug: paper/dev/particles
-version: 1.21.9
+version: "26.1"
 ---
 
 import { Tabs, TabItem, Badge } from "@astrojs/starlight/components";