Nilcord | Yet Another Discord Bridge for Minecraft

Originally created as a specialized project for a specific mod loader and Minecraft version, Nilcord is now available for all major game versions that interest me!

This mod creates a two-way connection between your Minecraft server chat and a selected Discord text channel, using a Discord bot and optionally webhooks.

Installation and Configuration

To install, simply place the mod file in the mods folder (or nilmods when using NilLoader), start your Minecraft server, and wait for the configuration file to be created.

The configuration file nilcord.toml is located in the config folder and contains clear settings:

# Discord settings
[discord]
    # Discord bot token
    token = "EMPTY"
    # Discord channel ID
    channel_id = "EMPTY"

    [discord.webhook]
        # Use webhook for sending messages
        enabled = false
        # Webhook URL
        url = "EMPTY"

# Minecraft settings
[minecraft]
    # Allow mentioning Discord users
    enable_mentions = false
    # Allow @everyone and @here mentions
    enable_everyone_and_here = false
    # Show Discord attachments
    show_attachments = true
    # Show messages from other bots
    show_bot_messages = false

# Message formatting
[formatting]
    [formatting.discord]
        server_start_message = "Server started!"
        server_stop_message = "Server stopped!"
        chat_message = "&lt;<username>&gt; <message>"
        join_message = "&gt; <username> joined the game"
        leave_message = "&gt; <username> left the game"
        advancement_fallback_message = "&gt; <username> has just earned the achievement [<advancement_title>]\n&gt; \&gt; _<advancementdescription>"
        advancement_challenge_message = "&gt; <username> has completed the challenge [<advancement_title>]\n&gt; \&gt; _<advancementdescription>"
        advancement_goal_message = "&gt; <username> has reached the goal [<advancement_title>]\n&gt; \&gt; _<advancementdescription>"
        advancement_task_message = "&gt; <username> has made the advancement [<advancement_title>]\n&gt; \&gt; _<advancementdescription>"
        deathmessage = "<username> died: <deathmessage>"

        [formatting.discord.webhook]
            avatar_url = "https://visage.surgeplay.com/bust/128/&lt;uuid&gt;"
            username = "<username>"
            chat_message = "<message>"

    [formatting.minecraft]
        discord_message = "[Discord] <reply_format><open_url:>'&gt;&lt;<username_format>&gt; <message><attachment_format>"
        username_format = "<show_text:>'&gt;<color:>'&gt;<nickname>"
        mention_format = "<underline><show_text:>'&gt;@<nickname></nickname></show_text:></underline>"
        reply_format = "<open_url:>'&gt;<show_text:>: <reply_message>'&gt;[<aqua>←</aqua><color:>'&gt;<reply_nickname>] "
        attachment_format = "<open_url:>'&gt;[<aqua>Attachment</aqua>]"

Note: This configuration is for Nilcord version 2.1.0+1.20.4+fabric. The file may differ in other versions.

Only the token and channel_id fields in the discord section must be filled out - all other settings use sensible default values.

Additional Features

For versions 1.21.1 and below, Simplified Text Format is supported, as well as placeholders from Text Placeholder API and compatible mods.

For versions 1.21.2 and above, Fabric versions support QuickText.

The Forge 1.7.10 version additionally supports ChromatiCraft progression messages and ServerUtilities AFK messages.