> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/plugins-and-integrations/convai-unity-sdk/features/multi-character-sessions.md). # Multi-character sessions Find guides for running several Convai characters in one Unity scene, choosing who the player talks to, and testing the shared room. A multi-character session is a Unity scene where two or more `ConvaiCharacter` components are active at once, sharing one room with Convai. The player addresses one character at a time, and the SDK works out which — no mode to switch on, no component to add, and no field to fill. Use these pages to add a second character to a working scene, understand how the room decides who is being addressed, and identify each character correctly once more than one shares the room.


How multi-character sessions work Understand how the room forms around the active characters in a scene, and how it decides who the player is addressing.	How multi-character sessions work
Build your first multi-character session Add a second character to a working scene and confirm the room addresses whichever one the player looks at.	Build your first multi-character session
Character identity Give every character in a room its own Character ID, and understand what happens when two characters share one.	Character identity
Multi-Character Sample Import the shipped sample scene and see several characters, interaction targeting, and a transcript UI working together.	Multi-Character Sample

### Two questions a multi-character scene raises Adding a second character to a scene raises two questions that a single-character scene never asks: who is the player talking to, and can the player talk right now. Each has its own feature area.


Conversation targeting How the SDK decides which character the player is addressing, and how to script or tune that decision.	Conversation targeting
Conversation availability Whether the addressed character can hear the player yet, and how to gate your own UI on that state.	Conversation availability

### Next steps Start with [Build your first multi-character session](/api-docs/plugins-and-integrations/convai-unity-sdk/features/multi-character-sessions/quick-start.md) to add a second character to a scene and confirm the room reaches it, then read [Character identity](/api-docs/plugins-and-integrations/convai-unity-sdk/features/multi-character-sessions/character-identity.md) before assigning Character IDs to more than one character. {% content-ref url="/pages/iYCwUGyNwOPIaSoxu1mq" %} [How multi-character sessions work](/api-docs/plugins-and-integrations/convai-unity-sdk/features/multi-character-sessions/how-multi-character-sessions-work.md) {% endcontent-ref %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.convai.com/api-docs/plugins-and-integrations/convai-unity-sdk/features/multi-character-sessions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.