Discord

Setup

1. Create a new discord application here

2. Copy your token and place it into the config.yml

3. If you don't want other people inviting the bot to their guild, disable Public Bot

1. Copy your guild/server ID into the config.yml . Don't see the option? See How to enable developer mode

discord:
    enabled: true
    guild: "guildId"
    token: "YOUR_TOKEN_HERE"

1. Go to Installation and disable User Install and set the Install Link to None

1. Go to Bot and enable the Message Content Intent

1. To invite the bot go to OAuth2, select applications.commands and bot, then scroll down and select Administrator permissions.

1. Copy the Generated URL and open it in a new tab, then follow the instructions and invite it to your server.

Logging

Logging allows various in-game events to be sent via discord.

discord:
    ...
    logging:
        pvp-death:
            enabled: true
            channel: "channelId"
            # available placeholders:
            # - %victim%
            # - %attacker%
            # - %death-message%
            message:
                embed:
                    color: "#990000"
                    author: 
                        name: "%victim% was slain by %attacker%"
                        icon-url: "https://mc-heads.net/avatar/%uuid%/64"
        non-pvp-death:
            enabled: true
            channel: "channelId"
            # available placeholders:
            # - %victim%
            # - %death-message%
            message:
                content: "%death-message%"
        death:
            enabled: true
            channel: "channelId"
            # available placeholders:
            # - %victim%
            # - %death-message%
            message:
                content: "%death-message%"
        join:
            enabled: true
            channel: "channelId"
            message:
                embed:
                    color: "#00ff00"
                    author: 
                        name: "%player% joined the game"
                        icon-url: "https://mc-heads.net/avatar/%uuid%/64"
        quit:
            enabled: true
            channel: "channelId"
            message:
                embed:
                    color: "#ff0000"
                    author: 
                        name: "%player% quit the game"
                        icon-url: "https://mc-heads.net/avatar/%uuid%/64"
        server-start:
            enabled: true
            channel: "channelId"
            message:
                content: "Server started"
        server-stop:
            enabled: true
            channel: "channelId"
            message:
                content: "Server stopped"

Discord Message Format

...:
    allow-mentions: false
    content: "The message contents"
    embed: 
        author: 
            name: "Author Name"
            icon-url: "https://mc-heads.net/avatar/%uuid%/64/nohelm"
        # supports either hex code or decimal
        color: "#ffffff"
        title: "Title"
        description: "Description"
        footer:
            text: "Footer text"
            icon-url: "https://mc-heads.net/avatar/%uuid%/64/nohelm"
        image-url: "https://mc-heads.net/avatar/%uuid%/64/nohelm"
        thumbnail-url: "https://mc-heads.net/avatar/%uuid%/64/nohelm"

How to enable developer mode

1. Go to your discord user settings

2. Go to Advanced

3. Enable Developer Mode