> For the complete documentation index, see [llms.txt](https://docs.playtheatria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.playtheatria.com/theatria/gameplay-features/messaging.md).

# Messaging

Theatria provides a few ways to communicate with other players.

## Global chat

* By default you'll chat in this channel, which broadcasts to all online players. If you ever leave the Global channel, you can return by typing `/ch join Global`.

## Local chat

* You can switch to the Local channel with `/ch join Local`. This broadcasts to the players in your immediate vicinity. Also try turning on our [Buddy Bonus](https://github.com/JL-III/Theatria/blob/master/docs/gameplay-features/economy/buddy-bonus.md) feature for extra Denarii while you're near others.

## Private chat

`/msg <PlayerName>`: begin a private message session with an online player. End the session by typing `/msg` `/msg <PlayerName> <your message here>`: send a single message to an online player. `/r <your message here>`: send a reply to the most recent private message you received.

## Server email

`/mail`: view all commands for server email. `/mail send <PlayerName> <your message here>`: send an in-game mail message to another player. They will be alerted to the message the next time they login. `/mail read`: begin reading your server email.


---

# 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:

```
GET https://docs.playtheatria.com/theatria/gameplay-features/messaging.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
