Merge pull request #1026 from ostermine/feat/can-be-placed

add can_be_placed block event
This commit is contained in:
MihailRis 2026-10-13 22:23:08 +03:00 • committed by GitHub
commit bccc6e154f
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
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)
```