From 7044c12da59607db7e6fcc63502c64dff3ebad84 Mon Sep 17 00:00:00 2001 From: MihailRis Date: Sun, 29 Dec 2024 09:22:35 +0300 Subject: [PATCH] update doc/*/block-properties.md --- doc/en/block-properties.md | 28 ++++++++++++++++++++++++++++ doc/ru/block-properties.md | 28 ++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+) diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md index 8011e9cc..f5478e0b 100644 --- a/doc/en/block-properties.md +++ b/doc/en/block-properties.md @@ -214,6 +214,34 @@ User properties must be declared in `pack:config/user-props.toml` file: Example: [user properties of pack **base**](../../res/content/base/config/user-props.toml). +## Properties introduced by the `base` pack + +### *base:durability* + +The time it takes to break a block without tools or effects, measured in seconds. + +### Loot - *base:loot* + +A list of tables with properties: + +```json +{ + "item": "pack:item", + "min": 1, + "max": 3, + "chance": 0.5 +} +``` + +- `count` defaults to 1. It does not need to be specified if `min` and `max` are provided. +- `min`, `max` - the minimum and maximum quantity of the item. +- `chance` - the probability of the item dropping. Defaults to 1.0. + +It should be noted that the `item` refers specifically to the item. That is, to specify the item of a block, you need to add `.item` after the block name. +Example: `base:dirt.item`. + +To generate loot, the function `block_loot(block_id: int)` in the `base:util` module should be used. + ## Methods Methods are used to manage the overwriting of properties when extending a block with other packs. diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md index 71d7cea3..3b75759e 100644 --- a/doc/ru/block-properties.md +++ b/doc/ru/block-properties.md @@ -225,6 +225,34 @@ Пример: [пользовательские свойства пака **base**](../../res/content/base/config/user-props.toml). +## Свойства, вводимые паком `base` + +### Прочность - *base:durability* + +Время разрушения блока без инструментов и эффектов в секундах. + +### Лут - *base:loot* + +Список таблиц со свойствами: + +```json +{ + "item": "пак:предмет", + "min": 1, + "max": 3, + "chance": 0.5 +} +``` + +- count равен 1 по-умолчанию. Не нужно указывать если указаны `min` и `max`. +- min, max - минимальное и максимальное количество предмета. +- chance - вероятность выпадения предмета. По-умолчанию: 1.0. + +Следует учитывать, что в item указывается именно предмет. Т.е. чтобы указать предмет блока, нужно добавить `.item` после имени блока. +Пример: `base:dirt.item`. + +Для генерации лута следует использовать функцию `block_loot(block_id: int)` в модуле `base:util`. + ## Методы Методы используются для управлением перезаписью свойств при расширении блока другими паками.