server.cfg والـ convars والصلاحيات

أين توجد الإعدادات#

يقرأ Tosun AntiCheat الإعدادات من server.cfg، ومن أربعة ملفات داخل المورد، ومن لوحة الويب. بيانات الاعتماد مكانها فقط في الأماكن الخاصة بالخادم. الملف configs/anticheat_config.lua سكربت مشترك، لذا يرسله الخادم إلى كل عميل.

• التثبيت
• إعداد اللوحة
• مفتاح الترخيص

مثال server.cfg كامل#

كتلة كاملة لتثبيت نموذجي. الترتيب مهم: يجب أن تأتي التبعيات و convars بيانات الاعتماد قبل ensure tosun-ac، لأن بيانات الاعتماد تُحدَّد مرة واحدة عند تحميل المورد. الأسطر التي تبدأ بعلامة # واحدة اختيارية؛ أزل الـ # لاستخدامها.

## ---------- Tosun AntiCheat: كتلة server.cfg ----------
## OneSync تبعية في الـ manifest (ويمكن لـ txAdmin تفعيله أيضًا).
set onesync on

## التبعيات: شغّلها قبل tosun-ac.
## oxmysql و tosun_render تبعيتان إلزاميتان.
## screenshot-basic هو ts.screenshotModule الافتراضي.
## اضبط mysql_connection_string قبل ensure oxmysql (راجع دليل MySQL).
ensure oxmysql
ensure screenshot-basic
ensure tosun_render

## بيانات الاعتماد: استخدم set (وليس setr أو sets أبدًا) وأبقِها فوق ensure tosun-ac.
## تُقرأ مرة واحدة عند تحميل المورد.
## صيغة الترخيص: tac_live_ متبوعًا بـ 40 حرف hex صغيرًا.
set tosun_ac_license "YOUR_LICENSE_KEY"
## اختياري: عندما يكون فارغًا، يُحمَّل مفتاح اللوحة من panel_settings في قاعدة بيانات اللعبة.
# set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
# set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
## اختياري: يستخدمه ts.licenseLock فقط.
# set tosun_ac_server_id "server-1"

## الموارد التي يمكنها استدعاء exports الـ AC المحمية (مفصولة بفواصل).
set tosun_ac_trusted_resources "my-housing,my-clothing"

## اختياري: عنوان https عام للوحة من أجل رفع لقطات الشاشة والأدلة.
# set ts_public_panel_url "https://panel.example.com"

## اختياري: تحكّم في جسر قاعدة البيانات Tosun Connect من هذا الملف.
## بدون سطر manual (ومع إيقاف ts.panelMirror)، يُفرض كلا convar الجسر على "1".
# set tosun_db_bridge_manual "1"
# set tosun_db_bridge_enabled "1"
# set tosun_db_bridge_money_write "0"

## اختياري: أوقف كاتب وقت اللعب (qb و qbcore و qbox فقط).
# set tosun_panel_playtime "0"

## اختياري، للمطورين الذين يستخدمون ملفات الجسر. العملاء يقرؤونها، لذا استخدم setr.
# setr tosun_ac_resource "tosun-ac"
# setr tosun_ac_bridge_client_ms "60000"

ensure tosun-ac

## ---------- صلاحيات الطاقم ----------
## حالة الطاقم وقائمة الإدارة داخل اللعبة:
add_ace group.admin tosun.admin allow
## tosunac_setup والفحوص اليدوية ومعاينة شاشة الحظر:
add_ace group.admin tosunac.admin allow
add_ace group.admin command.tosunac_setup allow
add_ace group.admin command.tosunac_backdoorscan allow
add_ace group.admin command.tosunac_eventscan allow
add_ace group.admin tosunac.banscreen.test allow
## سطر واحد لكل عضو في الطاقم:
add_principal identifier.license:YOUR_LICENSE_HEX group.admin

## ---------- convars التقوية في FiveM التي يتحقق منها الـ AC عند البدء ----------
set sv_stateBagStrictMode true
set sv_filterRequestControl 2
set sv_enableNetworkedSounds false
set sv_enableNetworkedPhoneExplosions false
set sv_enableNetworkedScriptEntityStates false
set sv_scriptHookAllowed false
## اختبر أولًا: القيمة relaxed أو strict قد تعطّل السكربتات التي تُظهر المركبات من العميل.
set sv_entityLockdown relaxed
set sv_pureLevel 1
## تدقيق server.cfg يُصدر تحذيرًا ما دام هذا فارغًا:
# set sv_enforceGameBuild YOUR_GAME_BUILD

• إعداد MySQL
• دليل الإعداد

قواعد كتلة server.cfg#

اتبع هذه القواعد عند تكييف المثال مع خادمك.

• شغّل oxmysql و tosun_render قبل tosun-ac. يعلن الـ manifest عن إصدار خادم 4890 أو أحدث، و OneSync، و oxmysql، و tosun_render كتبعيات.
• شغّل screenshot-basic إذا أبقيت ts.screenshotModule الافتراضي.
• ضع كل أسطر بيانات الاعتماد set tosun_ac_ قبل ensure tosun-ac. تُقرأ القيم مرة واحدة عند التحميل؛ والتغيير اللاحق يتطلب إعادة تشغيل المورد.
• استخدم set لبيانات الاعتماد. setr ينسخ القيمة إلى كل عميل، و sets ينشرها في معلومات الخادم العامة.
• استخدم setr فقط للـ convars التي يقرؤها العملاء: ts_screen_upload و tosun_ac_resource و tosun_ac_bridge_client_ms.
• لا تحتاج إلى أي سطر لجسر قاعدة البيانات. منذ 9.6.14 يكون الجسر مفعّلًا افتراضيًا، والأسطر set ... "0" تُتجاهل ما لم يكن tosun_db_bridge_manual هو "1" أو ts.panelMirror.enabled = true.
• أدلة التثبيت القديمة (INSTALLER-READY.md و INSTALLER-LICENSE.md و INSTALL-MULTILANG.md و CONFIG-PERFORMANCE-GUIDE.md) تضع ensure قبل بيانات الاعتماد، وتضع مفتاح اللوحة في configs/anticheat_config.lua، وتُغفل tosun_render. اتبع هذه الصفحة بدلًا منها.

مرجع الـ convars#

كل convar يقرؤه Tosun AntiCheat ويمكنك ضبطه. استخدم set ما لم يذكر عمود الملاحظات setr. يكتب الـ AC أيضًا بعض الـ convars الداخلية الخاصة به ويقرؤها؛ وهي محمية ويجب ألا تضبطها.

بيانات الاعتماد: الأولوية والتعامل معها#

تُحدَّد ثلاث بيانات اعتماد مرة واحدة عند تحميل المورد: مفتاح الترخيص، ومفتاح API الخاص باللوحة، والرمز المركزي. لكل منها يأخذ الـ AC أول قيمة غير فارغة بهذا الترتيب.

تحذير MIGRATION يطلب منك مسح القيمة المشتركة وتدوير أي بيانات اعتماد خُزّنت هناك يومًا، لأن ذلك الملف يُرسل إلى كل عميل.

القيمة الأطول من 4096 حرفًا، أو التي تحتوي أحرف تحكم، توقف التحميل بالخطأ Invalid server credential setting.

لمفتاح اللوحة فقط: إذا بقي فارغًا بعد هذه الخطوات، ينسخ الـ AC القيمة panel_settings.ac_api_key من قاعدة بيانات اللعبة. في كل بدء يكتب الـ AC المفتاح المحدَّد في سجل ac_settings webPanelKey كنص صريح. إذا عدّل أحد ذلك السجل في اللوحة، تحل القيمة المعدّلة محل قيمتك حتى إعادة التشغيل التالية.

لمفتاح الترخيص فقط: يقبل قفل الترخيص الصيغ tac_live_ مع 40 حرف hex صغيرًا (49 حرفًا)، و TOSUN-AC-YYYY-... و TOSUN-.... فحص الصيغة يعمل فقط عندما يكون ts.licenseLock.enabled = true، وهو يتحقق من الصيغة فقط.

1. convar الخادم: tosun_ac_license أو tosun_ac_panel_key أو tosun_ac_central_token.
2. القيمة في configs/anticheat_server.lua: licenseKey أو panelKey أو centralToken.
3. القيمة القديمة في الملف المشترك configs/anticheat_config.lua: ts.licenseLock.licenseKey أو ts.webPanelKey أو ts.Central.token. أي قيمة هنا تطبع تحذير MIGRATION في وحدة التحكم.

• مفتاح الترخيص

configs/anticheat_server.lua#

استخدم هذا الملف الخاص بالخادم فقط عندما تفضّل عدم وضع بيانات الاعتماد في server.cfg. يُحمَّل قبل سكربتات الخادم الخاصة بالـ AC ويعود فورًا على العملاء. اترك خانة فارغة لتستمر في استخدام الـ convar أو الاكتشاف من قاعدة البيانات.

• الـ convar غير الفارغ له الأولوية دائمًا على القيمة في هذا الملف.
• أبقِ الخانات المقابلة في configs/anticheat_config.lua فارغة: ts.webPanelKey و ts.Central.token و ts.licenseLock.licenseKey.
• احفظ النسخ الاحتياطية من هذا الملف بشكل خاص.
• الملف يملأ فقط ts.webPanelKey و ts.Central.token و ts.licenseLock.licenseKey. السكربتات الأخرى تقرأ تلك القيم، وليس الملف.

-- configs/anticheat_server.lua (الخادم فقط)
local credentials = {
    panelKey = '',     -- أو: set tosun_ac_panel_key "YOUR_PANEL_API_KEY"
    centralToken = '', -- أو: set tosun_ac_central_token "YOUR_FIVEM_SCOPED_TOKEN"
    licenseKey = '',   -- أو: set tosun_ac_license "YOUR_SERVER_LICENSE"
}

رابط اللوحة ورفع لقطات الشاشة#

ts.webPanelURL في configs/anticheat_config.lua هو الرابط الأساسي للوحة. يمكنك تركه فارغًا: عندما يكون فارغًا يحمّل الـ AC القيمة panel_url أو site_url من panel_settings في قاعدة بيانات اللعبة ويحفظها في ac_settings. مزامنة الإعدادات عبر HTTP تعمل فقط عندما يكون الرابط ومفتاح اللوحة مضبوطين.

اضبط ts_public_panel_url فقط عندما يجب أن تذهب لقطات الشاشة وأدلة الحظر والفيديو المباشر إلى عنوان عام مختلف. يجب أن يكون https. رموز الرفع تُصدر فقط لـ https://host/api/screen_upload.php عندما يساوي الأساس هذا الـ convar أو ts.webPanelURL.

ts_screen_upload مسار منفصل يستخدمه export screenCapture والأمران /capture و /ts_capture. يتطلب setr، والقيمة الافتراضية تشير إلى localhost. لا شيء في الـ AC يعالج نتيجة ذلك الرفع.

الأسماء القديمة ts.PanelUrl و ts.panelUrl و ts.webPanelUrl ما زالت تُقرأ كبدائل.

• إعداد اللوحة

convars جسر قاعدة البيانات Tosun Connect#

منذ 9.6.14 يكون جسر قاعدة البيانات عند الطلب مفعّلًا افتراضيًا ولا يحتاج إلى أي سطر في server.cfg. عند التحميل يضبط الملف editable/server/tosun_db_bridge_defaults.lua كلًا من tosun_db_bridge_enabled و tosun_db_bridge_money_write على "1"، لذا تُتجاهل أسطر "0" الواردة في الأدلة القديمة.

يمكنك أيضًا إيقاف الاتصال لخادم واحد من اللوحة: Servers، ثم الخادم، ثم بطاقة Tosun Connect.

يستطلع الجسر https://admin.tosundev.com/api/server_db_bridge.php، ويرسل مفتاح ترخيصك كرمز Bearer، وينفّذ فقط هذه العمليات: players.list و player.detail و player.vehicles و bans.list و logs.list و player.money.set.

مع ts.panelMirror.enabled = true لا يفرض الـ AC تشغيل الجسر، لذا تستمر المرآة القديمة في العمل. المرآة نفسها لا تعمل ما دام tosun_db_bridge_enabled هو "1".

أمرا وحدة التحكم tosunac_db_status و tosunac_db_check يعرضان حالة الجسر ويختبران oxmysql.

1. للتحكم في الجسر من server.cfg، أضف set tosun_db_bridge_manual "1" قبل ensure tosun-ac.
2. أضف set tosun_db_bridge_enabled بالقيمة "1" أو "0".
3. أضف set tosun_db_bridge_money_write بالقيمة "1" أو "0". بدون "1" تفشل player.money.set بـ write_disabled ولا تُعرض على اللوحة.

• إعداد MySQL

convars لمطوري السكربتات#

هذه الـ convars تهم فقط عندما يستدعي مورد آخر الـ AC. يحدد tosun_ac_trusted_resources الموارد التي يمكنها استدعاء exports المحمية؛ وتضبط convars الجسر ملفات الجسر الاختيارية.

من exports المحمية: SetExempt و SetPlayerExempt و exports الإيقاف المؤقت (Pause) و BypassDetection و addAdmin و whitelistPlayer و approveResource و ban و offlineBan و exports webBridge و quarantine.

وحدة تحكم الخادم و tosun-ac نفسه موثوقان دائمًا. الاستدعاء غير الموثوق يُرفض؛ ولكل زوج من المورد والـ export يطبع الـ AC تحذيرًا واحدًا في وحدة التحكم وسطرًا واحدًا في سجل اللوحة يذكر هذا الـ convar. مع ts.EnforceExportCallerWhitelist = false يعمل الاستدعاء ويُسجَّل مرة واحدة فقط.

المستدعون الموثوقون يحصلون أيضًا على MarkTeleport دون ميزانية لكل لاعب.

INTEGRATION.md و bridge/INTEGRATION.txt يستخدمان set مع tosun_ac_resource و tosun_ac_bridge_client_ms. استخدم setr بدلًا منه: جسر العميل يقرأ كليهما على العميل.

توجد أيضًا أحداث و exports داخلية للـ AC. هي محمية ويجب عدم استدعائها من مواردك.

# الموارد المسموح لها باستدعاء exports المحمية (مفصولة بفواصل أو مسافات)
set tosun_ac_trusted_resources "my-housing,my-clothing"

# ملفات الجسر داخل موردك الخاص
setr tosun_ac_resource "tosun-ac"
setr tosun_ac_bridge_client_ms "60000"
set tosun_ac_bridge_server_ms "60000"
set tosun_ac_bridge_cooldown_ms "750"

• Exports
• مرجع الـ Exports
• الأحداث

صلاحيات ACE#

كل صلاحية ACE يتحقق منها Tosun AntiCheat. امنح صلاحيات ACE لمجموعة وأضف الطاقم إلى المجموعة عبر add_principal. صلاحية ACE يملكها builtin.everyone أيضًا لا تجعل أحدًا من الطاقم أبدًا.

• الأوامر

الأوامر المقيّدة وأوامر وحدة التحكم فقط#

عشرة أوامر للـ AC مسجّلة كأوامر مقيّدة. داخل اللعبة يشترط FiveM عندها صلاحية ACE المطابقة للأمر إضافة إلى فحص الـ AC نفسه. خمسة من العشرة تتجاهل اللاعبين تمامًا.

banscreentest ليس مقيّدًا. صيغة وحدة التحكم banscreentest playerId لا تحتاج إلى ACE؛ و /banscreentest داخل اللعبة يحتاج إلى tosunac.banscreen.test أو tosunac.admin. رفض tosunac_setup والفحصين و banscreentest يكون صامتًا.

لا يعتمد tosunac_setup أي شيء إذا لم ينتهِ فحص الأبواب الخلفية أو فحص التواقيع، بما في ذلك عندما يكون ts.BackdoorGuard معطّلًا. يُرفض التشغيل الثاني أثناء تشغيل آخر.

• الأوامر

كيف يُتعرَّف على الطاقم#

لدى الـ AC مستويا وصول منفصلان. حالة الطاقم تمنح الإعفاء من العقوبة وأوامر الطاقم (أوامر /ts الفرعية وأوامر ts_). والوصول إلى القائمة يفتح قائمة الإدارة داخل اللعبة. بعض المصادر تمنح واحدًا منهما فقط.

الإعفاء من العقوبة للطاقم يُطبَّق فقط ما دام ts.AdminBypassDetections = true (القيمة المرفقة) و ts.Debug = false (القيمة المرفقة).

الوصول إلى القائمة يتطلب أيضًا أن يبقى ts.AdminMenu.enable و ts.AdminMenu.enabled بقيمة true. عندما يكون أحدهما false، لا تُسجَّل القائمة ولا المفتاح F7 ولا أوامر أدوات الإدارة على العميل.

أعضاء الطاقم الذين لديهم حالة الطاقم دون الوصول إلى القائمة، مثل طاقم txAdmin فقط، يمكنهم مع ذلك الضغط على F7. يُرفض الطلب ويُسجَّل.

• الأوامر

قوائم المعرّفات: Admins و allowedIds و AdminBypassIdentifiers#

استخدم معرّفات كاملة مثل قيم license: أو steam: أو discord: أو fivem:. فضّل admins/anticheat_admins.lua أو المنح من اللوحة للطاقم: ذلك الملف خاص بالخادم فقط، بينما يُرسل configs/anticheat_config.lua إلى كل عميل.

• Admins: يطابق الإدخال المعرّف الكامل (دون التأثر بحالة الأحرف) أو الجزء الذي بعد البادئة. يمنح حالة الطاقم والقائمة.
• ts.AdminMenu.allowedIds: حالة الطاقم والقائمة. القيمتان "all" و "staff" لا تمنحان شيئًا.
• ts.AdminBypassIdentifiers: حالة الطاقم والإعفاء فقط، بلا قائمة.

-- admins/anticheat_admins.lua (الخادم فقط)
Admins = {
    "license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "steam:11000010xxxxxxxx",
    "discord:123456789012345678",
}

-- configs/anticheat_config.lua (مشترك، يُرسل إلى العملاء)
ts.AdminMenu = {
    -- مفاتيح القائمة الأخرى تبقى كما هي في النسخة المرفقة
    allowedIds = {
        "license:YOUR_EXACT_PLAYER_IDENTIFIER",
    },
}
ts.AdminBypassIdentifiers = {}  -- حالة الطاقم والإعفاء، بلا قائمة

المنح من اللوحة و export addAdmin#

المنح من اللوحة سجلات في ac_v7_admin_grants تنشئها في لوحة الويب. المنح النشط يطابق license أو license2 الخاص باللاعب، مع البادئة أو بدونها، ويمنح حالة الطاقم والوصول إلى القائمة.

الإجابة الإيجابية تُخزَّن مؤقتًا 5 ثوانٍ والسلبية 30 ثانية، لذا قد يستغرق المنح الجديد حتى 30 ثانية ليسري على لاعب سبق فحصه.

يمكن لمورد موثوق استدعاء export addAdmin لمنح لاعب حالة الطاقم والوصول إلى القائمة حتى يُستدعى removeAdmin. ما دام ts.EnforceExportCallerWhitelist هو true، يجب أن يكون المستدعي مدرجًا في tosun_ac_trusted_resources أو ts.ExportCallerWhitelist.

• إعداد اللوحة
• Exports

القائمة البيضاء للاعبين ليست طاقمًا#

القائمة البيضاء للاعبين في اللوحة (ac_whitelist) والمعرّفات المضافة أثناء التشغيل عبر exports القائمة البيضاء توقف العقوبات فقط. لا تمنح أوامر طاقم ولا قائمة إدارة.

• يُحتسب السجل ما دام expires_at فارغًا أو في المستقبل.
• القيم المقبولة: معرّف license أو discord أو steam أو fivem، أو citizenid. تُزال البادئات.
• إدخالات وقت التشغيل محفوظة في الذاكرة وتضيع عند إعادة التشغيل.
• تُتجاهل القائمتان ما دام ts.Debug = true.

إعدادات تغيّر طريقة التعامل مع الطاقم#

هذه المفاتيح في configs/anticheat_config.lua تغيّر طريقة معاملة الطاقم ومستخدمي القائمة غير المصرّح لهم.

builtin.everyone وفحص IP عند الاتصال#

كل فحص لصلاحيات ACE الخاصة بالطاقم والقائمة يتجاهل صلاحية ACE يملكها builtin.everyone أيضًا. لذا فإن add_ace builtin.everyone command allow لا يجعل اللاعبين من الطاقم. فحص IP عند الاتصال يعمل بطريقة مختلفة.

ما دام ts.v12.bypassStaffIpCheck ليس false، يتخطى اللاعب المتصل قائمة الدول الممنوعة ورفض VPN والـ proxy والاستضافة في أي من هذه الحالات: اللاعب من الطاقم؛ أو اللاعب يملك صلاحية ACE command أو txadmin أو tx.admin أو txadmin.menu أو command.kick أو command.ban أو أحد الأسماء group.admin أو group.superadmin أو group.moderator أو group.god؛ أو يوجد منح نشط من اللوحة يطابق license اللاعب تمامًا.

هذا الفحص يستخدم اختبارات ACE بسيطة دون ترشيح builtin.everyone. لذلك على خادم فيه add_ace builtin.everyone command allow يتخطى كل لاعب فحوص VPN والدولة. فحص إغراق الانضمام (join-flood) ما زال يعمل قبل التجاوز.

ملف webhooks الخاصة بـ Discord#

الملف configs/anticheat_webhooks.lua خاص بالخادم فقط. يحتوي رابط webhook واحدًا من Discord لكل قناة سجل، ونمط الـ embed. كل رابط مرفق بالقيمة البديلة WEBHOOK_URL_BURAYA.

• مزامنة اللوحة عبر HTTP تكتب فوق أي webhook ترسل له رابطًا غير فارغ.
• الموارد الأخرى تتلقى روابط الـ webhook عبر getConfig('webhooks') فقط عندما تكون مستدعين موثوقين.
• سجلات لقطات الشاشة تضع على embed الخاص بـ Detections تسمية ts.punishType بدل العقوبة المحدَّدة فعليًا، وتنشر أيضًا إلى Webhooks.Bans كلما كان ts.punishType هو BAN.
• Webhooks.WebhookAvatar يضبط صورة الأفاتار في الـ embed.

Webhooks.Detections    = "https://discord.com/api/webhooks/..."
Webhooks.Bans          = "https://discord.com/api/webhooks/..."
Webhooks.AdminMenuLogs = "https://discord.com/api/webhooks/..."
Webhooks.Connections   = "https://discord.com/api/webhooks/..."
Webhooks.OCR           = "https://discord.com/api/webhooks/..."
Webhooks.Commands      = "https://discord.com/api/webhooks/..."
Webhooks.MoneyLogs     = "https://discord.com/api/webhooks/..."
Webhooks.ResourceLogs  = "https://discord.com/api/webhooks/..."

Webhooks.WebhookUsername = "Tosun AntiCheat"
Webhooks.WebhookColor    = 15285208
Webhooks.WebhookInlines  = true

كيف تتجاوز اللوحة ملف الإعدادات#

معظم القيم في configs/anticheat_config.lua قيم افتراضية. تحتفظ لوحة الويب بقيمها الخاصة في ac_settings وجداول ac_ الأخرى، وتلك القيم لها الأولوية. عدّل الملف فقط للقيم التي لا تديرها اللوحة.

• بعد نحو 3 ثوانٍ من البدء، ثم كل ts.ServerPerf.configSyncIntervalSec ثانية (القيمة المرفقة 120، والحد الأدنى 20، والبديل 60)، تكتب سجلات ac_settings فوق قيم ts.
• المفاتيح ذات النقاط مثل AdminMenu.enable تكتب حقولًا متداخلة. المفاتيح المسطحة القديمة مثل framework أو moneyCheck تُحوَّل أولًا.
• المفتاح الذي يبدأ بـ punishment_ يكتب ts.DetectionPunishments لذلك الاكتشاف. القيمتان BAN و KICK تبقيان؛ وأي قيمة أخرى تصبح LOG.
• حقول الإجراء تُوحَّد إلى ban أو kick أو log أو cancel أو reject أو stop. أي قيمة أخرى تصبح log.
• المفاتيح التي تبدأ بـ globalBan. تُتجاهل.
• قوائم اللوحة تستبدل قوائم الإعدادات: الأسلحة، والقائمة السوداء للمركبات، واللوحات، وقائمة المشغّلات (trigger list)، وحدود الأحداث، والموارد في القائمة البيضاء، وكلمات OCR، وقوائم Blacklist، وقائمة الانفجارات، وقوائم الكيانات البيضاء. أما الموارد في القائمة البيضاء وكلمات OCR من قاعدة البيانات فتُدمج بدل الاستبدال.
• استثناء: معالجات ts.EventLimiter و ts.ProtectedEvents تُسجَّل مرة واحدة من الملف عند التحميل. تغييرات اللوحة اللاحقة لا تغيّر الفرض على جانب الخادم لها.
• بعد أي تغيير، تُعاد إلى العملاء فقط المفاتيح الآمنة لجانب العميل.
• شغّل tosunac_doctor في وحدة التحكم لمراجعة القيم الخطرة بعد مزامنة اللوحة.

• الإعدادات والأداء
• إعداد اللوحة

الإعدادات الأساسية#

مفاتيح المستوى الأعلى قرب بداية configs/anticheat_config.lua. يمكن ضبط معظمها من اللوحة أيضًا.

أقسام الإعدادات: الاكتشافات والعقوبات#

أقسام تحدد ما يُكتشف ومدى شدة عقوبته.

أقسام الإعدادات: الحراس على جانب الخادم#

حراس يعملون على الخادم. عدة منهم يلغون الحدث أولًا ولا يعاقبون إلا بعد مخالفات متكررة.

أقسام الإعدادات: الاتصال والإدارة واللوحة#

أقسام خاصة بانضمام اللاعبين، وقائمة الإدارة، والاتصال باللوحة، والسلوك على مستوى الخادم.

أقسام الإعدادات: الموارد والأحداث والتكامل#

أقسام خاصة بالثقة في الموارد، والماسحات، وتكامل المطورين. الصفوف المعلَّمة "للمطورين" تهم فقط عندما تستدعي سكربتاتك الخاصة الـ AC.

• Exports
• الأحداث
• إطار العمل

أقسام الإعدادات: القوائم#

القوائم الافتراضية في configs/anticheat_config.lua. معظمها تستبدله جداول اللوحة عند المزامنة.

مفاتيح بلا تأثير، ومفاتيح غير موجودة في الملف#

بعض المفاتيح في configs/anticheat_config.lua لا يقرؤها الكود في 9.6.15. تغييرها بلا تأثير.

يقرأ الكود أيضًا مفاتيح غير موجودة في الملف. أضفها بنفسك إذا احتجت إليها: ts.v12.joinFloodWindowSec (60)، و ts.v12.joinFloodMaxJoins (6)، و ts.v12.bannedCountries (رموز دول؛ قائمة منع جغرافية)، و ts.v6Enforcement.heuristic (يستبدل قائمة أنواع الاستدلال)، و ts.LiveWatch.fps (30)، و ts.SafeEventMaxArgs (64)، و always = true في أحداث الخادم ضمن ts.DetectionExempt.

مفاتيح العميل هذه تُقرأ لكنها غير موجودة في الملف، وتكون مفعّلة ما لم تُضبط على false: ts.antiScreenshotBypass و ts.antiRateOfFire و ts.antiNetOwnership. كما يُقرأ ts.microJitterMeanMin (0.5) وهو غير موجود في الملف.

• ts.NetworkJoin.minimalSync
• ts.AdminMenu.espMaxDistance و ts.AdminMenu.screenshotTimeout (الـ ESP يستخدم espMaxDist)
• ts.AdminMenu.permissionLevel (تسمية قديمة؛ الوصول يأتي من صلاحيات ACE والقوائم والمنح)
• ts.ResourceGuard.strictClientDiff
• ts.LiveWatch.enabled و preferTosunRender و maxConcurrent
• ts.PhoneNotify.enabled و onBan و onDetect

تعليقات قديمة في ملف الإعدادات#

بعض التعليقات داخل configs/anticheat_config.lua تصف سلوكًا قديمًا. الكود يعمل كما يلي.

• يقول التعليق إن إعدادات اللوحة تُعاد مزامنتها كل 30 ثانية. الفترة هي ts.ServerPerf.configSyncIntervalSec (القيمة المرفقة 120 ثانية).
• يقول التعليق إن tosunac_setup يضيف الأحداث إلى القائمة البيضاء. هو يفهرسها فقط؛ و ts.EventScanner.autoProtect هو من يقرر الحماية.
• تعليق ts.ProtectedEvents يحذّر من أن أحداث أطر العمل تسبب حظرًا خاطئًا. الاستدعاءات بلا مفتاح تُرفض وتُسجَّل، ولا تُعاقَب أبدًا.
• تعليق ts.EventLimiter يقول إنه يعمل عند تجاوز الحد. هو يُطلق عندما يصل العدد إلى القيمة.
• تعليق الجسر يوصي باستخدام setr مع convars الجسر الأربعة كلها. فقط tosun_ac_resource و tosun_ac_bridge_client_ms يحتاجان إلى setr.
• تعليق ts.Locale يُغفل ar، لكن locales/ar.json مرفق.

convars التقوية في FiveM التي يتحقق منها الـ AC#

وحدتان تقرآن convars FiveM عند البدء. حارس الـ convars (ts.hardening) يعمل بعد نحو 8 ثوانٍ من البدء ويعتبر القيمة غير المضبوطة ضعيفة. تدقيق server.cfg (ts.cfgAudit) يعمل بعد 15 ثانية من البدء وهو للقراءة فقط.

مفاتيح التقوية ومخرجاتها#

كلا الفحصين يكتفي بالإبلاغ افتراضيًا. غيّرهما في configs/anticheat_config.lua.

• ts.hardening.enabled = false يتخطى حارس الـ convars.
• ts.hardening.autoApply = true (القيمة المرفقة false) يجعل الـ AC ينفّذ set بنفسه للـ convars الستة الآمنة. sv_entityLockdown و sv_pureLevel لا يُطبَّقان تلقائيًا أبدًا.
• ts.cfgAudit.enabled = false يوقف تدقيق server.cfg.
• حارس الـ convars يطبع تحذيرًا في وحدة التحكم ويكتب سجلًا واحدًا في ac_detections (detection_type hardening_missing) يذكر كل convar ضعيف.
• التدقيق يطبع تحذيرًا في وحدة التحكم ويكتب سجلًا واحدًا في admin_logs بعدد الإعدادات الضعيفة.
• نص وحدة التحكم في كلا الفحصين مكتوب بالتركية بشكل ثابت في الكود. كل سطر تحذير من الحارس يعرض سطر set الدقيق الذي يجب إضافته.
• tosunac_doctor تقرير منفصل في وحدة التحكم عن إعدادات الـ AC الخطرة، وليس عن convars FiveM.

أخطاء شائعة#

تحقق من هذه النقاط قبل أن تفتح تذكرة دعم.

• بيانات اعتماد مضبوطة بـ setr أو sets: تصل إلى كل عميل أو إلى معلومات الخادم العامة.
• بيانات اعتماد موضوعة بعد ensure tosun-ac: لا تُلتقط حتى إعادة تشغيل المورد التالية.
• مفتاح لوحة في configs/anticheat_config.lua: الملف يُرسل إلى العملاء ووحدة التحكم تطبع تحذير MIGRATION.
• tosun_render غير مشغّل: إنه تبعية إلزامية.
• ترك ts.Framework.framework على "qb" في خادم ESX أو Qbox.
• ترك ts.Locale على "tr" في خادم لا يستخدم التركية.
• ترك ts.appealDiscord على رابط Discord الخاص بالمطوّر.
• ضبط ts.punishType على LOG أو KICK: يصبح الحظر اليدوي أيضًا تسجيلًا أو طردًا.
• add_ace builtin.everyone command allow: كل لاعب يتخطى فحوص VPN والدولة.
• توقّع أن tosun.admin يفتح tosunac_setup: ذلك يتطلب tosunac.admin مع command.tosunac_setup.
• توقّع أن مشرفي txAdmin يستطيعون فتح قائمة الـ AC: صلاحيات ACE الخاصة بـ txAdmin تمنح حالة الطاقم فقط. أضف tosun.admin أو منحًا من اللوحة.
• set tosun_db_bridge_enabled "0" بدون tosun_db_bridge_manual "1": يُتجاهل السطر.
• ترك ts.Debug على true: تجاوزات الطاقم والقائمة البيضاء تكون متوقفة.

• البداية
• الأوامر