README.ar.md

🤖 بوت عيسى

بوت متكامل للتويتش والديسكورد مع دعم OBS 🎮

✨ المميزات

🎭 تكامل OBS

• 🎬 التحكم بالمشاهد من الشات والصوت
• 🔄 تغيير المشاهد تلقائياً
• 📡 اتصال WebSocket مع OBS

💬 تويتش

• 🤝 ردود تلقائية للترحيب
• 📎 إنشاء كليبات تلقائياً
• 🎯 أوامر مخصصة قابلة للتخصيص
• 🔗 ربط مباشر مع الديسكورد

🎮 ديسكورد

• 📢 إشعارات البث المباشر
• 🎥 مشاركة الكليبات تلقائياً
• 👥 رتب البث المباشر
• 🗣️ التحكم الصوتي عبر Deepgram
• 🎙️ أوامر صوتية للتحكم بالبث

⚙️ المتطلبات

• Node.js v16 أو أحدث
• OBS Studio مع WebSocket مفعل
• حساب تويتش للبوت
• حساب ديسكورد للبوت
• مفتاح API من Deepgram

🚀 التثبيت

1. تثبيت الحزم:

npm install

2. تعديل config.json:

{
    "OBS": {
        "address": "ws://localhost:4455",
        "password": "سر-obs"
    },
    "twitch": {
        "channel": "اسم-قناتك",
        "command": "!scene"
    },
    "deepgram": {
        "apiKey": "مفتاح-deepgram"
    }
}

📝 الأوامر

الأوامر الصوتية

• تغيير المشهد: "يا بوت غير المشهد إلى ..."
• إنشاء كليب: "يا بوت سوي كليب"
• تغيير العنوان: "يا بوت غير العنوان إلى ..."

تويتش

• !clip - إنشاء كليب للحظة الحالية
• !rank - عرض رتبة فالورانت
• !scene - تغيير مشهد OBS
• !mouse - معلومات الماوس
• !sens - إعدادات الحساسية

ديسكورد

• /alert - إضافة قناة للإشعارات
• /refresh - تحديث الأوامر

📊 نظام التسجيل

• 📁 تسجيل الأخطاء في logs/error.log
• 📁 تسجيل كل العمليات في logs/combined.log
• 🎨 تسجيل ملون في وحدة التحكم
• 📊 تسجيل زمني لكل العمليات

🛠️ التخصيص

الردود التلقائية

يمكن تعديل الردود في src/twitch/config/auto-responses.js:

module.exports = {
    greetings: {
        'السلام': (username) => `@${username} وعليكم السلام`,
    },
    homies: {
        'username': 'رد-مخصص'
    }
};

الأوامر الصوتية

يمكن تخصيص الأوامر الصوتية وإضافة أوامر جديدة في src/voice/commands/:

• تعديل الكلمات المفتاحية للأوامر
• إضافة أوامر جديدة
• تخصيص الردود الصوتية

📄 الترخيص

MIT