AMCDB

AMCDB (Another Minecraft-Discord Bridge)

AI-Free Software

AMCDB с гордостью создан человеческими руками — как труд любви к искусству программирования и традиции заглядывать в потроха программы собственными глазами.

Ни одна строка кода в этом моде не была создана LLM или инструментами «ИИ».

Обзор

AMCDB — это мод для Fabric/Quilt, который подключает ваш Minecraft-сервер к серверу Discord. Вы можете связать игровой чат с каналом Discord, настроить канал для консоли сервера и даже выполнять серверные команды откуда угодно!

Вот как это выглядит в Minecraft...

...а вот как это выглядит в Discord!

Если вы предпочитаете, чтобы сообщения из игры в Discord выглядели как сообщения от игроков (и отображали их головы как аватары!), AMCDB также поддерживает вебхуки Discord:

Ключевые возможности

• AMCDB *быстрый* и *дружелюбный к лагам*. Он выполняет почти всю работу вне главного потока сервера, так что на производительность игры это не влияет.
• AMCDB *гибкий. Вы можете настроить всё так, как хотите — изменить внешний вид сообщений в игре и в Discord, поместить самую полезную для *вас информацию в темы каналов, даже задать боту Discord хитрый статус!
• AMCDB *стабильный* и *совместимый*. Он не использует миксины для изменения кода Minecraft, поэтому редко ломается между версиями Minecraft и хорошо работает почти с любым другим модом для Fabric.

• И наконец, AMCDB — это *весело*. Он поддерживает всевозможные крутые функции Discord, такие как:

  • стили шрифта...
    
  • ...цвета имён...
    
  • ...и даже текст-спойлер, который можно раскрыть наведением!
    

Установка

Выполните эти шаги, чтобы настроить AMCDB на своём сервере.

Примечание: вам нужно быть администратором сервера Discord, к которому вы хотите подключиться.

Установите AMCDB на свой Minecraft-сервер

Вам нужен сервер Fabric или Quilt. Когда он будет настроен, убедитесь, что Fabric API лежит в папке mods — это единственная зависимость AMCDB.

Затем скачайте последний файл AMCDB .jar со страницы GitHub Releases или с Modrinth. Он будет называться примерно так: amcdb-1.1.5.jar. Положите его в папку mods.

Далее запустите сервер. Он упадёт — просто потому, что вы ещё не настроили AMCDB. После первого запуска сервера в папке config должен появиться файл amcdb.properties. Откройте его в текстовом редакторе и держите под рукой для следующего шага.

Настройте бота Discord

Если вы раньше использовали другой мод для связи Minecraft и Discord, у вас, возможно, уже есть бот. Его можно переиспользовать, если у него есть нужные права на вашем сервере — просто вставьте токен в файл amcdb.properties.

Если у вас нет бота Discord:

1. Войдите на https://discord.com/developers/applications/.
2. Нажмите New Application в правом верхнем углу.
3. Дайте боту имя и нажмите Create.
   
4. В левой части экрана нажмите Bot.
   
5. Теперь вы сгенерируете токен, который AMCDB будет использовать для подключения. В основной части страницы найдите Token в разделе Bot и нажмите Reset Token. После подтверждения и ввода кода 2FA (если требуется) появится случайная строка символов, как на картинке ниже — это и есть ваш токен! Нажмите Copy.
   

6. В файле amcdb.properties, который вы открыли ранее, найдите строку, начинающуюся с amcdb.discord.bot.token=, и вставьте токен бота в конец этой строки. Это будет выглядеть так:

   amcdb.discord.bot.token=MTUxNjYyMDU5MTU2ODkxNjUyMQ.GtHHYH.cwfUiwbSCguEt8vA4KtdUdPlD-kexM_V98cSwE

7. Прокрутите вниз до раздела Privileged Gateway Intents и включите Message Content Intent. Именно это позволяет боту читать сообщения на вашем сервере Discord, чтобы он мог отправлять их в чат вашей игры Minecraft.
   
8. Вернувшись в левую часть экрана, перейдите к OAuth2.
   

9. В разделе OAuth2 URL Generator в блоке Scopes отметьте галочкой пункт bot. Появится ещё одно поле с названием Bot Permissions. Здесь выберите следующие разрешения:

   • Manage Channels
   • View Channels
   • Send Messages

10. Затем прокрутите вниз до раздела Generated URL и скопируйте URL из поля. Он должен выглядеть так:

    https://discord.com/oauth2/authorize?client_id=1516620591568916521&permissions=3088&integration_type=0&scope=bot

11. Вставьте скопированный URL в новую вкладку браузера, выберите сервер, нажмите Continue, затем Authorize. Вы должны увидеть, что бот присоединился к вашему серверу Discord!

Настройка канала чата

У AMCDB есть много настроек, которые вы можете изменить, но помимо токена бота есть только одна, необходимая для начала работы — нужно указать AMCDB ID канала, который вы хотите использовать для игрового чата. Вероятно, стоит создать для этого новый текстовый канал, так как все сообщения в этом канале будут появляться в Minecraft и наоборот.

Чтобы получить ID канала, включите режим разработчика в приложении Discord. Откройте меню настроек, затем Advanced слева. После этого включите Developer Mode.

Когда режим разработчика включён, вы можете нажать правой кнопкой мыши на нужный канал и выбрать Copy ID. Вставьте этот ID в amcdb.properties сразу после amcdb.discord.chat.channel=. Это будет выглядеть так:

amcdb.discord.chat.channel=1046313040837832782

Если вы хотите настроить канал для консоли сервера, скопируйте его ID и вставьте после amcdb.discord.console.channel=. Канал консоли поддерживает выполнение команд, которые вы отправляете через Discord; эта функция по умолчанию отключена в целях безопасности, но вы можете включить её, изменив настройку amcdb.discord.channels.console.enableExecution= на true.

Затем сохраните файл amcdb.properties и снова запустите свой сервер Minecraft. Если вы всё сделали правильно, всё, что вы напишете в игровом чате, должно появиться в канале Discord, а всё, что вы напишете в канале Discord, должно появиться в игре!

Не стесняйтесь изучить остальную часть файла amcdb.properties, ведь именно там находятся все настройки конфигурации AMCDB. Если вы что-то измените, вам нужно будет остановить и запустить свой сервер Minecraft, чтобы новые настройки вступили в силу.

Настройка режима webhook

Если вы хотите отображать головы игроков Minecraft в качестве аватарок Discord, вам нужно включить режим webhook. Это необязательно -- AMCDB будет работать нормально, даже если вы не настроите webhook.

Чтобы настроить webhook, выполните следующие шаги:

1. Откройте страницу настроек вашего сервера Discord.
2. Слева выберите Integrations (в категории "Apps").
3. Нажмите на "Webhooks", затем на "New Webhook".
4. Нажмите на ваш новый webhook, измените его имя на Minecraft (или как вам нравится), и установите канал, который вы хотите использовать для чата Minecraft.
5. Нажмите "Copy Webhook URL".
6. Вставьте URL в amcdb.properties рядом с amcdb.discord.channels.chat.webhookUrl=. Не забудьте раскомментировать эту строку, убрав # в начале.
7. Как всегда, сохраните файл amcdb.properties и перезапустите сервер. Вы должны начать видеть сообщения из игры в Discord с именами игроков и аватарками!

Обновление

Как правило, обновить AMCDB можно просто заменив .jar файл на новую версию.

При обновлении стоит проверить, не добавились ли новые свойства в amcdb.properties; последнюю версию конфигурации по умолчанию можно найти здесь. Иногда добавляются новые обязательные свойства; это приведёт к тому, что ваш сервер не запустится после обновления .jar, пока вы не добавите новые свойства в свою конфигурацию.

Вы также можете обновить файл свойств, заставив AMCDB сгенерировать новый:

1. Остановите свой сервер Minecraft
2. Переименуйте amcdb.properties во временное имя, например amcdb.properties.old
3. Обновите .jar файл и запустите сервер. AMCDB сгенерирует новый шаблон amcdb.properties, и сервер остановится так же, как при новой установке.

4. Скопируйте свои настройки из amcdb.properties.old в новый amcdb.properties.

   • Вы также можете просто скопировать недостающие свойства в amcdb.properties.old и затем переименовать его обратно в amcdb.properties.
5. Запустите свой сервер Minecraft.