BeliX - Discord Bot

A comprehensive Discord bot designed to enhance community engagement with automated features, gamification, and educational content delivery.

🌟 Features

📚 Educational Content

Daily Programming Questions - Browse 129 programming questions with difficulty levels and explanations
Daily Terminology - Automated daily tech term posting to keep members learning
Question Browsing - Paginated navigation through questions with /dailyquestions command

🎮 Gamification

Points System - Members earn points through interactions and achievements
Leaderboard - Real-time leaderboard showing top 10 performers with pagination
Personal Statistics - Check your personal points and last activity with /mypoints

👥 Community Management

Member Synchronization - Automatic member data sync with Discord roles and metadata
Welcome Messages - Personalized welcome messages for new members
Birthday Announcements - Automated birthday announcements for community members
Progress Updates - Track member progress and milestones

⏰ Scheduling & Automation

Scheduled Reminders - Customizable reminders for important events
Daily Posts - Automated posting of terminologies and questions at scheduled times
Auto Synchronization - Periodic member data synchronization

🛠️ Admin Features

Channel Setup - Quick setup commands for bot channels and permissions
Database Management - Integrated SQLite database for data persistence
Slash Commands - Modern Discord slash commands for all functionality
Permission Control - Role-based access control for commands

🔄 Automation Features

Daily Automation

Daily Terminology Poster - Posts a new terminology term every day at 8:00 PM
Daily Question Updates - Tracks and cycles through programming questions
Scheduled Reminders - Automatically sends reminders at configured times

Real-Time Automation

Member Sync - Automatically syncs member data when they join/leave
Points Tracking - Tracks and updates member points automatically
Leaderboard Updates - Real-time leaderboard calculations

Background Tasks

Message Handlers - Processes all member interactions
Activity Logging - Logs all member activities for analytics
State Management - Maintains synchronization state between Discord and database

📋 Slash Commands

Command	Description	Usage
`/help`	Show all available commands	`/help`
`/leaderboard`	Display top 10 users with pagination	`/leaderboard`
`/mypoints`	Show your personal points and statistics	`/mypoints`
`/terminology`	Show today's tech terminology	`/terminology`
`/next`	Preview the next terminology	`/next`
`/prev`	Preview the previous terminology	`/prev`
`/dailyquestions`	Browse 129 programming questions	`/dailyquestions`

📦 Project Structure

BeliX/
├── index.js                          # Main bot entry point
├── package.json                      # Dependencies and metadata
├── README.md                         # This file
│
├── database/
│   ├── db.js                        # Database operations (SQLite)
│   ├── insertMembers.js             # Member data insertion
│   └── schema.sql                   # Database schema
│
├── json/
│   ├── dailyQuestion.json           # Daily coding questions
│   └── terminologies.json           # Daily tech terminologies
│
├── features/
│   ├── birthdayAnnouncement.js      # Birthday announcements
│   ├── channelSetup.js              # Channel configuration
│   ├── dailyGatheringScheduler.js   # Daily gathering coordination & tracking
│   ├── dailyQuestionPoster.js       # Question posting automation
│   ├── dailyTerminology.js          # Terminology management
│   ├── leaderboard.js               # Leaderboard display logic
│   ├── memberSync.js                # Member synchronization
│   ├── progressupdate.js            # Progress updates
│   ├── scheduledReminders.js        # Reminder scheduling
│   ├── slashCommands.js             # Slash command handlers
│   └── welcome.js                   # Welcome messages
│
├── json/
│   ├── dailyQuestion.json           # 129 programming questions (Days 1-129)
│   └── terminologies.json           # Tech terminology database
│
├── prompts/
│   └── botInstructions.txt          # Bot behavior guidelines
│
└── text/
    └── [Various text assets]        # Text resources

🚀 Installation & Setup

Prerequisites

Node.js (v16 or higher)
Discord Bot Token
SQLite3

Installation

Clone the repository
```
git clone <repository-url>
cd BeliX
```
Install dependencies
```
npm install
```

Configure environment variables Create a .env file in the root directory:

TOKEN=your_discord_bot_token
GUILD_ID=your_guild_id
DATABASE_URL=./database.db

Initialize the database

sqlite3 database.db < database/schema.sql

Start the bot
```
node index.js
```

💾 Database

The bot uses SQLite for persistent data storage with the following main tables:

Members

User ID, Username, Join Date
Role Information
Member Metadata

Points

User ID, Points Balance
Transaction History
Last Update Timestamp

Sync State

Member sync status
Last synchronization time
Sync error tracking

📊 Data Files

dailyQuestion.json

Contains 129 programming questions organized by day (Day 1-129), including:

Question title
Input example
Expected output
Detailed explanation
Formula (where applicable)

terminologies.json

Tech terminology database with:

Term name
Definition
Category
Current index pointer

🔐 Permissions & Security

Commands use Discord's permission system
Role-based access control for admin features
Secure database operations with prepared statements
Token security via environment variables
Rate limiting on API calls

🎯 Key Features Explained

Points System

Members accumulate points through:

Message interactions
Command usage
Event participation
Achievement milestones

Leaderboard

Updated in real-time
Top 10 players displayed
Pagination support for browsing
Personal rank visibility

Member Synchronization

Automatic sync on member join/leave
Periodic bulk synchronization
State tracking to prevent duplicates
Metadata preservation

Daily Terminology

Scheduled posting at 8:00 PM
Automatic rotation through terminologies
Category-based organization
Preview functionality

📈 Statistics & Metrics

The bot tracks:

Total member points
Leaderboard rankings
Daily active members
Command usage statistics
Sync success/failure rates

🛡️ Error Handling

Comprehensive error logging
Graceful fallbacks for API failures
Database transaction rollback on errors
User-friendly error messages
Retry mechanisms for failed operations

🔄 Update & Maintenance

Regular Updates

Daily terminology rotation
Question of the day selection
Member points synchronization
Leaderboard recalculation

Maintenance Tasks

Database optimization
Old data archival
Sync state cleanup
Cache management

📝 Configuration

Bot Instructions

Edit prompts/botInstructions.txt to customize bot behavior

Questions

Add new questions to json/dailyQuestion.json following the format:

{
  "Day": 1,
  "Question": "Question title",
  "Input": "Sample input",
  "Output": "Expected output",
  "Explain": "Explanation",
  "Formula": "Optional formula"
}

Terminologies

Add new terms to json/terminologies.json

Reminders

Configure reminders through the bot's reminder system with time and message

🚦 Getting Started for Developers

Review the main entry point: index.js
Check slash command handlers: features/slashCommands.js
Explore database operations: database/db.js
Study automation features: features/

📞 Support & Contribution

For issues, feature requests, or contributions:

Check existing documentation
Review code comments
Follow Discord.js best practices
Test thoroughly before submitting

📜 Technology Stack

Discord.js - Discord API wrapper
SQLite3 - Database management
Node.js - Runtime environment
JSON - Data storage format

📅 Version Info

Current Version: 1.0.0
Last Updated: February 2026
Status: Active & Maintained

🎓 Questions Database

The bot includes a comprehensive 129-day programming question bank covering:

Basic Programming Concepts
Arithmetic & Logic Operations
String & Number Manipulation
Geometric Calculations
Pattern Recognition
Data Structures
Object-Oriented Programming
Advanced Algorithms

Perfect for daily learning and coding practice!

🌐 Community Features

Real-time Leaderboard - See who's leading
Personal Statistics - Track your progress
Daily Learning - 129 programming questions
Tech Insights - Daily terminology posts
Community Events - Meeting tracking & announcements

Made with ❤️ for the Community

Name		Name	Last commit message	Last commit date
.vscode		.vscode
database		database
features		features
json		json
scripts		scripts
utils		utils
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
index.js		index.js
package-lock.json		package-lock.json
package.json		package.json

Latest commit

History

Folders and files

Repository files navigation