# AMCDB (Another Minecraft-Discord Bridge)<\/p>\n
**AI-Free Software**<\/p>\n
*AMCDB is proudly built by human hands, as a labor of love for the art of programming and the tradition of looking into the guts of a piece of software with one’s own eyes.*<\/p>\n
*No code within this mod was created by LLM or “AI” tools.*<\/p>\n
## Overview<\/p>\n
AMCDB is a Fabric\/Quilt mod to connect your Minecraft server to a Discord
\nserver. You can connect in-game chat to a Discord channel, set up a channel
\nfor the server console, and even run server commands from anywhere!<\/p>\n
**Here’s what it looks like in Minecraft…**
\n<\/p>\n
**…and here’s what it looks like in Discord!**
\n<\/p>\n
In case you prefer to see in-game messages in Discord appear to come from
\nplayers (and see their player heads as avatars!), AMCDB supports Discord
\nwebhooks as well:
\n<\/p>\n
## Key Features
\n– AMCDB is ***fast*** and ***lag-friendly***. It does almost all its work off
\nthe main server thread, so there’s no impact to game performance.
\n– AMCDB is ***flexible***. You can configure everything just the way you want
\nit — customize how messages look in game and in Discord, put the most useful
\ninformation for *you* in the channel topics, even give the Discord bot a clever
\nstatus message!
\n– AMCDB is ***stable*** and ***compatible***. It doesn’t use mixins to modify
\nMinecraft code, so it rarely breaks between Minecraft versions and it works
\nwell with just about any other Fabric mod.
\n– And lastly, AMCDB is ***fun***. It supports all sorts of cool Discord
\nfeatures, like:
\n – font styles…
\n 
\n – …name colors…
\n 
\n – …and even spoiler text you can hover to reveal!
\n <\/p>\n
## Installation
\nFollow these steps to set up AMCDB on your server.<\/p>\n
Note: you’ll need to be an admin of the Discord server you want to connect.<\/p>\n
### Install AMCDB on your Minecraft server
\nYou need a Fabric or Quilt server. Once you have that set up, make sure
\nFabric API is in your `mods` folder –
\nthat’s the one dependency AMCDB has.<\/p>\n
Then, grab the latest AMCDB `.jar` file from
\nGitHub Releases
\nor Modrinth. It’ll be something like `amcdb-1.1.6.jar`.
\nPut that in your `mods` folder.<\/p>\n
Next, start up your server. It will crash — that’s just because you haven’t
\nconfigured AMCDB yet. Now that you’ve started the server once, there should be
\na file called `amcdb.properties` inside your `config` folder. Open that file in
\nyour text editor and keep it around for the next step.<\/p>\n
### Set up a Discord bot
\n*If you’ve used a different Minecraft-Discord mod before, you might already
\nhave a bot. You can reuse it as long as it has the right permissions on your
\nserver – just put the token in the `amcdb.properties` file.*<\/p>\n
If you don’t have a Discord bot:
\n1. Log into https:\/\/discordapp.com\/developers\/applications\/.
\n2. Click **New Application** in the top right.
\n3. Give your bot a name, and click **Create**.
\n 
\n4. On the left side of the screen, click **Bot**.
\n 
\n5. Now you’ll generate the token that AMCDB will use to connect. On the main
\npart of the page, find the “Build-A-Bot” section and click **Reset Token**.
\nOnce you confirm and enter your 2FA code, a random string of characters will
\nappear like the picture below — that’s your token! Click **Copy**.
\n 
\n6. In the `amcdb.properties` file you opened earlier, find the line that starts
\nwith `amcdb.discord.bot.token=` and paste your bot token on the end of that
\nline. It’ll look like this:
\n “`yaml
\n amcdb.discord.bot.token=MTA2OTdyNTM0NzUxMyQ0MjMyNA.GYMgJ0.cvrf8Ah0jFQ8MtGQHsgDh2MrT_Iq8-56EUbm0c
\n “`
\n7. Scroll down to the **Privileged Gateway Intents** section and turn on
\n**Message Content Intent**. This is what lets your bot read messages in your
\nDiscord server so it can put them in your Minecraft game chat.
\n 
\n8. Now on the left side of the screen, move on to **URL Generator** under
\n**OAuth2**.
\n 
\n9. Under **Scopes**, checkmark the `bot` option. Another box labeled **Bot
\nPermissions** will appear. Here, choose **Manage Channels**,
\n**Read Message\/View Channels**, and **Send Messages**, then click **Copy**.
\n 
\n10. Paste the URL you copied into a new browser tab, select a server, click
\n**Continue**, then **Authorize**. You should see the bot join your Discord
\nserver!<\/p>\n
### Configure the chat channel
\nAMCDB has a lot of settings you *can* configure, but besides the bot token,
\nthere’s only one you need to get started — you need to tell AMCDB the ID of
\nthe channel you want to use for the in game chat. You’ll probably want to
\ncreate a new text channel for this, since all the messages in that channel
\nwill appear in Minecraft and vice versa.<\/p>\n
To get the channel ID, enable Developer Mode in your Discord app. Open
\nthe settings menu, then **Advanced** on the left. Then, turn on **Developer
\nMode**.
\n<\/p>\n
Once Developer mode is turned on, you can right click on the channel you want
\nto use and click **Copy ID**. Paste that ID into `amcdb.properties` right next
\nto `amcdb.discord.chat.channel=`. It’ll look like this:
\n“`yaml
\namcdb.discord.chat.channel=1046313040837832782
\n“`
\nIf you want to set up a channel for the server console, copy its ID too and
\npaste it next to `amcdb.discord.console.channel=`. The console channel supports
\nrunning commands that you send via Discord; this feature is disabled by default
\nfor safety, but you can enable it by changing the setting
\n`amcdb.discord.channels.console.enableExecution=` to `true`.<\/p>\n
Then save the `amcdb.properties` file and start your Minecraft server again.
\nIf you’ve done everything correctly, anything you type in the game chat
\nshould appear in the Discord channel, and anything you type in the Discord
\nchannel should appear in your game!<\/p>\n
Feel free to explore the rest of the `amcdb.properties` file, as that’s where
\nall of the configuration settings for AMCDB live. If you change anything,
\nyou’ll need to stop and start your Minecraft server for the new settings to
\ntake effect.<\/p>\n
### Configure webhook mode
\nIf you want to display Minecraft player heads as Discord avatars, you’ll need
\nto enable webhook mode. This is optional — AMCDB will work fine if you don’t
\nset up a webhook.<\/p>\n
To set up a webhook, follow these steps:
\n1. Open your Discord server Settings page.
\n2. On the left, select Integrations (under the “Apps” category).
\n3. Click on “Webhooks”, then “New Webhook”.
\n4. Click on your new webhook, change its name to Minecraft (or whatever you
\n like), and set the channel to the channel you want to use for Minecraft
\n chat.
\n5. Click “Copy Webhook URL”.
\n6. Paste the URL into `amcdb.properties` next to `amcdb.discord.channels.chat.webhookUrl=`.
\n Don’t forget to uncomment that line by removing the `#` at the beginning.
\n7. As always, save the `amcdb.properties` file and restart your server. You
\n should start to see in-game messages appearing in Discord with player names
\n and avatars!<\/p>\n
## Upgrade
\nGenerally, you can upgrade AMCDB simply by replacing the `.jar` file with the
\nnew version.<\/p>\n
When you upgrade, it’s a good idea to check whether new properties have been
\nadded to `amcdb.properties`; you can find latest version of the default
\nconfiguration here. Occasionally, new
\nrequired properties are added; this will cause your server to fail to start
\nafter updating the `.jar` until you add the new properties to your
\nconfiguration.<\/p>\n
You can also update your properties file by forcing AMCDB to generate a new one:
\n1. Stop your Minecraft server
\n2. Rename `amcdb.properties` to a temporary name, e.g. `amcdb.properties.old`
\n3. Update the `.jar` file and start your server. AMCDB will generate a new
\n `amcdb.properties` template, and the server will stop just like with a new
\n installation.
\n4. Copy your settings from `amcdb.properties.old` to the new `amcdb.properties`.
\n – You can also simply copy any missing properties into `amcdb.properties.old`
\n and then rename it back to `amcdb.properties`.
\n5. Start your Minecraft server.<\/p>\n","protected":false},"excerpt":{"rendered":"
Another Minecraft-Discord Bridge<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"amcdb","_minecraft_project_id":"8X31FLYC","_minecraft_author":"0x4e49434f4c45","_minecraft_license":"MIT","_minecraft_downloads":2142,"_minecraft_follows":15,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"amcdb.zip","_minecraft_size_bytes":174213253,"_minecraft_version_count":18,"_minecraft_updated_at":"2026-05-15T23:34:36.397095Z","_minecraft_date_created":"2023-01-06T23:02:31.253538Z","_minecraft_date_modified":"2026-04-02T00:53:03.071295Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/amcdb","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-05-31T17:22:38+00:00","_minecraft_import_hash":"cff9380f27abb317936d81fe4763e329","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,98,92],"mod_loader":[99,100],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-13192","mod","type-mod","status-publish","hentry","mod_category-fabric","mod_category-management","mod_category-quilt","mod_category-utility","mod_loader-fabric","mod_loader-quilt","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n