====== OnPlayerBreakingBlock hook callback function ======
This function gets called when a player breaks a block, before the block is actually broken in the World. Plugins may refuse the breaking.

===== Function signature =====
<code lua>
function OnPlayerBreakingBlock(Player, BlockX, BlockY, BlockZ, BlockFace, BlockType, BlockMeta)
</code>
Parameters:
| Player | [[API:cPlayer|cPlayer]] | The player that is digging 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 | The face of the block upon which the player is acting. One of the BLOCK_FACE_ constants |
| BlockType | BLOCKTYPE | The block type of the block being broken |
| BlockMeta | NIBBLETYPE | The block meta of the block being broken |

===== Return values =====
If the function returns false, other plugins' callbacks are called, and the block is broken. If the function returns true, no other plugin's callback is called and the block breaking is cancelled. The server re-sends the block back to the player to replace it (the player's client already thinks the block was broken).

===== Registering the callback =====
To register your plugin to receive a callback through this function, use the hook [[api:plugin:hooks|HOOK_PLAYER_BREAKING_BLOCK]]

<code lua>
PluginManager = cPluginManager:GetPluginManager()
PluginManager:AddHook(Plugin, cPluginManager.HOOK_PLAYER_BREAKING_BLOCK)
</code>
