How senotron/owo-bot works
OwO Bot is a Discord game and social bot. Users issue prefix or slash commands and interact with Discord buttons and menus; command and interaction handlers produce game results, profile views, or collection updates backed by persistent profiles. The main domain stages are hunting and collecting, zoo and inventory management, battles, casino and lottery games, and social/profile features. Engines implement game rules, while the database and animal catalog provide shared internal layers. The README documents broader capabilities than the sampled excerpts; links for unsampled command behavior are therefore limited to documented relationships.
Main entry points: db.js Profile database · interactionCreate.js Interaction handler · huntEngine.js Hunt engine · battleEngine.js Battle engine
Components 23
Discord entry points
- Message handler
src/events/messageCreate.js - Interaction handler
src/events/interactionCreate.js - Bot startup
src/index.js
Commands and features
- Hunt command
src/commands/hunt.js - Zoo and selling
src/commands/zoo.js - Inventory and shop
src/commands/inventory.js - Battle and team
src/commands/battle.js - Slots command
src/commands/slots.js - Blackjack command
src/commands/blackjack.js - Coinflip command
src/commands/coinflip.js - Lottery command
src/commands/lottery.js - Economy and social
src/commands/economy.js - Profile and marriage
src/commands/profile.js - Fun and OwOify
src/commands/fun.js - Help command
src/commands/help.js - Stats command
src/commands/stats.js
Game systems
- Hunt engine
src/systems/huntEngine.js - Battle engine
src/systems/battleEngine.js - Casino engine
src/systems/casinoEngine.js
Shared services
- Animal catalog
src/systems/animals.js - Profile database
src/database/db.js - Profile card renderer
src/utils/canvasCard.js
Other components
- Discord user
Connections 29
- Discord user → Message handler: sends prefix command
README.md - Discord user → Interaction handler: uses slash command
README.md - Discord user → Interaction handler: uses components
README.md - Hunt command → Hunt engine: runs hunt
src/commands/hunt.js - Hunt engine → Animal catalog: selects animal
src/systems/huntEngine.js - Hunt engine → Profile database: updates rewards
src/systems/huntEngine.js - Interaction handler → Hunt engine: runs hunt again
src/events/interactionCreate.js - Zoo and selling → Profile database: reads collection
src/commands/zoo.js - Zoo and selling → Animal catalog: looks up animals
src/commands/zoo.js - Interaction handler → Zoo and selling: opens zoo view
src/events/interactionCreate.js - Inventory and shop → Profile database: manages inventory
src/commands/inventory.js - Inventory and shop → Animal catalog: uses animal data
src/commands/inventory.js - Battle and team → Battle engine: runs battle
src/commands/battle.js - Battle engine → Animal catalog: resolves combatants
src/systems/battleEngine.js - Battle engine → Profile database: reads team and rewards
src/systems/battleEngine.js - Interaction handler → Battle engine: runs rematch
src/events/interactionCreate.js - Slots command → Casino engine: plays slots
src/commands/slots.js - Coinflip command → Casino engine: plays coinflip
src/commands/coinflip.js - Casino engine → Profile database: updates balance
src/systems/casinoEngine.js - Interaction handler → Casino engine: replays wager
src/events/interactionCreate.js - Blackjack command → Profile database: reads and updates balance
src/commands/blackjack.js - Interaction handler → Blackjack command: handles game actions
src/events/interactionCreate.js - Lottery command → Profile database: charges tickets
src/commands/lottery.js - Economy and social → Profile database: manages economy
src/commands/economy.js - Profile and marriage → Profile database: reads and saves profile
src/commands/profile.js - Profile and marriage → Profile card renderer: renders profile card
src/commands/profile.js - Stats command → Profile database: reads statistics
- Bot startup → Message handler: registers handler
- Bot startup → Interaction handler: registers handler