{"id":29744628,"url":"https://github.com/kynuxdev/discord-clan-bot","last_synced_at":"2025-07-26T05:24:07.054Z","repository":{"id":303240922,"uuid":"984193415","full_name":"KynuxDev/Discord-Clan-Bot","owner":"KynuxDev","description":"A sophisticated Discord bot that automatically detects users with Discord's clan tag feature and manages role assignments with advanced analytics and statistics tracking","archived":false,"fork":false,"pushed_at":"2025-07-06T14:05:13.000Z","size":37,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-06T15:20:43.804Z","etag":null,"topics":["clan-tag","discord-bot","discord-clan","discord-clan-badge","discord-clan-bot","discord-tag","discord-tag-bot","kynuxdev","nodejs","role-manager"],"latest_commit_sha":null,"homepage":"https://discord.gg/NEaAFUvb9k","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KynuxDev.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"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-05-15T14:38:07.000Z","updated_at":"2025-07-06T14:05:16.000Z","dependencies_parsed_at":"2025-07-06T15:33:11.530Z","dependency_job_id":null,"html_url":"https://github.com/KynuxDev/Discord-Clan-Bot","commit_stats":null,"previous_names":["kynuxdev/discord-clan-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KynuxDev/Discord-Clan-Bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscord-Clan-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscord-Clan-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscord-Clan-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscord-Clan-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KynuxDev","download_url":"https://codeload.github.com/KynuxDev/Discord-Clan-Bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscord-Clan-Bot/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267122921,"owners_count":24039448,"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","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clan-tag","discord-bot","discord-clan","discord-clan-badge","discord-clan-bot","discord-tag","discord-tag-bot","kynuxdev","nodejs","role-manager"],"created_at":"2025-07-26T05:24:01.998Z","updated_at":"2025-07-26T05:24:07.043Z","avatar_url":"https://github.com/KynuxDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eDiscord Clan Tag Role Bot\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node.js-v18+-green.svg\" alt=\"Node.js Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/discord.js-v14-blue.svg\" alt=\"Discord.js Version\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-All%20Rights%20Reserved-red.svg\" alt=\"License\"\u003e\n  \u003ca href=\"README.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/Türkçe-Dokümantasyon-red.svg\" alt=\"Turkish Documentation\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eA modern Discord bot that detects users with Discord's new clan tag feature and automatically assigns them roles.\u003c/b\u003e\n\u003c/p\u003e\n\u003cimg src=\"https://i.postimg.cc/xT5bnVXG/image.png\" alt=\"Görsel 1\"\u003e\n\u003cimg src=\"https://i.postimg.cc/d0k7274n/image.png\" alt=\"Görsel 2\"\u003e\n## 📋 Features\n\n- ✅ **Automatic Tag Checking**: Checks users' clan tags every 10 seconds\n- 🔄 **Real-time Updates**: Automatically adds/removes roles when users add/change their tags\n- 🔔 **Detailed Notifications**: Reports all actions to a log channel using modern embeds\n- 📊 **Statistics System**: Visualizes role changes, tagged member ratios, and other data\n- 💬 **Dual Command System**: Supports both slash commands (`/stats`) and prefix commands (`!stats`)\n- 💾 **Database Integration**: Permanently stores all statistics\n- 🔒 **Secure**: Protects sensitive data by storing it in the .env file\n\n## 🚀 Installation\n\n### Requirements\n\n- Node.js (v18.0.0 or higher)\n- Discord Bot Token\n\n### Steps\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/kynuxdev/discord-tag-bot.git\n   cd discord-tag-bot\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Copy the `.env.example` file to `.env` and add the necessary information:\n   ```bash\n   cp .env.example .env\n   ```\n\n4. Edit the `.env` file:\n   ```\n   BOT_TOKEN=your_discord_bot_token\n   CLIENT_ID=your_client_id\n   GUILD_ID=your_server_id\n   TAG_ROLE_ID=role_id_to_assign\n   TARGET_TAG=OHIO\n   LOG_CHANNEL_ID=log_channel_id\n   PREFIX=!\n   ```\n\n5. Start the bot:\n   ```bash\n   node index.js\n   ```\n\n## 🤖 Creating a Discord Bot\n\n1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)\n2. Click \"New Application\" and enter a name for your bot\n3. Go to the \"Bot\" tab and click \"Add Bot\"\n4. Create a token with \"Reset Token\" and copy it\n5. Enable the following permissions in bot settings:\n   - SERVER MEMBERS INTENT\n   - MESSAGE CONTENT INTENT\n6. In the \"OAuth2 \u003e URL Generator\" section:\n   - Scopes: `bot`, `applications.commands`\n   - Permissions: `Manage Roles`, `Read Messages/View Channels`, `Send Messages`\n7. Add the bot to your server using the generated URL\n\n## 📈 Statistics\n\nThe bot tracks the following statistics, which you can view with the `/stats` or `!stats` commands:\n\n- Number of tagged and untagged members\n- Total number of checks\n- Role addition/removal counts\n- Number of members who joined the server\n- Tagged member ratio (with visual graph)\n- Most used commands\n\n## 🔧 Customization\n\nTo change the target tag, update the `TARGET_TAG` value in the `.env` file. Many other settings can be customized directly in the code.\n\n## 🌎 Language Support\n\nThis bot was originally developed for Turkish users, but you can use it internationally with these English instructions. If you want to translate the bot interface and commands to a different language, you can adapt the relevant files to your language.\n\n## 📝 Notes\n\n- Since Discord's clan tag feature is new, there may be changes in the API usage. In this case, the code may need to be updated.\n- Make sure the bot has a role with \"Manage Roles\" permission for it to work most efficiently.\n- The bot interface is currently in Turkish. You can translate the messages in the code files if needed.\n\n## 📄 License\n\nAll Rights Reserved \u0026copy; 2025 [KynuxDev](https://github.com/kynuxdev)\n\nThis code and associated documentation files cannot be used, copied, modified, distributed, or sold without the express permission of the software owner. For more information, please see the `LICENSE` file.\n\n---\n\n*Note: This bot was originally developed for Turkish users. If you need to use it in another language, you can modify the code to suit your needs or use translation tools to understand the interface.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Fdiscord-clan-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkynuxdev%2Fdiscord-clan-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Fdiscord-clan-bot/lists"}