> For the complete documentation index, see [llms.txt](https://mic-scripts.gitbook.io/mic/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mic-scripts.gitbook.io/mic/documentation/parrots-as-pets.md).

# Parrots As Pets

{% hint style="info" %}
💬 **Need help?** Support, updates and changelogs are on the [**Mic Scripts Discord**](https://discord.gg/86FPzAV73B). Open a ticket with your Tebex transaction ID and the console error.
{% endhint %}

<a href="https://discord.gg/86FPzAV73B" class="button primary">💬 Join the Discord</a> <a href="https://mic.tebex.io/" class="button secondary">🛒 Get it on Tebex</a>

{% embed url="<https://www.youtube.com/watch?v=LFVGtAOqCps>" %}

## What it is

**mic\_parrots** turns birds into inventory items. A player uses the item, whistles, and a bird flies in from behind them and lands on their right shoulder. From there a small menu moves it to their head, lets it follow them through the air, or sends it away.

Fourteen birds ship with it: five that are already in GTA and nine custom models that stream with the resource. Every other player sees the same bird in the same place, and nothing is written to your database.

***

### Key features

* **Fourteen birds** 🐦\
  Crow, pigeon, seagull, cormorant and chicken hawk from the base game, plus custom macaw, parrot, falcon, vulture, eagle, owl, hornbill, sparrow and warbler models.
* **A real arrival** 🛬\
  The bird appears fifteen metres behind the player, flies to them, plays its landing and settles on the shoulder.
* **A menu with four choices** 🎛️\
  Shoulder, Head, Follow and Dismiss. Moving between spots makes the bird take off, circle the player twice and land again.
* **Follow mode** 🪽\
  The bird leaves the shoulder and flies a few metres behind the player, keeping up as they move.
* **Seen by everyone** 👀\
  The bird is a networked entity. Other players see it land, move and leave, and it goes away with its owner when they disconnect.
* **The item is not used up** ♻️\
  Using a bird item calls the bird; the item stays in the inventory. One bird per player at a time.
* **Open key and command** ⌨️\
  **U** or `/parrot` opens the menu. Both are set in `config.lua`.
* **Nine languages** 🗣️\
  English, Spanish, German, French, Italian, Polish, Portuguese, Russian and Turkish.
* **Open source Lua** 🔓\
  The config, the locales, the client and the server files are all left open to edit.

***

### What you need

| You need                                | Why                                                                                            |
| --------------------------------------- | ---------------------------------------------------------------------------------------------- |
| **ESX**, **QBCore** or **QBox**         | Registers the bird items as usable and shows the notifications. Chosen with `Config.Framework` |
| An inventory that supports usable items | The ready-made item lines ship for ESX, QBCore and ox\_inventory                               |

No database tables, no target resource, no other dependency. The custom bird models and their `flight.meta` ship inside the resource.

***

### Where to go next

| Page                                                                        | What is in it                                                   |
| --------------------------------------------------------------------------- | --------------------------------------------------------------- |
| [🪛 Installation](/mic/documentation/parrots-as-pets/installation.md)       | Folder, start order, the fourteen items and the first test      |
| [🎨 Customization](/mic/documentation/parrots-as-pets/customization.md)     | Which file decides what, every option, languages, adding a bird |
| [🩺 Troubleshooting](/mic/documentation/parrots-as-pets/troubleshooting.md) | The problems buyers actually hit, and the fix for each          |