Item-Stats-and-Options.md

@@ -246,4 +246,7 @@ FIRE_GREATLANCE:
 There are two main item stats you can use to customize muskets. Muskets are special range weapons that fire bullets when right-clicked. The knockback item stat defines the knockback applied onto the player whenever he fires a musket. It thus must be a positive value. The recoil defines the shooting accuracy e.g when set to 5, shots will be performed randomly 5° around your cursor.
 
 ## Lute Stats
-Lutes are ranged weapons which emit a music projectile when right clicked. Lutes have different attack effects (the list of all available effects is prompted when editing any lute attack effect using the edition GUI) which define the look of the projectile. You can also change the sound played when attacking. Note Weight when set to any value strictly greater than 0 will make the projectile slightly tilt its trajectory downwards with time as if it was pulled down by gravity.
+Lutes are ranged weapons which emit a music projectile when right clicked. Lutes have different attack effects (the list of all available effects is prompted when editing any lute attack effect using the edition GUI) which define the look of the projectile. You can also change the sound played when attacking. Note Weight when set to any value strictly greater than 0 will make the projectile slightly tilt its trajectory downwards with time as if it was pulled down by gravity.
\ No newline at end of file
+
+## Custom Item Sounds
+Custom item sounds are sounds played when performing specific actions with your items like attacking entities, right clicking your item, picking up your item... **Warning**, these sounds do not correspond to the Spigot javadocs sound names, they correspond to the vanilla sound names like `entity.zombie.attack_iron_door` (instead of `ENTITY_ZOMBIE_ATTACK_IRON_DOOR`). Since they utilize vanilla sound names, you may use the sounds you added to your server resource pack setup!
\ No newline at end of file