yBan

سكربت الحظر الآمن والمناسب لجميع السيرفرات

سكربت مخصص فقط لحظر اللاعبين بواجهة مستخدم ملائمة بصرياً للمستخدم

السكربت خفيف ولا يتطلب أي استهلاك مستمر على الطرفين (اللاعب والسيرفر)

يعمل مع جميع الفريموركات (ESX / QBCore / Standalone) لأنه يعتمد على معرّفات اللاعب فقط، ولا يحتاج أي تعديل على سكربتاتك الحالية.

أبرز المميزات

• حظر دائم أو مؤقت — بالساعة أو اليوم أو الأسبوع أو الشهر أو السنة، مع فك الحظر تلقائياً فور انتهاء المدة.
• حظر اللاعبين الأونلاين والأوفلاين — تقدر تحظر أي لاعب دخل السيرفر سابقاً حتى لو كان غير متصل.
• معرّف حظر فريد لكل عملية (مثال: XKD-482) يسهّل على اللاعب التظلم وعلى الإداري البحث وفك الحظر.
• سجل كامل لكل لاعب — كل عمليات الحظر السابقة محفوظة حتى بعد فكها أو انتهائها، لأنها سجل وليست حالة.
• بحث فوري بالاسم أو المعرّف أو رقم الحظر.
• عدّاد مباشر لعدد المحظورين يتحدث لحظياً لجميع الإداريين.

نظام كشف الحسابات الوهمية

عند دخول أي لاعب يتم حفظ جميع معرّفاته (License / Steam / Discord / FiveM) بالإضافة إلى بصمات الجهاز (HWID) وربطها بحسابه الأساسي.

وعند حظر أي حساب، يتم طرد ومنع كل حساب يشارك أي معرّف أو بصمة جهاز معه — يعني اللاعب المحظور ما يقدر يرجع بحساب ثاني.

ولأن هذا الأمر قد يظلم لاعبين أبرياء (إخوة في نفس البيت أو جهاز مشترك)، أضفنا خاصية فك الارتباط: يقدر أدمن يفصل حسابين عن بعض بضغطة واحدة، ويعيد ربطهما لاحقاً وقت ما يشاء.

بطاقة الحظر

عند محاولة اللاعب المحظور الدخول، تظهر له بطاقة أنيقة تحتوي على:

• اسم السيرفر وشعاره ووصفه (قابلة للإخفاء).
• سبب الحظر ومعرّف الحظر وتاريخ بدايته.
• الوقت المتبقي بصيغة عربية مفهومة (مثال: "بعد 3 أيام و 5 ساعات").
• باقي الحظورات على حسابه إن وجدت.
• زر للدخول إلى ديسكورد السيرفر وزر لفتح المتجر الإلكتروني.

نظام الصلاحيات

يعتمد على صلاحيات FiveM الأصلية (ACE) وينقسم إلى أربع صلاحيات منفصلة تقدر توزعها كما يناسبك:

• فتح القائمة — عرض اللاعبين والسجلات فقط.
• الحظر
• فك الحظر
• ربط وفك ربط الحسابات

الواجهة تخفي تلقائياً أي زر لا يملك الإداري صلاحيته، ومع ذلك يتم التحقق من كل طلب في السيرفر ولا يتم الوثوق بالواجهة إطلاقاً.

الأمان والأداء

• جميع استعلامات قاعدة البيانات محمية بالكامل من SQL Injection.
• لا يزيد الضغط على قاعدة البيانات مهما زاد عدد اللاعبين.

الإكسبورتس (للمطورين)

تقدر تربط السكربت مع نظام الأنتي تشيت أو أي سكربت آخر:

-- حظر لاعب متصل لمدة يوم، ويرجع معرّف الحظر
local banID = exports.yBan:Ban(source, "السبب", 86400, "اسم الإداري")

-- حظر دائم لحساب غير متصل
exports.yBan:Ban("license2:xxxxxxxx", "السبب", 0)

exports.yBan:Unban("XKD-482")
exports.yBan:IsBanned(source)
exports.yBan:Unlink(identifierA, identifierB)
exports.yBan:Relink(identifierA, identifierB)
exports.yBan:GetBanCount()

التركيب والمتطلبات

• المتطلبات: oxmysql وقاعدة بيانات MySQL.
• لا يوجد ملف SQL — جميع الجداول تُنشأ وتُفحص تلقائياً عند أول تشغيل.
• التركيب لا يتجاوز دقيقة: ضع المجلد، أضف ensure yBan، وعدّل الصلاحيات.
• القائمة تُفتح بأمر /yban.

للدعم الفني والاستفسارات: discord.gg/yscripts