docker-Curseforge-Bot
A discord bot, which informs users about new files of specific mods or Curseforge projects in general. Based on ijo42's fork CurseForge2Discord.
Creates a Container which runs ijo42's CurseForge2Discord, with lsiobase/alpine as the base image, as seen on https://github.com/ijo42/CurseForge2Discord.
The lsiobase/alpine image is a custom base image built with Alpine linux and S6 overlay. Using this image allows us to use the same user/group ids in the container as on the host, making file transfers much easier
Deployment
Tags | Description |
---|---|
latest |
Using the latest tag will pull the latest image for amd64/x86_64 architecture. |
Pre-built images
using docker-compose:
version: "2"
services:
curseforge-bot:
image: griefed/curseforge-bot:latest
container_name: curseforge-bot
restart: unless-stopped
environment:
- TZ=Europe/Berlin # Timezone
- ROLE_ID=000000000 # (Optional) The ID of the discord role mentioned when the bot makes a post
- PUID=1000 # User ID
- PROJECT_ID=430517 # The ID of your Curseforge project
- PGID=1000 # Group ID
- FILE_LINK=curse # direct-link to file or curseforge-link on project page or nolink.
- DISCORD_CHANNEL_ID=000000000 # The ID of the channel you want the bot to post in
- WEBHOOK_TOKEN=InsertHere # Your discord-server webhook
- DESCRIPTION=New File(s) Detected For CurseForge Project(s) # This sets the text that appears as the message description in the update notification
- CHANGELOG_FORMAT=md # yml or md or css. Only choose one syntax. Can be very usefull if project owner/author uses discord MarkDown formatting in their changelog.
volumes:
- /host/path/to/config:/config # Where the bot-conf will be stored
Using CLI:
docker create \
--name=curseforge-bot \
-e TZ=Europe/Berlin `# Timezone` \
-e ROLE_ID=000000000 `# (Optional) The ID of the discord role mentioned when the bot makes a post` \
-e PUID=1000 `# User ID` \
-e PROJECT_ID=430517 `# The ID of your Curseforge project` \
-e PGID=1000 `# Group ID` \
-e FILE_LINK=curse `# direct-link to file or curseforge-link on project page or nolink.` \
-e DISCORD_CHANNEL_ID=000000000 `# The ID of the channel you want the bot to post in` \
-e WEBHOOK_TOKEN=InsertHere `# Your discord-server webhook` \
-e DESCRIPTION=New File(s) Detected For CurseForge Project(s) `# This sets the text that appears as the message description in the update notification` \
-e CHANGELOG_FORMAT=md `# yml or md or css. Only choose one syntax. Can be very usefull if project owner/author uses discord MarkDown formatting in their changelog.` \
-v /host/path/to/config:/config `# Where the bot-conf will be stored` \
--restart unless-stopped \
griefed/curseforge-bot:latest
Raspberry Pi
Unfortunately, due to OpenJDK-15 not having an image supporting armv7, there is no arm-image for this container.
Configuration
Configuration | Explanation |
---|---|
Restart policy | "no", always, on-failure, unless-stopped |
config volume | Contains config files and logs. |
data volume | Contains your/the containers important data. |
TZ | Timezone |
PUID | for UserID |
PGID | for GroupID |
WEBHOOK_TOKEN | Your discord-server webhook |
DISCORD_CHANNEL_ID | The ID of the channel you want the bot to post in |
PROJECT_ID | The ID of your Curseforge project |
ROLE_ID | (Optional) The ID of the discord role mentioned when the bot makes a post |
FILE_LINK |
direct -link to file or curse forge-link on project page or nolink . |
DESCRIPTION | This sets the text that appears as the message description in the update notification |
CHANGELOG_FORMAT |
yml or md or css . Only choose one syntax. Can be very usefull if project owner/author uses discord MarkDown formatting in their changelog. |
More information at the Curseforge-Bot wiki.
Adding more projects to track
If you have multiple projects in Curseforge which you want to track with this bot, you need to manually edit the bot.conf file which is created after container creation. Here's an example for multiple project IDs and how it's formatted:
ids = [
# Project ID
"Project ID;;Channel ID;;Webhook",
"Project ID2;;Channel ID2;;Webhook",
"Project ID3;;Channel ID;;Webhook",
"Project ID4;;Channel ID;;Webhook"
]
Every new project ID need to be in "" followed by a ,
if an additional ID follows. Last ID must not have a ,
at the end.
User / Group Identifiers
When using volumes, permissions issues can arise between the host OS and the container. Linuxserver.io avoids this issue by allowing you to specify the user PUID
and group PGID
.
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
In this instance PUID=1000
and PGID=1000
, to find yours use id user
as below:
$ id username
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
Building the image yourself
Use the Dockerfile to build the image yourself, in case you want to make any changes to it
docker-compose.yml:
version: '3.6'
services:
curseforge-bot:
container_name: curseforge-bot
build: ./builds/docker-Curseforge-Bot
restart: unless-stopped
volumes:
- ./path/to/config:/config
environment:
- TZ=Europe/Berlin
- PUID=1000 # User ID
- PGID=1000 # Group ID
- WEBHOOK_TOKEN=
- DISCORD_CHANNEL_ID=
- PROJECT_ID=
- ROLE_ID=
- FILE_LINK=
- DESCRIPTION=
- CHANGELOG_FORMAT=
- Clone the repository:
git clone https://github.com/Griefed/docker-Curseforge-Bot.git ./docker-Curseforge-Bot
- Prepare docker-compose.yml file as seen above
docker-compose up -d --build curseforge-bot
- ???
- Profit!