MiniatureDiscordSRV_JarStandalone

MiniatureDiscordSRV — Minecraft Forge 1.20.1

A Forge mod that bridges your Minecraft server with Discord, inspired by DiscordSRV.

Features

💬 Bidirectional chat — Minecraft ↔ Discord in real time
🔔 Notifications — join, leave, and death messages sent to Discord
🖥️ Console channel — run server commands directly from a Discord channel (role-restricted)
🔗 Account linking — players link their Minecraft UUID to their Discord account with /discord link
🎭 Role sync — automatically assign a Discord role when a player links their account
🟢 Server status — online/offline messages sent to a dedicated Discord channel
🌍 Multilingual — English and Spanish support

Requirements

Java 17+
Forge 1.20.1 (47.4.10+)
A Discord bot token (create one here)

Building

⚠️ This project requires Gradle 8.5 (ForgeGradle 6 is not compatible with Gradle 9+).

# Linux/Mac — use the bundled Gradle 8.5
GRADLE_HOME=/opt/gradle-8.5 /opt/gradle-8.5/bin/gradle build

# Or if you have Gradle 8.x on PATH:
gradle build

The compiled JAR will be at build/libs/MiniatureDiscordSRV-1.20.1-1.0.0.jar.

Installation

Copy the JAR to your server’s mods/ folder.
Start the server once to generate the config file at config/discordsrv-server.toml.
Stop the server and edit the config (see below).
Restart the server.

Usage in a Docker/Forge server

This repository contains the mod source code and build scripts. The companion itzg-minecraft-server-forge directory in this workspace holds a complete Forge 1.20.1 server instance running in the itzg/minecraft-server Docker container.

Quick start

Build the mod: gradle build (outputs build/libs/MiniatureDiscordSRV-1.20.1-1.0.0.jar).
Copy the JAR to itzg-minecraft-server-forge/data-neoforge/mods/.
Start the server: cd itzg-minecraft-server-forge && docker-compose up -d.
Wait for the server to start and generate config/discordsrv-server.toml.
Edit the config with your Discord bot token, server ID, channel IDs, etc.
Restart the server or reload the mod.

About the server repository

The itzg-minecraft-server-forge directory contains the full server state:

data-neoforge/config/ — all mod configurations, including discordsrv-server.toml.
data-neoforge/mods/ — the mods loaded on server startup (including this mod once you’ve placed the JAR).
data-neoforge/world/… — the generated world and player data.
docker-compose.yml — Forge 1.20.1 environment setup with JVM memory, MOTD, RCON, etc.

💡 Tip: Store your discordsrv-server.toml and discordsrv-links.json files (from data-neoforge/config/) in version control or backups. If you regenerate the world or container, you won’t lose your Discord integration settings and linked accounts.

Configuration

Edit config/discordsrv-server.toml:

[bot]
  # Your Discord bot token
  botToken = "YOUR_BOT_TOKEN_HERE"
  # Your Discord server (guild) ID
  serverId = "YOUR_SERVER_ID_HERE"

[channels]
  # Channel ID for Minecraft <-> Discord chat
  chatChannelId = ""
  # Channel ID for console commands (leave empty to disable)
  consoleChannelId = ""
  # Channel ID for server online/offline status
  statusChannelId = ""

[chat]
  enabled = true
  minecraftToDiscordFormat = "**{player}**: {message}"
  discordToMinecraftFormat = "§9[Discord]§r <{user}> {message}"

[notifications]
  notifyJoin = true
  notifyLeave = true
  notifyDeath = true
  joinMessage  = "✅ **{player}** joined the server."
  leaveMessage = "❌ **{player}** left the server."
  deathMessage = "💀 **{player}** died: {cause}"

[console]
  # Enable the console channel feature
  enabled = false
  # Discord role ID allowed to run commands (leave empty = everyone in that channel)
  allowedRoleId = ""

[roleSync]
  enabled = false
  # Role ID to assign when a player links their account
  linkedRoleId = ""

[status]
  enabled = true
  onlineMessage  = "🟢 Server is now **online**!"
  offlineMessage = "🔴 Server is now **offline**."

Account Linking

In Minecraft

/discord link    → Get a 6-digit code (expires in 5 minutes)
/discord unlink  → Unlink your account
/discord status  → Check if your account is linked

In Discord

/link <code>     → Link your Discord account using the code from Minecraft

Link data is saved to config/discordsrv-links.json and persists across server restarts.

Discord Bot Permissions

Your bot needs the following permissions:

Read Messages / View Channels
Send Messages
Manage Roles (only if role sync is enabled)
Message Content Intent (must be enabled in the Developer Portal)

Project Structure

src/main/java/com/miniature/discordsrv/
├── MiniatureDiscordSRVMod.java          Main mod class
├── config/
│   └── ModConfig.java                   Forge config spec
├── discord/
│   ├── DiscordManager.java              JDA lifecycle & message sender
│   ├── DiscordChatListener.java         Discord → Minecraft chat
│   ├── DiscordConsoleListener.java      Discord → Server console
│   └── DiscordSlashCommandListener.java /link slash command handler
├── listeners/
│   ├── MinecraftEventListener.java      Minecraft events → Discord
│   ├── ServerEventListener.java         Server start/stop → Discord
│   └── CommandListener.java             /discord in-game commands
└── util/
    └── LinkManager.java                 Account linking + persistence