diff --git a/mappings/net/minecraft/world/World.mapping b/mappings/net/minecraft/world/World.mapping
index e99891e288..e1a3a58f76 100644
--- a/mappings/net/minecraft/world/World.mapping
+++ b/mappings/net/minecraft/world/World.mapping
@@ -45,6 +45,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 		ARG 2 old
 		ARG 3 updated
 	METHOD method_17452 addImportantParticleClient (Lnet/minecraft/class_2394;ZDDDDDD)V
+		COMMENT Adds an important particle to the client's world renderer. Important particles get added even if the Particles graphics option is set to Minimal
+		COMMENT Does nothing on the server.
+		COMMENT
+		COMMENT @see ServerWorld#spawnParticles
 		ARG 1 parameters
 		ARG 2 force
 		ARG 3 x
@@ -135,9 +139,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 	METHOD method_43126 getSpawnPos ()Lnet/minecraft/class_2338;
 	METHOD method_43127 getSpawnAngle ()F
 	METHOD method_43128 playSound (Lnet/minecraft/class_1297;DDDLnet/minecraft/class_3414;Lnet/minecraft/class_3419;FF)V
+		COMMENT Plays a sound caused by a source. On the client, the sound will only play if the source is the same as the client's player.
+		COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
 		ARG 1 source
-			COMMENT the player that caused this sound, or {@code null}. On the client, the sound will only if if the source is the same as the client's player.
-			COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
+			COMMENT the player that caused this sound, or {@code null}
 		ARG 2 x
 		ARG 4 y
 		ARG 6 z
@@ -146,9 +151,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 		ARG 10 volume
 		ARG 11 pitch
 	METHOD method_43129 playSoundFromEntity (Lnet/minecraft/class_1297;Lnet/minecraft/class_1297;Lnet/minecraft/class_3414;Lnet/minecraft/class_3419;FF)V
+		COMMENT Plays a sound caused by a source at the provided entity's position. On the client, the sound will only play if the source is the same as the client's player.
+		COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
 		ARG 1 source
-			COMMENT the player that caused this sound, or {@code null}. On the client, the sound will only if if the source is the same as the client's player.
-			COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
+			COMMENT the player that caused this sound, or {@code null}
 		ARG 2 entity
 		ARG 3 sound
 		ARG 4 category
@@ -190,9 +196,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 	METHOD method_47576 (Ljava/util/function/Predicate;Ljava/util/List;ILnet/minecraft/class_5575;Lnet/minecraft/class_1297;)Lnet/minecraft/class_7927$class_7928;
 		ARG 4 entity
 	METHOD method_47967 playSound (Lnet/minecraft/class_1297;DDDLnet/minecraft/class_3414;Lnet/minecraft/class_3419;FFJ)V
+		COMMENT Plays a sound caused by a source. On the client, the sound will only play if the source is the same as the client's player.
+		COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
 		ARG 1 source
-			COMMENT the player that caused this sound, or {@code null}. On the client, the sound will only if if the source is the same as the client's player.
-			COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
+			COMMENT the player that caused this sound, or {@code null}
 		ARG 2 x
 		ARG 4 y
 		ARG 6 z
@@ -285,9 +292,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 	METHOD method_8442 getSkyAngleRadians (F)F
 		ARG 1 tickDelta
 	METHOD method_8449 playSoundFromEntity (Lnet/minecraft/class_1297;Lnet/minecraft/class_1297;Lnet/minecraft/class_6880;Lnet/minecraft/class_3419;FFJ)V
+		COMMENT Plays a sound caused by a source at the provided entity's position. On the client, the sound will only play if the source is the same as the client's player.
+		COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
 		ARG 1 source
-			COMMENT the player that caused this sound, or {@code null}. On the client, the sound will only if if the source is the same as the client's player.
-			COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
+			COMMENT the player that caused this sound, or {@code null}
 		ARG 2 entity
 		ARG 3 sound
 		ARG 4 category
@@ -325,9 +333,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 		ARG 2 block
 	METHOD method_8458 isSavingDisabled ()Z
 	METHOD method_8465 playSound (Lnet/minecraft/class_1297;DDDLnet/minecraft/class_6880;Lnet/minecraft/class_3419;FFJ)V
+		COMMENT Plays a sound caused by a source. On the client, the sound will only play if the source is the same as the client's player.
+		COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
 		ARG 1 source
-			COMMENT the player that caused this sound, or {@code null}. On the client, the sound will only if if the source is the same as the client's player.
-			COMMENT On the server, sound packets will be sent to players around the source, excluding the source itself.
+			COMMENT the player that caused this sound, or {@code null}
 		ARG 2 x
 		ARG 4 y
 		ARG 6 z
@@ -337,6 +346,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 		ARG 11 pitch
 		ARG 12 seed
 	METHOD method_8466 addParticleClient (Lnet/minecraft/class_2394;ZZDDDDDD)V
+		COMMENT Adds a particle to the client's world renderer.
+		COMMENT Does nothing on the server.
+		COMMENT
+		COMMENT @see ServerWorld#spawnParticles
 		ARG 1 parameters
 		ARG 2 force
 		ARG 3 canSpawnOnMinimal
@@ -380,6 +393,10 @@ CLASS net/minecraft/class_1937 net/minecraft/world/World
 		ARG 2 sourceBlock
 		ARG 3 orientation
 	METHOD method_8494 addImportantParticleClient (Lnet/minecraft/class_2394;DDDDDD)V
+		COMMENT Adds an important particle to the client's world renderer. Important particles get added even if the Particles graphics option is set to Minimal
+		COMMENT Does nothing on the server.
+		COMMENT
+		COMMENT @see ServerWorld#spawnParticles
 		ARG 1 parameters
 		ARG 2 x
 		ARG 4 y
diff --git a/mappings/net/minecraft/world/WorldAccess.mapping b/mappings/net/minecraft/world/WorldAccess.mapping
index 80aef46829..fdb850fc70 100644
--- a/mappings/net/minecraft/world/WorldAccess.mapping
+++ b/mappings/net/minecraft/world/WorldAccess.mapping
@@ -47,6 +47,10 @@ CLASS net/minecraft/class_1936 net/minecraft/world/WorldAccess
 	METHOD method_8404 getLocalDifficulty (Lnet/minecraft/class_2338;)Lnet/minecraft/class_1266;
 		ARG 1 pos
 	METHOD method_8406 addParticleClient (Lnet/minecraft/class_2394;DDDDDD)V
+		COMMENT Adds a particle to the client's world renderer.
+		COMMENT Does nothing on the server.
+		COMMENT
+		COMMENT @see ServerWorld#spawnParticles
 		ARG 1 parameters
 		ARG 2 x
 		ARG 4 y