Аддон - это набор файлов, который изменяет Minecraft Bedrock Edition. Он может добавить новые предметы, блоки, мобов, рецепты и звуки или изменить то, что уже есть в игре. Саму игру трогать не нужно: Minecraft читает твои файлы и загружает их поверх обычной игры.
И самое приятное: аддоны состоят из простых текстовых файлов и картинок. Если ты умеешь редактировать текстовый файл и нарисовать картинку 16x16, ты сможешь сделать аддон.
Два вида пакетов
Большинство аддонов состоят из двух пакетов, которые работают в команде.
Пакет поведения (BP)
Пакет поведения отвечает за то, как всё работает. Он работает на "серверной" стороне игры, то есть задаёт правила:
- сколько урона наносит меч
- сколько голода восстанавливает еда
- что делает моб, когда видит игрока
- какие предметы нужны для рецепта крафта
- что выпадает, когда ломаешь блок
Пакет поведения - это в основном JSON-файлы, а ещё файлы .mcfunction для команд и JavaScript-файлы для скриптов.
Пакет ресурсов (RP)
Пакет ресурсов отвечает за то, как всё выглядит и звучит. Он работает на "клиентской" стороне, на устройстве каждого игрока:
- текстуры (картинки на предметах, блоках и мобах)
- 3D-модели и анимации
- звуки и музыка
- названия, которые ты видишь в игре, на всех языках
- частицы и некоторые меню
Зачем два пакета?
Когда внешний вид и правила разделены, пакеты получаются гибкими. Набор текстур - это просто пакет ресурсов без пакета поведения. Пакет, который меняет только поведение мобов, может состоять из одного пакета поведения. А когда ты добавляешь что-то совсем новое, например свой меч, обычно нужны оба: BP говорит, что предмет существует и как он работает, а RP даёт ему текстуру и название.
Вот маленький пример. Этот файл в пакете поведения создаёт новый предмет:
{
"format_version": "1.26.30",
"minecraft:item": {
"description": {
"identifier": "demo:ruby",
"menu_category": {
"category": "items"
}
},
"components": {
"minecraft:icon": {
"textures": {
"default": "ruby"
}
},
"minecraft:max_stack_size": 64
}
}
}Имя иконки "ruby" указывает на картинку, зарегистрированную в пакете ресурсов. Без пакета ресурсов предмет всё равно будет существовать, но останется без текстуры. Ты соберёшь этот предмет шаг за шагом в гайде Твой первый предмет.
Что можно изменить?
Аддоны умеют очень многое. Вот главное, что ты изучишь на этой вики:
| Что | Пакет | Гайд |
|---|---|---|
| Предметы, еда, инструменты, броня | BP + RP | Свой предмет |
| Блоки | BP + RP | Свой блок |
| Мобы и существа | BP + RP | Свой моб |
| Рецепты крафта и печи | BP | Рецепты |
| Текстуры | RP | Пиксельные текстуры |
| Команды, которые запускаются сами | BP | Функции |
Всё новое собирается из компонентов. Компонент - это одна маленькая возможность, например "этот предмет можно съесть" или "этот блок светится". Ты складываешь компоненты вместе, как кубики. В справочнике компонентов предметов есть каждый из них с примерами.
Аддоны - это не моды для Java
Аддоны для Bedrock и моды для Java Edition - совершенно разные вещи. Моды для Java пишутся на Java и требуют загрузчиков вроде Forge или Fabric. Аддоны для Bedrock используют JSON, картинки, команды и JavaScript, и никакой дополнительный загрузчик им не нужен.
Типы файлов, которые ты встретишь
Когда ты скачиваешь аддон, обычно это один из таких файлов:
.mcpack: один пакет (один пакет поведения или один пакет ресурсов). На самом деле это файл.zipс другим расширением..mcaddon: набор из нескольких пакетов, обычно BP и его RP вместе. Это тоже переименованный.zip..mcworldи.mctemplate: целые миры и шаблоны миров, внутри которых могут быть пакеты.
Когда ты открываешь такой файл, Minecraft импортирует его автоматически. Как их делать, ты узнаешь в гайде Экспорт и игра.
Работает везде
Bedrock Edition работает на Windows, Android, iPhone и iPad, Xbox, PlayStation и Nintendo Switch. Аддоны используют одни и те же файлы на всех этих платформах. Пакет, сделанный на телефоне, заработает на компьютере друга, а сделанный на компьютере - на телефоне.
Есть несколько ограничений, о которых стоит знать:
- На консолях нельзя напрямую импортировать свои файлы. Но там всё равно можно играть с аддонами на Realm, на сервере или из Marketplace.
- Некоторые возможности помечены как экспериментальные. Они работают, только если в мире включён нужный эксперимент. Большинству предметов, блоков и мобов эксперименты больше не нужны.
Два способа сделать аддон
Вручную. Ты создаёшь папки, пишешь JSON в текстовом редакторе, рисуешь текстуры в графическом редакторе, а потом упаковываешь всё в архив. Эта вики научит тебя каждому шагу, а понимать, как устроены файлы, - очень полезный навык.
Простой способ. GodCraft - бесплатное приложение для iPhone и Android, которое делает аддоны без кода. Ты открываешь Мастерскую, добавляешь объекты вроде предметов, блоков или мобов и заполняешь простые формы. Приложение само пишет весь JSON, манифесты и UUID и экспортирует .mcaddon, который сразу открывается в Minecraft.
Можно совмещать оба способа. Многие авторы начинают в GodCraft, чтобы быстро получить рабочий пакет, а потом читают эту вики, чтобы понять, что делает каждый файл.
Что читать дальше
- Нужные инструменты: что установить или как сделать всё прямо с телефона.
- Твой первый пакет: создаём папки и манифесты.
- JSON за 5 минут: формат файлов, который используют все аддоны.
- Экспорт и игра: как добавить пакет в игру.