diff --git a/docs/effects/all-effects/aoe.md b/docs/effects/all-effects/aoe.md
index 0c426a0b1d..12ba42fbad 100644
--- a/docs/effects/all-effects/aoe.md
+++ b/docs/effects/all-effects/aoe.md
@@ -1,18 +1,21 @@
 # `aoe`
+
 #### Triggered Effect
 
 Runs effects for all entities within an area of effect (aoe)
 
 ## List of Shapes
-| ID | Description |Args |
-| --- | --- | --- |
-| `cone` | A cone in front of the player (think sweeping edge) | `radius` The radius of the cone (distance in front) <br /> `angle` The angle of the cone |
-| `circle` | A circle around the player | `radius` The radius of the circle |
-| `offset_circle` | A circle around a point in front of the player | `radius` The radius of the circle <br /> `offset` The amount of blocks in front |
-| `scan_in_front` | Scan for entities in the direction you're looking at and affect the first ones found | `radius` The radius of the scan <br /> `max_distance` The maximum distance to scan |
 
+| ID              | Description                                                                        | Args                                                                                                                                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `cone`          | A cone in front of the player (think sweeping edge)                                | `radius` The radius of the cone (distance in front) <br /> `angle` The angle of the cone                                                                                                                 |
+| `circle`        | A circle around the player                                                         | `radius` The radius of the circle                                                                                                                                                                        |
+| `offset_circle` | A circle around a point in front of the player                                     | `radius` The radius of the circle <br /> `offset` The amount of blocks in front                                                                                                                          |
+| `scan_in_front` | Scan for entities in the direction you're looking, and affect the first ones found | `radius` The radius of the scan <br /> `max_distance` The maximum distance to scan                                                                                                                       |
+| `beam`          | A beam in the direction you're looking                                             | `radius` The radius of the beam <br /> `distance` The length of the beam <br /> `pierce_blocks` If the beam should pass through blocks <br /> `pierce_entities` If the beam should pass through entities |
 
 # Example Config
+
 ```yaml
 - id: aoe
   args:
diff --git a/docs/effects/all-effects/aoe_blocks.md b/docs/effects/all-effects/aoe_blocks.md
new file mode 100644
index 0000000000..c9d47e4173
--- /dev/null
+++ b/docs/effects/all-effects/aoe_blocks.md
@@ -0,0 +1,22 @@
+# `aoe_blocks`
+
+#### Triggered Effect
+
+Runs effects for all blocks within an area of effect
+
+The list of shapes is found [here](https://plugins.auxilor.io/effects/all-effects/aoe#list-of-shapes)
+
+# Example Config
+
+```yaml
+- id: aoe
+  args:
+    effects: # The effects to run for each block
+      - id: break_block
+    shape: beam # The shape of the AOE area (see above)
+    radius: 3 # The radius of the cone (see above)
+    distance: 15 # The length of the beam (see above)
+    pierce_blocks: true # If the beam should pass through blocks (see above)
+    pierce_entities: true # If the beam should pass through entities (see above)
+  ...other config (eg triggers, filters, mutators, etc)
+```