Custom-Blocks.md

@@ -2,7 +2,15 @@ Crucible allows people to create "custom blocks" using the extra block states fr
 
 Items that are configured to be blocks will have their corresponding block placed in the world where the player is looking when right-clicked, and will drop the original item when broken by default (unless configured otherwise).
 
-
+Custom Blocks use blockstates to work. This can lead to some glitchy looking behaviour with block updates, if you are using Paper it is recommended to disable updates for these blocks.
+Head to `/config/paper-global.yml` and disable block updates for the base block type you use in the section at the top. This example disables Noteblock updates.
+```yaml
+block-updates:
+  disable-chorus-plant-updates: false
+  disable-mushroom-block-updates: false
+  disable-noteblock-updates: true
+  disable-tripwire-updates: false
+```
 ## Custom Block Options
 All options are placed under a `CustomBlock` section on an item.