Velocity Carbon Discord

Мост для интеграции чат-каналов Carbon с платформой Discord.

Для работы этого плагина необходимо установить Carbon на прокси-сервере. Если вы используете Carbon на бэкенд-серверах, воспользуйтесь совместимостью с DiscordSRV.

Основные возможности

• Гибкая настройка конфигурации
• Отправка сообщений через вебхуки или бота
• Отображение количества игроков в статусе бота
• Упоминание пользователей Discord из игры
• Ответ на внутриигровые сообщения из Discord
• Поддержка отдельных сопоставлений чат-каналов (например, отдельный канал для глобального чата и для чата администраторов)
• Настраиваемое отображение аватаров Minecraft
• Отображение вложений Discord в игре
• Статусные сообщения при запуске и остановке сервера, а также при подключении, отключении или переходе игрока между серверами
• Форматирование общих точек пути Xaero's Minimap в Discord

Установка

1. Создайте приложение бота Discord
2. Включите опции SERVER MEMBERS INTENT и MESSAGE CONTENT INTENT в разделе Privileged Gateway Intents
3. Перейдите на вкладку OAuth2 и скопируйте CLIENT ID
4. Создайте пригласительную ссылку для вашего нового бота
5. Включите разрешения: View Channels, Send Messages и Read Message History
6. Вставьте скопированный CLIENT ID в соответствующее поле
7. Перейдите по сгенерированной ссылке, чтобы добавить бота на ваш Discord-сервер
8. На вкладке Bot скопируйте токен бота (возможно, потребуется нажать Reset Token)
9. Установите плагин на сервер, запустите сервер для генерации конфигурации и остановите его
10. Откройте файлы конфигурации плагина по пути plugins/velocitycarbondiscord/config.yaml
11. Замените TOKEN на скопированный ранее токен бота
12. Настройте сопоставление каналов, указав идентификаторы каналов Carbon и Discord
13. Установите дополнительные параметры конфигурации по желанию
14. Запустите сервер

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

Конфигурация по умолчанию, генерируемая при запуске:

discord:
   token: 'TOKEN'
   # Доступные заполнители: <username>
   messages:
      # Дополнительные заполнители: <displayname> <message>
      chat_message: '<username>: <message>'
      # Дополнительные заполнители: <server>
      join_message: '<username> joined <server>'
      leave_message: '<username> left <server>'
      # Дополнительные заполнители: Н/Д
      disconnect_message: '<username> was disconnected'
      # Дополнительные заполнители: <server>
      disconnect_server_message: '<username> was disconnected from <server>'
      # Дополнительные заполнители: <previous_server> <server>
      server_switch_message: '<username> moved from <previous_server> to <server>'
      # Доступные заполнители: Н/Д
      shutdown_message: 'Proxy shutting down'
      start_message: 'Ready for connections'
      # Дополнительные заполнители: <displayname> <title> <description>
      advancement_defaultmessage: "<username> has just earned the achievement [<title>]** (<description>)_"
      advancement_challengemessage: "<username> has completed the challenge [<title>]** (<description>)_"
      advancement_goalmessage: "<username> has reached the goal [<title>]** (<description>)_"
      advancement_taskmessage: "<username> has made the advancement [<title>]** (<description>)_"
      # Дополнительные заполнители: <displayname> <message>
      death_message: "<message>"
   webhook:
      # Доступные заполнители: <displayname> <username> <uuid>
      avatar_url: 'https://crafatar.com/renders/head/&lt;uuid&gt;?overlay'
      username: '<username>'
      # Доступные заполнители: <message>
      message: '<message>'
   show_bot_messages: false
   show_attachments_ingame: true
   show_activity: true
   # Доступные заполнители: <amount>
   activity_text: 'with <amount> players online'
   enable_mentions: true
   enable_everyone_and_here: false
   prefer_webhook: true
# Доступные заполнители: <message> <nickname> <role_color> <username>
minecraft:
   # Дополнительные заполнители: <attachments> <discord_format> <reply_format> <username_format>
   format: '<discord_format> <reply_format><username_format> <dark_gray>» <reset><message><attachments>'
   discord_format: '<dark_gray>(<color:#7289da>discord<dark_gray>)<reset>'
   username_format: '<color:<role_color>><hover:show_text:<username>><nickname></hover><reset>'
   mention_format: '<color:<role_color>><underlined>@<nickname></underlined></color>'
   # Дополнительные заполнители: <reply_message> <reply_nickname> <reply_role_color> <reply_url> <reply_username>
   reply_format: '<dark_gray><click:open_url:<reply_url>>[<color:#4abdff>←<color:<reply_role_color>><hover:show_text:<reply_username>><reply_nickname></hover><dark_gray>]</click><reset> '
   # Дополнительные заполнители: <attachment_url>
   attachment_format: '<dark_gray><click:open_url:<attachment_url>>[<color:#4abdff>Attachment<dark_gray>]</click><reset>'
channels:
   -   name: 'carbon:global'
       enabled: true
       broadcast_events: true
       discord:
          webhook:
             url: 'WEBHOOK_URL'
          channel_id: 'CHANNEL_ID'
   -   name: 'carbon:staff'
       enabled: true
       minecraft:
          format: '<discord_format> <gray>✦</gray> <username_format> <dark_gray>» <aqua><message><attachments>'
       discord:
          webhook:
             url: 'WEBHOOK_URL'
          channel_id: 'CHANNEL_ID'

Благодарности

• fooooooooooooooo: Создание Velocity Discord, который вдохновил многие функции и эту документацию
• Draycia: Создатель Carbon, а также оказал значительную помощь в решении вопросов реализации