====== OnPlayerBrokenBlock hook callback function ======
This function is called after a player breaks a block. The block is already removed from the world and pickups have been spawned. To get the world in which the block has been dug, use the [[API:cPlayer|cPlayer]]:GetWorld() function.

===== Function signature =====
<code lua>
function OnPlayerBrokenBlock(Player, BlockX, BlockY, BlockZ, BlockFace, BlockType, BlockMeta)
</code>
Parameters:
| Player | [[API::cPlayer|cPlayer]] | The player who broke the block |
| BlockX | number | X-coord of the block |
| BlockY | number | Y-coord of the block |
| BlockZ | number | Z-coord of the block |
| BlockFace | number | Face of the block through which the player interacted |
| BlockType | BLOCKTYPE | Block type of the block |
| BlockMeta | NIBBLETYPE | Block meta of the block |

===== Return values =====
If the function returns false or no value, the next plugin's callback is called. If the function returns true, no other callback is called for this event.

===== Registering the callback =====
To register your plugin to receive a callback through this function, use the hook [[api:plugin:hooks|HOOK_PLAYER_BROKEN_BLOCK]]
<code lua>
cPluginManager:Get():AddHook(Plugin, cPluginManager.HOOK_PLAYER_BROKEN_BLOCK);
</code>