cryptoblades-stamina-notifier

🏃 Get notified when stamina thresholds are reached for CryptoBlades characters

Notifies on Discord if stamina thresholds are reached for given CryptoBlades characters. Fetches stamina and character information from smart contracts on the Binance Smart Chain, Huobi ECO Chain or OKExChain. It notifies to a Discord channel using Discord Webhooks.

Usage

Within a Docker container

From Docker Hub Image

This will pull the image from Docker Hub and run the image with the provided configuration for web hooks as below. It's required to provide account addresses, names and the Webhook URL or both the Webhook ID and token.

# Providing a Discord Webhook URL and a single account
$ docker run -d -e DISCORD_WEBHOOK_URL=<URL_HERE> \
    -e ADDRESSES=<single_address> \
    -e ACCOUNT_NAMES="Main" \
    knutkirkhorn/cryptoblades-stamina-notifier

# Providing a Discord Webhook URL and multiple accounts
$ docker run -d -e DISCORD_WEBHOOK_URL=<URL_HERE> \
    -e ADDRESSES=<first_address>,<second_address> \
    -e ACCOUNT_NAMES="First, Second" \
    knutkirkhorn/cryptoblades-stamina-notifier

From source code

# Build container from source
$ docker build -t cryptoblades-stamina-notifier .

# Providing a single account
$ docker run -d -e DISCORD_WEBHOOK_URL=<URL_HERE> \
    -e ADDRESSES=<single_address> \
    -e ACCOUNT_NAMES="Main" \
    cryptoblades-stamina-notifier

# Providing multiple accounts
$ docker run -d -e DISCORD_WEBHOOK_URL=<URL_HERE> \
    -e ADDRESSES=<first_address>,<second_address> \
    -e ACCOUNT_NAMES="First, Second" \
    cryptoblades-stamina-notifier

Outside of a Docker container

# Install
$ npm install

# Run
$ npm start

Environment variables

Provide these with the docker run command or store these in a .env file.

• DISCORD_WEBHOOK_URL
  • URL to the Discord Webhook containing both the ID and the token
  • Format: DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/<ID_HERE>/<TOKEN_HERE>
• DISCORD_WEBHOOK_ID
  • ID for the Discord Webhook
• DISCORD_WEBHOOK_TOKEN
  • Token for the Discord Webhook
• WAIT_TIMEOUT (optional)
  • The time interval in milliseconds between each check of character staminas.
  • Default: 3600000 (60 minutes)
• STAMINA_THRESHOLD (optional)
  • The stamina threshold for when to notify.
  • Default: 160
• NETWORK (optional)
  • The blockchain network used for smart contract interaction.
  • Default: bsc (Binance Smart Chain)
  • Supported networks:
    • bsc
    • heco
    • okex
• BLOCKCHAIN_PROVIDER (optional)
  • The URI for the blockchain provider used for smart contract interaction.
  • Default: The selected network's blockchain provider
• ADDRESSES
  • The blockchain address(es) used for checking character staminas.
• ACCOUNT_NAMES (optional)
  • Names for the account(s) used for better knowing for which account the stamina threshold was reached. This can be anything and are just used in the Discord message.
  • Needs to be in the same order as the addresses.
  • If not provided it will create 1st, 2nd, 3rd etc. for the length of provided addresses.
• WIN_PERCENTAGE_THRESHOLD (optional)
  • A threshold for calculated fight win percentages. Notifies if percentage is above given threshold.
  • This is only used if WEAPON_IDS are provided.
  • Default: 98
• WEAPON_IDS (optional)
  • IDs for the weapons used for calculating win percentages for the different opponents.
  • Needs to be in the same order as the addresses.