@qspkp @NoHaijeSo1o @shonestew

Script API(то, что используется для создания скриптов);
JavaScript(язык программирования, на котором пишутся скрипты);
bedrock.dev(документация к аддонам),
wiki.bedrock.dev(некий учебник и документация к аддонам, также там есть туториалы по скриптам).

Доброго дня, в этой публикации будет расказываться об структуре аддонов, как они устроены и т.д. Погнали!

Аддоны внутренне устроены следующим образом - в директории(папка) аддона есть две другие директории - это ресурспак, там лежат текстуры предметов, мобов, настройки интерфейса и т.п., и набор параметров - там лежит файлы, которые обьявляют новый предмет, мобов и т.п. а также описывают им свойства(к примеру, у предметов это прочность, текстура и т.д.).

Каждый пак(набор параметров и ресурспаки обобщено) обьявляют главным файлом manifest.json, которые идентифицируют пак, его название, описание а также подключенные внутри него модули. К примеру, чтобы идентифицировать ресурспак, надо написать в манифест(manifest.json) следующее:

{
    "format_version": 2,
    "header": {
        "name": "Пример манифеста ресурспака",
        "description": "Ресурспак",
        "uuid": "b603f596-e272-40df-ae7c-05a1dcc610d6",
        "version": [1, 0, 0],
        "min_engine_version": [1, 20, 0]
    },
    "modules": [
        {
            "description": "Модуль для ресурспака",
            "type": "resources",
            "uuid": "4b71209a-6927-4e29-b297-f8e551cb8ea2",
            "version": [1, 0, 0]
        }
    ]
}

Давайте же разберём этот код, и поймем какие опции за что отвечают:
format_version - версия формата, для скин-паков - это 1, для ресурспаков и набором параметров - 2.
header - секция заголовка аддона, куда указывается его название, описание, uuid(дальше разберем что это), версия аддона и минимальная версия клиента/сервера, при котором можно ещё установить пак. Его опции:
name - название аддона,
description - его описание,
uuid - 16-байтный идентификатор аддона, позволяет отличать паки. Сгенерировать его можно тут.
version - версия аддона, и кстати - при импорте того же аддона, но с версией, указанной выше заменяется сам аддон и его файлы на версию новее.
min_engine_version - минимальная версия клиента/сервера, при котором можно ещё установить пак.
modules - секция для подключения модулей. В неё можно подключать модули для работы клиентских скриптов, ресурспаков и наборов параметров. Строение подключенного модуля:
description - описание модуля,
type - тип подключаемого модуля, для ресурспаков - resources, для наборов параметров - data,
uuid - идентификатор модуля,
version - версия модуля.

Все эти опции являются обязательными, и без них манифест, и соответственно сам пак, не импортируется в игру. Также есть и другие, необязательные опции, которые можно тоже применять в манифесте, для дополнительной идентификации пака. Для того, чтобы сделать манифест для набора параметров, надо изменить тип подключаемого модуля на data. Подробнее читать про это здесь.

Теперь, когда мы разобрались в строении манифест, можно начать разбираться, как составлять директории в паках.
Для ресурспаков лучшее всего делать расположение директории так:

my_resource_pack/
├── textures/
│    ├── items/
│    │    ├── item1.png
│    │    ├── item2.png
│    │    └── item3.png
│    └── blocks/
│    │    ├── block1.png
│    │    ├── block2.png
│    │    └── block3.png
├── manifest.json
└── pack_icon.png

Это одна из распространенных видов структурирования директории и файлов аддона. В наборе параметров в основном всё так:

my_behavior_pack/
├── items/
│    └── item1.json
│    └── item2.json
│    └── item3.json
├── blocks/
│    └── block1.json
│    └── block2.json
│    └── block3.json
├── manifest.json
└── pack_icon.png

Такие виды структурирования паков очень распространены. Они более удобны для ориентировки по исходникам аддона, и позволяют удобнее делать обновление аддонам в будущем. Но как структурировать аддон остается во многом за вами, но один момент который является обязательным - manifest должен быть в самой главной по иерархии директорией(то есть, в примере это my_resource_pack или my_behavior_pack).

Как вы знаете, для разработки аддонов требуются некоторые приложения(если у вас смартфон) или программы(если у вас ПК/ноутбук).
В этой публикации будет 2 группы приложении/программ для разработки аддонов и 1 дополнение. Поехали!

Приложения и программы из этой группы нужны для создания структуры аддона, его внутренних файлов и папок, а также архивирование файлов аддона и его изменения расширения, для импорта в игру.

Файловый менеджер - замечательный файловый менеджер, подходит для управлениями файлов.
Cx проводник - тоже, замечательный файловый менеджер, более популярный.
RAR - для архивации файлов аддонов, но можно использовать его как файловый менеджер.
7-zip - древний архиватор на Windows, с открытым исходным кодом.

Надо же как-то редактировать файл, дабы туда записать код. Так вот, редакторы кода с этим вам помогут. Администраторы канала советуют вам несколько приложении и программ для редактирования кода, а именно:

QuickEdit - простой редактор кода, подойдет для написания мелких аддонов, прост и понятен.
Acode - более продвинутый, подойдет для написания более крупных аддонов, поддерживаем плагины и выводит подсказки.
Visual Studio Code - очень популярный редактор кода на Windows, Linux и macOS , плагинов уйма и подходит не только для написания аддонов, а и для программ, чат ботов и так далее.
Subline Text - очень легкий редактор кода на Windows, Linux и macOS, тоже подходит для написания аддонов.

JaylyBot - бот для дебаггинга кода, можно не заходя в игру проверять работоспособность кода, на сайте бота написано и показано как его использовать.