> For the complete documentation index, see [llms.txt](https://docs.quickclient.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quickclient.cc/ui/messages.md).

# Сообщения

Чат, консоль скриптов, уведомления и буфер обмена.

Эта страница о том, как сообщить что-то игроку или вывести отладочную информацию: через чат, консоль скриптов, всплывающие уведомления и буфер обмена.

## Chat

Через `chat()` можно написать в свой чат или отправить сообщение на сервер. Если нужно просто вывести строку без подписи скрипта, есть короткий `chat(String)`.

```java
chat().print("здоровье: " + player().health());
chat().print("Аукцион", Text.of("лот продан").color(0xFF57D977));
chat().sendToServer("/spawn");
```

| Метод                    | Описание                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `print(message)`         | сообщение с именем скрипта; `Text` печатается со всем оформлением, остальное через `toString`                                   |
| `print(prefix, message)` | то же, но со своей подписью                                                                                                     |
| `sendToServer(message)`  | в чат сервера, а если строка начинается с `/`, то как команда; уходит через очередь Quick, поэтому открытый сундук не закроется |

Всё, что выводит `print`, видит только сам игрок. Чтобы узнать, что пришло в чат, нужно подписаться на событие `ChatEvent`, см. [Подписка на события](/events/basics.md).

## Log

`log()` пишет в консоль скриптов. Она открывается кнопкой в шапке меню на вкладке Скрипты. Туда же Quick пишет, как скрипт загрузился, включился и какие в нём возникли ошибки. Эту консоль читает и ИИ-агент через `console_read`.

| Метод                   | Описание                                              |
| ----------------------- | ----------------------------------------------------- |
| `info(message)`         | обычная строка                                        |
| `warn(message)`         | предупреждение                                        |
| `error(message)`        | ошибка                                                |
| `error(message, cause)` | ошибка с причиной; полный стектрейс будет в логе игры |

У каждой строки указаны имя скрипта и время. Окно консоли можно закрепить булавкой, тогда оно не закроется вместе с меню.

## Notifications

| Метод                      | Описание            |
| -------------------------- | ------------------- |
| `info(message, millis)`    | обычное уведомление |
| `success(message, millis)` | зелёное             |
| `warning(message, millis)` | жёлтое              |
| `error(message, millis)`   | красное             |

`millis` задаёт, сколько миллисекунд уведомление остаётся на экране.

## Clipboard

`clipboard().read()` возвращает текст из буфера обмена, а если там пусто, пустую строку. `clipboard().write(text)` кладёт текст в буфер. Каждое чтение записывается в консоль, так что всегда видно, какой скрипт обращался к буферу.


---

# 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.quickclient.cc/ui/messages.md?ask=<question>&goal=<endgoal>
```

`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.