BotFire
A comprehensive Discord bot built for "Il Bonfire" community server, serving as both a community hub and Twitch channel management tool. Features advanced game suggestion system with IGDB integration, Twitch schedule management with Google Calendar sync, and modern Discord Components V2 interface.
Tags
Technologies Used
Project Links
Project Details
Quick Stats
Project Overview
BotFire is a comprehensive Discord bot I created for my community Discord server "Il Bonfire". The bot serves a dual purpose: it functions as a community hub for my followers (called "viandanti") and as a powerful tool for managing my Twitch channel, making my life as a content creator significantly easier.
The project was born from my need for custom solutions tailored to my specific requirements. Rather than using generic bots, I wanted something that perfectly fits my workflow and community needs. BotFire combines user-facing features that enhance community engagement with private administrative tools that streamline content creation tasks.
The bot features two main systems: an advanced game suggestion system that uses complex IGDB API queries to fetch official and canonical games from series, and a Twitch schedule management system that provides instant CRUD operations with automatic Google Calendar synchronization—a feature that works better than Twitch's official calendar sync.
Built with modern technologies including Discord.js v14, Components V2, and multiple API integrations, BotFire represents a custom-fitted solution that I use daily. The bot is actively maintained and continues to evolve based on my needs and community feedback.
Development began on September 16, 2025, and the project was completed within approximately a month. However, BotFire is far from static—it's an ongoing project that receives regular maintenance, updates, and new features as my needs evolve and the community grows. Every time I make significant changes or improvements, I update this portfolio page to reflect the current state of the bot.
The bot has become an integral part of my content creation workflow and community management. While not all users utilize the full potential of the bot (some are hesitant to use Discord bots, even though BotFire is quite user-friendly and robust), the most popular commands like /prossima-liveand /suggerisci-gioco are used frequently by the community, demonstrating the bot's value in enhancing the Discord server experience.
Technical Highlights
Modern Architecture
Built with Discord.js v14 using ES Modules, featuring Discord's latest Components V2 (Display Components) for modern, embed-free interfaces. The codebase follows modern JavaScript best practices with proper error handling and logging.
Multi-Service Integration
Seamlessly integrates with Twitch API (Helix), IGDB API, Google Calendar API, and Firebase Firestore. Implements sophisticated synchronization patterns and handles complex data relationships across services.
Smart Caching System
Implements intelligent in-memory caching with TTL (Time To Live) and LRU (Least Recently Used) eviction strategies. Reduces API calls significantly while maintaining data freshness across user info, schedules, and categories.
Performance Optimized
Features background prefetching, component budget management for Discord's limits, and optimized API queries. The system handles complex multiquery operations efficiently and provides responsive user interactions.
Key Features
Advanced Game Suggestion System
Complex IGDB API integration that detects game collections, checks PC compatibility, and prevents duplicates. Features autocomplete search with game covers and metadata.
Twitch Schedule Management
Full CRUD operations for Twitch streaming schedules with instant Google Calendar sync. Beautiful Components V2 interface with month navigation and interactive actions.
Google Calendar Integration
Automatic bidirectional synchronization between Twitch schedules and Google Calendar. Better than Twitch's official sync, with proper recurring event support.
Community Features
User-friendly commands for checking next streams, viewing game suggestions with vote counts, and accessing community information. Public and private feature separation.
Permission System
5-level permission hierarchy (Everyone, Member, Moderator, Admin, Owner) with role-based detection and dynamic permission management via commands.
Modern Discord Interface
Uses Discord Components V2 (Display Components) for modern, embed-free messages. Interactive buttons, modals, select menus, and beautiful visual displays.
Why I Built BotFire
Custom Solutions for My Needs
I prefer creating custom solutions tailored to my specific requirements rather than using generic tools. BotFire is custom-fitted to my workflow and community needs, making it more efficient than off-the-shelf solutions.
Official Game Suggestion System
I needed an official way for users to suggest games. The game suggestion feature is top-notch, using complicated queries to get all official and canonical games from series or standalone games, then saving them in Firebase Firestore with easy command-based display.
Better Twitch Schedule Management
The official Twitch way to sync schedule and calendar is half broken. BotFire provides instant CRUD operations for my Twitch schedule with reliable Google Calendar synchronization, allowing for better handling through instant viewing of schedule fragments and instant actions.
Community Hub Integration
As a content creator, I use my Discord "Il Bonfire" as a meeting point for my users. The bot provides both user-facing features for community engagement and private features for administrative tasks, creating a balanced tool for both community and creator needs.
Other Side Projects
Arise Crossover Tools (Discord Bot)
A multi-guild Discord bot designed to fetch and relay official game information to the Arise Crossover Tools website, featuring guild-specific configurations and automated role management.
LegitBot
A Discord bot designed for Pet Simulator 99 clans to track diamond donations and manage clan activities. Built for the LEGIT clan, it featured real-time donation tracking, automated announcements, and clan management tools.
Tik2Insta
A Telegram bot that automatically converts TikTok videos to Instagram posts, preserving metadata like descriptions and tags while crediting the original author. Built as a proof of concept for creating an Instagram profile focused on cute animals.