A discord bot to display V:tES cards, using the VEKN official card texts and KRCG rulings list.
Portions of the materials are the copyrights and trademarks of Paradox Interactive AB, and are used with permission. All rights reserved. For more information please visit white-wolf.com.
This bot lets you retrieve cards official text, image and rulings:
To call the bot, use slash commands: /card
followed by a card name.
Make sure you use the name autocompletion or you might not get the result you want.
By default, the bot answers to you with a private message other members do not see.
You can use the optional public
paramater to your slash command to make the message
visible for everyone in the channel.
It is online and free to use, install it on your Discord server.
Contributions are welcome !
This bot is an offspring of the KRCG python package, so please refer to that repository for issues, discussions and contributions guidelines.
If you need to host a new version of the bot yourself,
Python 3 is required, as well as an
environment variable DISCORD_TOKEN
.
The token can be found on your
Discord applications page.
The preferred way to run the bot is to use a python virtualenv:
/usr/bin/python3 -m venv venv
source venv/bin/activate
pip install krcg-bot
DISCORD_TOKEN=discord_token_of_your_bot
krcg-bot
A systemd unit can be used to configure the bot as a system service:
[Unit]
Description=krcg-bot
After=network-online.target
[Service]
Type=simple
Restart=always
WorkingDirectory=directory_where_krcg_is_installed
Environment=DISCORD_TOKEN=discord_token_of_your_bot
ExecStart=/bin/bash -c 'source venv/bin/activate && krcg-bot'
[Install]
WantedBy=multi-user.target
For development, the environment variable DISCORD_TOKEN
can be provided
by a personal .env
file at the root of the krcg folder (ignored by git):
export DISCORD_TOKEN="discord_token_of_your_bot"