Skip to main content
Jill Stingray Hero

​
Time to mix drinks and change lives

Jill Stingray is a feature-rich Discord bot inspired by the cyberpunk bartending visual novel VA-11 HALL-A. Serve authentic cocktails from TheCocktailDB, challenge your friends to Geoguessr matches, manage custom roles, and bring the neon-soaked atmosphere of Glitch City to your server.

​
Key Features

Get Started

Install and configure Jill Stingray in minutes with Docker or npm

Drink Mixing

Mix VA-11 HALL-A specials and real-world cocktails with dynamic animations

Geoguessr Game

Play competitive global Geoguessr with interactive maps and live scoring

Command Reference

Browse the complete command library with usage examples

​
What Makes Jill Stingray Special?

Serves all the iconic drinks from the game with original recipes, descriptions, and images. Each special drink includes flavor profiles, pricing, and the signature VA-11 HALL-A presentation style.
Integrated with TheCocktailDB API to serve thousands of real-world cocktails with step-by-step mixing instructions, ingredient lists, and photos.
Full-featured Geoguessr implementation using Mapillary street imagery. Supports multiple rounds, custom time limits, and live scoring with distance calculations.
Custom role management, timed mutes, permission systems, and comprehensive audit logging. Includes activity tracking and regular status rewards.
Powered by Eris (Discord.js alternative), PostgreSQL for persistence, Supabase for file storage, and Docker for easy deployment.

​
Tech Stack

Jill Stingray is built with:
  • Eris - Lightweight Discord API library
  • PostgreSQL - Primary database for persistence
  • Supabase - Cloud storage for images and assets
  • Node.js 24 - Latest LTS runtime
  • Canvas - Dynamic image generation for maps and palettes
  • Mapillary API - Street-level imagery for Geoguessr
  • TheCocktailDB - Real cocktail recipes and data
Jill Stingray requires Discord bot permissions for message content, guild members, and message reactions. See Installation for setup details.

​
Ready to Start?

Installation Guide

Set up Jill Stingray with Docker or npm

Configuration

Configure environment variables and integrations
New to VA-11 HALL-A? The bot works great even if you haven’t played the game. All cocktail features are fully functional with or without knowledge of the source material.

Build docs developers (and LLMs) love

Get started for freeTalk to us