{"id":28950522,"url":"https://github.com/aifordiscord/astracord","last_synced_at":"2026-01-20T16:34:07.718Z","repository":{"id":300331967,"uuid":"1005901078","full_name":"aifordiscord/astracord","owner":"aifordiscord","description":"astracord and advanced Discord bot ","archived":false,"fork":false,"pushed_at":"2025-06-21T04:38:55.000Z","size":869,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T05:19:45.702Z","etag":null,"topics":["bot","discord","discord-api","discord-bot","discord-js","discordbot","discordbotsite","discordjs","discordjs-v14"],"latest_commit_sha":null,"homepage":"https://dsc.gg/astracord","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aifordiscord.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T03:47:16.000Z","updated_at":"2025-06-21T04:44:30.000Z","dependencies_parsed_at":"2025-06-21T05:30:22.436Z","dependency_job_id":null,"html_url":"https://github.com/aifordiscord/astracord","commit_stats":null,"previous_names":["aifordiscord/astracord"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/aifordiscord/astracord","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aifordiscord%2Fastracord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aifordiscord%2Fastracord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aifordiscord%2Fastracord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aifordiscord%2Fastracord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aifordiscord","download_url":"https://codeload.github.com/aifordiscord/astracord/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aifordiscord%2Fastracord/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261491786,"owners_count":23166671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","discord","discord-api","discord-bot","discord-js","discordbot","discordbotsite","discordjs","discordjs-v14"],"created_at":"2025-06-23T14:01:07.589Z","updated_at":"2026-01-20T16:34:07.704Z","avatar_url":"https://github.com/aifordiscord.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# AstraCord\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://dsc.gg/astracord\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://watchbot.cwkbot.fun/api/badge/1384948025721360394\" alt=\"AstraCord status\" width=\"600\"/\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n  \n  \u003cp\u003e\u003cstrong\u003eA powerful, feature-rich Discord bot with 47+ commands across 4 categories\u003c/strong\u003e\u003c/p\u003e\n  \n  [![Discord](https://img.shields.io/discord/1378278142698848276?color=7289da\u0026logo=discord\u0026logoColor=white\u0026label=Support%20Server)](https://dsc.gg/aifordiscord)\n  [![Bot Invite](https://img.shields.io/badge/Invite%20Bot-AstraCord-7289da?logo=discord\u0026logoColor=white)](https://dsc.gg/astracord)\n  [![GitHub Stars](https://img.shields.io/github/stars/aifordiscord/astracord?style=social)](https://github.com/aifordiscord/astracord)\n  [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org)\n  [![Discord.js](https://img.shields.io/badge/Discord.js-14.x-blue.svg)](https://discord.js.org)\n\u003c/div\u003e\n\n## ✨ Features\n\nAstraCord is a comprehensive Discord bot built with modern architecture and advanced features:\n\n- **🎮 Interactive Games** - Play games like Blackjack, Connect 4, Snake, Memory, and more\n- **🛡️ Advanced Moderation** - Complete moderation suite with warnings, bans, role management\n- **🎭 Fun Commands** - Entertainment commands including memes, jokes, trivia, and utilities\n- **📊 Server Management** - Server info, user info, statistics, and administration tools\n- **🔧 Advanced Help System** - Interactive navigation with pagination and category browsing\n- **🎨 Custom Emoji Integration** - Rich embeds with custom emojis stored in JSON format\n- **📝 Professional Logging** - Comprehensive logging system for monitoring and debugging \n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 18 or higher\n- Discord Bot Token\n- Discord Application Client ID\n### YouTube video toutoreal \n[Video](https://youtu.be/Gwtg-rvt76k?si=WiTkpZzrG1E4SC5r) \n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/aifordiscord/astracord.git\n   cd astracord\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Configure environment variables**\n   ```bash\n   # Create .env file and add:\n   DISCORD_TOKEN=your_bot_token_here\n   CLIENT_ID=your_application_client_id_here\n   ```\n\n4. **Deploy slash commands**\n   ```bash\n   node deploy-commands.js\n   ```\n\n5. **Start the bot**\n   ```bash\n   npm start\n   ```\n\n## 📋 Command Categories\n\n### 🎮 Games (11 Commands)\nInteractive games with button controls and advanced gameplay mechanics:\n- `blackjack` - Play Blackjack against the dealer\n- `connect4` - Play Connect 4 against the bot\n- `hangman` - Word guessing game with multiple difficulties\n- `mathquiz` - Test your math skills with customizable difficulty\n- `memory` - Memory matching game with emojis\n- `numberguess` - Guess the secret number\n- `rps` - Rock, Paper, Scissors with the bot\n- `snake` - Classic Snake game using Discord buttons\n- `tictactoe` - Play Tic-Tac-Toe against the bot\n- `trivia` - Multiple choice trivia questions\n- `wordchain` - Collaborative word chain game\n\n### 🛡️ Moderation (13 Commands)\nComprehensive moderation tools with permission checks:\n- `ban` / `unban` - Ban and unban members\n- `kick` - Remove members from the server\n- `mute` / `unmute` - Timeout management\n- `warn` / `warnings` - Warning system\n- `clear` / `purge` - Advanced message deletion\n- `role` - Role management for users\n- `nickname` - Nickname management\n- `slowmode` - Channel slowmode control\n- `lockdown` - Channel lockdown functionality\n\n### 🎭 Fun (12 Commands)\nEntertainment and utility commands:\n- `8ball` - Magic 8-ball predictions\n- `coinflip` - Flip a coin with animations\n- `joke` / `meme` - Random jokes and memes\n- `quote` / `facts` - Inspirational quotes and facts\n- `riddle` - Brain teasers and riddles\n- `roast` / `compliment` - Light-hearted roasts and compliments\n- `roll` - Customizable dice rolling\n- `choose` - Decision maker\n- `wouldyourather` - Interactive would you rather questions\n\n### 📊 General (11 Commands)\nInformation and utility commands:\n- `help` - Advanced interactive help system\n- `ping` - Latency and API response time\n- `serverinfo` - Detailed server information\n- `userinfo` - User profile information\n- `avatar` - High-quality avatar display\n- `botinfo` - Bot statistics and information\n- `stats` - Detailed bot and server statistics\n- `uptime` - Bot uptime tracking\n- `roles` - Server role information\n- `emojis` - Custom emoji display\n- `invite` - Bot invite link with permissions\n\n## 🏗️ Architecture\n\nAstraCord features a professional modular architecture:\n\n```\nastracord/\n├── commands/           # Command modules organized by category\n│   ├── fun/           # Entertainment commands\n│   ├── games/         # Interactive game commands\n│   ├── general/       # Information and utility commands\n│   └── moderation/    # Server moderation tools\n├── events/            # Discord.js event handlers\n├── handlers/          # Command and event loading systems\n├── utils/             # Utility classes and helpers\n├── data/              # JSON data storage (emojis, etc.)\n└── logs/              # Application logs\n```\n\n### Key Features:\n- **Modular Command System** - Easy to extend and maintain\n- **Advanced Error Handling** - Comprehensive error catching and logging\n- **Custom Embed Builder** - Consistent styling across all commands\n- **Pagination System** - Interactive navigation for large datasets\n- **Permission Management** - Proper permission checking for all commands\n- **Cooldown System** - Rate limiting to prevent spam\n- **Professional Logging** - File-based logging with rotation\n\n## 🔧 Configuration\n\n### Environment Variables\n```env\nDISCORD_TOKEN=your_bot_token_here\nCLIENT_ID=your_application_client_id_here\n```\n\n### Custom Emoji Configuration\nEdit `data/emojis.json` to customize emojis used throughout the bot:\n```json\n{\n  \"success\": \"✅\",\n  \"error\": \"❌\",\n  \"info\": \"ℹ️\",\n  \"warning\": \"⚠️\",\n  \"loading\": \"⏳\"\n}\n```\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **Support Server**: [Join our Discord](https://dsc.gg/aifordiscord)\n- **Bot Invite**: [Add AstraCord to your server](https://dsc.gg/astracord)\n- **Issues**: [Report bugs on GitHub](https://github.com/aifordiscord/astracord/issues)\n\n## 🤖 Development Credits\n\nAstraCord was developed using advanced AI assistance including:\n- **ChatGPT-4o** - Core architecture and command development\n- **DeepSeek** - Advanced algorithm implementation\n- **Claude** - Code optimization and documentation\n- **Replit Agent** - Error resolution and debugging\n\n*This collaborative approach between human creativity and AI assistance resulted in a robust, feature-rich Discord bot.*\n\n## 📊 Statistics\n\n- **Total Commands**: 47\n- **Categories**: 4\n- **Interactive Games**: 11\n- **Moderation Tools**: 13\n- **Lines of Code**: 4000+\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMade with ❤️ by the AiForDiscord team\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://dsc.gg/astracord\"\u003eInvite Bot\u003c/a\u003e •\n    \u003ca href=\"https://dsc.gg/aifordiscord\"\u003eSupport Server\u003c/a\u003e •\n    \u003ca href=\"https://github.com/aifordiscord/astracord\"\u003eGitHub\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n![views](https://2ac61851-9e32-424b-aa5b-be6f88cdc885-00-km60sh0zr7fs.worf.replit.dev/api/badge/aifordiscord/astracord/views?style=glow)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faifordiscord%2Fastracord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faifordiscord%2Fastracord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faifordiscord%2Fastracord/lists"}