# Using plugins

> Install, enable and configure a plugin inside a chat.

Source: https://reverie.im/en/docs/plugins/using-plugins
Language: en

Plugins are installed per chat, from the **Plugins** tab of the chat side panel. You need to be signed in — the tab shows a sign-in prompt otherwise.

## Install a plugin \[#install-a-plugin]

### Open the Plugins tab \[#open-the-plugins-tab]

In a chat, open the side panel and pick **Plugins**. Switch between **My**, **Official** and **Community**. The **Community** tab has a search box that matches plugin names and descriptions.

### Read the cost estimate \[#read-the-cost-estimate]

Every card carries an estimate of what the plugin adds to each message, in credits, calculated for the model the chat is currently using. Switching models changes the estimate, and the install dialog repeats it in full.

### Install \[#install]

Press **Install**. If the plugin has settings, the **Install Plugin** dialog opens first: fill the fields and save. Plugins with settings also offer **AI Generate**, which fills those fields from a description you type.

### Enable it for this chat \[#enable-it-for-this-chat]

An installed plugin's card carries a switch. On means the plugin runs in this chat; off means it stays installed but does nothing. Reopen the settings any time with **Configure Plugin**, and remove it with **Uninstall**.

Enabled interactive plugins appear in a plugin menu beside the message box. That menu is only there when at least one interactive plugin is on.

You can set plugins up before you send the first message in a new chat. They take effect as soon as the conversation starts.

## The order badge and the five-prompt limit \[#the-order-badge-and-the-five-prompt-limit]

Each enabled plugin shows a \**#1*\*, \**#2*\*, **#3**… badge. That number is its position in this chat, assigned in the order you installed things, and it decides which prompt plugins are applied.

> **At most five prompt plugins are applied to a chat.** Enable six and the
> first five in that order run; the rest are skipped in silence — they look
> enabled on their cards, they show a cost estimate, and they contribute
> nothing to the reply. Tool and interactive plugins do not count towards the
> five. Switching a prompt plugin off frees its slot for the next one in
> order, so turn off the ones you don't need rather than wondering which five
> won.

There is no ceiling on tool or interactive plugins, but each tool plugin adds its description to every request, so the cost estimate on the card rises with each one.

## Model support \[#model-support]

Tool plugins only work on models that support tool calling. On a model that doesn't, the card is disabled and reads **Current model does not support tool plugins**. Prompt and interactive plugins work on every model. [Choosing a model →](https://reverie.im/en/docs/reference/choosing-a-model)

## AI-generated panels \[#ai-generated-panels]

Some interactive plugins open a panel that the character fills in on the spot, such as a diary entry or a status board. Generating a page spends credits, and the panel asks you to confirm that the first time.

Every page it generates is kept with the chat. Reopening the panel, on any device, shows the last page without generating it again, and the panel's **History** button lists the earlier pages of that plugin in this chat; opening one costs nothing. New pages are written with the earlier ones in view, so a diary continues instead of starting over, and a message sent from a page lets the character see what you were reading when it replies. The character also keeps the latest page of each panel in mind while chatting, so what a diary or a status board established stays consistent. The panel's header also lets you write pages with your chat model instead of the fast default, and in a group chat pick whose page it is; a page may offer a text field so you can reply in your own words.

A forked chat keeps the pages made before the fork point. Deleting messages removes the pages generated after them, and once a plugin's history grows long its oldest pages are dropped. You can also delete a page yourself from the History panel; the character stops taking it into account as well.

## Versions and updates \[#versions-and-updates]

An installed plugin card shows the version you are running, like **v3**. When the author publishes a newer version, an update control naming that version appears on the card, and nothing changes until you press it. Your chat keeps running the exact version you installed, including its wording in your language.

## Character defaults \[#character-defaults]

A character's creator can ship tool and interactive plugins with the character. Those arrive already installed when you open a chat with them, and you can switch them off like any other plugin. If you install the same plugin yourself, your own settings win.

Creators can only attach a version that has been through review, so a visitor never runs an unreviewed draft.

Nothing else arrives preinstalled. A new chat runs no plugins until you install one or the character's creator attached one.

## Image generation \[#image-generation]

Image generation in chat is switched on by installing the official image generation plugin. Its install dialog asks you to confirm that generating images spends credits; the install doesn't complete until you do. [Image generation →](https://reverie.im/en/docs/media/image-generation)

## Plugins you created \[#plugins-you-created]

The **My** tab also holds **Edit**, **Debug** and **Delete** for plugins you wrote, plus **View Earnings**. Deleting a plugin you created is permanent and is confirmed first.

## Related \[#related]

* [Plugins overview](https://reverie.im/en/docs/plugins) — the three kinds and what each can do
* [Creating plugins](https://reverie.im/en/docs/plugins/creating-plugins) — write and publish your own
* [Side panel](https://reverie.im/en/docs/chatting/side-panel) — the other tabs in the same panel
* [Credits](https://reverie.im/en/docs/billing/credits) — how per-message cost is calculated