| Name | krcg-bot JSON |
| Version |
4.5
JSON |
| download |
| home_page | None |
| Summary | Discord bot for VTES cards |
| upload_time | 2025-11-01 15:43:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
bot
ccg
discord
vampire
vtes
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# KRCG Discord Bot
[](https://badge.fury.io/py/krcg-bot)
[](https://github.com/lionel-panhaleux/krcg-bot/actions)
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/psf/black)
A discord bot to display V:tES cards, using
the VEKN [official card texts](http://www.vekn.net/card-lists) and
[KRCG](https://github.com/lionel-panhaleux/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](http://www.white-wolf.com).
## Use it
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](https://discordapp.com/oauth2/authorize?client_id=703921850270613505&scope=bot%20applications.commands).
## Contribute
**Contributions are welcome !**
This bot is an offspring of the [KRCG](https://github.com/lionel-panhaleux/krcg)
python package, so please refer to that repository for issues, discussions
and contributions guidelines.
## Hosting the bot
If you need to host a new version of the bot yourself,
[Python 3](https://www.python.org/downloads/) is required, as well as an
environment variable `DISCORD_TOKEN`.
The token can be found on your
[Discord applications page](https://discord.com/developers/applications).
The preferred way to run the bot is to use a python virtualenv:
```bash
/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](https://en.wikipedia.org/wiki/Systemd) unit can be used
to configure the bot as a system service:
```ini
[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):
```bash
export DISCORD_TOKEN="discord_token_of_your_bot"
```
Raw data
{
"_id": null,
"home_page": null,
"name": "krcg-bot",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "lionelpx <lionel.panhaleux@gmail.com>",
"keywords": "bot, ccg, discord, vampire, vtes",
"author": null,
"author_email": "lionelpx <lionel.panhaleux@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/8b/dd/d914bfc29f96494cd110eefbc3186e453a49f836472c37c473be0f324757/krcg_bot-4.5.tar.gz",
"platform": null,
"description": "# KRCG Discord Bot\n\n[](https://badge.fury.io/py/krcg-bot)\n[](https://github.com/lionel-panhaleux/krcg-bot/actions)\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/psf/black)\n\nA discord bot to display V:tES cards, using\nthe VEKN [official card texts](http://www.vekn.net/card-lists) and\n[KRCG](https://github.com/lionel-panhaleux/krcg) rulings list.\n\nPortions of the materials are the copyrights and trademarks of Paradox Interactive AB,\nand are used with permission. All rights reserved.\nFor more information please visit [white-wolf.com](http://www.white-wolf.com).\n\n\n\n## Use it\n\nThis bot lets you retrieve cards official text, image and rulings:\n\n\nTo call the bot, use slash commands: `/card` followed by a card name.\nMake sure you use the name autocompletion or you might not get the result you want.\nBy default, the bot answers to you with a private message other members do not see.\nYou can use the optional `public` paramater to your slash command to make the message\nvisible for everyone in the channel.\n\nIt is online and free to use,\n[install it on your Discord server](https://discordapp.com/oauth2/authorize?client_id=703921850270613505&scope=bot%20applications.commands).\n\n## Contribute\n\n**Contributions are welcome !**\n\nThis bot is an offspring of the [KRCG](https://github.com/lionel-panhaleux/krcg)\npython package, so please refer to that repository for issues, discussions\nand contributions guidelines.\n\n## Hosting the bot\n\nIf you need to host a new version of the bot yourself,\n[Python 3](https://www.python.org/downloads/) is required, as well as an\nenvironment variable `DISCORD_TOKEN`.\nThe token can be found on your\n[Discord applications page](https://discord.com/developers/applications).\n\nThe preferred way to run the bot is to use a python virtualenv:\n\n```bash\n/usr/bin/python3 -m venv venv\nsource venv/bin/activate\npip install krcg-bot\nDISCORD_TOKEN=discord_token_of_your_bot\nkrcg-bot\n```\n\nA [systemd](https://en.wikipedia.org/wiki/Systemd) unit can be used\nto configure the bot as a system service:\n\n```ini\n[Unit]\nDescription=krcg-bot\nAfter=network-online.target\n\n[Service]\nType=simple\nRestart=always\nWorkingDirectory=directory_where_krcg_is_installed\nEnvironment=DISCORD_TOKEN=discord_token_of_your_bot\nExecStart=/bin/bash -c 'source venv/bin/activate && krcg-bot'\n\n[Install]\nWantedBy=multi-user.target\n```\n\nFor development, the environment variable `DISCORD_TOKEN` can be provided\nby a personal `.env` file at the root of the krcg folder (ignored by git):\n\n```bash\nexport DISCORD_TOKEN=\"discord_token_of_your_bot\"\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Discord bot for VTES cards",
"version": "4.5",
"project_urls": {
"Homepage": "http://github.com/lionel-panhaleux/krcg-bot",
"Issues": "http://github.com/lionel-panhaleux/krcg-bot/issues",
"Repository": "http://github.com/lionel-panhaleux/krcg-bot"
},
"split_keywords": [
"bot",
" ccg",
" discord",
" vampire",
" vtes"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "9003bd93c219afc43beba4f5a46ca93ac3ed1e0654b4b94416006dd1aa86fd07",
"md5": "b2719c16863f64984646e63b47e65ff9",
"sha256": "c49bbcba75e67e4d319e24732faeea72f3dcdae5758ae4212067c14d044571c4"
},
"downloads": -1,
"filename": "krcg_bot-4.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b2719c16863f64984646e63b47e65ff9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 10100,
"upload_time": "2025-11-01T15:43:14",
"upload_time_iso_8601": "2025-11-01T15:43:14.911669Z",
"url": "https://files.pythonhosted.org/packages/90/03/bd93c219afc43beba4f5a46ca93ac3ed1e0654b4b94416006dd1aa86fd07/krcg_bot-4.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8bddd914bfc29f96494cd110eefbc3186e453a49f836472c37c473be0f324757",
"md5": "126ca79dd4f8e8574dc4c8bc1d84000d",
"sha256": "0896c8ffb8cff5e6effd6b38795ff068514bcd8c217393a56d28bccc61b3a099"
},
"downloads": -1,
"filename": "krcg_bot-4.5.tar.gz",
"has_sig": false,
"md5_digest": "126ca79dd4f8e8574dc4c8bc1d84000d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 756171,
"upload_time": "2025-11-01T15:43:16",
"upload_time_iso_8601": "2025-11-01T15:43:16.370771Z",
"url": "https://files.pythonhosted.org/packages/8b/dd/d914bfc29f96494cd110eefbc3186e453a49f836472c37c473be0f324757/krcg_bot-4.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-01 15:43:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "lionel-panhaleux",
"github_project": "krcg-bot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "krcg-bot"
}
