Просмотр кода страницы Создание и установка ресурсных пакетов (resource packs)

= Создание и установка поведенческих пакетов (behavior packs) =

== 1. Подготовка ==

* Убедитесь, что Bedrock сервер установлен.
* Имейте базовое понимание JSON и структуры дополнений Minecraft.
* Подготовьте инструменты для создания пакетов (текстовый редактор).
* Рекомендуется использовать Ubuntu 24.04 LTS.

== 2. Что такое Behavior Packs ==

=== Определение ===

Behavior Packs (BP) - это пакеты, которые изменяют поведение игры:
* Добавляют новые сущности
* Изменяют поведение существующих мобов
* Добавляют новые механики
* Изменяют правила игры

=== Структура Behavior Pack ===

1. Базовая структура:
<pre>behavior_pack_name/
├── manifest.json
├── pack_icon.png
└── [другие файлы]</pre>

== 3. Создание базового Behavior Pack ==

=== Создание структуры директорий ===

1. Создайте директорию для пакета:
<pre>mkdir -p ~/my_behavior_pack
cd ~/my_behavior_pack</pre>

2. Создайте базовую структуру:
<pre>mkdir -p entities
mkdir -p items
mkdir -p loot_tables
mkdir -p recipes
mkdir -p scripts</pre>

=== Создание manifest.json ===

1. Создайте файл manifest.json:
<pre>nano manifest.json</pre>

2. Добавьте базовую конфигурацию:
<pre>{
  "format_version": 2,
  "header": {
    "description": "Мой кастомный Behavior Pack",
    "name": "My Custom Behavior Pack",
    "uuid": "12345678-1234-1234-1234-123456789abc",
    "version": [1, 0, 0],
    "min_engine_version": [1, 20, 0]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "87654321-4321-4321-4321-cba987654321",
      "version": [1, 0, 0]
    }
  ]
}</pre>

3. Генерация UUID:
<pre>\# Используйте онлайн генератор UUID или:
python3 -c "import uuid; print(uuid.uuid4())"</pre>

=== Создание иконки пакета ===

1. Создайте изображение 64x64 пикселей
2. Сохраните как `pack_icon.png` в корне пакета

== 4. Примеры Behavior Packs ==

=== Пример 1: Изменение поведения зомби ===

1. Создайте файл сущности:
<pre>mkdir -p entities
nano entities/zombie.json</pre>

2. Добавьте содержимое:
<pre>{
  "format_version": "1.20.0",
  "minecraft:entity": {
    "description": {
      "identifier": "minecraft:zombie",
      "is_spawnable": true,
      "is_summonable": true,
      "is_experimental": false
    },
    "component_groups": {
      "custom_behavior": {
        "minecraft:behavior.random_stroll": {
          "priority": 7,
          "speed_multiplier": 2.0
        }
      }
    },
    "components": {
      "minecraft:type": {
        "value": "npc"
      },
      "minecraft:collision_box": {
        "width": 0.6,
        "height": 1.9
      }
    },
    "events": {
      "minecraft:entity_spawned": {
        "add": {
          "component_groups": ["custom_behavior"]
        }
      }
    }
  }
}</pre>

=== Пример 2: Добавление нового предмета ===

1. Создайте файл предмета:
<pre>mkdir -p items
nano items/custom_item.json</pre>

2. Добавьте содержимое:
<pre>{
  "format_version": "1.20.0",
  "minecraft:item": {
    "description": {
      "identifier": "my_pack:custom_item",
      "category": "items"
    },
    "components": {
      "minecraft:icon": {
        "texture": "custom_item"
      },
      "minecraft:display_name": {
        "value": "Кастомный предмет"
      },
      "minecraft:max_stack_size": 64
    }
  }
}</pre>

== 5. Установка Behavior Pack на сервер ==

=== Ручная установка ===

1. Скопируйте пакет на сервер:
<pre>sudo cp -r ~/my_behavior_pack /opt/bedrock/behavior_packs/my_behavior_pack</pre>

2. Установите права:
<pre>sudo chown -R bedrock:bedrock /opt/bedrock/behavior_packs/my_behavior_pack
sudo chmod -R 755 /opt/bedrock/behavior_packs/my_behavior_pack</pre>

3. Проверьте UUID пакета:
<pre>cat /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json | grep uuid</pre>

=== Активация в мире ===

1. Найдите UUID пакета:
<pre>grep -A 2 '"header"' /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json</pre>

2. Отредактируйте world_behavior_packs.json:
<pre>nano /opt/bedrock/worlds/ваш_мир/world_behavior_packs.json</pre>

3. Добавьте пакет:
<pre>[
  {
    "pack_id": "12345678-1234-1234-1234-123456789abc",
    "version": [1, 0, 0]
  }
]</pre>

4. Перезапустите сервер:
<pre>sudo systemctl restart minecraft-bedrock</pre>

== 6. Создание .mcpack файла ==

=== Упаковка пакета ===

1. Создайте архив:
<pre>cd ~/my_behavior_pack
zip -r my_behavior_pack.mcpack .</pre>

2. Проверьте содержимое:
<pre>unzip -l my_behavior_pack.mcpack</pre>

=== Установка .mcpack ===

1. Используйте скрипт установки:
<pre>sudo /usr/local/bin/bedrock-addon-install.sh my_behavior_pack.mcpack</pre>

2. Или установите вручную:
<pre>unzip my_behavior_pack.mcpack -d /opt/bedrock/behavior_packs/my_behavior_pack</pre>

== 7. Проверка установки ===

=== Валидация manifest.json ===

1. Проверьте JSON синтаксис:
<pre>python3 -m json.tool /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json</pre>

2. Проверьте структуру:
<pre>ls -la /opt/bedrock/behavior_packs/my_behavior_pack/</pre>

=== Проверка в игре ===

1. Подключитесь к серверу
2. Проверьте, что пакет активен
3. Проверьте изменения в поведении

== 8. Отладка Behavior Packs ==

=== Просмотр ошибок ===

1. Проверьте логи сервера:
<pre>tail -f /opt/bedrock/logs/latest.log | grep -i "error\|behavior\|pack"</pre>

2. Проверьте content-log:
<pre>tail -f /opt/bedrock/logs/content-log-*.log</pre>

=== Типичные ошибки ===

1. '''Неправильный UUID''':
* Убедитесь, что UUID уникален
* Проверьте формат UUID

2. '''Неправильный format_version''':
* Проверьте версию формата в manifest.json
* Используйте совместимую версию

3. '''Отсутствующие файлы''':
* Проверьте все ссылки в manifest.json
* Убедитесь, что все файлы на месте

== 9. Примеры использования ===

=== Создание кастомного моба ===

1. Структура для нового моба:
<pre>entities/
└── custom_mob.json
</pre>

2. Базовый пример нового моба:
<pre>{
  "format_version": "1.20.0",
  "minecraft:entity": {
    "description": {
      "identifier": "my_pack:custom_mob",
      "is_spawnable": true,
      "is_summonable": true
    },
    "components": {
      "minecraft:type": {
        "value": "animal"
      },
      "minecraft:collision_box": {
        "width": 0.8,
        "height": 1.8
      },
      "minecraft:health": {
        "value": 20,
        "max": 20
      }
    }
  }
}</pre>

== 10. Устранение неполадок ===

=== Пакет не загружается ===

1. Проверьте manifest.json:
<pre>python3 -m json.tool manifest.json</pre>

2. Проверьте UUID в world_behavior_packs.json
3. Проверьте версию формата

=== Конфликты пакетов ===

1. Отключите все пакеты
2. Включайте по одному
3. Определите конфликтующий пакет

== Заключение ==

Создание и установка поведенческих пакетов (behavior packs) позволяет значительно расширить возможности Bedrock сервера. Правильная структура manifest.json и корректные UUID обеспечивают успешную установку и работу пакетов.

'''Для размещения ваших Bedrock серверов с кастомными пакетами на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''

* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных Bedrock серверов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних серверов

Наши специалисты помогут с установкой и настройкой поведенческих пакетов на Bedrock серверах!