Instalação

Cinco minutos. Não há arquivo SQL próprio nem uma segunda resource: a única coisa que você adiciona fora da pasta são os itens das aves no seu inventário.

Antes de começar

Você precisa	Por quê
ESX, QBCore ou QBox, em execução	As aves são itens utilizáveis, registrados através do seu framework
Acesso à lista de itens do seu inventário	Quatorze itens precisam existir lá
Acesso à pasta de imagens do seu inventário	Para que os itens tenham ícones

1. Coloque a pasta no lugar

Coloque mic_parrots dentro de suas resources, por exemplo em resources/[mic]/. Mantenha o nome da pasta como está; o menu se comunica com a resource pelo próprio nome dela.

As nove aves personalizadas estão na pasta stream/ e seus dados de voo estão em flight.meta. Ambos são carregados automaticamente pelo manifesto; você não precisa movê-los para lugar nenhum.

2. Inicie após o seu framework

No server.cfg, coloque ensure mic_parrots abaixo do seu framework (es_extended, qb-core ou qbx_core) e abaixo do seu inventário.

Funcionou quando o servidor inicia mic_parrots sem linhas vermelhas abaixo dele.

3. Informe qual framework você usa

Abra config.lua e defina Config.Framework para um dos seguintes valores:

Valor	Para
`esx`	ESX (este é o padrão)
`qb-core`	QBCore
`qbox`	QBox

Não há detecção automática: este valor decide como os itens são registrados e como as notificações são exibidas.

4. O banco de dados

Nada para importar para a resource em si. No ESX com o inventário padrão, os itens ficam na tabela items, então você os adiciona lá (próximo passo).

5. Adicione os itens

Cada nome de item chama uma ave. Os nomes dos itens ficam no lado esquerdo de Config.BirdItems em config.lua.

Item	Ave	Modelo
`crow`	Corvo	jogo base
`pigeon`	Pombo	jogo base
`seagull`	Gaivota	jogo base
`cormorant`	Corvo-marinho	jogo base
`chickenhawk`	Gavião	jogo base
`macaw`	Arara	personalizado, transmitido
`parrot`	Papagaio	personalizado, transmitido
`falcon`	Falcão	personalizado, transmitido
`vulture`	Abutre	personalizado, transmitido
`eagle`	Águia	personalizado, transmitido
`owl`	Coruja	personalizado, transmitido
`hornbill`	Calau	personalizado, transmitido
`sparrow`	Pardal	personalizado, transmitido
`warbler`	Toutinegra	personalizado, transmitido

Onde estão as definições prontas: o arquivo readme.md dentro da resource possui três blocos, um para cada inventário:

ox_inventory — o bloco marcado para ox_inventory/data/items.lua. Cole-o nesse arquivo.
QBCore — o bloco marcado para qb-core/shared/items.lua. Cole-o nesse arquivo.
ESX — o bloco marcado como “ITEMS FOR ESX SQL”. Execute-o uma vez no seu banco de dados.

Imagens: todos os quatorze ícones estão na pasta inventory_images/, nomeados de acordo com o item (crow.png, eagle.png…). Copie-os para a pasta de imagens do seu inventário — para o ox_inventory é ox_inventory/web/images/, para o qb-inventory é qb-inventory/html/images/.

Funcionou quando você consegue dar parrot para si mesmo e ele aparece no seu inventário com a imagem correspondente.

6. Primeiro teste

Dê uma ave para si mesmo e use-a pelo inventário.

Funcionou quando seu personagem assobia, uma ave vem voando por trás e pousa no seu ombro direito. Pressione U (ou digite /parrot) e o menu Bird Companion se abrirá com Shoulder, Head, Dismiss e Follow. Dismiss manda a ave embora e libera você para chamar outra.

Antes de abrir sua cidade

Config.Framework corresponde ao seu servidor. Um valor incorreto é o motivo mais comum para nada acontecer.
Todos os quatorze itens existem, incluindo sparrow, e cada um tem o seu ícone.
Config.Locale está definido com o idioma que você deseja para as notificações.
A tecla U está livre. Se outro script usar o U, altere Config.MenuKey — veja Personalização.