Unofficial ForgeHub Discord Bot ⚒️

A Discord bot that automatically fetches latest map submissions on forgehub.com, latest FH's tweets, and alerts whenever FH goes live on Twitch!

Prerequisites

• node >=16.13.2
• npm >=8.4.0

Install

With Docker

A Dockerfile is available at the root of the project so you can easily set the bot up without having to care about any global dependency or anything. If you want to do it this way, make sure you have Docker installed on your machine.

git clone https://github.com/Halocrea/forgehub-discordbot.git
cd forgehub-discordbot

cp .env.dist .env
vi .env
#provide the information required in the .env file

docker build -t forgehub-discordbot .
docker run -d -v /absolute/path/to/forgehub-discordbot/data:/app/data --restart=always --name=forgehub-discordbot forgehub-discordbot

Without Docker

Make sure you have the proper Node.js and NPM versions installed on your machine.

git clone https://github.com/Halocrea/forgehub-discordbot.git
cd forgehub-discordbot

cp .env.dist .env
vi .env
#provide the information required in the .env file

npm

node index.js

Setup

• If you never set up a Discord bot before, please follow the instructions over here.
• If you don't want to host your own version of the bot but consume an existing instance of it, you can use the following invite link: https://discordapp.com/oauth2/authorize?client_id=706124989597876294&scope=bot&permissions=27712
• Once that is done, invite the bot to your server, and follow the instructions of the greeting message to learn about the available slash commands.

Supported languages

• 🇺🇸 English
• 🇫🇷 French
• 🇪🇸 Spanish

If you'd like to get the bot in another language, feel free to contact us and contribute!

Commands list

Here's the list of slash commands available once the bot is on a server; please note that these commands are localized, for example /help to show this list of commands is /aide in French and /ayuda in Spanish.

General commands

• /help: show this help message.
• /latest topic: I will show you the latest map or tweet depending on which of those two_topics_ you choose.
• /invite: get a link to invite this bot to your own servers.

Admin commands

• /setup topic channel: You can set the channel into which I will automatically post the latest map/tweet/stream alert.
• /set-language language: to define which language the bot should use whenever it automatically posts a message.

To ask questions to the developers of this bot, feel free to contact us at {discordInvite}!

Contribution

Thank you RBLS#7532 for the spanish translation!

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!