Personalización

Casi todo está en un único archivo corto. El resto del Lua también queda abierto, así que puedes cambiar el propio comportamiento si lo necesitas.

Qué archivo decide qué

Archivo o carpeta	Qué decide	¿Abierto?
`config.lua`	Framework, idioma, tecla y comando del menú, la lista de aves	Abierto
`locales/*.lua`	Los textos de las notificaciones, un archivo por idioma	Abierto
`client/utils.lua`	Cómo se muestra una notificación, según el framework	Abierto
`client/client.lua`	La tecla del menú, el comando `/parrot` y lo que hace cada botón del menú	Abierto
`client/bird_management.lua`	Cómo llega el ave volando, se posa, se mueve, sigue y se marcha	Abierto
`server/server.lua`	Registra cada ave como ítem usable y mantiene sincronizados a los demás jugadores	Abierto
`html/`	El menú Bird Companion: `index.html`, `style.css`, `script.js`, y sus iconos en `html/img/`	Archivos normales
`stream/`	Los nueve modelos de aves personalizados	Recursos gráficos
`flight.meta`	Los datos de ped de las nueve aves personalizadas	Datos
`inventory_images/`	Los catorce iconos de los ítems	Recursos gráficos
`readme.md`	Líneas de ítems ya preparadas para ox_inventory, QBCore y ESX	Referencia

locales/main.lua es el único archivo Lua protegido (escrow).

Ajustes generales — `config.lua`

Opción	Qué hace	Por defecto
`Config.Framework`	`esx`, `qb-core` o `qbox`. Decide cómo se registran los ítems y cómo se muestran las notificaciones	`esx`
`Config.Locale`	Idioma de las notificaciones: `en`, `es`, `de`, `fr`, `it`, `pl`, `pt`, `ru`, `tr`	`en`
`Config.MenuKey`	Índice del control del juego que abre el menú. `303` es U	`303`
`Config.OpenMenuCommand`	Comando de chat que abre el menú	`parrot`
`Config.NoActiveBirdNotification`	Muestra un mensaje cuando alguien intenta abrir el menú sin tener un ave fuera	`false`

Config.MenuKey es un número de control de FiveM, no una letra. La lista de números está en la página de referencia de controles de FiveM. Como se lee directamente, los jugadores no pueden reasignarlo en sus propios ajustes; el comando siempre está ahí como alternativa.

Las aves — `Config.BirdItems`

Una lista de nombre de ítem → modelo de ped. Cada entrada se convierte en un ítem usable al arrancar.

Ítem	Modelo
`crow`	`a_c_crow`
`pigeon`	`a_c_pigeon`
`seagull`	`a_c_seagull`
`cormorant`	`a_c_cormorant`
`chickenhawk`	`a_c_chickenhawk`
`macaw`	`Macaw`
`parrot`	`Parrot`
`falcon`	`Falcon`
`vulture`	`Vulture`
`eagle`	`Eagle`
`owl`	`Owl`
`hornbill`	`Hornbill`
`sparrow`	`Sparrow`
`warbler`	`Warbler`

Añadir un ave

Añade una línea a Config.BirdItems con el nombre de tu nuevo ítem y el modelo de ped que debe generar.
Añade el ítem a tu inventario igual que los demás (consulta Instalación) y dale un icono.
Un ave del juego base (cualquier modelo de ave a_c_…) no necesita nada más.
Un ave personalizada necesita sus archivos de modelo en stream/ y su propia entrada en flight.meta, junto a las nueve que ya hay. Sin la entrada en flight.meta, el modelo carga pero no se comporta como un ave.
refresh y luego restart mic_parrots.

Quitar un ave

Borra su línea de Config.BirdItems. El ítem deja de hacer nada; quítalo también de tu inventario para que nadie se quede con un ítem inútil.

El menú — `html/`

Las etiquetas del menú (Bird Companion, Shoulder, Head, Dismiss, Follow, Close) están escritas en html/index.html, no en los archivos de locales. Tradúcelas o cámbialas ahí. Los colores y la disposición están en html/style.css, y los iconos de los botones son los PNG de html/img/.

html/index.html también contiene dos botones comentados, Dance y Sing. No tienen ninguna acción detrás en el Lua, así que déjalos comentados.

Esc o el botón Close cierran el menú.

Idiomas

Vienen nueve, un archivo cada uno en locales/: en, es, de, fr, it, pl, pt, ru, tr. Elige uno con Config.Locale.

Cada archivo tiene seis líneas: sin permiso, ya tienes un ave, no hay ningún ave en tu hombro, el ave ya está en tu hombro, el ave ya está en tu cabeza, y necesitas un ave activa para abrir el menú.

Para añadir un idioma: copia locales/en.lua a un archivo nuevo (por ejemplo locales/nl.lua), cambia la clave de idioma de arriba de en a nl, traduce los seis textos y añade el nuevo archivo a las dos listas, client_scripts y server_scripts, en fxmanifest.lua. Después pon Config.Locale en nl, haz refresh y reinicia.

Notificaciones

client/utils.lua envía todas las notificaciones: ESX.ShowNotification en ESX, QBCore.Functions.Notify en QBCore, el export de notificaciones de QBox en QBox y el feed normal de GTA para cualquier otro caso. Sustituye el cuerpo de esa única función para enviar los mensajes a tu propio recurso de notificaciones.

Comandos

Comando o tecla	Qué hace	Se define en
`/parrot`	Abre el menú Bird Companion cuando tienes un ave fuera	`Config.OpenMenuCommand`
U	Lo mismo que el comando	`Config.MenuKey`