Discord Bot Creator

مكتبة بسيطة وسهلة لإنشاء وإدارة بوتات Discord باستخدام توكنات حسابات المستخدمين وواجهة برمجة تطبيقات Discord.

المميزات الرئيسية 🌟

• إنشاء بوتات Discord تلقائياً
• دعم المصادقة الثنائية (2FA)
• دعم البروكسي (SOCKS5/HTTP)
• التعامل التلقائي مع حدود معدل الطلبات
• حفظ التوكنات في ملف
• تجاوز الحذف التلقائي للبوتات
• واجهة برمجة سهلة الاستخدام
• أحداث مخصصة للتتبع

التثبيت 📦

npm install discord-bot-creator

الاستخدام الأساسي 🚀

مثال بسيط

const TokenCreator = require('discord-bot-creator');

// إنشاء مثيل جديد
const creator = new TokenCreator({
    tokens: [
        {
            token: "توكن_حساب_المستخدم",
            twoFactorKey: "مفتاح_المصادقة_الثنائية", // اختياري
            password: "كلمة_المرور" // مطلوب إذا كان الحساب يستخدم المصادقة الثنائية بكلمة المرور
        }
    ],
    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
    nameFormat: "بوت_{0}", // {0} سيتم استبداله برقم عشوائي
    enableIntents: true // تمكين صلاحيات البوت
});

// بدء إنشاء البوتات
creator.start({
    pathToSaveTokens: "./tokens.json", // مسار حفظ التوكنات (اختياري)
    loopCount: 5, // عدد البوتات المراد إنشاؤها
    loopWait: 10000 // وقت الانتظار بين كل عملية إنشاء (بالميلي ثانية)
}).then(tokens => {
    console.log("تم إنشاء البوتات بنجاح:", tokens);
}).catch(err => {
    console.error("حدث خطأ:", err);
});

الخيارات المتقدمة 🛠️

استخدام البروكسي

const creator = new TokenCreator({
    tokens: [...],
    userAgent: "...",
    proxy: "socks5://user:pass@host:port" // أو "http://user:pass@host:port"
});

تخصيص تنسيق أسماء البوتات

const creator = new TokenCreator({
    tokens: [...],
    userAgent: "...",
    nameFormat: "MyBot_{0}" // سيتم إنشاء بوتات بأسماء مثل: MyBot_1234, MyBot_5678
});

استخدام الأحداث

// عند إنشاء توكن جديد
creator.on('tokenCreated', (data) => {
    console.log('تم إنشاء بوت جديد:', {
        botID: data.botID,
        name: data.name,
        token: data.token,
        userToken: data.userToken,
        haveTwoFactor: data.haveTwoFactor
    });
});

// عند وجود توكن غير صالح
creator.on('tokenInvalid', (tokenData) => {
    console.log('توكن غير صالح:', tokenData);
});

التعامل مع المصادقة الثنائية 🔐

المصادقة باستخدام TOTP (Google Authenticator)

const creator = new TokenCreator({
    tokens: [
        {
            token: "توكن_الحساب",
            twoFactorKey: "مفتاح_TOTP_السري" // المفتاح السري من Google Authenticator
        }
    ],
    userAgent: "..."
});

المصادقة باستخدام كلمة المرور

const creator = new TokenCreator({
    tokens: [
        {
            token: "توكن_الحساب",
            password: "كلمة_المرور" // كلمة مرور الحساب للمصادقة الثنائية
        }
    ],
    userAgent: "..."
});

حفظ التوكنات 💾

عند تحديد pathToSaveTokens، سيتم حفظ كل توكن تم إنشاؤه في الملف المحدد بالتنسيق التالي:

[
    {
        "botID": "123456789",
        "name": "MyBot_1234",
        "token": "توكن_البوت",
        "userToken": "توكن_المستخدم",
        "haveTwoFactor": true
    }
]

الأخطاء الشائعة وحلولها 🔧

1. خطأ: "tokens must be an array"

   • تأكد من أن tokens هو مصفوفة من الكائنات

2. خطأ: "userAgent must be set first"

   • يجب تعيين User-Agent قبل بدء الإنشاء
   • استخدم setUserAgent() أو قم بتمريره في الخيارات

3. خطأ: "proxy must be a [socks5|http] proxy"

   • تأكد من أن عنوان البروكسي يبدأ بـ "socks5://" أو "http://"

4. خطأ: "nameFormat must include {0}"

   • يجب أن يحتوي تنسيق الاسم على "{0}" ليتم استبداله برقم عشوائي

نصائح وأفضل الممارسات 💡

1. استخدام البروكسي

   • يُنصح دائماً باستخدام بروكسي لتجنب الحظر
   • تأكد من أن البروكسي سريع وموثوق

2. وقت الانتظار

   • استخدم loopWait مناسب (10000ms على الأقل)
   • زيادة الوقت يقلل من فرص الحظر

3. حفظ التوكنات

   • دائماً قم بتحديد pathToSaveTokens
   • احتفظ بنسخة احتياطية من التوكنات

4. المصادقة الثنائية

   • TOTP أكثر أماناً من كلمة المرور
   • احتفظ بالمفاتيح السرية بشكل آمن

الأمان 🔒

1. لا تشارك توكنات الحسابات أو مفاتيح المصادقة الثنائية
2. استخدم دائماً اتصال آمن عند استخدام المكتبة
3. قم بتشفير ملفات التوكنات المحفوظة
4. لا تقم بنشر التوكنات في مستودعات عامة

المساهمة 🤝

نرحب بالمساهمات! إذا وجدت مشكلة أو لديك اقتراح للتحسين:

1. قم بفتح issue جديد
2. أو قم بإنشاء pull request
3. اتبع إرشادات المساهمة في الملف CONTRIBUTING.md

الترخيص 📄

هذا المشروع مرخص تحت MIT License

إخلاء المسؤولية ⚠️

استخدم هذه المكتبة على مسؤوليتك الخاصة. تأكد من اتباع شروط خدمة Discord وسياساتهم.