Saros Report System [26.3] [26.2] [1.21.10] [1.20.6]

Главные особенности

• Игровые тикеты одной простой командой: /ticket <категория> <причина...>

• Поддержка категорий из нескольких слов (например, «Запрос к администрации», «Жалоба на игрока»)

• Умное автодополнение (Tab), предлагающее только созданные вами категории

• Интеграция с Discord через Webhook с использованием красивых Embed-сообщений:

  • Настраиваемый цвет Embed-сообщения (HEX)

  • Отображение головы/аватара игрока в сообщении

  • Чистый и читаемый вид на основе вашего шаблона

• Полностью серверная конфигурация (common config) — установка мода на клиент не требуется

• Настраиваемые сообщения для игроков (успех/помощь/ошибки) с поддержкой плейсхолдеров

Команды тикетов

• /ticket <категория> <причина...>

  • Работает с категориями из нескольких слов

  • Ввод просто /ticket выводит настраиваемое сообщение с помощью и инструкцией

• Discord Embeds

  • Тикет отправляется в Discord-канал через Webhook

  • Настраиваемый цвет (HEX, например #5865F2)

  • Голова Minecraft-персонажа игрока используется как аватар и иконка (thumbnail)

  • Все плейсхолдеры из вашего шаблона успешно сохраняются

• Только серверная конфигурация

  • Всё настраивается через общий конфиг сервера (зависимость от клиента отсутствует)

  • Все игроки видят одинаковые сообщения независимо от языка их клиента

• Удобный UX для администраторов

  • Автодополнение по клавише Tab показывает только категории из вашего конфига

  • Несуществующие категории или отсутствие причины возвращают понятные настраиваемые ошибки

Основная команда

• Базовая команда: /ticket

• Использование: /ticket <категория> <причина...>

• Примеры:

  • /ticket Баг Пчелы улетают из загона

  • /ticket Запрос к администрации Пожалуйста, проверьте мой приват

  • /ticket Жалоба на игрока Steve загриферил мою базу на спавне

• Примечания:

  • Категории из нескольких слов распознаются корректно; весь оставшийся текст становится причиной

  • Подсказки показывают только настроенные категории

Конфигурация

Все параметры находятся в файле config/sarosdiscordwebhook-common.toml. Основные настройки:

Основные (Core)

• tickets.enabled — включить/выключить систему

• tickets.categories — список категорий (строки). Поддерживает названия из нескольких слов

• tickets.discordWebhookUrl — ссылка на ваш Discord Webhook

• tickets.commandPermissionLevel — необходимый ванильный уровень прав (0–4; 0 = доступно всем)

• tickets.messageTemplate — текст, используемый в качестве описания Embed-сообщения

• tickets.embedColorHex — цвет Embed-сообщения (например, #5865F2)

Расширенные (Advanced)

• tickets.inputTimeoutSeconds — таймаут сессии для будущих многошаговых сценариев

• tickets.hideReasonInChat — для будущего перехвата сообщений из чата (не используется при стандартной однострочной команде)

Сообщения (Messages)

(Все настраиваются на стороне сервера; поддерживают плейсхолдеры там, где это указано)

• tickets.messages.successSubmitted — выводится при успешной отправке.

  Плейсхолдеры: {category}, {reason}

• tickets.messages.errorInvalidCategory — указана неверная категория

• tickets.messages.errorMissingReason — не указана причина

• tickets.messages.errorWebhookNotConfigured — Webhook не настроен

• tickets.messages.errorOnlyPlayers — попытка вызова из консоли или не-игроком

• tickets.messages.usageHelp — выводится при вводе команды без аргументов /ticket.

  Плейсхолдеры: {categories} (список через запятую)

• tickets.messages.errorNoCategories — если список категорий пуст

• tickets.messages.errorSendFailed — ошибка отправки в Discord

Плейсхолдеры, доступные в tickets.messageTemplate (используются внутри Discord Embed): {player}, {uuid}, {category}, {reason}, {dimension}, {x}, {y}, {z}

FAQ и советы

• Ничего не отправляется в Discord

  • Убедитесь, что параметр tickets.discordWebhookUrl задан и содержит корректную ссылку

  • Проверьте, что установлено значение tickets.enabled = true

• Игроки не могут использовать /ticket

  • Понизьте значение tickets.commandPermissionLevel (значение 0 позволяет использовать команду всем)

• Я хочу изменить внешний вид Embed-сообщения

  • Настройте параметры tickets.messageTemplate и tickets.embedColorHex

• В названиях моих категорий есть пробелы

  • Это поддерживается! Команда сопоставляет ввод с самой длинной подходящей категорией из конфига в начале строки