jarecoder/kingshot-redeemer repository overview

⁠Kingshot Redeemer Bot

A Discord bot that automates gift code redemption for Kingshot players using browser automation. Redeem codes for multiple accounts simultaneously with a single command.

⁠Features

• 🎁 Bulk Redemption - Redeem gift codes for all registered players at once
• 🤖 Browser Automation - Uses Playwright for reliable web interaction
• 💾 Auto-Sync Player Names - Player nicknames automatically update from the offician redeeming site
• 📋 Player Management - Add, remove, search, and list players
• 🔄 Auto-Update Check - Automatically checks for new Docker image versions every 24h
• 🐳 Docker Ready - Easy deployment with Docker/Docker Compose
• 🔄 Cross-Platform - Supports AMD64 and ARM64 architectures

⁠Quick Start

⁠Prerequisites

1. A Discord bot token (Get one here⁠)
2. Docker installed on your system

⁠Run with Docker

Option 1: Docker Run

docker run -d \
  --name kingshot-redeemer \
  -e DISCORD_TOKEN=your_discord_token_here \
  -e TIMEOUT_MS=500 \
  -v kingshot-data:/data \
  --restart unless-stopped \
  jarecoder/kingshot-redeemer:latest

Option 2: Docker Compose (Recommended)

1. Create a docker-compose.yml file:

version: '3.8'

services:
  kingshot-redeemer:
    image: jarecoder/kingshot-redeemer:latest
    container_name: kingshot-redeemer-bot
    restart: unless-stopped
    environment:
      - DISCORD_TOKEN=${DISCORD_TOKEN}
      - TIMEOUT_MS=${TIMEOUT_MS}
    volumes:
      - kingshot-data:/data

volumes:
  kingshot-data:

1. Create a .env file:

DISCORD_TOKEN=your_discord_token_here
TIMEOUT_MS=500

1. Start the bot:

docker-compose up -d

1. View logs:

docker-compose logs -f

⁠Discord Bot Setup

⁠1. Create a Discord Application

1. Go to the Discord Developer Portal⁠
2. Click "New Application"
3. Give it a name (e.g., "Kingshot Redeemer")
4. Click "Create"

⁠2. Create a Bot User

1. In your application, go to the "Bot" tab
2. Click "Add Bot" → "Yes, do it!"
3. Under the bot's username, click "Reset Token" and copy it
   • ⚠️ Save this token securely - you'll need it for the DISCORD_TOKEN environment variable
4. Bot can be public or private up to your choosing. I will always recommend private bots for security reasons.

⁠3. Invite the Bot to Your Server

1. Go to the "OAuth2" → "URL Generator" tab
2. Select these scopes:
   • ✅ bot
   • ✅ applications.commands
3. Select these bot permissions:
   • ✅ Send Messages
   • ✅ Use Slash Commands
4. Copy the generated URL and open it in your browser
5. Select your server and authorize

⁠Discord Commands

⁠Environment Variables

⁠Data Persistence

Bot data (including players and configuration) is stored in /app/data/botData.json inside the container. The Docker volume kingshot-data ensures your data persists across:

• Container restarts
• Bot updates
• System reboots

⁠Backup Data

# Export bot data
docker run --rm -v kingshot-data:/data -v $(pwd):/backup \
  alpine tar czf /backup/bot-data-backup.tar.gz -C /data .

# Restore bot data
docker run --rm -v kingshot-data:/data -v $(pwd):/backup \
  alpine tar xzf /backup/bot-data-backup.tar.gz -C /data

⁠Troubleshooting

⁠Commands not appearing in Discord

Global sync (up to 1 hour):

• Wait up to 1 hour for Discord to propagate commands globally
• Or kick & reinvite the bot

⁠Bot not responding

1. Check logs: docker-compose logs -f
2. Verify DISCORD_TOKEN is correct
3. Ensure bot has proper permissions in Discord
4. Check that Message Content Intent is enabled

⁠Player nicknames not updating

Nicknames auto-update when:

• A gift code is successfully redeemed
• The game page returns a valid player name
• The stored name differs from the page name

⁠Building from Source

# Clone the repository
git clone https://github.com/JareCoder/KingshotRedeemer.git
cd KingshotRedeemer

# Build the Docker image
docker build -t kingshot-redeemer .

# Run it
docker-compose up -d

⁠Supported Platforms

• ✅ linux/amd64 (x86_64 - Most PCs and servers)
• ✅ linux/arm64 (Apple Silicon Macs, Raspberry Pi, ARM servers)

⁠Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

⁠License

MIT License - feel free to use this project for personal or commercial purposes.

⁠Links

• Docker Hub⁠
• GitHub Repository⁠
• Report Issues⁠