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

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

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

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

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

Определение

Behavior Packs (BP) - это пакеты, которые изменяют поведение игры:

• Добавляют новые сущности
• Изменяют поведение существующих мобов
• Добавляют новые механики
• Изменяют правила игры

Структура Behavior Pack

1. Базовая структура:

behavior_pack_name/
├── manifest.json
├── pack_icon.png
└── [другие файлы]

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

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

1. Создайте директорию для пакета:

mkdir -p ~/my_behavior_pack
cd ~/my_behavior_pack

2. Создайте базовую структуру:

mkdir -p entities
mkdir -p items
mkdir -p loot_tables
mkdir -p recipes
mkdir -p scripts

Создание manifest.json

1. Создайте файл manifest.json:

nano manifest.json

2. Добавьте базовую конфигурацию:

{
  "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]
    }
  ]
}

3. Генерация UUID:

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

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

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

4. Примеры Behavior Packs

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

1. Создайте файл сущности:

mkdir -p entities
nano entities/zombie.json

2. Добавьте содержимое:

{
  "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"]
        }
      }
    }
  }
}

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

1. Создайте файл предмета:

mkdir -p items
nano items/custom_item.json

2. Добавьте содержимое:

{
  "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
    }
  }
}

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

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

1. Скопируйте пакет на сервер:

sudo cp -r ~/my_behavior_pack /opt/bedrock/behavior_packs/my_behavior_pack

2. Установите права:

sudo chown -R bedrock:bedrock /opt/bedrock/behavior_packs/my_behavior_pack
sudo chmod -R 755 /opt/bedrock/behavior_packs/my_behavior_pack

3. Проверьте UUID пакета:

cat /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json | grep uuid

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

1. Найдите UUID пакета:

grep -A 2 '"header"' /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json

2. Отредактируйте world_behavior_packs.json:

nano /opt/bedrock/worlds/ваш_мир/world_behavior_packs.json

3. Добавьте пакет:

[
  {
    "pack_id": "12345678-1234-1234-1234-123456789abc",
    "version": [1, 0, 0]
  }
]

4. Перезапустите сервер:

sudo systemctl restart minecraft-bedrock

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

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

1. Создайте архив:

cd ~/my_behavior_pack
zip -r my_behavior_pack.mcpack .

2. Проверьте содержимое:

unzip -l my_behavior_pack.mcpack

Установка .mcpack

1. Используйте скрипт установки:

sudo /usr/local/bin/bedrock-addon-install.sh my_behavior_pack.mcpack

2. Или установите вручную:

unzip my_behavior_pack.mcpack -d /opt/bedrock/behavior_packs/my_behavior_pack

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

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

1. Проверьте JSON синтаксис:

python3 -m json.tool /opt/bedrock/behavior_packs/my_behavior_pack/manifest.json

2. Проверьте структуру:

ls -la /opt/bedrock/behavior_packs/my_behavior_pack/

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

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

8. Отладка Behavior Packs

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

1. Проверьте логи сервера:

tail -f /opt/bedrock/logs/latest.log | grep -i "error\|behavior\|pack"

2. Проверьте content-log:

tail -f /opt/bedrock/logs/content-log-*.log

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

1. Неправильный UUID:

• Убедитесь, что UUID уникален
• Проверьте формат UUID

2. Неправильный format_version:

• Проверьте версию формата в manifest.json
• Используйте совместимую версию

3. Отсутствующие файлы:

• Проверьте все ссылки в manifest.json
• Убедитесь, что все файлы на месте

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

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

1. Структура для нового моба:

entities/
└── custom_mob.json

2. Базовый пример нового моба:

{
  "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
      }
    }
  }
}

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

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

1. Проверьте manifest.json:

python3 -m json.tool manifest.json

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 серверах!