Kojima Bot brings a Metal Gear-themed catch game to your Discord server. Wild entities appear on a timer, and members race to grab them by typing a phrase or clicking Catch. Pair it with casino minigames, a full achievement system, auto-meme slash commands, and social link-fixup — all running locally on Bun with a zero-config SQLite database.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/noskap/kojima-bot/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Install, configure, and get your first spawn in under five minutes.
Configuration
Every environment variable, with defaults and examples.
Spawn Game
How rarity weights, spawn timers, and catch interactions work.
Casino
Slots, coin flip, and roulette — with a shared chip economy.
Achievements
20+ unlockable milestones for catches, gifting, and gambling.
Meme Commands
Auto-generated slash commands from your own image files.
How it works
Set your environment
Copy
.env.example to .env and fill in your Discord token, client ID, and guild ID.Key features
22 Spawn Rarities
From Stylish (common) to Weed (ultra-rare) — each with unique artwork and a weighted probability.
Chip Economy
Players earn chips by catching spawns and spend them at the casino. Balances persist per user per guild.
Full Re-skinning
Rename the entity, swap all artwork, and tune spawn intervals without touching any TypeScript.
Custom Commands
Drop a
.ts file into src/commands/custom/ and it loads automatically — no registration needed.Kojima Bot is licensed under the AGPL-3.0 license. If you modify and distribute it, you must share your source changes under the same license.