diff --git a/mappings/net/minecraft/network/packet/s2c/play/EntityVelocityUpdateS2CPacket.mapping b/mappings/net/minecraft/network/packet/s2c/play/EntityVelocityUpdateS2CPacket.mapping
index ea6111b06d..cc5adc9ce7 100644
--- a/mappings/net/minecraft/network/packet/s2c/play/EntityVelocityUpdateS2CPacket.mapping
+++ b/mappings/net/minecraft/network/packet/s2c/play/EntityVelocityUpdateS2CPacket.mapping
@@ -1,4 +1,9 @@
 CLASS net/minecraft/class_2743 net/minecraft/network/packet/s2c/play/EntityVelocityUpdateS2CPacket
+	COMMENT Sent when a server modifies an entity's velocity.
+	COMMENT
+	COMMENT <p>If the entity is a player, {@link
+	COMMENT net.minecraft.network.packet.s2c.play.ExplosionS2CPacket} can be used as
+	COMMENT a replacement.
 	FIELD field_12561 velocityZ I
 	FIELD field_12562 velocityY I
 	FIELD field_12563 velocityX I
diff --git a/mappings/net/minecraft/network/packet/s2c/play/ExplosionS2CPacket.mapping b/mappings/net/minecraft/network/packet/s2c/play/ExplosionS2CPacket.mapping
index 469a338953..48269e742b 100644
--- a/mappings/net/minecraft/network/packet/s2c/play/ExplosionS2CPacket.mapping
+++ b/mappings/net/minecraft/network/packet/s2c/play/ExplosionS2CPacket.mapping
@@ -1,4 +1,11 @@
 CLASS net/minecraft/class_2664 net/minecraft/network/packet/s2c/play/ExplosionS2CPacket
+	COMMENT Sent when an explosion occurs in the world.
+	COMMENT
+	COMMENT <p>The client will update {@linkplain
+	COMMENT net.minecraft.client.MinecraftClient#player the player}'s velocity as
+	COMMENT well as performing an explosion.
+	COMMENT
+	COMMENT @see net.minecraft.network.packet.s2c.play.EntityVelocityUpdateS2CPacket
 	FIELD field_12176 playerVelocityX F
 	FIELD field_12177 z D
 	FIELD field_12178 y D