https://github.com/aifordiscord/astracord
astracord and advanced Discord bot
https://github.com/aifordiscord/astracord
bot discord discord-api discord-bot discord-js discordbot discordbotsite discordjs discordjs-v14
Last synced: 5 months ago
JSON representation
astracord and advanced Discord bot
- Host: GitHub
- URL: https://github.com/aifordiscord/astracord
- Owner: aifordiscord
- License: mit
- Created: 2025-06-21T03:47:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-21T04:38:55.000Z (about 1 year ago)
- Last Synced: 2025-06-21T05:19:45.702Z (about 1 year ago)
- Topics: bot, discord, discord-api, discord-bot, discord-js, discordbot, discordbotsite, discordjs, discordjs-v14
- Language: JavaScript
- Homepage: https://dsc.gg/astracord
- Size: 849 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# AstraCord
A powerful, feature-rich Discord bot with 47+ commands across 4 categories
[](https://dsc.gg/aifordiscord)
[](https://dsc.gg/astracord)
[](https://github.com/aifordiscord/astracord)
[](https://nodejs.org)
[](https://discord.js.org)
## ⨠Features
AstraCord is a comprehensive Discord bot built with modern architecture and advanced features:
- **đŽ Interactive Games** - Play games like Blackjack, Connect 4, Snake, Memory, and more
- **đĄī¸ Advanced Moderation** - Complete moderation suite with warnings, bans, role management
- **đ Fun Commands** - Entertainment commands including memes, jokes, trivia, and utilities
- **đ Server Management** - Server info, user info, statistics, and administration tools
- **đ§ Advanced Help System** - Interactive navigation with pagination and category browsing
- **đ¨ Custom Emoji Integration** - Rich embeds with custom emojis stored in JSON format
- **đ Professional Logging** - Comprehensive logging system for monitoring and debugging
## đ Quick Start
### Prerequisites
- Node.js 18 or higher
- Discord Bot Token
- Discord Application Client ID
### YouTube video toutoreal
[Video](https://youtu.be/Gwtg-rvt76k?si=WiTkpZzrG1E4SC5r)
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/aifordiscord/astracord.git
cd astracord
```
2. **Install dependencies**
```bash
npm install
```
3. **Configure environment variables**
```bash
# Create .env file and add:
DISCORD_TOKEN=your_bot_token_here
CLIENT_ID=your_application_client_id_here
```
4. **Deploy slash commands**
```bash
node deploy-commands.js
```
5. **Start the bot**
```bash
npm start
```
## đ Command Categories
### đŽ Games (11 Commands)
Interactive games with button controls and advanced gameplay mechanics:
- `blackjack` - Play Blackjack against the dealer
- `connect4` - Play Connect 4 against the bot
- `hangman` - Word guessing game with multiple difficulties
- `mathquiz` - Test your math skills with customizable difficulty
- `memory` - Memory matching game with emojis
- `numberguess` - Guess the secret number
- `rps` - Rock, Paper, Scissors with the bot
- `snake` - Classic Snake game using Discord buttons
- `tictactoe` - Play Tic-Tac-Toe against the bot
- `trivia` - Multiple choice trivia questions
- `wordchain` - Collaborative word chain game
### đĄī¸ Moderation (13 Commands)
Comprehensive moderation tools with permission checks:
- `ban` / `unban` - Ban and unban members
- `kick` - Remove members from the server
- `mute` / `unmute` - Timeout management
- `warn` / `warnings` - Warning system
- `clear` / `purge` - Advanced message deletion
- `role` - Role management for users
- `nickname` - Nickname management
- `slowmode` - Channel slowmode control
- `lockdown` - Channel lockdown functionality
### đ Fun (12 Commands)
Entertainment and utility commands:
- `8ball` - Magic 8-ball predictions
- `coinflip` - Flip a coin with animations
- `joke` / `meme` - Random jokes and memes
- `quote` / `facts` - Inspirational quotes and facts
- `riddle` - Brain teasers and riddles
- `roast` / `compliment` - Light-hearted roasts and compliments
- `roll` - Customizable dice rolling
- `choose` - Decision maker
- `wouldyourather` - Interactive would you rather questions
### đ General (11 Commands)
Information and utility commands:
- `help` - Advanced interactive help system
- `ping` - Latency and API response time
- `serverinfo` - Detailed server information
- `userinfo` - User profile information
- `avatar` - High-quality avatar display
- `botinfo` - Bot statistics and information
- `stats` - Detailed bot and server statistics
- `uptime` - Bot uptime tracking
- `roles` - Server role information
- `emojis` - Custom emoji display
- `invite` - Bot invite link with permissions
## đī¸ Architecture
AstraCord features a professional modular architecture:
```
astracord/
âââ commands/ # Command modules organized by category
â âââ fun/ # Entertainment commands
â âââ games/ # Interactive game commands
â âââ general/ # Information and utility commands
â âââ moderation/ # Server moderation tools
âââ events/ # Discord.js event handlers
âââ handlers/ # Command and event loading systems
âââ utils/ # Utility classes and helpers
âââ data/ # JSON data storage (emojis, etc.)
âââ logs/ # Application logs
```
### Key Features:
- **Modular Command System** - Easy to extend and maintain
- **Advanced Error Handling** - Comprehensive error catching and logging
- **Custom Embed Builder** - Consistent styling across all commands
- **Pagination System** - Interactive navigation for large datasets
- **Permission Management** - Proper permission checking for all commands
- **Cooldown System** - Rate limiting to prevent spam
- **Professional Logging** - File-based logging with rotation
## đ§ Configuration
### Environment Variables
```env
DISCORD_TOKEN=your_bot_token_here
CLIENT_ID=your_application_client_id_here
```
### Custom Emoji Configuration
Edit `data/emojis.json` to customize emojis used throughout the bot:
```json
{
"success": "â
",
"error": "â",
"info": "âšī¸",
"warning": "â ī¸",
"loading": "âŗ"
}
```
## đ¤ Contributing
We welcome contributions! Please follow these steps:
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## đ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## đ Support
- **Support Server**: [Join our Discord](https://dsc.gg/aifordiscord)
- **Bot Invite**: [Add AstraCord to your server](https://dsc.gg/astracord)
- **Issues**: [Report bugs on GitHub](https://github.com/aifordiscord/astracord/issues)
## đ¤ Development Credits
AstraCord was developed using advanced AI assistance including:
- **ChatGPT-4o** - Core architecture and command development
- **DeepSeek** - Advanced algorithm implementation
- **Claude** - Code optimization and documentation
- **Replit Agent** - Error resolution and debugging
*This collaborative approach between human creativity and AI assistance resulted in a robust, feature-rich Discord bot.*
## đ Statistics
- **Total Commands**: 47
- **Categories**: 4
- **Interactive Games**: 11
- **Moderation Tools**: 13
- **Lines of Code**: 4000+
---
