6.3 KiB
Свойства предметов
Вид
Тип иконки - icon-type и сама иконка - icon
В последней версии движка существуют следующие типы иконок предметов, определяющих то, как предмет будет отображаться в инвентаре:
none- невидимый тип, используется только дляcore:empty(пустой предмет). Не влияет на появление предмета на панель доступа к контенту. Тип может быть удалён в будущемsprite- 2D изображение. Требуется указание свойства icon, состоящее из имени атласа и имени текстуры в этом атласе, разделённые:. Пример:blocks:notfound. На данный момент в движке существует два текстурных атласа:- blocks (генерируется из png файлов в
res/textures/blocks/) - items (генерируется из png файлов в
res/textures/items/)
- blocks (генерируется из png файлов в
block- отображает предпросмотр блока. В icon указывается строковый id блока который нужно отображать. Примерbase:wood
Модель предмета - model-name
Имя модели предмета. Модель будет загружена автоматически.
Значение по умолчанию - packid:itemname.model.
Если модель не указана, будет сгенерирована автоматически
Имя и Описание
caption - имя предмета в инвентаре
description - описание предмета в инвентаре
Можно использовать md
см. Text Styles
Поведение
Устанавливаемый блок - placing-block
При указании строкового id блока предмет устанавливает его при нажатии ПКМ. Именно это свойство используется у всех сгенерированных для блоков предметов.
Пример: предмет ставит блоки базальта:
"placing-block": "base:bazalt"
Излучение - emission
Влияет на свет излучаемый предметом, когда он находится в руке игрока.
Массив из трех целых чисел - R, G, B освещения от 0 до 15.
Примеры:
[15, 15, 15]- самый яркий белый свет[7, 0, 0]- слабый красный свет[0, 0, 0]- предмет не излучает свет (по умолчанию)
Размер стопки (стека) - stack-size
Определяет максимальное количество предмета в одном слоте. Значение по умолчанию - 64.
Число использований (прочность) - uses
Свойство, используемое через inventory.use.
Статус свойства отображается в интерфейсе инвентаря. Способ отображения определяется через uses-display.
Отображение использований - uses-display
none- отображение отключеноnumber- числоrelation- отношение текущего значения к изначальному (x/y)vbar- вертикальная шкала (используется по умолчанию)
Имя скрипта - script-name
Определяет имя скрипта, содержащего обработчики событий предмета. По умолчанию соответствует строковому id (имени) предмета. Свойство обеспечивает возможность использования одного скрипта для нескольких предметов.
Пользовательские свойства
Доступ к пользовательским свойствам предметов осуществляется через таблицу item.properties[id]["свойство"], где id — числовой индекс предмета.
Пользовательские свойства должны быть объявлены в файле пак:config/user-props.toml:
"пак:имя_свойства" = {}
Пример использования в Lua - base_survival:tool
local tool = item.properties[itemid]["base_survival:tool"]
if tool then
local stone_material = tool.materials['base:stone']
if stone_material then
print(tool.type, stone_material.speed)
end
end
Описание в JSON предмета:
{
"base_survival:tool": {
"type": "breaker",
"materials": {
"base:stone": {
"speed": 15.0
}
}
}
}
Пользовательские свойства следуют тем же правилам наследования и переопределения, что и свойства блоков.
Теги - tags
Теги позволяют обозначать обобщённые свойства предметов. Названия следует формировать как префикс:имя_тега.
Префикс не является обязательным, но позволяет избегать нежелательных логических коллизий. Пример:
{
"tags": [
"core:fuel",
"base_survival:poison",
]
}
Теги предметам можно добавлять и из других паков, с помощью файла ваш_пак:tags.toml. Пример
"префикс:имя_тега" = [
"рандомный_пак:предмет",
"ещё_один_пак:какой_то_блок",
]
"другой_префикс:другое_имя_тега" = [
# ...
]