Решение проблем

Проблемы, с которыми люди действительно сталкиваются в этом ресурсе, — в том порядке, в котором они обычно возникают.

Изменение ресурса ничего не дало

restart не перечитывает fxmanifest.lua. Если вы добавили файл — новую локаль, новую модель в stream/, — сначала выполните refresh в консоли сервера, а затем restart mic_parrots. Без refresh сервер продолжает работать со списком файлов, который у него был, и нового файла там просто нет.

Использование предмета-птицы ничего не делает

По порядку:

Config.Framework не соответствует вашему серверу. Он должен быть в точности esx, qb-core или qbox. Предметы регистрируются только для названного там фреймворка.
mic_parrots запускается раньше вашего фреймворка. Переместите ensure mic_parrots ниже него в server.cfg.
Названия предмета нет в Config.BirdItems. Используемыми являются только перечисленные там названия.
На ESX со стандартным инвентарём предмета нет в таблице items. Выполните блок для ESX из readme.md в ресурсе.

Консоль показывает ошибку про `qbx-core` на QBox

Ветка QBox в server/server.lua и client/utils.lua запрашивает ресурс с названием qbx-core. Если ваше ядро называется qbx_core (с подчёркиванием), этот поиск не срабатывает. Оба файла открыты: измените там название в соответствии с вашим ресурсом или откройте тикет в Discord, и мы разберёмся вместе с вами.

«You already have a bird companion!»

Одна птица на игрока. Откройте меню и нажмите Dismiss, дождитесь, пока она улетит, а затем используйте следующий предмет.

Меню не открывается

Меню открывается, только пока у вас есть птица. Сначала используйте предмет-птицу.

Если U ничего не делает, а /parrot работает, то то же управление использует другой ресурс. Измените Config.MenuKey в config.lua на другой номер управления.

`/parrot` говорит «You don’t have permission to use this command»

Это сообщение, которое команда показывает, когда у вас нет птицы и Config.NoActiveBirdNotification равен true. Это строка no_permission в вашем файле локали; клавиша U использует вместо неё строку no_active_bird_for_menu. Сначала вызовите птицу или перепишите no_permission в locales/, если формулировка вас не устраивает.

Нет предмета `sparrow`

Воробей поставляется (модель, запись в flight.meta и inventory_images/sparrow.png), но отсутствует в трёх готовых блоках в readme.md. Добавьте его в ваш инвентарь, скопировав любую другую строку птицы и переименовав её в sparrow.

Баклан и ястреб-курятник показывают иконку камышовки на QBCore

Строки QBCore в readme.md для cormorant и chickenhawk указывают на изображение warbler.png. Измените их на cormorant.png и chickenhawk.png, оба лежат в inventory_images/.

Собственная птица невидима или падает вместо того, чтобы лететь

Девять собственных моделей берутся из stream/, а данные их педа — из flight.meta. Проверьте, что оба по-прежнему лежат в папке ресурса и что ничто другое на вашем сервере не стримит модель с тем же названием (Parrot, Eagle, Owl…). Если вы добавили собственную птицу, ей нужна своя запись в flight.meta.

Меню на английском, хотя я сменил язык

Config.Locale меняет уведомления. Кнопки меню записаны в html/index.html; переведите их там.

«Locale [xx] does not exist»

Config.Locale называет язык, для которого нет файла. Используйте одно из значений en, es, de, fr, it, pl, pt, ru, tr или добавьте своё, как описано в разделе Настройка.