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

@ -24,6 +24,26 @@ function on_placed(x, y, z, playerid)
Вызывается после установки блока игроком
```lua
function can_be_placed(x, y, z, playerid, rotation) -> bool
```
Вызывается перед установкой блока игроком, после встроенных проверок
(заменяемость, `grounded`, пересечение с сущностями).
Блок устанавливается, только если функция возвращает `true`.
`rotation` - индекс поворота, с которым будет установлен блок
(см. `block.get_rotation`).
Пример: саженец, который можно посадить только на землю.
```lua
function can_be_placed(x, y, z, playerid, rotation)
return block.name(block.get(x, y - 1, z)) == "base:dirt"
end
```
Событие не вызывается при установке блока через `block.place` и `block.set`.
```lua
function on_broken(x, y, z, playerid)
```