Instalación

Cinco minutos. No tiene archivo SQL propio ni un segundo recurso: lo único que añades fuera de la carpeta son los ítems de las aves en tu inventario.

Antes de empezar

Necesitas	Por qué
ESX, QBCore o QBox, en marcha	Las aves son ítems usables, registrados a través de tu framework
Acceso a la lista de ítems de tu inventario	Ahí tienen que existir catorce ítems
Acceso a la carpeta de imágenes de tu inventario	Para que los ítems tengan iconos

1. Coloca la carpeta

Copia mic_parrots en tus recursos, por ejemplo dentro de resources/[mic]/. Mantén el nombre de la carpeta tal cual; el menú se comunica con el recurso por su propio nombre.

Las nueve aves personalizadas están en la carpeta stream/ y sus datos de vuelo son flight.meta. Ambos se cargan solos desde el manifest; no tienes que moverlos a ningún sitio.

2. Inícialo después de tu framework

En server.cfg, pon ensure mic_parrots por debajo de tu framework (es_extended, qb-core o qbx_core) y por debajo de tu inventario.

Ha funcionado si el servidor inicia mic_parrots sin líneas rojas debajo.

3. Indícale qué framework usas

Abre config.lua y pon Config.Framework en uno de estos valores:

Valor	Para
`esx`	ESX (es el valor por defecto)
`qb-core`	QBCore
`qbox`	QBox

No hay detección automática: este valor decide cómo se registran los ítems y cómo se muestran las notificaciones.

4. La base de datos

No hay nada que importar para el recurso en sí. En ESX con el inventario por defecto, los ítems viven en la tabla items, así que los añades ahí (siguiente paso).

5. Añade los ítems

Cada nombre de ítem llama a un ave. Los nombres de los ítems son la parte izquierda de Config.BirdItems en config.lua.

Ítem	Ave	Modelo
`crow`	Cuervo	juego base
`pigeon`	Paloma	juego base
`seagull`	Gaviota	juego base
`cormorant`	Cormorán	juego base
`chickenhawk`	Halcón colirrojo	juego base
`macaw`	Guacamayo	personalizado, en streaming
`parrot`	Loro	personalizado, en streaming
`falcon`	Halcón	personalizado, en streaming
`vulture`	Buitre	personalizado, en streaming
`eagle`	Águila	personalizado, en streaming
`owl`	Búho	personalizado, en streaming
`hornbill`	Cálao	personalizado, en streaming
`sparrow`	Gorrión	personalizado, en streaming
`warbler`	Curruca	personalizado, en streaming

Dónde están las definiciones ya preparadas: el archivo readme.md dentro del recurso tiene tres bloques, uno por inventario:

ox_inventory: el bloque marcado para ox_inventory/data/items.lua. Pégalo en ese archivo.
QBCore: el bloque marcado para qb-core/shared/items.lua. Pégalo en ese archivo.
ESX: el bloque marcado como “ITEMS FOR ESX SQL”. Ejecútalo una vez contra tu base de datos.

Imágenes: los catorce iconos están en la carpeta inventory_images/, con el nombre del ítem (crow.png, eagle.png…). Cópialos en la carpeta de imágenes de tu inventario: para ox_inventory es ox_inventory/web/images/, para qb-inventory qb-inventory/html/images/.

Ha funcionado si puedes darte parrot y aparece en tu inventario con su imagen.

6. Primera prueba

Date un ave y úsala desde el inventario.

Ha funcionado si tu personaje silba y un ave llega volando desde detrás y se posa en tu hombro derecho. Pulsa U (o escribe /parrot) y se abre el menú Bird Companion con Shoulder, Head, Dismiss y Follow. Dismiss la despide y te deja libre para llamar a otra.

Antes de abrir tu ciudad

Config.Framework coincide con tu servidor. Un valor incorrecto es la causa más habitual de que no pase nada.
Existen los catorce ítems, incluido sparrow, y cada uno tiene su icono.
Config.Locale es el idioma que quieres para las notificaciones.
La U está libre. Si otro script usa la U, cambia Config.MenuKey; consulta Personalización.