Документация

Быстрый старт

Начните использовать MTB за несколько минут:

Создайте аккаунт — перейдите на web.metalib.xyz/register и заполните форму.
Создайте сервер — нажмите «+» в боковой панели и выберите шаблон или создайте с нуля.
Пригласите друзей — скопируйте ссылку приглашения и поделитесь с друзьями.
Настройте каналы — создайте текстовые и голосовые каналы для разных тем.
Общайтесь! — отправьте первое сообщение или подключитесь к голосовому каналу.

Руководство: Создание аккаунта

Для использования MTB необходимо создать аккаунт:

Перейдите на web.metalib.xyz/register
Укажите адрес электронной почты, имя пользователя, отображаемое имя и пароль
Подтвердите email (если требуется)
Настройте профиль: аватар, описание, статус

Совет: Используйте надёжный пароль и включите двухфакторную аутентификацию (2FA) в настройках безопасности.

Руководство: Создание сервера

Серверы — основа MTB. Это пространства для общения с группами людей:

Нажмите «+» в боковой панели серверов
Выберите «Создать сервер»
Укажите название и загрузите иконку
Настройте каналы, категории и роли

Каждый сервер получает уникальную ссылку приглашения, которую можно настроить (время жизни, лимит использований).

Руководство: Каналы и категории

Каналы организуют общение на сервере:

Текстовые каналы (#) — для переписки, вложений, эмодзи, реакций
Голосовые каналы (🔊) — для голосовых/видео звонков в реальном времени
Категории — группируют каналы по темам (игры, общение, модерация)

Управление: правая кнопка мыши → «Настройки канала» для настройки прав доступа, описания и лимитов.

Руководство: Роли и разрешения

Роли позволяют гибко управлять правами пользователей:

@everyone — роль по умолчанию для всех участников
Кастомные роли — создавайте роли с уникальными цветами и иконками
Разрешения — настраивайте доступ к каналам, управлению сервером, модерации
Иерархия — роли выше в списке имеют приоритет

Руководство: Голосовые каналы

Голосовые каналы не требуют звонка — просто подключитесь:

Нажмите на голосовой канал для подключения
Управляйте микрофоном и наушниками через нижнюю панель
Включите видео или демонстрацию экрана
Настройте лимит участников и битрейт в настройках канала

Руководство: Личные сообщения

Общайтесь один на один или в группах:

Нажмите на имя пользователя → «Написать сообщение»
Создайте групповую беседу (до 10 участников)
Делитесь файлами, изображениями, GIF-ами

Руководство: Персонализация

Сделайте MTB своим:

Аватар: загрузите изображение профиля
Статус: установите кастомный статус с текстом и эмодзи
Описание: расскажите о себе в профиле
Тема: переключайтесь между тёмной и светлой темами
Уведомления: настройте уведомления для каждого сервера и канала

Руководство: Модерация

Инструменты для поддержания порядка:

Бан/кик: удаление нарушителей
Мут/таймаут: временное ограничение прав
Медленный режим: ограничение частоты сообщений в канале
Журнал аудита: отслеживание всех действий на сервере
Автомодерация: фильтрация спама и нежелательного контента

Руководство: Мобильные клиенты

MTB доступен в браузере на мобильных устройствах. Просто откройте web.metalib.xyz в мобильном браузере для полного доступа ко всем функциям.

API Reference: Обзор

MTB предоставляет HTTP REST API и WebSocket Gateway для программного взаимодействия с платформой.

Base URL: https://web.metalib.xyz/api/v9
Формат: JSON
Авторизация: Bearer-токен в заголовке Authorization
WebSocket: wss://web.metalib.xyz/gateway

API: Аутентификация

Аутентификация выполняется через HTTP-заголовок:

Authorization: Bearer <ваш_токен>

Получение токена:

POST/auth/login

Параметр	Тип	Описание
`login`	string	Email или имя пользователя
`password`	string	Пароль аккаунта

Ответ содержит поле token, используемое для последующих запросов.

POST/auth/register

Параметр	Тип	Описание
`email`	string	Адрес электронной почты
`username`	string	Имя пользователя
`password`	string	Пароль (мин. 8 символов)
`date_of_birth`	string	Дата рождения (YYYY-MM-DD)

API: Пользователи

GET/users/@me

Получение информации о текущем пользователе.

PATCH/users/@me

Обновление профиля текущего пользователя (аватар, описание, статус).

GET/users/{user_id}/profile

Получение публичного профиля пользователя.

API: Каналы

GET/channels/{channel_id}

Получение информации о канале.

POST/guilds/{guild_id}/channels

Создание нового канала на сервере.

Параметр	Тип	Описание
`name`	string	Название канала
`type`	integer	0 = текстовый, 2 = голосовой, 4 = категория
`topic`	string	Описание канала
`parent_id`	snowflake	ID категории

API: Сообщения

GET/channels/{channel_id}/messages

Получение сообщений канала. Поддерживает пагинацию через before, after, limit.

POST/channels/{channel_id}/messages

Отправка сообщения в канал.

Параметр	Тип	Описание
`content`	string	Текст сообщения (до 2000 символов)
`tts`	boolean	Озвучить сообщение
`nonce`	string	Идентификатор для дедупликации

DELETE/channels/{channel_id}/messages/{message_id}

Удаление сообщения.

PUT/channels/{channel_id}/messages/{message_id}/reactions/{emoji}/@me

Добавление реакции к сообщению.

API: Серверы (Guilds)

POST/guilds

Создание нового сервера.

GET/guilds/{guild_id}

Получение информации о сервере.

GET/guilds/{guild_id}/members

Список участников сервера.

GET/guilds/{guild_id}/roles

Список ролей сервера.

POST/guilds/{guild_id}/roles

Создание новой роли.

API: Голос

Голосовые соединения устанавливаются через WebSocket Gateway. Процесс:

Отправьте Voice State Update через Gateway
Получите Voice Server Update с endpoint и token
Подключитесь к голосовому серверу по WebSocket
Установите UDP-соединение для передачи аудио

API: WebSocket Gateway

Gateway обеспечивает получение событий в реальном времени:

wss://web.metalib.xyz/gateway?v=9&encoding=json

Основные события:

Событие	Описание
`READY`	Соединение установлено, получены начальные данные
`MESSAGE_CREATE`	Новое сообщение
`MESSAGE_UPDATE`	Сообщение отредактировано
`MESSAGE_DELETE`	Сообщение удалено
`GUILD_CREATE`	Присоединение к серверу
`GUILD_MEMBER_ADD`	Новый участник на сервере
`PRESENCE_UPDATE`	Изменение статуса пользователя
`TYPING_START`	Пользователь начал печатать
`VOICE_STATE_UPDATE`	Изменение голосового статуса

Heartbeat: после получения HELLO, отправляйте Heartbeat с интервалом heartbeat_interval мс:

{"op": 1, "d": null}

API: Rate Limits

API использует систему ограничения запросов. Заголовки ответа содержат:

Заголовок	Описание
`X-RateLimit-Limit`	Максимум запросов в текущем окне
`X-RateLimit-Remaining`	Оставшееся количество запросов
`X-RateLimit-Reset`	Время сброса (Unix timestamp)
`Retry-After`	Секунды до возможности повторного запроса (при 429)

При превышении лимита возвращается 429 Too Many Requests.

API: Коды ошибок

Код	Описание
`400`	Некорректный запрос — проверьте параметры
`401`	Не авторизован — невалидный или отсутствующий токен
`403`	Доступ запрещён — недостаточно прав
`404`	Не найдено — ресурс не существует
`429`	Rate limit — слишком много запросов
`500`	Внутренняя ошибка сервера
`502`	Bad Gateway — временная проблема

Документация MTB

Быстрый старт

Руководство пользователя

API Reference

WebSocket

Быстрый старт

Руководство: Создание аккаунта

Руководство: Создание сервера

Руководство: Каналы и категории

Руководство: Роли и разрешения

Руководство: Голосовые каналы

Руководство: Личные сообщения

Руководство: Персонализация

Руководство: Модерация

Руководство: Мобильные клиенты

API Reference: Обзор

API: Аутентификация

API: Пользователи

API: Каналы

API: Сообщения

API: Серверы (Guilds)

API: Голос

API: WebSocket Gateway

API: Rate Limits

API: Коды ошибок