What is WickesyBot?
WickesyBot is a Twitch chatbot ecosystem built entirely on Cloudflare Workers for the Wickesy Twitch channel. It consists of three workers and one shared library:
| Component | Worker name | Purpose |
|---|---|---|
| Bot | wickesybot | Twitch chat — EventSub, chat, commands, games, economy, wallet monitor, AI |
| Admin | wickesybot-admin-v2 | React 19 SPA + Hono API — full web-based bot configuration |
| Discord | wickesybot-discord | Discord gateway bot — 29 slash commands, moderation, roles, presence |
| Shared | @wickesybot/shared | Zod schemas, KV helpers, DO client, rate limiter, Twitch OAuth, AI wrappers |
Key Features
- Custom Commands — Template-based with cooldowns, permissions, and multi-platform dispatch
- Games — Blackjack, Trivia, Raffles, Slots, Coinflip, Diceroll
- Economy — Watchtime tracking (D1) + Credits system
- Wallet Monitor — Solana RPC + Pump.fun WebSocket for live token tracking
- AI Integration — 3-provider cascade (Workers AI → G4F Dev → Gemini) with per-key rate limiting
- Admin Dashboard — Real-time WebSocket feeds, analytics, full CRUD for bot config
- Discord Bot — 29 slash commands, self-assignable roles, moderation, reactive presence
- Real-time Events — WebSocket feeds via Durable Objects for live overlay updates
- Free Tier Hardened — KV namespace splits, D1 batch optimization, DO alarm scheduling
Quick Links
- Architecture — System design and communication patterns
- Tech Stack — All technologies used
- Getting Started — Run the project locally