AstralBot

This is a Minecraft mod and Discord Bot in one package. It's intended for the Create: Astral Modpack's official server, but it's implemented cross-platform to be usable by others too. The goal is to be easy-to-use and accessible for non-technical server admins, while allowing true complexity for power users.

Features

These features are the core of what this bot will do. See the Status section to see how things are implemented.

• Discord and Minecraft account linking, optionally requiring this to be whitelisted
• Discord and Minecraft chat synchronization
• FAQ commands using Markdown files without needing to restart the server

Dependencies

This mod has a few dependencies, some of which are not specified directly as they're technically optional:

• The Kotlin Implementation for the platform you're running. (e.g. Kotlin For Forge or Fabric Language Kotlin)
• The Forge Config API (Included in Forge, extra mod for Fabric)
• The SQLite Database Driver. (This is included in Ledger but also available separately)

Implementation

• JDA library to communicate with the Discord API.
• Kotlin for the improved development experience over Java
• Architectury for multiplatform development
• JetBrains Exposed to communicate with the Database

Configuration

The following things are configurable:

• Required linking to be whitelisted (default: off)
• Chat synchronization with imitated Discord Users

Running

There is no public instance of this bot/mod available. To use it, create a new Application on the Discord Developer Portal and configure it to have the three privileged gateway intents: PRESENCE, SERVER MEMBERS and MESSAGE CONTENT.

Copy the bot token and store it somewhere safe (like a Password Manager) and never show it to anybody else. To make sure the token gets read by the bot, it has to be in an Environment Variable DISCORD_TOKEN where the running Minecraft server can access it. You could for example modify a start.sh script on a Unix-like system to export it or start the shell script with it set directly.

After starting the server, you can go into the OAuth2 URL builder on the Discord Developer Portal and generate a URL with the bot and applications.command permissions. Use the generated URL to have the bot join your server.