diff --git a/doc/en/block-properties.md b/doc/en/block-properties.md index 676dfa44..60f87722 100644 --- a/doc/en/block-properties.md +++ b/doc/en/block-properties.md @@ -143,6 +143,8 @@ Block is not a physical obstacle if **false** An array of 6 numbers describing an offset an size of a block hitbox. +The numbers are specified in the range [0.0, 1.0] - i.e. within the block (in the case of an extended block, the hitbox can be larger than one, but must not go beyond the "size" property). + Array *\[0.25, 0.0, 0.5, 0.75, 0.4, 0.3\]* describes hitbox width: - offset 0.25m east - offset 0.0m up @@ -151,6 +153,15 @@ Array *\[0.25, 0.0, 0.5, 0.75, 0.4, 0.3\]* describes hitbox width: - 0.4m height - 0.3m length (from south to north) +For composite hitboxes, the *hitboxes* property is used - an array of hitboxes, for example: + +```json +"hitboxes": [ + [0, 0, 0, 1, 0.625, 1], + [0, 0.6875, 0, 1, 0.3125, 1] +] +``` + ### *grounded* Is block may only be set on a solid block and destructs on below block destruction. diff --git a/doc/ru/block-properties.md b/doc/ru/block-properties.md index 1fabcd5c..601a0dba 100644 --- a/doc/ru/block-properties.md +++ b/doc/ru/block-properties.md @@ -152,7 +152,7 @@ Массив из 6 чисел описывающих смещение и размер хитбокса блока. -Числа указываются в диапазоне [0.0, 1.0] - т.е в пределах блока. +Числа указываются в диапазоне [0.0, 1.0] - т.е в пределах блока (в случае расширенного блока хитбокс может быть больше единицы, но не должен выходить за пределы size). Массив `[0.25, 0.0, 0.5, 0.75, 0.4, 0.3]` описывает хитбокс: - смещен на 0.25 м на запад @@ -162,6 +162,15 @@ - высотой 0.4 м - длиной (с юга на север) 0.3 м +Для составных хитбоксов используется свойство *hitboxes* - массив хитбоксов, например: + +```json +"hitboxes": [ + [0, 0, 0, 1, 0.625, 1], + [0, 0.6875, 0, 1, 0.3125, 1] +] +``` + ### Приземленность - *grounded* Блок может быть установлен только на полный блок.