update doc/*/scripting/events.md

2025-11-18 20:58:12 +03:00
parent 1a6880a572
commit b3e5f2a1c0
2 changed files with 18 additions and 0 deletions
@@ -53,6 +53,15 @@ function on_block_tick(x, y, z, tps: number)
 Called tps (20 / tick-interval) times per second for a block.
 Use 1/tps instead of `time.delta()`.

+```lua
+function on_block_present(x, y, z)
+```
+
+Called for a specific block when it appears in the world (generated/loaded/placed).
+The call occurs within a time period that may depend on the event queue load.
+Under light load, it occurs during the first tick interval of the block.
+on_block_tick is not called until the event is called.
+
 ```lua
 function on_player_tick(playerid: int, tps: int)
 ```