Files
VoxelEngine/doc/ru/content-packs.md
T
2024-11-10 19:41:08 +03:00

50 lines
2.4 KiB
Markdown

# Контент-паки
Для создания контент-пака сначала нужно придумать ему название (id) соответствующее следующим требованиям:
- название может состоять только из букв латиницы, цифр и символа подчёркивания '\_'
- название не может начинаться с цифры
- длина названия должна находиться в пределах от 2 до 24 включительно
Далее в *res/content* создаётся папка с выбранным названием контент-пака.
В созданной папке создаётся файл **package.json** с следующим содержимым:
```json
{
"id": "выбранное_имя_пака",
"title": "имя контент-пака для отображения в меню контента",
"version": "версия контент-пака в формате major.minor",
"creator": "создатель контент-пака",
"description": "краткое описание",
"dependencies": [
"зависимости",
"пакета"
]
}
```
Вместо `creator` можно указать массив `creators`
Уровни зависимостей указываются с помощью префиксов в имени:
- '!' - обязательная зависимость
- '?' - опциональная зависимость
- '~' - слабая зависимость
Отсутствие префикса интерпретируется как '!'.
Пример: '~randutil' - слабая зависимость 'randutil'.
Пример:
```json
{
"id": "doors",
"title": "DOORS",
"creator": "MihailRis",
"version": "1.0",
"description": "doors test"
}
```
Изображение контент-пака добавляется в виде файла *icon.png* в папку пака (не в textures). Рекомендованный размер изображения: 128x128
Новые блоки добавляются в под-папку **blocks**, предметы в **items**, текстуры в **textures**
С примером файловой структуры лучше ознакомиться через базовый пакет (*res/content/base*)