document tick-interval

This commit is contained in:
MihailRis 2025-12-04 17:35:39 +03:00 committed by ShiftyX1
parent f1d9f1bf60
commit db09672e50
4 changed files with 23 additions and 11 deletions

View File

@ -216,10 +216,6 @@ Item will be chosen on MMB click on the block.
Example: block `door:door_open` is hidden, so you need to specify `picking-item: "door:door.item"` to bind it to not hidden `door:door` block item. Example: block `door:door_open` is hidden, so you need to specify `picking-item: "door:door.item"` to bind it to not hidden `door:door` block item.
### *script-name*
Used to specify block script name (to reuse one script to multiple blocks). Name must not contain `packid:scripts/` and extension. Just name.
### *ui-layout* ### *ui-layout*
Block UI XML layout name. Default: string block id. Block UI XML layout name. Default: string block id.
@ -316,6 +312,16 @@ Example: `base:dirt.item`.
To generate loot, the function `block_loot(block_id: int)` in the `base:util` module should be used. To generate loot, the function `block_loot(block_id: int)` in the `base:util` module should be used.
## Other properties
### *script-name*
Used to specify block script name (to reuse one script to multiple blocks). Name must not contain `packid:scripts/` and extension. Just name.
### Tick Interval - *tick-interval*
The interval in ticks (1/20th of a second). A value of 20 results in an on_block_tick call interval of one second.
## Methods ## Methods
Methods are used to manage the overwriting of properties when extending a block with other packs. Methods are used to manage the overwriting of properties when extending a block with other packs.

View File

@ -48,7 +48,7 @@ Called on random block update (grass growth)
function on_blocks_tick(tps: int) function on_blocks_tick(tps: int)
``` ```
Called tps (20) times per second. Use 1/tps instead of `time.delta()`. Called tps (20 / tick-interval) times per second. Use 1/tps instead of `time.delta()`.
```lua ```lua
function on_block_tick(x, y, z, tps: number) function on_block_tick(x, y, z, tps: number)

View File

@ -226,11 +226,6 @@
Пример: блок `door:door_open` скрыт (hidden) поэтому указывается `picking-item: "door:door.item"` Пример: блок `door:door_open` скрыт (hidden) поэтому указывается `picking-item: "door:door.item"`
### Имя скрипта - *script-name*
Позволяет указать название скрипта блока. Свойство обеспечивает возможность использования одного скрипта для нескольких блоков.
Название указывается без `пак:scripts/` и расширения.
### Имя макета UI - *ui-layout* ### Имя макета UI - *ui-layout*
Позволяет указать id XML-макета интерфейса блока. По-умолчанию используется строковый id блока. Позволяет указать id XML-макета интерфейса блока. По-умолчанию используется строковый id блока.
@ -325,6 +320,17 @@
Для генерации лута следует использовать функцию `block_loot(block_id: int)` в модуле `base:util`. Для генерации лута следует использовать функцию `block_loot(block_id: int)` в модуле `base:util`.
## Другое
### Имя скрипта - *script-name*
Позволяет указать название скрипта блока. Свойство обеспечивает возможность использования одного скрипта для нескольких блоков.
Название указывается без `пак:scripts/` и расширения.
### Интервал тактов - *tick-interval*
Интервал в тактах мира (1/20 секуды). Значение 20 приводит к интервалу вызова on_block_tick равному одной секунде.
## Методы ## Методы
Методы используются для управлением перезаписью свойств при расширении блока другими паками. Методы используются для управлением перезаписью свойств при расширении блока другими паками.

View File

@ -48,7 +48,7 @@ function on_random_update(x, y, z)
function on_blocks_tick(tps: int) function on_blocks_tick(tps: int)
``` ```
Вызывается tps (20) раз в секунду. Используйте 1/tps вместо `time.delta()`. Вызывается tps (20 / tick-interval) раз в секунду. Используйте 1/tps вместо `time.delta()`.
```lua ```lua
function on_block_tick(x, y, z, tps: number) function on_block_tick(x, y, z, tps: number)