Nilcord

# Настройки, относящиеся к самому Discord
[discord]
    # Токен Discord-бота для использования
    # default: 
    token = ""
    # ID канала Discord по умолчанию, в который бот отправляет сообщения / из которого получает сообщения. Используется ВМЕСТЕ с send_to и receive_from. Может быть пустым!
    # default: 
    channel_id = ""
    # Другие ID каналов Discord, в которые бот отправляет сообщения
    send_to = []
    # Другие ID каналов Discord, из которых бот получает сообщения
    receive_from = []

    # Настройки, относящиеся к вебхуку Discord
    [discord.webhook]
        # Использовать ли вебхук для отправки сообщений чата игроков в Discord
        # default: false
        enabled = false
        # URL вебхука для использования
        # default: 
        url = ""

# Настройки, относящиеся к самому Minecraft
[minecraft]
    # Разрешать ли упоминания пользователей Discord из Minecraft
    # default: false
    enable_mentions = false
    # Разрешать ли упоминания @everyone и @here из Minecraft
    # default: false
    enable_everyone_and_here = false
    # Показывать ли вложения сообщений Discord в игре
    # default: true
    show_attachments = true
    # Показывать ли в игре сообщения от других Discord-ботов
    # default: false
    show_bot_messages = false
    # Показывать ли в игре сообщения от вебхуков Discord
    # default: true
    show_webhook_messages = true
    # ID приложений / пользователей, сообщения от которых игнорировать
    ignored_ids = ["000000000000000000"]

# Настройки, относящиеся к форматированию сообщений
[formatting]

    # Настройки, относящиеся к сообщениям, видимым в Discord
    # Доступные плейсхолдеры: <displayname> <username>
    [formatting.discord]
        # Сообщение о запуске сервера
        # Доступные плейсхолдеры: Н/Д
        # default: **Server starting...**
        server_starting_message = "**Server starting...**"
        # Сообщение о запущенном сервере
        # Доступные плейсхолдеры: Н/Д
        # default: **Server started!**
        server_started_message = "**Server started!**"
        # Сообщение об остановке сервера
        # Доступные плейсхолдеры: Н/Д
        # default: **Server stopping...**
        server_stopping_message = "**Server stopping...**"
        # Сообщение об остановленном сервере
        # Доступные плейсхолдеры: Н/Д
        # default: **Server stopped!**
        server_stopped_message = "**Server stopped!**"
        # Сообщение о краше сервера
        # Доступные плейсхолдеры: Н/Д
        # default: **Server crashed :(**
        server_crash_message = "**Server crashed :(**"
        # Сообщения чата игроков
        # Дополнительные плейсхолдеры: <message>
        # default: **<<username>>** <message>
        chat_message = "**<<username>>** <message>"
        # Сообщения о входе игроков
        # Дополнительные плейсхолдеры: Н/Д
        # default: > **<username> joined the game**
        join_message = "> **<username> joined the game**"
        # Сообщения о выходе игроков
        # Дополнительные плейсхолдеры: Н/Д
        # default: > **<username> left the game**
        leave_message = "> **<username> left the game**"
        # Сообщения о достижениях игроков
        # Дополнительные плейсхолдеры: <advancement_description> <advancement_title>
        # default: > **<username>** has just earned the achievement **[<advancement_title>]**
        #> \> _<advancement_description>_
        advancement_fallback_message = "> **<username>** has just earned the achievement **[<advancement_title>]**\n> \\> _<advancement_description>_"
        # default: > **<username>** has completed the challenge **[<advancement_title>]**
        #> \> _<advancement_description>_
        advancement_challenge_message = "> **<username>** has completed the challenge **[<advancement_title>]**\n> \\> _<advancement_description>_"
        # default: > **<username>** has reached the goal **[<advancement_title>]**
        #> \> _<advancement_description>_
        advancement_goal_message = "> **<username>** has reached the goal **[<advancement_title>]**\n> \\> _<advancement_description>_"
        # default: > **<username>** has made the advancement **[<advancement_title>]**
        #> \> _<advancement_description>_
        advancement_task_message = "> **<username>** has made the advancement **[<advancement_title>]**\n> \\> _<advancement_description>_"
        # Сообщения о смерти игроков
        # Дополнительные плейсхолдеры: <death_message>
        # default: **<username> died:** _<death_message>_
        death_message = "**<username> died:** _<death_message>_"

        # Настройки, относящиеся к сообщениям, отправляемым из вебхука, если он включён
        [formatting.discord.webhook]
            # URL для использования в качестве аватара вебхука
            # Дополнительные плейсхолдеры: <skin_id> <skin_model> <uuid>
            # default: https://visage.surgeplay.com/bust/128/<skin_id>?<skin_model>
            avatar_url = "https://visage.surgeplay.com/bust/128/<skin_id>?<skin_model>"
            # ID скина по умолчанию для аватара вебхука, если скин игрока не удаётся загрузить
            # default: 31f477eb1a7beee631c2ca64d06f8f68fa93a3386d04452ab27f43acdf1b60cb
            default_skin_id = "31f477eb1a7beee631c2ca64d06f8f68fa93a3386d04452ab27f43acdf1b60cb"
            # Модель скина по умолчанию для аватара вебхука, если скин игрока не удаётся загрузить
            # default: wide
            default_skin_model = "wide"
            # Имя пользователя вебхука
            # Дополнительные плейсхолдеры: Н/Д
            # default: <username>
            username = "<username>"
            # Сообщения чата игроков
            # Дополнительные плейсхолдеры: <message>
            # default: <message>
            chat_message = "<message>"

    # Настройки, относящиеся к сообщениям, видимым в Minecraft
    # Доступные плейсхолдеры: <message> <message_url> <nickname> <role_color> <username>
    [formatting.minecraft]
        # Сообщения Discord
        # Дополнительные плейсхолдеры: <attachment_format> <discord_format> <reply_format> <username_format>
        # default: [Discord] <reply_format><click type:open_url value:'<message_url>'><<username_format>></click> <message><attachment_format>
        discord_message = "[Discord] <reply_format><click type:open_url value:'<message_url>'><<username_format>></click> <message><attachment_format>"
        # Формат имени пользователя
        # Дополнительные плейсхолдеры: Н/Д
        # default: <hover type:show_text value:'@<username>'><color value:'<role_color>'><nickname></color></hover>
        username_format = "<hover type:show_text value:'@<username>'><color value:'<role_color>'><nickname></color></hover>"
        # Формат упоминания
        # Дополнительные плейсхолдеры: Н/Д
        # default: <underline><hover type:show_text value:'@<username>'>@<nickname></hover></underline>
        mention_format = "<underline><hover type:show_text value:'@<username>'>@<nickname></hover></underline>"
        # Формат ответа
        # Дополнительные плейсхолдеры: <reply_message> <reply_nickname> <reply_role_color> <reply_url> <reply_username>
        # default: <click type:open_url value:'<reply_url>'><hover type:show_text value:'@<reply_username>: <reply_message>'>[<aqua>←</aqua><color value:'<reply_role_color>'><reply_nickname></color>]</hover></click> 
        reply_format = "<click type:open_url value:'<reply_url>'><hover type:show_text value:'@<reply_username>: <reply_message>'>[<aqua>←</aqua><color value:'<reply_role_color>'><reply_nickname></color>]</hover></click> "
        # Формат вложения
        # Дополнительные плейсхолдеры: <attachment_url>
        # default: <click type:open_url value:'<attachment_url>'>[<aqua>Attachment</aqua>]</click>
        attachment_format = "<click type:open_url value:'<attachment_url>'>[<aqua>Attachment</aqua>]</click>"

</details>

(Учти, что это файл конфигурации для Nilcord `4.2+26.2+fabric`. На других версиях он может выглядеть иначе.)

Обязательно нужно заполнить только поля `token` и `channel_id` (в категории `discord`); для всего остального мод подставляет разумные значения по умолчанию. Но можешь менять их как угодно!

## Примечания

Чтобы настроить приложение Discord (и получить токен бота), следуй гайду discord.js: [Setting up a bot application | discord.js Guide](https://discordjs.guide/preparations/setting-up-a-bot-application.html)

Чтобы найти "Channel ID" канала Discord, следуй гайду Discord: [Where can I find my User/Server/Message ID? - Discord](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID#h_01HRSTXPS5FMK2A5SMVSX4JW4E)

На 1.21.1 и ниже версии для Fabric также могут использовать [Simplified Text Format](https://placeholders.pb4.eu/user/text-format/), а также плейсхолдеры из [Text Placeholder API](https://modrinth.com/mod/placeholder-api) и разных модов, которые её поддерживают.

На 1.21.2 и выше версии для Fabric позволяют использовать ещё и [QuickText](https://placeholders.pb4.eu/user/quicktext/).

На 1.20.4, а также 26.1 и выше версии для NeoForge тоже позволяют использовать Simplified Text Format и QuickText.

Версия для Forge 1.7.10 дополнительно поддерживает сообщения о прогрессе из [ChromatiCraft](https://www.curseforge.com/minecraft/mc-mods/chromaticraft), а также AFK-сообщения из [ServerUtilities](https://github.com/GTNewHorizons/ServerUtilities).

***

Есть комментарии? Вопросы? Предложения? Требования? Открывай issue в [issue tracker](https://github.com/unilock/nilcord/issues)!