توثيق ZeroDev Sentinel
ZeroDev Sentinel: التثبيت وطريقة الاستخدام
ZeroDev Sentinel هو resource أنتي تشيت يعمل من جهة السيرفر لـ FiveM. يسجّل ما يراه السيرفر، ويحكم عليه بقواعد تشرح نفسها بجمل واضحة، ويعطي طاقمك الأدلة قبل معاقبة أي أحد. يبدأ على مستوى الحماية Watch: يسجّل ولا يعاقب أحدًا حتى تختار غير ذلك. يغطي هذا الدليل الإصدار 0.1.2 على سيرفرات ESX وQBCore وQbox وstandalone.
1. المتطلبات
- تفعيل OneSync (
set onesync onفي server.cfg). يعلن الـ resource أن OneSync اعتمادية له، لذلك لا يشغّله FXServer بدون OneSync. - FXServer artifact يشغّل سكربتات Node 22 (أي artifact موصى به حاليًا؛ يطلب الـ manifest
node_version '22'). يتولى Node الـ hashing والضغط وسرد الملفات ومسار الويب الخاص بالاستئناف. - اختياري: oxmysql. معه، يحفظ Sentinel سجلاته في قاعدة بياناتك وينشئ جداوله بنفسه عند أول تشغيل. لا يوجد ملف SQL لاستيراده. بدونه، يُحفظ كل شيء في مخزن key-value الخاص بالـ resource.
- اختياري: pma-voice، للاستماع إلى الدردشة الصوتية للاعب من الكونسول أو من لوحة المتصفح.
الـ framework مهم لأمرين فقط: تتبّع المال والعناصر (مال وعناصر لم يصرفها أي متجر أو وظيفة أو سكربت، وحلقات المكافآت، والتراجع rollback) ومن هم أفراد طاقمك (مجموعات ACE، التي يستخدمها كل framework). الكشف والقضايا والمقاطع والكونسول ولوحة المتصفح وDiscord ومكتب المالك تعمل بالطريقة نفسها على كل framework.
2. تثبيت في خمس دقائق
لا شيء يحتاج إلى SQL، ولا حاجة لتعديل الإعدادات عند أول تشغيل، ولا يتم تغيير أي resource آخر.
الخطوة 5: افتح مكتب المالك
اضغط F7 داخل اللعبة (أو اكتب sentinel:console في F8) وافتح OWNER. تعرض صفحة First run ما تم إنجازه وما لم يتم: Discord، وتخزين المقاطع، وطاقمك وصلاحياتهم. لكل سطر زر واحد. بعد ذلك العب لبضعة أيام على Watch، واقرأ ما وجده Sentinel في صفحة Right now، ثم غيّر مستوى الحماية إلى Recommended من المكتب نفسه (القسم 6).
3. الـ framework الخاص بك
يكتشف Sentinel الـ framework والإنفنتوري بنفسه عند التشغيل. لا يوجد شيء لضبطه. يعرض sentinel:trail في كونسول السيرفر الـ adapter الذي اختاره.
ESX Legacy
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel- المال والعناصر: تُقرأ من server events الخاصة بـ ESX نفسه (مال حساب أُضيف أو أُزيل أو تم ضبطه؛ عناصر إنفنتوري أُضيفت أو أُزيلت؛ عناصر أُعطيت من لاعب إلى لاعب، مع ربط الطرفين). يستخدم التراجع (rollback) دوال اللاعب الخاصة بـ ESX نفسه ثم يقرأ النتيجة مرة أخرى.
- ESX مع ox_inventory: يُتتبّع المال بالطريقة نفسها. في هذا الوضع لا تُرجع دوال العناصر في ESX أي نتائج، لذلك يقرر Sentinel فقط بناءً على القراءة اللاحقة.
- الطاقم: امنح الأدمنز صلاحية ACE (القسم 5). مجموعة ESX الخاصة
group.adminتعمل كمجموعة ACE عندما تضيف السطر الخاص بها.
QBCore
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory # or ox_inventory
# your other resources ...
ensure zerodev_sentinel- المال: يُقرأ من event تغيير المال في QBCore (إضافة وإزالة وضبط، مع السبب). الخسارة والربح المساوي لها في اللحظة نفسها يُربطان كتحويل، لأن QBCore ليس لديه event خاص بالتحويل.
- العناصر: مع ox_inventory، تُتتبّع العناصر عبر الـ hooks الخاصة به. مع qb-inventory، لا تُتتبّع تغييرات العناصر (لأن بيانات الـ listener الخاصة به غير موثّقة)، لكن التراجع (rollback) يمكنه مع ذلك نقل العناصر باستخدام exports الموثّقة في qb-inventory.
- الطاقم: مجموعات الصلاحيات في QBCore هي مجموعات ACE (
group.admin،group.god). أضف أسطر ACE الموجودة في القسم 5.
Qbox
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel- المال: يُقرأ من event تغيير المال في Qbox؛ وتُقرأ الأرصدة مرة أخرى باستخدام exports الخاصة بـ
qbx_coreنفسه. المال الذي يتغيّر لشخصية غير متصلة (عبر citizen id) لا يطلق أي event، لذلك لا يظهر في التتبّع. - العناصر: يستخدم Qbox الـ ox_inventory، ويتتبّع Sentinel عناصره عبر hooks الخاصة بـ ox_inventory. العناصر التي تمثّل مال الـ framework تُترك لجزء الـ framework.
- الطاقم: مجموعات ACE، كما في QBCore.
Standalone (بدون framework)
set onesync on
ensure zerodev_sentinel- كل شيء يعمل باستثناء تتبّع المال والعناصر: الحركة، والعالم، والأحداث، وأحداث الطُّعم، والـ godmode، والـ state bags، والأسلحة، والقضايا، والمقاطع، والإعادة، والكونسول، واللوحة، وDiscord، والأدوار، والحظر.
- مع ox_inventory وبدون framework، تُتتبّع العناصر عبر ox_inventory.
- التخزين: مخزن key-value، أو oxmysql إذا شغّلته أولًا.
التحقق من أنه يعمل
sentinel:health: صندوق بدء التشغيل مرة أخرى. كل صف فحص حقيقي؛ READY تعني أنه لا ينقص شيء.sentinel:diag: لماذا تم اختيار التخزين والـ adapters والمستوى، وكل قاعدة مع عداداتها، وآخر القرارات.sentinel:trail: الـ adapter المستخدم للمال والعناصر، وآخر التغييرات للاعب واحد.
في وضع التخزين التلقائي يستخدم Sentinel الـ oxmysql فقط عندما يكون oxmysql قد بدأ بالفعل (ينتظر حتى 15 ثانية أثناء بدء oxmysql)؛ إذا بدأ oxmysql لاحقًا، فإنه يستخدم مخزن key-value.
4. التشغيل الأول: مقعد المالك
أول تشغيل يطبع رمزًا لمرة واحدة في كونسول السيرفر، صالحًا لمدة 30 دقيقة (sentinel:owner code يطبع رمزًا جديدًا). ادخل واكتب /sentinel owner <code>: يرتبط المقعد بحسابك ويصبح الرمز غير صالح.
مقعد المالك وحده يمكنه تغيير المفاتيح ومستوى الحماية والأدوار والصلاحيات. sentinel:owner reset في كونسول السيرفر يحرّر المقعد إذا احتجت إلى نقله إلى حساب آخر.
5. الطاقم والصلاحيات
في مكتب المالك، STAFF: اختر لاعبًا متصلًا، واختر دورًا، واضغط GRANT. تأتي أربعة أدوار جاهزة:
| الدور | يستطيع، افتراضيًا |
|---|---|
| الدعم | رؤية القضايا، ومعالجة البلاغات، وخريطة المناوبة |
| Moderator | مثل Support، بالإضافة إلى الإعادات والطرد والحجر |
| Admin | مثل Moderator، بالإضافة إلى الكشف والمسح والعرض المباشر وطلبات الحظر والاستئنافات |
| Senior admin | مثل Admin، بالإضافة إلى حظر يُطبَّق فورًا |
الصلاحيات تختارها أنت. كل دور هو قائمة من المفاتيح يمكنك تغييرها. أنشئ أدوارك الخاصة من نسخة (مثلًا "Trial mod")، وأعد تسمية أي دور، وامنح شخصًا واحدًا مفتاحًا إضافيًا أو اسحب منه واحدًا دون تغيير دوره. المفاتيح المعلّمة كخطيرة (الحظر الفوري، والاستماع إلى الدردشة الصوتية، والإعدادات، وإدارة الطاقم) تطلب ضغطة ثانية. كل تغيير يُكتب في سجل الطاقم، لذلك يمكنك دائمًا رؤية من غيّر ماذا.
لا يزال ACE يعمل للسيرفرات التي تستخدمه بالفعل، ويُقرأ في كل فحص:
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin| الصلاحية | الدور الذي تمنحه |
|---|---|
sentinel.admin |
Admin (Senior admin حتى يتم استلام مقعد المالك) وكل أوامر sentinel:* داخل اللعبة |
sentinel.staff |
Moderator؛ قواعد الحركة تعتبر حركة عضو الطاقم نفسه مبرَّرة |
بعض الأوامر (sentinel:audit، sentinel:case، sentinel:replay، sentinel:save) مسجّلة كأوامر مقيّدة: داخل اللعبة تحتاج أيضًا إلى command.<name>. السطر المعتاد add_ace group.admin command allow يغطي ذلك. يمكن لكونسول السيرفر تشغيل كل الأوامر.
6. مستوى الحماية
مفتاح واحد في مكتب المالك (OWNER، PROTECTION)، وأيضًا sentinel:level في كونسول السيرفر وConfig.Protection في config/config.lua. ما تضبطه في المكتب يُحفظ ويتغلّب على سطر الإعدادات بعد إعادة التشغيل.
- Watch: كل قاعدة تراقب وتكتب ما كانت ستفعله؛ لا يتم تنبيه أحد ولا يحدث شيء لأي أحد. في الأثناء يتعلّم Sentinel ما هو طبيعي على سيرفرك: مراقب الأحداث (معدّلات وأشكال كل event) وفحص الدخول يتعلّمان فقط على Watch؛ أما حدود الكيانات والقتال والمال فتستمر في التعلّم من اللعب النظيف.
- Recommended: كل قاعدة مفعّلة. يحصل الطاقم على تنبيهات مع الأدلة، وتُفتح قضية. لا يعاقب Sentinel أبدًا من تلقاء نفسه؛ طاقمك هو من يقرر.
- Strict: مثل Recommended، والنتيجة العالية تضع اللاعب في الحجر حتى ينظر الطاقم في الأمر؛ والنتيجة بمستوى الإثبات (Tier A: تم إطلاق event طُعم، أو طلب مزوّر) تضيف أيضًا حظرًا إلى قائمة موجة الحظر.
تحت المفتاح يعرض المكتب كل قاعدة مع حالتها ومن أين تأتي تلك الحالة. ثبّت قاعدة واحدة على Live أو Shadow هناك إذا احتاج سيرفرك لذلك (قاعدة تستمر في الإشارة إلى أحد سكربتاتك، مثلًا)؛ سطر state في Config.Rules يثبّتها في ملف الإعدادات ويتغلّب على المكتب.
ترتيب منطقي:
- Watch لبضعة أيام من اللعب العادي.
- اقرأ ما كانت القواعد ستفعله: صفحة Right now، و
sentinel:diag rules(عمود shadow يعدّ المرات التي كانت القاعدة ستسجّل فيها نتيجة) وsentinel:diag decisions 100. - ثبّت على Shadow أي قاعدة أشارت إلى شخص تثق به، وأخبرنا بذلك.
- انتقل إلى Recommended. يرى الطاقم الآن القضايا والأدلة؛ لا يُعاقَب أحد تلقائيًا.
- Strict عندما تثق بما يعرضه لك Recommended.
للتراجع في أي وقت: Watch في المكتب، أو sentinel:level watch.
7. كونسول الطاقم (F7)
اضغط F7 داخل اللعبة (أو اكتب sentinel:console في F8). يستطيع كل لاعب تغيير الزر من إعدادات اللعبة (Key Bindings، FiveM). زر Esc يغلقه.
- Right now يشرح بكلمات بسيطة ما يحدث على سيرفرك: من يبدو خطرًا ولماذا، وما الذي ثبت، وما الذي له تفسير (إنعاش، أو انتقال فوري من سكربت خاص بك)، وما الذي يحتاج إليك. كل لاعب مهم يحصل على صف واحد: ما فعله، وما يُرجَّح أنه يكون، ومدى تأكد Sentinel (Unusual، Suspicious، Very likely، Proven)، وما فعله Sentinel بالفعل، وخطوة تالية واحدة.
- ملفات القضايا: القضايا المفتوحة أولًا، كل منها مع النتيجة، والأدلة، ومقاطع الشاشة، والختم (هل ما زالت سلسلة الـ hash الخاصة بالقضية سليمة) والأزرار REVEAL وQUARANTINE وCLEAR وBAN (يطلب CLEAR وBAN ضغطة ثانية).
- خريطة المناوبة: اللاعبون المتصلون على نموذج ثلاثي الأبعاد للجزيرة. تُقاس التضاريس من لعبة أول عضو في الطاقم وتُحفظ في
data/map/. - Play replay يغلق الكونسول ويعيد عرض الحادثة في عالم خاص؛ اضغط Backspace للعودة.
- المالك (لمقعد المالك فقط): First run وProtection وKeys وStaff وInternal affairs وServer check.
الأوامر داخل اللعبة تُكتب في F8 بدون شرطة مائلة، أو في الشات مع شرطة مائلة (/sentinel:diag).
8. لوحة المتصفح
المكتب نفسه في متصفح ويب، لما لا تكون داخل اللعبة:
- على جهاز السيرفر:
http://127.0.0.1:<port>/zerodev_sentinel/panel/(المنفذ هو منفذ سيرفرك، 30120 افتراضيًا) - من مكان آخر:
http://<server address>:<port>/zerodev_sentinel/panel/، أو عنوان HTTPS خاص بك أمامه
تسجيل الدخول. استخدم رمزًا لمرة واحدة: اكتب /sentinel panel داخل اللعبة (يظهر الرمز لك وحدك، ويعمل مرة واحدة، لمدة 5 دقائق)، أو شغّل sentinel:panel <id or account> في كونسول السيرفر. تستمر الجلسة 8 ساعات؛ SIGN OUT وEND ALL MY SESSIONS ينهيانها. دورك ومفاتيحك تنطبق في المتصفح تمامًا كما في اللعبة.
العرض المباشر. يستطيع أعضاء الطاقم الذين لديهم مفتاح العرض المباشر مشاهدة شاشة أي لاعب متصل من اللوحة أو الكونسول. لا يُحفظ شيء على القرص إلا إذا ضغطت Save to case.
الاستماع. الاستماع إلى المحادثة الصوتية لذلك اللاعب يحتاج إلى مفتاح الاستماع (للمالك فقط افتراضيًا) وإلى pma-voice. الصوت يعمل عبر لعبتك أنت، لذا كن داخل اللعبة على السيرفر نفسه.
كل عرض مباشر وكل استماع يُكتب في سجل الطاقم وفي قضية اللاعب، ويُبلَّغ اللاعبون عند أول دخول لهم أن الطاقم قد يشاهد ويستمع (إشعار التسجيل، Config.Notice).
9. القضايا والحجر والطرد والحظر والاستئناف
عندما يُكتشف شيء، يذكر Right now اسم اللاعب بكلام واضح: ما فعله، ومدى تأكد Sentinel، وما فعله حيال ذلك. افتح القضية لترى الأدلة (المواقع، ومقاطع الشاشة المختومة بـ SHA-256، وإعادة عرض ثلاثية الأبعاد) واستخدم الأزرار:
- REVEAL: يعرض معرّفات (identifiers) اللاعب.
- QUARANTINE: ينقل اللاعب من العالم الحقيقي إلى routing bucket خاص حتى ينظر الطاقم في الأمر.
sentinel:release <server id>يعيده. - CLEAR: لا يوجد غش؛ يغلق القضية ويوقف الحظر المجدول لها.
- KICK: طرد من السيرفر، مع سبب يقرؤه اللاعب.
- BAN: عبر موجة الحظر، مع رمز استئناف.
موجة الحظر. أوامر الحظر، بما فيها BAN المضغوط في الكونسول، توضع في قائمة انتظار موجة الحظر ولا تُطبَّق إلا على Strict، في وقت عشوائي بعد 2 إلى 24 ساعة افتراضيًا (Config.Actions). sentinel:wave يعرضها، وsentinel:wave now <account> يطبّق واحدًا فورًا، وsentinel:wave cancel <account> يلغيه.
الاستئناف. يرى اللاعب المحظور رمز استئناف في رسالة الرفض (8 أحرف وأرقام). لا يستطيع الدخول ليقدّم الاستئناف، لذا يصلك الاستئناف من خارج اللعبة:
- عبر طاقمك. يرسل اللاعب الرمز إلى طاقمك (تذكرة على Discord، بريد). يسجّله أحد أعضاء الطاقم بـ
sentinel:appeal <code> <text>. - عبر مسار الويب. يستجيب Sentinel على عنوان سيرفرك نفسه:
http://<server address>:<port>/zerodev_sentinel/appeal. لا يقبل إلا طلب POST بصيغة JSON{ "code": "...", "text": "...", "contact": "optional" }(النص من 10 إلى 2000 حرف)، فهو مخصص لنموذج على موقعك، وليس صفحة ترسل اللاعبين إليها. كل طلب مقبول يحصل على الرد نفسه، 202 "received"، سواء طابق الرمز حظرًا أم لا. الطلبات الكثيرة جدًا من عنوان واحد (5 خلال 10 دقائق) أو إجمالًا (30 في الدقيقة) تحصل على 429. إذا كان أمامه reverse proxy بـ HTTPS خاص بك، اضبطset sentinel_http_proxy trueحتى تُحسب الحدود على عنوان الزائر.
نص الرفض لا يقول أين يُقدَّم الاستئناف. أخبر اللاعبين في قوانينك، أو اكتب نصك الخاص مع رابطك في Config.Bans.message (احتفظ بـ %s، فهو يصبح الرمز)، مثلًا 'You are banned. Appeal at discord.gg/yourserver with code %s'.
يقرّر الطاقم في الكونسول أو بـ sentinel:decide <case or code> accept|reject [note]. القبول (accept) يرفع كل حظر نشط على ذلك الحساب أو تلك القضية ويلغي حظر الموجة المجدول؛ والرفض (reject) يُبقي الحظر. القرار نهائي ويُكتب في سجل القضية. sentinel:appeals يعرض الاستئنافات المفتوحة.
10. البلاغات والشؤون الداخلية
بلاغات اللاعبين. أي لاعب يكتب /report <server id> <what happened> للإبلاغ عن لاعب أو عن عضو في الطاقم. تُحفظ آخر دقيقتين حول اللاعبَين في قضية. يغلق الطاقم البلاغ بوصفه: تم اتخاذ إجراء، أو لا مخالفة، أو لا دليل، أو مكرر. البلاغات عن الطاقم تذهب إلى المالك فقط.
الشؤون الداخلية (للمالك فقط، في مكتب المالك): ما فعله كل عضو في الطاقم، وما يحتاج إلى نظرة (منح لأنفسهم، أو الاختباء أثناء القتال، أو حظر بدون قضية، أو انتقال فوري إلى لاعبين). يُكتب تقرير أسبوعي عن العدالة في data/reports/؛ وsentinel:staff report يكتبه الآن. لا شيء في سجل الطاقم يعاقب الطاقم.
11. حماية resource
بدون أي إعداد، يراقب Sentinel كل حدث يستطيع اللاعبون إرساله إلى سكربتاتك ويحكم على اللاعب. لكنه لا يستطيع منع الـ handler الخاص بـ resource آخر من العمل. لإيقاف استدعاء سيئ قبل أن يعمل السكربت، أضف الـ guard إلى ذلك السكربت.
- يعرض
sentinel:auditأحداث كل resource مُشغَّل التي يستطيع العملاء تشغيلها، مصنّفة حسب ما تفعله الـ handlers الخاصة بها (مثلًا handler يعطي مالًا بمبلغ يختاره العميل). استخدمه لتقرر أي resources تحميها أولًا. sentinel:guard <resource>يطبع السطر الذي يجب إضافته، والـ server_scripts الخاصة بالـ resource كما ستبدو بعد ذلك. يجب أن يكون سطر الـ guard أول server script. الأمر يطبع فقط؛ ولا يغيّر أي ملف.
lua
server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }
- أعد تشغيل ذلك الـ resource. الآن يقول
sentinel:guard <resource>"guarded since ...". وsentinel:guardوحده يعرض كل resource محمي. - أضف قواعد بـ
sentinel:patch. إلى أن تكون للـ resource قواعد، يسمح الـ guard الخاص به بمرور كل استدعاء، باستثناء الاستدعاءات من لاعبين في الحجر، فهذه يرفضها كل guard. مثال: 3 عمليات شراء كحد أقصى خلال 10 ثوانٍ، واسم عنصر حتى 32 حرفًا، وكمية من 1 إلى 10؛ والاستدعاء المرفوض يُعدّ دليلًا ("hard": true):
text
sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}
لـ callback من الـ framework، اكتب callback:<name> كاسم للحدث: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> يعرض قواعد الـ resource؛ وsentinel:patch <resource> <event> off يحذف واحدة منها.
الـ guard لا يعدّل الملفات أبدًا ولا يغيّر أبدًا ما يستقبله الـ handler. إنه كود Lua بسيط ومقروء في guard/guard.lua.
12. مفاتيح Discord وتخزين المقاطع
أسهل طريقة هي مكتب المالك، KEYS: الصق كل قيمة واضغط SAVE. تُحفظ المفاتيح على السيرفر فقط؛ المكتب وكل رد يقولان "set" فقط ولا يعرضان المفتاح مرة أخرى أبدًا.
| السطر في المكتب | ما هو | أو في server.cfg (استخدم set، وليس setr أبدًا) |
|---|---|---|
| توكن بوت Discord | بوت أنشأته على discord.com/developers ودعوته إلى سيرفرك | set sentinel_discord_token "..." |
| معرّف سيرفر Discord | انقر بزر الفأرة الأيمن على سيرفرك، Copy Server ID (مع تفعيل وضع المطوّر) | set sentinel_discord_guild "..." |
| معرّف قناة التنبيهات | حيث تُنشر القضايا، مع أزرار لطاقمك | set sentinel_discord_channel "..." |
| معرّف قناة الاستئنافات | حيث تُنشر الاستئنافات | set sentinel_discord_appeals "..." |
| مفتاح FiveManage | مفتاح وسائط من fivemanage.com؛ تُرفع المقاطع إلى هناك | set sentinel_fivemanage_key "..." |
| webhook المقاطع | بدلًا من FiveManage: webhook على Discord يستقبل المقاطع | set sentinel_clip_webhook "..." |
| تخزين المقاطع | fivemanage أو discord أو off أو automatic (أول واحد مضبوط) | set sentinel_clip_storage "..." |
المفتاح في server.cfg يتقدّم على المكتب، والمكتب يوضّح ذلك. أزرار Discord تتبع الأدوار والمفاتيح نفسها التي يتبعها الكونسول. بدون أيٍّ من هذه، تبقى القضايا والمقاطع على سيرفرك (data/) ويعرضها الكونسول واللوحة.
تنبيهات الـ webhook الأبسط ما زالت تعمل: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" أو sentinel:webhook set <url> في كونسول السيرفر. sentinel:webhook test يرسل رسالة تجريبية؛ وsentinel:webhook يعرض الحالة دون أن يطبع الرابط أبدًا؛ وsentinel:webhook clear يحذف الرابط المحفوظ.
13. ما تلتقطه كل قاعدة
كل قاعدة تكتب جملة بسيطة عندما تنطلق، تقول ما رأته وما استبعدته. قبل أن تُحسب قاعدة ضد أي أحد، يتحقق Sentinel من الأسباب التي قد تفسّرها (إعادة ظهور، أو إنعاش، أو إجراء من الطاقم، أو أحد سكربتاتك التي تنقل اللاعبين أو تدفع لهم). النتيجة التي لها تفسير تُسجَّل ولا تُحتسب في الدرجة أبدًا.
- الفئة A دليل: شيء لا يفعله إلا الغش (حدث طُعم لا يستدعيه أي سكربت حقيقي، أو طلب مزوّر).
- الفئة B قوية: يجب أن ينظر فيها أحد أعضاء الطاقم. وحدها لا تفتح قضية إلا إذا اتفقت عائلتان مختلفتان، أو تكررت العائلة نفسها.
- الفئة C ضعيفة: تضيف إلى الدرجة ولا تتصرف وحدها أبدًا.
الحركة
| القاعدة | ما تلتقطه | ما يفسّرها | الفئة |
|---|---|---|---|
| teleport | قفزة تزيد على 150 م (أو 3x ما هو ممكن) بين عيّنتين | الظهور، أو إعادة الظهور، أو الإنعاش، أو تغيير الـ routing bucket، أو الطاقم، أو حدث الانتقال الفوري في سكربتك | B |
| foot_speed | الركض بأكثر من 12 م/ث لمدة 1.5 ث سيرًا على الأقدام، دون سقوط ودون ragdoll | الظهور، إعادة الظهور، الطاقم، سكربتك | B |
| air_float | التحرك وهو مجمّد (noclip)؛ "السقوط" دون أن ينزل (طيران)؛ التحرك بسرعة حسب الإحداثيات بينما تقول اللعبة إن اللاعب واقف (قوائم السرعة) | الظهور، إعادة الظهور، الطاقم، سكربتك | B |
| foot_rise | الصعود عموديًا بأسرع من 4 م/ث سيرًا على الأقدام لمدة 3 ث | الظهور، إعادة الظهور، الطاقم، سكربتك | B |
| vehicle_speed | مركبة تتجاوز 1.3x أعلى سرعة تصل إليها فئتها على سيرفرك | الطاقم، سكربتك | B |
العالم
| القاعدة | ما تلتقطه | ما يفسّرها | الفئة |
|---|---|---|---|
| entity_blocked | إنشاء (spawn) موديل قمت بحظره | سكربتاتك التي تنشئه | B |
| entity_rate / entity_model_rate | إنشاء كيانات (أو موديل واحد) في الدقيقة أكثر بكثير مما يفعله اللاعبون والسكربتات | سكربتات الإنشاء الخاصة بك | B |
| entity_untrusted | كيانات أنشأها عميل دون وجود سكربت ينشئها | سكربتات الإنشاء الخاصة بك | B |
| entity_disguised | دفعة من موديل ped عادي واحد حول لاعب واحد (قائمة غش تخفي ما تنشئه على أنه حركة مرور) | الظهور، إعادة الظهور، تغيير الـ bucket | B |
| explosion_weapon / explosion_rate / explosion_hidden / world_distance | انفجارات لا يستطيع السلاح المحمول إحداثها، أو كثيرة جدًا، أو غير مرئية، أو بعيدة عن اللاعب | انفجارات سكربتاتك | B |
| projectile_weapon / projectile_rate | مقذوفات لا يستطيع السلاح إطلاقها، أو كثيرة جدًا | B | |
| ptfx_rate | إغراق بتأثيرات الجسيمات (هجوم شائع للتسبب في الكراش واللاق) | B | |
| fire_rate | حرائق تُشعَل أسرع مما يسمح به أي سلاح | B |
القتال
| القاعدة | ما تلتقطه | الفئة |
|---|---|---|
| damage_plausibility | ضرر يتجاوز القيمة الممكنة للسلاح | B |
| hit_range | إصابات من خارج مدى السلاح | B |
| shot_rate / kill_rate | إطلاق نار أسرع من السلاح؛ قتلات في الدقيقة أعلى بكثير من المعتاد على سيرفرك | B |
| silent_aim | إصابات في مكان لم يكن اللاعب يصوّب نحوه، بشكل متكرر | B |
| aim_stats / aim_stats_backed | نسبة ضربات الرأس وزوايا الالتقاط المفاجئ بعيدة جدًا عن لاعبي سيرفرك على مدى 30+ مواجهة | C (B مع عائلة أخرى) |
| esp_los_backed | تصويب متكرر نحو لاعبين يفيد الشهود بأنهم مختبئون خلف الجدران | من C إلى B |
الأحداث والطلبات
| القاعدة | ما تلتقطه | الفئة |
|---|---|---|
| bait_event | استدعاء حدث مزروع لا يستخدمه أي سكربت حقيقي (قوائم الغش تبحث عن هذه الأحداث وتشغّلها) | A |
| bait_statebag / statebag_write | كتابة state bags لا يجب أن يكتبها إلا السيرفر (جعل نفسك أدمن، أعلام godmode)، أو state bags كبيرة الحجم بشكل مفرط | A / B |
| events_before_ready / _trap | أحداث تُرسل قبل أن يظهر اللاعب أصلًا (حُقنت قبل الدخول) | B / A |
| event_rate / event_shape | حدث يُستدعى أسرع من المعتاد بكثير، أو بمعاملات تختلف في شكلها عن الاستدعاءات المعتادة على سيرفرك | B |
| event_flood | 500+ استدعاء خلال 10 ث؛ وعند طرد FiveM نفسه بسبب الـ overflow، تُعرض الأحداث الأكثر استدعاءً | B |
| guard_rule / guard_hard | مخالفة قاعدة وضعتها على حدث محمي (الكمية، المعدل، المسافة) | B / A |
الاقتصاد
| القاعدة | ما تلتقطه | الفئة |
|---|---|---|
| money_nowhere / item_nowhere | مال أو عناصر لم يعطها أي متجر أو وظيفة أو سكربت (أحداث المطوّرين، أو عمليات بيع مسرّبة من المتاجر) | B |
| economy_repeat | حدث مكافأة أو وظيفة دُفع 10 مرات خلال 30 ث (تجميع عبر استدعائه في حلقة) | B |
| money_jump / money_rate | قفزة مفاجئة في الرصيد أو معدل دخل أعلى بكثير من المعتاد على سيرفرك | B |
| economy_trap | المطالبة بمكافأة مزروعة لا تدفعها أي وظيفة حقيقية | A |
| weapon_not_owned | حمل سلاح لم يعطه المخزون (inventory) أبدًا | B |
لعبة اللاعب (الشاهد)
| القاعدة | ما تلتقطه | الفئة |
|---|---|---|
| godmode | يرى السيرفر أن اللاعب لا يُقهر لمدة 30 ث (وليست منطقة آمنة مشتركة) | B |
| witness_backed | علامات من اللعبة تدعمها رؤية السيرفر نفسه (godmode، الاختفاء، عدم التصادم) | B |
| witness_bait | اللعبة تجيب على فحص لا يُفترض أن تعرف بوجوده | A |
| witness_tamper | فحوصات Sentinel نفسها داخل اللعبة تم اعتراضها (hook) أو تغييرها | B |
الهوية والملفات
| القاعدة | ما تلتقطه | الفئة |
|---|---|---|
| ban_fingerprint | لاعب محظور عاد بحساب جديد (hardware tokens، المعرّفات، بصمة المتصفح) | A / flag |
| young_account | حساب جديد تمامًا (يضيف وزنًا فقط) | C |
| scanner_error / too_large | resources لم يستطع ماسح السكربتات قراءتها، أو ملفات كبيرة الحجم تستحق نظرة | info |
ما لا تعد به أي قاعدة
يحكم Sentinel على ما يستطيع السيرفر رؤيته وما تبلّغ عنه لعبة اللاعب. لا يقرأ البرامج الأخرى على جهاز اللاعب، ولا يمكن لأي نظام مكافحة غش أن يعد باكتشاف كل غش. كل نتيجة تأتي مع أدلتها، حتى يقرر طاقمك بناءً على الحقائق.
14. الأوامر والإعدادات
كل أمر موجود في صفحة الأوامر وكل مفتاح إعداد في صفحة الإعدادات، وكلاهما مولَّد من الـ resource نفسه. الأكثر استخدامًا:
| الأمر | ما يفعله |
|---|---|
/sentinel owner <code> |
استلام مقعد المالك داخل اللعبة بالرمز من الكونسول |
/sentinel panel |
رمز تسجيل دخول لمرة واحدة للوحة المتصفح (لطاقم الإدارة فقط) |
/report <server id> <what happened> |
أي لاعب يبلّغ عن لاعب أو عن عضو في طاقم الإدارة |
sentinel:health |
صندوق بدء التشغيل مرة أخرى |
sentinel:diag |
ما قرّره Sentinel ولماذا |
sentinel:level watch\|recommended\|strict |
تغيير مستوى الحماية وحفظه |
sentinel:wave |
حالات الحظر المنتظرة في موجة الحظر |
sentinel:appeals |
الاستئنافات المفتوحة |
sentinel:audit |
الأحداث (events) الخطرة لكل resource تم تشغيله |
sentinel:guard <resource> |
السطر الذي يحمي resource |
sentinel:advisor |
إعدادات FiveM التي يستحق تغييرها على سيرفرك |
ملفات الإعداد في config/ (config.lua، protection.lua، watch.lua) والترجمات في config/locales/ مفتوحة لك، وكذلك محوّلات الـ framework في bridge/ وملف الحماية في guard/. أبقِها Lua صالحة وأعد تشغيل zerodev_sentinel بعد أي تغيير. لا حاجة لتعديل أي إعداد قبل التشغيل الأول.
15. صندوق بدء التشغيل ومستشار التحصين
بعد لحظة من جاهزية التخزين، يطبع Sentinel صندوقًا في كونسول السيرفر. صف FAIL يعني أن Sentinel لا يستطيع العمل بشكل صحيح؛ وصف WARN يعني أنه يعمل بإمكانيات أقل (مثلًا أدلة بدون بصمات digest). اطبعه مرة أخرى في أي وقت بـ sentinel:health.
| الصف | ما الذي يفحصه | عندما لا يكون OK |
|---|---|---|
| البناء (Build) | الإصدار وتسمية البناء من fxmanifest.lua. | - |
| OneSync | الـ convar onesync. يقرأ Sentinel المواقع والكيانات وأحداث اللعبة عبر OneSync. |
اضبط onesync على on في server.cfg |
| النسخ العاملة | كم نسخة من الـ resource تم تشغيلها، أيًّا كان اسم مجلدها. يجب أن تكون 1. | أبقِ نسخة واحدة من Sentinel؛ أوقف المجلد الآخر |
| التخزين | أي تخزين تم اختياره (mysql أو kvp) وهل هو جاهز. | راجع sentinel:diag storage |
| مجلد الأدلة | كتابة وقراءة تجريبية في data/archive داخل الـ resource. | أنشئ المجلد data/archive داخل resource الخاص بـ Sentinel وتأكد أن السيرفر يستطيع الكتابة فيه |
| SHA-256 | هل يستجيب node/util.js؛ فهو يأخذ بصمة لكل دليل. | تُحفظ الأدلة بدون بصمات digest؛ راجع الكونسول بحثًا عن خطأ Node |
| الحماية | مستوى الحماية، ووضعه، ومن أين جاء. | - |
| القواعد | كم قاعدة تعمل Live وكم قاعدة في وضع Shadow. | - |
بعد صندوق بدء التشغيل، يطبع المستشار إعدادات FiveM التي يستحق تغييرها على سيرفرك (مع Config.Advisor.atStartup = false لا يطبعها إلا عند sentinel:advisor). لكل إعداد يعرض القيمة الحالية، والقيمة الموصى بها، وما الذي تمنعه، وما الذي قد تعطّله، والسطر الذي تنسخه. هو يقرأ القيم فقط؛ ولا يغيّر server.cfg أبدًا. جرّب السطر على سيرفرك قبل أن تُبقيه.
16. اللغات، وما يتم تسجيله
نصوص اللاعبين وطاقم الإدارة تأتي من config/locales/<code>.lua، 25 لغة في هذا البناء. Config.Locale يحدد اللغة؛ ومع Config.GameLanguage = true فإن اللاعب الذي تعمل لعبته بلغة توفرها GTA يقرأ Sentinel بتلك اللغة بمجرد دخوله اللعبة.
يحتفظ Sentinel في الذاكرة، لكل لاعب، بآخر دقيقتين تقريبًا من المواقع والأحداث (Config.Recorder)، ويكتبها في أرشيف داخل data/archive/ عندما تُفتح قضية أو يستخدم طاقم الإدارة sentinel:save. أثناء المراجعة يطلب من لعبة المشتبه به مقاطع من الشاشة (أجزاء مدتها 20 ثانية) ويحفظها في data/clips/. يحفظ المعرّفات التي يعطيها FiveM للسيرفر (يُسجَّل عنوان IP لكنه لا يُستخدم افتراضيًا أبدًا لرفض اتصال)، ومعرّف Discord عندما يعمل Discord. في أول دخول يحصل كل لاعب على إشعار قصير بلغته بأن السيرفر يسجّل اللعب وأن طاقم الإدارة قد يشاهد ويستمع (Config.Notice = false يوقفه؛ وعندها أخبرهم في قوانينك). واذكر ذلك في سياسة الخصوصية أيضًا.
لا تُحذف الأرشيفات والمقاطع القديمة تلقائيًا في هذا البناء: أفرغ data/archive/ وdata/clips/ بنفسك عندما لا تحتاجها.
مع oxmysql، تكون سجلات Sentinel في الجداول zds_account وzds_ban وzds_setting وzds_pair وzds_exemption وzds_case وzds_schema وzds_report وzds_trail. بدون oxmysql تبقى السجلات نفسها في مخزن key-value الخاص بالـ resource (مفاتيح تبدأ بـ zds:). الحظر يُنسخ دائمًا إلى مخزن key-value، لذلك يبقى مطبّقًا حتى عندما تكون قاعدة البيانات متوقفة.
17. التحديث
تُنشر الإصدارات الجديدة على نفس الـ asset في Keymaster. يحتفظ Sentinel بأدلته داخل مجلده الخاص، لذلك قبل أن تستبدله:
- خذ نسخة احتياطية من مجلد
zerodev_sentinel، وتحديدًا المجلدينconfig/وdata/(الأرشيفات، والمقاطع، والبلاغات، وخطوط الأساس المتعلَّمة)، ومع oxmysql جداولzds_. - أوقف السيرفر، واستبدل مجلد
zerodev_sentinelبالجديد (احتفظ باسم المجلد)، وأعد مجلدdata/الخاص بك إلى مكانه. انقل الإعدادات التي غيّرتها إلى ملفات الإعداد الجديدة بدلًا من نسخ الملفات القديمة فوقها. - شغّل السيرفر واقرأ صندوق بدء التشغيل (
sentinel:health).
اقرأ ملاحظات الإصدار الجديد في سجل التغييرات قبل التحديث.
18. إلغاء التثبيت
- احذف سطر الحماية من كل resource قمت بحمايته (
sentinel:guardيعرضها كلها) وأعد تشغيل تلك الـ resources. افعل هذا أولًا: ملف الحماية يختفي بمجرد حذف المجلد. - احذف
ensure zerodev_sentinelوسطريsentinel.admin/sentinel.staffمن server.cfg، ثم أوقف الـ resource. إذا كانsentinel:lockdownقد غيّر قفل الكيانات (entity lockdown)، فإن إيقاف Sentinel يعيد الوضع الأصلي. - احذف مجلد
zerodev_sentinel. هذا يحذفdata/مع كل الأرشيفات والمقاطع والبلاغات، لذلك انسخ أي شيء تريد الاحتفاظ به. - مع oxmysql، احذف جداول
zds_المذكورة في القسم 16 إذا لم تعد تريد حالات الحظر والقضايا. تبقى سجلات key-value في مخزن السيرفر تحت اسم الـ resource ولا تفعل شيئًا بدونه.
يكتب Sentinel فقط داخل مجلده الخاص، وجداول قاعدة بياناته، ومخزن key-value الخاص به. لا يعدّل resources أخرى ولا server.cfg.
الأسئلة الشائعة
هل يحظر Sentinel أو يطرد أي أحد من تلقاء نفسه؟
ليس على Watch أو Recommended. يبدأ على Watch، حيث يسجّل فقط ما كان سيفعله. على Recommended يحصل طاقم الإدارة على الأدلة ويقرر. فقط على Strict تؤدي النتيجة المرتفعة إلى وضع اللاعب في الحجر حتى يراجعه الطاقم، ويؤدي الاكتشاف بمستوى الدليل القاطع إلى إدراج حظر في موجة الحظر.
هل أحتاج إلى قاعدة بيانات؟
لا. مع oxmysql يحفظ Sentinel سجلاته في قاعدة بياناتك وينشئ جداوله الخاصة عند أول تشغيل؛ ولا يوجد ملف SQL للاستيراد. بدونه، كل شيء يُحفظ في مخزن key-value الخاص بالـ resource.
هل يعمل على QBCore وQbox؟
نعم. الكشف والقضايا والمقاطع والكونسول ولوحة المتصفح وDiscord ومكتب المالك هي نفسها على كل framework. ولسجل تتبّع الأموال والعناصر محوّل خاص لـ ESX وQBCore وQbox وox_inventory.
كيف أمنح الأدمنز صلاحية الوصول؟
في مكتب المالك، STAFF: اختر لاعبًا متصلًا، واختر دورًا، واضغط GRANT. أو استمر في استخدام ACE: sentinel.admin يمنح Admin وsentinel.staff يمنح Moderator.
هل يستطيع اللاعب المحظور تقديم استئناف؟
نعم. رسالة الرفض تعرض رمز استئناف. يرسله اللاعب إلى طاقم الإدارة، فيسجّلونه بـ sentinel:appeal، أو يرسله موقعك إلى مسار الاستئناف الخاص بـ Sentinel. يقبله الطاقم أو يرفضه في الكونسول أو بـ sentinel:decide.
هل يمكنه رؤية برامج الغش على جهاز اللاعب؟
لا. يحكم Sentinel على ما يستطيع السيرفر رؤيته وما تبلّغ عنه لعبة اللاعب. لا يقرأ البرامج الأخرى على جهاز اللاعب.
هل الاستماع إلى الدردشة الصوتية جاهز؟
يحتاج إلى pma-voice، ومفتاح الاستماع (للمالك فقط افتراضيًا)، ويُشغَّل الصوت عبر لعبتك أنت.
ماذا يرى اللاعبون؟
في أول دخول، إشعار قصير بلغتهم بأن السيرفر يسجّل اللعب وأن طاقم الإدارة قد يشاهد ويستمع (Config.Notice). لا يتغير شيء آخر للاعب النظيف.