Установка

Пять минут. У ресурса нет собственного SQL-файла и нет второго ресурса: единственное, что вы добавляете вне папки, — это предметы-птицы в ваш инвентарь.

Прежде чем начать

Что нужно	Зачем
ESX, QBCore или QBox, запущенный	Птицы — это используемые предметы, регистрируемые через ваш фреймворк
Доступ к списку предметов вашего инвентаря	Четырнадцать предметов должны существовать там
Доступ к папке изображений вашего инвентаря	Чтобы у предметов были иконки

1. Положите папку на место

Поместите mic_parrots в ваши ресурсы, например в resources/[mic]/. Оставьте название папки как есть; меню обращается к ресурсу по его собственному имени.

Девять собственных птиц лежат в папке stream/, а их данные полёта — в flight.meta. Оба загружаются сами из манифеста; никуда перемещать их не нужно.

2. Запустите его после вашего фреймворка

В server.cfg поставьте ensure mic_parrots ниже вашего фреймворка (es_extended, qb-core или qbx_core) и ниже вашего инвентаря.

Всё сработало, если сервер запускает mic_parrots без красных строк под ним.

3. Укажите, какой у вас фреймворк

Откройте config.lua и установите Config.Framework в одно из значений:

Значение	Для
`esx`	ESX (значение по умолчанию)
`qb-core`	QBCore
`qbox`	QBox

Автоопределения нет: это значение решает, как регистрируются предметы и как показываются уведомления.

4. База данных

Для самого ресурса импортировать ничего не нужно. На ESX со стандартным инвентарём предметы живут в таблице items, поэтому добавьте их туда (следующий шаг).

5. Добавьте предметы

Каждое название предмета вызывает одну птицу. Названия предметов — это левая часть Config.BirdItems в config.lua.

Предмет	Птица	Модель
`crow`	Crow	базовая игра
`pigeon`	Pigeon	базовая игра
`seagull`	Seagull	базовая игра
`cormorant`	Cormorant	базовая игра
`chickenhawk`	Chicken Hawk	базовая игра
`macaw`	Macaw	собственная, стримится
`parrot`	Parrot	собственная, стримится
`falcon`	Falcon	собственная, стримится
`vulture`	Vulture	собственная, стримится
`eagle`	Eagle	собственная, стримится
`owl`	Owl	собственная, стримится
`hornbill`	Hornbill	собственная, стримится
`sparrow`	Sparrow	собственная, стримится
`warbler`	Warbler	собственная, стримится

Где лежат готовые определения: в файле readme.md внутри ресурса есть три блока — по одному на каждый инвентарь:

ox_inventory — блок, помеченный для ox_inventory/data/items.lua. Вставьте его в этот файл.
QBCore — блок, помеченный для qb-core/shared/items.lua. Вставьте его в этот файл.
ESX — блок, помеченный «ITEMS FOR ESX SQL». Выполните его один раз в вашей базе данных.

Изображения: все четырнадцать иконок лежат в папке inventory_images/ и названы по предмету (crow.png, eagle.png…). Скопируйте их в папку изображений вашего инвентаря — для ox_inventory это ox_inventory/web/images/, для qb-inventory — qb-inventory/html/images/.

Всё сработало, если вы можете выдать себе parrot, и он появляется в вашем инвентаре со своей картинкой.

6. Первый тест

Выдайте себе птицу и используйте её из инвентаря.

Всё сработало, если ваш персонаж свистит, а птица подлетает сзади и садится на ваше правое плечо. Нажмите U (или введите /parrot) — откроется меню Bird Companion с кнопками Shoulder, Head, Dismiss и Follow. Dismiss отправляет птицу прочь и освобождает вас, чтобы вы могли вызвать другую.

Прежде чем открывать ваш город

Config.Framework соответствует вашему серверу. Неверное значение — самая частая причина того, что ничего не происходит.
Все четырнадцать предметов существуют, включая sparrow, и у каждого есть своя иконка.
Config.Locale — это язык, который вы хотите для уведомлений.
U свободна. Если другой скрипт использует U, измените Config.MenuKey — см. Настройку.