🎴 Cardian

Yu-Gi-Oh! Paper, Master Duel and Duel Links Discord Bot

Fetches data from the YGOPRODeck, Master Duel Meta and Duel Links Meta APIs

Get the bot from the new Discord app directory!

Features

• Autocompletion
  • Card suggestions with fuzzy searching
• Card info
  • different formats using the format: option
  • remembers the last used option as default
• High quality art
• Add card info to messages with <card name>s via right click

Docker container

🚨 The ongoing development made the bot reliant on other services that I host, which makes self hosting not a great option.

Create a Discord application and get the bot token. (More info here)

Run the container with this command:

docker pull ghcr.io/okkdev/cardian:latest
docker run -e CARDIAN_TOKEN=<your-bot-token> okkdev/cardian --name cardian

To deploy the application commands run this command once:

docker exec cardian /app/bin/cardian rpc "Cardian.Commands.deploy()"

🚨 It can take up to 1h to register application commands

🚨 Emotes are currently hardcoded and will probably stop working

Environment variables

• CARDIAN_TOKEN: Discord bot token
• BONK_URL: This is the URL for the bonk microservice which returns the whitelist of users that donated on kofi, used for the OCG art command
• CARDIAN_UPDATE_INTERVAL: Card cache update interval in minutes. Default: 120
• OTEL_EXPORTER_OTLP_ENDPOINT: OpenTelemetry exporter endpoint for metrics and logging
• OTEL_AUTH: Basic auth credentials for the OTLP exporter
• OTEL_STREAM_NAME: OTLP stream name. Default: default
• PUSH_URL: Uptime Kuma push monitor URL for health checks

Development

1. Install dependencies:

mix deps.get

2. Set env vars.

3. Run the app:

mix run --no-halt
# or
iex -S mix