CancerBot - IRC Bot with Plugin System

An IRC bot for #bakedbeans on irc.libera.chat with a comprehensive plugin system and various games.

Quick Start

# Install dependencies
npm install

# Run the main bot
node botmain.js

Bot Configuration

• Server: irc.libera.chat:6667
• Nickname: cancerbot
• Channel: #bakedbeans
• Command Prefix: !

Main Files

• botmain.js - Main bot file (run this one)
• complete_irc_bot.js - Alternative bot without debug features
• bot_template.js - Template for reference
• plugin_template.js - Plugin development template

Duck Hunt Plugin (Enhanced)

The duck hunt game has been enhanced with a hunt/feed system for more engaging gameplay.

Game Mechanics

• 80% Hunt Ducks: Require !shoot or !bang to hunt
• 20% Feed Ducks: Require !feed to feed
• Persistent Scores: Scores saved to plugins/duck_hunt_scores.json
• Reaction Time: Tracked for both hunting and feeding
• Wrong Action Penalties: Using the wrong command makes the duck flee

Commands

• !shoot / !bang - Hunt aggressive ducks
• !feed - Feed hungry ducks
• !duckscore - Check your score
• !topducks - View leaderboard
• !duckstats - Show game statistics
• !stopducks - Stop duck spawning (bakedbeans only)
• !startducks - Resume duck spawning (bakedbeans only)

Duck Types

• Common: 🦆 Mallard (1pt), 🦢 Swan (2pts), 🪿 Goose (2pts)
• Rare: 🐧 Penguin (3pts), 🦜 Parrot (3pts), 🦉 Owl (4pts), 🦅 Eagle (5pts)
• Legendary: 🏆 Golden Duck (10pts), 💎 Diamond Duck (15pts), 🌟 Cosmic Duck (20pts)

Spawn Messages

• Hunt Ducks: "Quick, !shoot it!", "Someone !shoot it before it escapes!"
• Feed Ducks: "!feed it some bread!", "It looks hungry, !feed it!"

Other Games/Plugins

Casino Games (All with persistent scores)

• Coin Flip: !flip - Bet on heads/tails
• Hi-Lo: !hilo - Guess if next card is higher/lower
• Slots: !slots - Spin the slot machine
• Scratch Cards: !scratch - Virtual scratch cards

Multiplayer Games

• Pass the Pigs: !pigs - Multiplayer dice game
• Zombie Dice: !zombie - Multiplayer zombie brain collecting
• Quiplash: !quiplash - Answer prompts and vote

Text/Chat Plugins

• Babble: !babble - Generate text from learned patterns
• Story: !story - Collaborative story writing
• Emojify: !emojify - Convert text to emojis
• Conspiracy: !conspiracy - Generate conspiracy theories
• Drunk Historian: !history - Historical "facts" with varying sobriety

Utility

• Basic: !ping, !help, !time
• Combo: Track message combos in channels
• Bot Reply: Responds to other bots

Admin Commands

• !reloadplugins - Reload all plugins (megasconed only)

Plugin Development

See plugin_template.js for creating new plugins. Plugins support:

• Command registration
• Event handling (onMessage, etc.)
• Persistent storage
• Initialization and cleanup

Recent Changes

Duck Hunt Enhancements (Latest)

• Added hunt/feed mechanic (80% hunt, 20% feed)
• New !feed command for feeding ducks
• Wrong action penalties for immersion
• Persistent score storage
• Channel control commands (!stopducks/!startducks)

Bot Structure Cleanup

• Renamed debug_bot.js to botmain.js as main bot
• Removed Windows Zone.Identifier files
• Organized file structure for clarity

Technical Notes

• Uses Node.js with net module for IRC connection
• SQLite3 for data persistence in some plugins
• Plugin system with hot-reloading capability
• Comprehensive error handling and logging
• Automatic reconnection on disconnect

File Structure

cancerbot/
├── botmain.js              # Main bot file
├── complete_irc_bot.js     # Alternative bot
├── bot_template.js         # Bot template
├── plugin_template.js     # Plugin template
├── plugins/               # Plugin directory
│   ├── duck_hunt_plugin.js
│   ├── coinflip_plugin.js
│   ├── [other plugins...]
│   ├── duck_hunt_scores.json
│   └── [other score files...]
├── package.json
└── README.md

Enjoy your holiday! 🦆🏖️