add can_be_placed block event

can_be_placed(x, y, z, playerid, rotation) is called before a player
places the block, after the built-in checks (replaceability, grounded,
entities). The block is placed only if the function returns true.
rotation is the rotation the block is going to be placed with, so
blocks like ladders can check the block they are attached to.

The event is not called for block.place / block.set.

Closes #909
This commit is contained in:
ostermine 2026-10-10 15:54:21 +03:00
parent 1dd1af1a72
commit 2a01cfc5b1
6 changed files with 68 additions and 0 deletions

View file

@ -14,6 +14,26 @@ function on_placed(x, y, z, playerid)
Called on block placed by player
```lua
function can_be_placed(x, y, z, playerid, rotation) -> bool
```
Called before a player places the block, after the built-in checks
(replaceability, `grounded`, intersection with entities).
The block is placed only if the function returns `true`.
`rotation` is the rotation index the block will be placed with
(see `block.get_rotation`).
Example: a sapling that can only be planted on dirt.
```lua
function can_be_placed(x, y, z, playerid, rotation)
return block.name(block.get(x, y - 1, z)) == "base:dirt"
end
```
The event is not called when the block is placed with `block.place` or `block.set`.
```lua
function on_broken(x, y, z, playerid)
```