Average Discord Bridge

A simple Discord bridge for Hytale servers. Allows Hytale chat to relay to Discord, and vice-versa.

223.0 загрузок

Обновлён 7 дней назад

Разное Улучшение Качества Жизни Утилиты

Описание

Средний диссонанс

Комплексный плагин Discord-Hytale для моста сервера, который легко соединяет ваш Hytale игровой сервер с Discord, позволяющий синхронизировать чат в реальном времени и получать уведомления о состоянии сервера.

Обзор

Средний диссонанс Это мощный плагин, предназначенный для серверов Hytale, который устанавливает двусторонний коммуникационный мост между вашим внутриигровым чатом и назначенным каналом Discord. Мониторинг активности сервера, получение уведомлений о присоединении / выходе игрока и предоставление участникам Discord возможности общаться с игроками на вашем сервере Hytale — все это в режиме реального времени.

Особенности

двунаправленный Мост Чат

Синхронизация в реальном времени между внутриигровым чатом и раздором
Форматированная поддержка сообщений с правильным анализом текста
Разногласия, отправленные на назначенный канал, появляются в игре
Сообщения в чате пересылаются на Discord с именами игроков

Уведомления о статусе сервера

Автоматическое уведомление о запуске сервера
Автоматическое уведомление об отключении сервера
Игрок присоединяется к уведомлениям с именами игроков
Игрок отключает уведомления с именами игроков
Улучшенные эмодзи сообщения для лучшей видимости () ) )️ )️)

Гибкий многоканальный выход

Маршрутизация различных типов сообщений по различным каналам Discord
Поддержка 6 различных типов продукции: Все, Chat, Join/Leave, Server State, Internal Log, Desc Status
Настройка нескольких каналов с различными выходными фильтрами
Организуйте свою Сервер Discord со специализированными каналами для различных событий

️️ Легкая конфигурация

Конфигурационный файл на основе JSON с многоканальной поддержкой
Функциональность горячей загрузки без перезагрузки сервера
настраиваемый Префикс Discordbot для внутриигровых сообщений
Пользовательская активность бота / сообщение состояния
Поддержка форматированных цветовых кодов в сообщениях Discord
Дополнительный активный дисплей подсчета игроков

Динамические обновления статуса

Автоматические обновления активности ботов с текущим счетом игроков каждые 10 минут
Дополнительные обновления описания канала с информацией о состоянии сервера (например, количество игроков)

️️ Административные команды

/discordridge reload - Перезагрузка конфигурации плагина на лету
Алиасы: /гм, /агм, групповой человек
Грациозная синхронизация конфигураций

установка

скачать Последний файл AverageDiscord JAR
Место В твоем Папка плагинов Hytale Server
Создание Discord-бота в Портал разработчиков Discord
конфигурировать Плагин (см. раздел Конфигурация ниже)
Перезапустить твой Hytale сервер или использование /discordridge reload

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

После первой пробежки а Discord_bridge.json Конфигурационный файл будет создан на вашем сервере Средний диссонанс папка.

Пример файла конфигурации

{
"botToken": "your_bot_token_here",
"каналы": [
{
"channelId": "1234567890",
"тип": [все]
?
{
"channelId": "2345678901",
"тип": [чат]
?
{
"channelId": "3456789012",
"тип": ["join_leave", "server_state", "desc_status"]
?
{
"channelId": "4567890123",
Тип: ["internal_log"]
?
]
«botActivityMessage»: «Playing Hytale!»,
"discordIngamePrefix": "&9[Discord]",
"showActivePlayerCount": правда
?

Варианты конфигурации

Вариант	Тип	Описание	Пример
`боттокен`	Струна	Ваш бот-токен Discord с портала разработчиков	`"token_here"`
`каналы`	массив	Конфигурация канала (см. Конфигурация канала ниже)	`[{...}]`
`botActivityMessage`	Струна	Сообщение о статусе бота в Discord	`"Играй в Хитэйл!"`
`Разработчик:IngamePrefix`	Струна	Префикс для сообщений Discord в игре (поддерживает цветовые коды)	`"&amp;9 [Разлад]"`
`Разработчик:ActivePlayerCount`	булевый	Показать активный счет игрока в статусе активности бота	`истинный`

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

Каждый объект канала в каналы массив имеет следующую структуру:

Вариант	Тип	Описание	Пример
`канал Ид`	Струна	ID канала Discord, куда будут отправляться сообщения такого типа	`"1234567890"`
`тип`	Аррея струн	Типы вывода для этого канала (см. Типы вывода ниже)	`["chat", "join_leave"]`

Типы выходных каналов

Настройте, какие типы сообщений отправляются на каждый канал:

Тип	Описание
`все`	Все сообщения, кроме внутренних журналов (чат, соединение / выход, состояние сервера)
`болтать`	Игрок чат сообщения
`скачать_leave`	Игрок присоединяется и отключает уведомления
`Server_state`	Уведомления о запуске сервера и отключении
`Internal_log`	Внутренний плагин для регистрации и отладки сообщений
`desc_status`	Обновления описания канала с информацией о состоянии сервера

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

Как получить токен Bot и Channel ID

Бот Токен:
- Пойти Портал разработчиков Discord
- Создайте новое приложение или выберите существующее
- Перейдите на вкладку «Bot»
- Нажмите «Добавить Бота» (если новый)
- Копировать токен в разделе «TOKEN»
Канал ID:
- Включить режим разработчика в Discord (User Settings → Advanced → Developer Mode)
- Нажмите правой кнопкой мыши на желаемый канал
- Выберите «Copy Channel ID»
- Вставьте его в конфигурацию

Как это работает

Маршрутизация сообщений

Плагин использует гибкую многоканальную систему для маршрутизации различных типов сообщений по различным каналам Discord. Каждый канал сконфигурирован с одним или несколькими типами вывода, которые определяют, какие сообщения он получает.

Синхронизация чата

В игре Discord: Когда игрок вводит в чат, сообщение отправляется по всем каналам, настроенным на болтать или все Типы выходных данных
Разногласия внутри игры: Когда пользователь, не являющийся ботом, отправляет сообщение в канале, настроенном на болтать или все выходных типов, появляется в игре с настраиваемым префиксом

Серверные события

Плагин отслеживает и сообщает о следующих событиях:

Игрок присоединяется: Отправлено на каналы с скачать_leave или все Типы выходных данных
Игрок отключается: Отправлено на каналы с скачать_leave или все Типы выходных данных
Серверный запуск: Отправлено на каналы с Server_state или все Типы выходных данных
Выключение сервера: Отправлено на каналы с Server_state или все Типы выходных данных
Игровой чат: Отправлено на каналы с болтать или все Типы выходных данных
Внутренние журналы: Отправлено только на каналы, явно сконфигурированные Internal_log тип

Слушатели событий

Плагин регистрирует слушателей для:

ИгрокChatEvent - Вперед в игре чат к раздору
Игрок готов Событие Уведомление о разногласиях, когда игроки присоединяются
PlayerDisconnect Событие Уведомление о разладе, когда игроки уходят
AllWorldsLoaded скачать Событие Уведомляет о разладе, когда сервер запускается
Отключение Событие Уведомляет о разладе, когда сервер останавливается

Зависимости

Обратите внимание: JAR, который вы загружаете, является теневым JAR, который объединяет все зависимости, поэтому вам не нужно устанавливать какие-либо дополнительные библиотеки. Они перечислены исключительно для справочной информации и прозрачности.

Hytale Server Реализация основного сервера (HytaleServer.jar)
Средний HytaleCore - Базовая библиотека коммунальных услуг
ДПД (Java Discord API) Версия 6.3.0 для ботов Discord
Гсон JSON парсинг и сериализация для конфигурации
SLF4J - Реализация лесозаготовок

Требования

Java 11 или выше
Активная установка сервера Hytale
Диссон-бот с надлежащими разрешениями:
- Смотреть каналы
- Отправить сообщения
- Прочитайте историю сообщений
- Намерения: GUILD_MESSAGES, Сообщение_Содержание

командование

`/discordridge reload`

Перезагружает конфигурацию плагина без необходимости перезагрузки сервера.

Алиасы: гм, агма, член группы

Использование: /discordridge reload

Разрешение: Администратор сервера/оператор

Цветные коды

The Разработчик:IngamePrefix поддержка Цветовые коды Minecraft для настройки внешнего вида сообщений:

и 9 - Синий.
и Зеленый
и - Красный
и - Желтый
&f - Белый
И еще много стандартных цветовых кодов Minecraft

устранение неполадок

Токен Bot недействителен

Убедитесь, что токен бота правильно скопирован с портала разработчиков Discord.
Убедитесь, что вы скопировали весь токен без дополнительных мест
Регенерировать токен при необходимости

Идентификатор канала Не найдено

Убедитесь, что разработчик Режим включен в Discord
Убедитесь, что идентификатор канала правильный (должен быть числовым)
Убедитесь, что бот имеет доступ к каналу.

Сообщения, не появляющиеся в раздоре

Убедитесь, что у бота есть разрешение на отправку сообщений по каналу.
Убедитесь, что идентификатор канала в конфигурации правильный
Убедитесь, что канал сконфигурирован с правильными типами вывода (болтать, все, скачать_leave, Server_stateили Internal_log)
Убедитесь, что хотя бы один канал настроен на тип сообщения, которое вы пытаетесь отправить.
Проверьте журналы сервера на наличие ошибок
Попробуйте использовать /discordridge reload Чтобы обновить конфигурацию

Сообщения, не появляющиеся в игре

Убедитесь, что бот Discord имеет разрешение на отправку сообщений в настроенных каналах.
Убедитесь, что идентификаторы канала в конфигурации правильные.
Убедитесь, что канал Discord настроен на болтать или все типы вывода для получения сообщений Discord и их ретрансляции в игре

Проблемы конфигурации

Обеспечьте Discord_bridge.json файл является действительным JSON (при необходимости используйте валидатор JSON)
Убедитесь, что все необходимые поля присутствуют: боттокен, каналы, botActivityMessage, Разработчик:IngamePrefix
Проверьте, что тип массив в каждом канале содержит допустимые типы вывода
Попробуйте использовать /discordridge reload После изменения конфигурации

Bot Offline скачать

Проверьте, действителен ли токен бота
Убедитесь, что ваш сервер имеет подключение к Интернету
Поиск сообщений об ошибках в консоли сервера

Автор

средний (js3 на Hytale)

Примечание: Этот плагин требует действительного токена бота Discord и правильной конфигурации для работы. Убедитесь, что все предпосылки выполнены перед установкой.

Показать оригинальное описание (English)

AverageDiscord

A comprehensive Discord-Hytale server bridge plugin that seamlessly connects your Hytale game server with Discord, enabling real-time chat synchronization and server status notifications.

Overview

AverageDiscord is a powerful plugin designed for Hytale servers that establishes a two-way communication bridge between your in-game chat and a designated Discord channel. Monitor server activity, receive player join/leave notifications, and allow Discord members to chat with players on your Hytale server—all in real-time.

Features

🔗 Bi-Directional Chat Bridge

Real-time synchronization between in-game chat and Discord
Formatted message support with proper text parsing
Discord messages sent to the designated channel appear in-game
In-game chat messages are forwarded to Discord with player names

📢 Server Status Notifications

Automatic server startup notification
Automatic server shutdown notification
Player join notifications with player names
Player disconnect notifications with player names
Emoji-enhanced messages for better visibility (✅ ☒ ➡️ ⬅️)

📡 Flexible Multi-Channel Output

Route different message types to different Discord channels
Support for 6 distinct output types: All, Chat, Join/Leave, Server State, Internal Log, Desc Status
Configure multiple channels with different output filters
Organize your Discord server with specialized channels for different events

⚙️ Easy Configuration

JSON-based configuration file with multi-channel support
Hot-reload functionality without restarting the server
Customizable Discord bot prefix for in-game messages
Custom bot activity/status message
Support for formatted color codes in Discord messages
Optional active player count display

📊 Dynamic Status Updates

Automatic bot activity updates with current player count every 10 minutes
Optional channel description updates with server status information (e.g., player count)

🛠️ Admin Commands

/discordbridge reload - Reloads plugin configuration on-the-fly
Aliases: /gm, /agm, /groupman
Graceful config synchronization

Installation

Download the latest AverageDiscord JAR file
Place it in your Hytale server's plugins folder
Create a Discord bot at Discord Developer Portal
Configure the plugin (see Configuration section below)
Restart your Hytale server or use /discordbridge reload

Configuration

After first run, a discord_bridge.json configuration file will be created in your server's AverageDiscord folder.

Configuration File Example

{
  "botToken": "your_bot_token_here",
  "channels": [
    {
      "channelId": "1234567890",
      "type": ["all"]
    },
    {
      "channelId": "2345678901",
      "type": ["chat"]
    },
    {
      "channelId": "3456789012",
      "type": ["join_leave", "server_state", "desc_status"]
    },
    {
      "channelId": "4567890123",
      "type": ["internal_log"]
    }
  ],
  "botActivityMessage": "Playing Hytale!",
  "discordIngamePrefix": "&9[Discord] ",
  "showActivePlayerCount": true
}

Configuration Options

Option	Type	Description	Example
`botToken`	String	Your Discord bot token from the Developer Portal	`"token_here"`
`channels`	Array	Array of channel configurations (see Channel Configuration below)	`[{...}]`
`botActivityMessage`	String	The bot's status message in Discord	`"Playing Hytale!"`
`discordIngamePrefix`	String	Prefix for Discord messages in-game (supports color codes)	`"&amp;9[Discord] "`
`showActivePlayerCount`	Boolean	Show active player count in bot activity status	`true`

Channel Configuration

Each channel object in the channels array has the following structure:

Option	Type	Description	Example
`channelId`	String	The Discord channel ID where messages of this type will be sent	`"1234567890"`
`type`	Array of Strings	Output types for this channel (see Output Types below)	`["chat", "join_leave"]`

Channel Output Types

Configure which types of messages are sent to each channel:

Type	Description
`all`	All messages except internal logs (chat, join/leave, server state)
`chat`	In-game player chat messages
`join_leave`	Player join and disconnect notifications
`server_state`	Server startup and shutdown notifications
`internal_log`	Internal plugin logging and debugging messages
`desc_status`	Channel description updates with server status information

Note: The all output type does not include internal_log. If you want internal logs, you must explicitly add the internal_log type to a channel.

How to Get Your Bot Token and Channel ID

Bot Token:
- Go to Discord Developer Portal
- Create a new application or select an existing one
- Navigate to the "Bot" tab
- Click "Add Bot" (if new)
- Copy the token under the "TOKEN" section
Channel ID:
- Enable Developer Mode in Discord (User Settings → Advanced → Developer Mode)
- Right-click on your desired channel
- Select "Copy Channel ID"
- Paste it in the configuration

How It Works

Message Routing

The plugin uses a flexible multi-channel system to route different message types to different Discord channels. Each channel is configured with one or more output types that determine what messages it receives.

Chat Synchronization

In-Game → Discord: When a player types in chat, the message is sent to all channels configured with the chat or all output types
Discord → In-Game: When a non-bot user sends a message in a channel configured with the chat or all output types, it appears in-game with a customizable prefix

Server Events

The plugin monitors and reports the following events:

Player Join: Sent to channels with join_leave or all output types
Player Disconnect: Sent to channels with join_leave or all output types
Server Startup: Sent to channels with server_state or all output types
Server Shutdown: Sent to channels with server_state or all output types
Player Chat: Sent to channels with chat or all output types
Internal Logs: Sent only to channels explicitly configured with internal_log type

Event Listeners

The plugin registers listeners for:

PlayerChatEvent - Forwards in-game chat to Discord
PlayerReadyEvent - Notifies Discord when players join
PlayerDisconnectEvent - Notifies Discord when players leave
AllWorldsLoadedEvent - Notifies Discord when the server starts
ShutdownEvent - Notifies Discord when the server stops

Dependencies

Please note: The JAR you download is a shadowed JAR that bundles all dependencies, so you do not need to install any additional libraries. These are listed solely for reference and transparency.

Hytale Server - The core server implementation (HytaleServer.jar)
AverageHytaleCore - Core utilities library
JDA (Java Discord API) - Version 6.3.0 for Discord bot functionality
Gson - JSON parsing and serialization for configuration
SLF4J - Logging implementation

Requirements

Java 11 or higher
Active Hytale server installation
Discord bot with proper permissions:
- View Channels
- Send Messages
- Read Message History
- Intents: GUILD_MESSAGES, MESSAGE_CONTENT

Commands

`/discordbridge reload`

Reloads the plugin configuration without requiring a server restart.

Aliases: gm, agm, groupman

Usage: /discordbridge reload

Permission: Server admin/operator

Color Codes

The discordIngamePrefix supports Minecraft color codes for customizing message appearance:

&9 - Blue
&a - Green
&c - Red
&e - Yellow
&f - White
And many more standard Minecraft color codes

Troubleshooting

Bot Token Invalid

Verify the bot token is correctly copied from the Discord Developer Portal
Ensure you've copied the entire token without extra spaces
Regenerate the token if necessary

Channel ID Not Found

Ensure Developer Mode is enabled in Discord
Verify the channel ID is correct (should be numeric)
Ensure the bot has access to the channel

Messages Not Appearing in Discord

Check that the bot has permission to send messages in the channel
Verify the channel ID in the configuration is correct
Ensure the channel is configured with the correct output types (chat, all, join_leave, server_state, or internal_log)
Check that at least one channel is configured with the message type you're trying to send
Check server logs for any errors
Try using /discordbridge reload to refresh the configuration

Messages Not Appearing In-Game

Verify that the Discord bot has permission to send messages in the configured channels
Ensure the channel IDs in the configuration are correct
Make sure the Discord channel is configured with chat or all output types to receive Discord messages and relay them in-game

Configuration Issues

Ensure the discord_bridge.json file is valid JSON (use a JSON validator if needed)
Verify that all required fields are present: botToken, channels, botActivityMessage, discordIngamePrefix
Check that the type array in each channel contains valid output types
Try using /discordbridge reload after making configuration changes