{"id":29744627,"url":"https://github.com/kynuxdev/discordplus-bykynux","last_synced_at":"2025-07-30T09:02:49.591Z","repository":{"id":306044932,"uuid":"1024796493","full_name":"KynuxDev/DiscordPlus-ByKynux","owner":"KynuxDev","description":"🌐 DiscordPlus - Complete Minecraft-Discord Integration | Account verification, permission sync, chat bridge, statistics \u0026 voting system","archived":false,"fork":false,"pushed_at":"2025-07-23T09:28:32.000Z","size":106,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-23T11:30:35.309Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/KynuxDev.png","metadata":{"files":{"readme":"README.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-07-23T09:02:58.000Z","updated_at":"2025-07-23T10:16:34.000Z","dependencies_parsed_at":"2025-07-23T11:30:44.683Z","dependency_job_id":"a195ae63-6ee9-49ea-8111-a2ea8acd28eb","html_url":"https://github.com/KynuxDev/DiscordPlus-ByKynux","commit_stats":null,"previous_names":["kynuxdev/discordplus-bykynux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/KynuxDev/DiscordPlus-ByKynux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscordPlus-ByKynux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscordPlus-ByKynux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscordPlus-ByKynux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscordPlus-ByKynux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KynuxDev","download_url":"https://codeload.github.com/KynuxDev/DiscordPlus-ByKynux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FDiscordPlus-ByKynux/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":[],"created_at":"2025-07-26T05:23:56.797Z","updated_at":"2025-07-26T05:24:01.504Z","avatar_url":"https://github.com/KynuxDev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DiscordPlus\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge\u0026logo=discord\u0026logoColor=white)\r\n![Minecraft](https://img.shields.io/badge/Minecraft-62B47A?style=for-the-badge\u0026logo=minecraft\u0026logoColor=white)\r\n![Java](https://img.shields.io/badge/Java-ED8B00?style=for-the-badge\u0026logo=java\u0026logoColor=white)\r\n\r\n**🔗 Gelişmiş Minecraft-Discord Entegrasyon Plugin'i**\r\n\r\n*Discord Bot ile hesap eşleme, rol senkronizasyonu, chat köprüsü ve kapsamlı istatistik sistemi*\r\n\r\n[![Version](https://img.shields.io/badge/version-1.0-blue.svg)](https://github.com/KynuxDev/DiscordPlus-ByKynux)\r\n[![Minecraft](https://img.shields.io/badge/minecraft-1.16.5+-green.svg)](https://www.spigotmc.org/)\r\n[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n## 📋 İçindekiler\r\n\r\n- [📋 İçindekiler](#-i̇çindekiler)\r\n- [✨ Özellikler](#-özellikler)\r\n- [⚙️ Gereksinimler](#️-gereksinimler)\r\n- [📦 Kurulum](#-kurulum)\r\n- [🔧 Yapılandırma](#-yapılandırma)\r\n- [🎮 Komutlar](#-komutlar)\r\n- [🔑 İzinler](#-i̇zinler)\r\n- [🔌 API Entegrasyonları](#-api-entegrasyonları)\r\n- [📊 Özellik Detayları](#-özellik-detayları)\r\n- [🌐 Çok Dil Desteği](#-çok-dil-desteği)\r\n- [❓ Sıkça Sorulan Sorular](#-sıkça-sorulan-sorular)\r\n- [🐛 Hata Bildirimi](#-hata-bildirimi)\r\n- [📝 Lisans](#-lisans)\r\n\r\n---\r\n\r\n## ✨ Özellikler\r\n\r\n### 🔗 **Hesap Eşleme Sistemi**\r\n- ✅ Discord hesaplarını Minecraft hesapları ile güvenli eşleme\r\n- ✅ Benzersiz doğrulama kodu sistemi\r\n- ✅ Otomatik rol atama ve kaldırma\r\n- ✅ Whitelist entegrasyonu desteği\r\n\r\n### 🎭 **Rol \u0026 İzin Senkronizasyonu**\r\n- ✅ LuckPerms ile tam entegrasyon\r\n- ✅ Otomatik Discord rol senkronizasyonu\r\n- ✅ Öncelik tabanlı rol yönetimi\r\n- ✅ Real-time izin güncellemeleri\r\n\r\n### 💬 **Chat Köprüsü**\r\n- ✅ İki yönlü Minecraft ↔ Discord chat\r\n- ✅ Webhook desteği (zengin görünüm)\r\n- ✅ LuckPerms prefix entegrasyonu\r\n- ✅ Bot mesaj filtreleme\r\n\r\n### 📊 **İstatistik \u0026 Leaderboard Sistemi**\r\n- ✅ Oyuncu istatistikleri tracking\r\n- ✅ Dinamik leaderboard'lar\r\n- ✅ PlaceholderAPI entegrasyonu\r\n- ✅ Discord embed ile otomatik güncelleme\r\n\r\n### 🗳️ **Vote Sistemi**\r\n- ✅ Vote sitesi entegrasyonu\r\n- ✅ Otomatik ödül dağıtımı\r\n- ✅ Vote streak bonusları\r\n- ✅ Leaderboard desteği\r\n\r\n### 📢 **Bildirim Sistemi**\r\n- ✅ Oyuncu giriş/çıkış bildirimleri\r\n- ✅ Ölüm ve achievement bildirimleri\r\n- ✅ Server status güncellemeleri\r\n- ✅ Boost ödülleri\r\n\r\n### 🎯 **Gelişmiş GUI Sistemi**\r\n- ✅ İnteraktif menüler\r\n- ✅ Hesap yönetimi paneli\r\n- ✅ İstatistik görüntüleme\r\n- ✅ Admin kontrol paneli\r\n\r\n---\r\n\r\n## ⚙️ Gereksinimler\r\n\r\n| Bileşen | Minimum Sürüm | Önerilen |\r\n|---------|----------------|----------|\r\n| **Minecraft Server** | 1.16.5+ | 1.20.1+ |\r\n| **Java** | 8+ | 17+ |\r\n| **Discord Bot** | JDA 5.0+ | ✅ |\r\n| **Veritabanı** | H2 (dahili) | ✅ |\r\n\r\n### 🔌 **Opsiyonel Entegrasyonlar**\r\n- **LuckPerms** - Rol senkronizasyonu için\r\n- **Vault** - Ekonomi entegrasyonu için\r\n- **PlaceholderAPI** - Gelişmiş placeholder desteği için\r\n\r\n---\r\n\r\n## 📦 Kurulum\r\n\r\n### 1️⃣ **Plugin Kurulumu**\r\n```bash\r\n# Plugin'i sunucunuzun plugins klasörüne kopyalayın\r\ncp discordplus-1.0.jar /path/to/server/plugins/\r\n\r\n# Sunucuyu başlatın (konfigürasyon dosyaları oluşturulacak)\r\njava -jar server.jar\r\n```\r\n\r\n### 2️⃣ **Discord Bot Oluşturma**\r\n1. [Discord Developer Portal](https://discord.com/developers/applications)'a gidin\r\n2. **New Application** → Bot oluşturun\r\n3. **Bot Token**'ı kopyalayın\r\n4. **Privileged Gateway Intents**'i etkinleştirin:\r\n   - `GUILD_MEMBERS`\r\n   - `MESSAGE_CONTENT`\r\n\r\n### 3️⃣ **Bot İzinleri**\r\nBot'unuza şu izinleri verin:\r\n- `Manage Roles`\r\n- `Send Messages`\r\n- `Embed Links`\r\n- `Read Message History`\r\n- `Use Slash Commands`\r\n\r\n---\r\n\r\n## 🔧 Yapılandırma\r\n\r\n### **Ana Konfigürasyon** (`config.yml`)\r\n...\r\n---\r\n\r\n## 🎮 Komutlar\r\n\r\n| Komut | Açıklama | İzin |\r\n|-------|----------|------|\r\n| `/verify` | Discord hesabını eşle | `discordplus.command.verify` |\r\n| `/discord` | Discord bilgilerini göster | `discordplus.command.discord` |\r\n| `/dpgui` | Ana menüyü aç | `discordplus.use` |\r\n| `/sync` | Rolleri manuel senkronize et | `discordplus.command.sync` |\r\n| `/istatistik` | İstatistik menüsünü aç | `discordplus.command.stats` |\r\n| `/discordplus reload` | Plugin'i yeniden yükle | `discordplus.admin` |\r\n| `/discordplus status` | Plugin durumunu göster | `discordplus.admin` |\r\n\r\n### **Komut Takma Adları**\r\n- `/verify` → `/dogrula`, `/link`\r\n- `/discord` → `/dc`\r\n- `/discordplus` → `/dp`, `/discordp`\r\n- `/sync` → `/syncrole`, `/rolesync`\r\n- `/istatistik` → `/stats`, `/istatistikler`\r\n\r\n---\r\n\r\n## 🔑 İzinler\r\n\r\n### **Ana İzinler**\r\n```yaml\r\ndiscordplus.*:          # Tüm izinler\r\ndiscordplus.admin:      # Admin komutları\r\ndiscordplus.use:        # Temel kullanım\r\ndiscordplus.bypass:     # Zorunlu eşleme atlama\r\n```\r\n\r\n### **Komut İzinleri**\r\n```yaml\r\ndiscordplus.command.verify:    # /verify komutu\r\ndiscordplus.command.discord:   # /discord komutu  \r\ndiscordplus.command.sync:      # /sync komutu\r\ndiscordplus.command.stats:     # /istatistik komutu\r\n```\r\n\r\n---\r\n\r\n## 🔌 API Entegrasyonları\r\n\r\n### **LuckPerms Entegrasyonu**\r\n```java\r\n// Otomatik rol senkronizasyonu\r\n// İzin değişiklikleri real-time Discord'a yansır\r\nluckPermsManager.syncPlayerPermissions(player);\r\n```\r\n\r\n### **Vault Entegrasyonu**\r\n```java\r\n// Ekonomi sisteminden bakiye çekme\r\nEconomy economy = getEconomy();\r\ndouble balance = economy.getBalance(player);\r\n```\r\n\r\n### **PlaceholderAPI Desteği**\r\n```yaml\r\n# Kullanılabilir placeholderlar:\r\n%discordplus_user_tag%          # Discord tag\r\n%discordplus_user_id%           # Discord ID\r\n%discordplus_linked_status%     # Eşleme durumu\r\n%discordplus_server_members%    # Sunucu üye sayısı\r\n```\r\n\r\n---\r\n\r\n## 📊 Özellik Detayları\r\n\r\n### 🔗 **Hesap Eşleme Süreci**\r\n1. Oyuncu `/verify` komutunu kullanır\r\n2. Discord'da eşleme kanalına mesaj gönderilir\r\n3. \"🔗 Hesap Eşle\" butonuna tıklanır\r\n4. Benzersiz kod üretilir ve DM gönderilir\r\n5. Oyuncu kodu Minecraft'ta onaylar\r\n6. Hesaplar başarıyla eşlenir\r\n\r\n### 🎭 **Rol Senkronizasyonu**\r\n- **Otomatik**: İzin değişiklikleri 5 dakikada kontrol edilir\r\n- **Manuel**: `/sync` komutu ile anında senkronizasyon\r\n- **Öncelik**: Yüksek priority rolleri diğerlerini geçersiz kılar\r\n- **Bildirim**: DM ile rol değişiklikleri bildirilir\r\n\r\n### 📊 **İstatistik Sistemi**\r\n```yaml\r\n# Desteklenen istatistikler:\r\n- playtime          # Oyun süresi\r\n- deaths            # Ölüm sayısı  \r\n- kills             # Öldürme sayısı\r\n- votes             # Oy sayısı\r\n- vault_eco_balance # Ekonomi bakiyesi\r\n- loginstreak       # Giriş serisi\r\n```\r\n\r\n---\r\n\r\n## 🌐 Çok Dil Desteği\r\n\r\nPlugin şu dilleri destekler:\r\n\r\n### 🇹🇷 **Türkçe** (`messages_tr.yml`)\r\n```yaml\r\nlanguage: \"tr\"\r\n```\r\n\r\n### 🇺🇸 **İngilizce** (`messages_en.yml`)  \r\n```yaml\r\nlanguage: \"en\"\r\n```\r\n\r\n### **Özel Mesajlar**\r\nTüm mesajlar dil dosyalarında özelleştirilebilir:\r\n```yaml\r\naccount-linking:\r\n  verification-success: \"{prefix}\u0026aHesap başarıyla eşlendi!\"\r\n  already-linked: \"{prefix}\u0026cBu hesap zaten eşlenmiş!\"\r\n```\r\n\r\n---\r\n\r\n## ❓ Sıkça Sorulan Sorular\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cb\u003eQ: Bot çevrimdışı görünüyor, ne yapmalıyım?\u003c/b\u003e\u003c/summary\u003e\r\n\r\n**A:** Şunları kontrol edin:\r\n1. Bot token'ın doğru olduğunu\r\n2. Bot'un sunucunuzda olduğunu\r\n3. Gerekli izinlere sahip olduğunu\r\n4. Konsol loglarını inceleyin\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cb\u003eQ: Rol senkronizasyonu çalışmıyor?\u003c/b\u003e\u003c/summary\u003e\r\n\r\n**A:** Şunları kontrol edin:\r\n1. LuckPerms'in yüklü olduğunu\r\n2. Rol ID'lerinin doğru olduğunu\r\n3. Bot'un \"Manage Roles\" iznine sahip olduğunu\r\n4. Bot'un rolü, verilecek rolden daha yüksekte olduğunu\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cb\u003eQ: Chat köprüsü mesajları göndermiyor?\u003c/b\u003e\u003c/summary\u003e\r\n\r\n**A:** Şunları kontrol edin:\r\n1. Chat kanal ID'sinin doğru olduğunu\r\n2. Bot'un kanala mesaj gönderme iznine sahip olduğunu\r\n3. `chat-bridge.enabled: true` olduğunu\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n\u003csummary\u003e\u003cb\u003eQ: İstatistikler güncelleniyor mu?\u003c/b\u003e\u003c/summary\u003e\r\n\r\n**A:** İstatistikler şu şekilde güncellenir:\r\n- **Playtime**: Her dakika otomatik\r\n- **Leaderboard**: 60 dakikada bir\r\n- **Manual**: `/istatistik` komutu ile anında\r\n\u003c/details\u003e\r\n\r\n---\r\n\r\n## 🔄 Güncelleme Notları\r\n\r\n### **v1.0** - İlk Sürüm\r\n- ✅ Temel Discord entegrasyonu\r\n- ✅ Hesap eşleme sistemi\r\n- ✅ Rol senkronizasyonu\r\n- ✅ Chat köprüsü\r\n- ✅ İstatistik sistemi\r\n- ✅ Vote sistemi\r\n- ✅ Çok dil desteği\r\n\r\n---\r\n\r\n## 🛠️ Geliştirici API\r\n\r\nPlugin, diğer geliştiriciler için API sağlar:\r\n\r\n```java\r\n// Plugin instance alma\r\nDiscordPlus plugin = DiscordPlus.getInstance();\r\n\r\n// Hesap eşleme kontrolü\r\nboolean isLinked = plugin.getLinkingManager().isLinked(player.getUniqueId());\r\n\r\n// Discord kullanıcı bilgisi alma\r\nString discordTag = plugin.getLinkingManager().getDiscordTag(player.getUniqueId());\r\n\r\n// Manuel rol senkronizasyonu\r\nplugin.getPermissionSyncManager().syncPlayer(player);\r\n```\r\n\r\n---\r\n\r\n## 🐛 Hata Bildirimi\r\n\r\nHata bulduysanız lütfen şunları dahil edin:\r\n\r\n1. **Server versiyonu** (Spigot/Paper/etc.)\r\n2. **Plugin versiyonu** \r\n3. **Hata logu** (console log)\r\n4. **Yapılandırma dosyası** (token'ları gizleyin)\r\n5. **Yeniden üretme adımları**https://github.com/KynuxDev/DiscordPlus-ByKynux\r\n\r\n**🔗 Issues:** [GitHub Issues](https://github.com/KynuxDev/DiscordPlus-ByKynux/issues)\r\n\r\n---\r\n\r\n## 💡 Katkıda Bulunma\r\n\r\nProjeye katkıda bulunmak isterseniz:\r\n\r\n1. **Fork** edin\r\n2. **Feature branch** oluşturun (`git checkout -b feature/amazing-feature`)\r\n3. **Commit** edin (`git commit -m 'Add amazing feature'`)\r\n4. **Push** edin (`git push origin feature/amazing-feature`)\r\n5. **Pull Request** açın\r\n\r\n---\r\n\r\n## 🤝 Destek\r\n\r\n- **Discord**: [Nexoro](https://discord.gg/wCK5dVSY2n)\r\n- **Website**: [kynux.cloud](https://kynux.cloud)\r\n- **E-mail**: support@kynux.cloud\r\n\r\n---\r\n\r\n## 📝 Lisans\r\n\r\nBu proje [MIT License](LICENSE) altında lisanslanmıştır.\r\n\r\n---\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n**⭐ Eğer bu plugin'i beğendiyseniz, lütfen star verin!**\r\n\r\nMade with ❤️ by [Kynux](https://github.com/kynuxdev)\r\n\r\n![Footer](https://img.shields.io/badge/Made%20with-❤️-red.svg)\r\n![Java](https://img.shields.io/badge/Built%20with-Java-orange.svg)\r\n![Discord](https://img.shields.io/badge/Powered%20by-Discord-blue.svg)\r\n\r\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Fdiscordplus-bykynux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkynuxdev%2Fdiscordplus-bykynux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Fdiscordplus-bykynux/lists"}