Configuration

الإعدادات

كل ما يُفترض بصاحب السيرفر تعديله تجده داخل config.lua، وقد تم التعليق على الملف قسمًا بعد قسم. الصلاحيات والمدّة والحدود مشروحة في Permissions & Duration؛ وللويب هوك صفحة خاصة به. هذه الصفحة تغطي باقي التفاصيل.

العام

config.lua

Config.Command      = 'status'
Config.Keybind      = ''             -- 'F6', 'F7', 'INSERT'… فارغ لتعطيلها
Config.ClearCommand = 'statusclear'
Config.Debug        = false

النص داخل العالم

ما يراه اللاعبون الآخرون عائمًا فوق الشخصية (Ped).

الخيار	القيمة الافتراضية	الغرض
`Config.Text.ViewDistance`	`6.0`	لا يتم رسم أي شيء بعد هذه المسافة، بالمتر.
`Config.Text.ScanInterval`	`800`	عدد المرات (بالميللي ثانية) التي يعيد فيها العميل فحص اللاعبين القريبين الذين يحملون ملاحظات. القيمة الأعلى توفر أداءً أفضل لكنها تظهر بشكل أبطأ.
`Config.Text.Size`	`0.34`	الحجم الأساسي؛ يتغير مقياس السكربت تلقائيًا مع مسافة الكاميرا أيضًا.
`Config.Text.Font`	`4`	رقم خط GTA — 0 لـ chalet، 1 لـ sign، 2 لـ slab، 4 لـ chalet comprime، 7 لـ pricedown.
`Config.Text.Outline`	`true`	إطار داكن خلف النص ليبقى مقروءًا على أي سطح.
`Config.Text.MinScale` / `MaxScale`	`0.10` / `0.58`	حدود لضمان ألا يصبح النص غير مقروء أو كبيرًا بشكل مبالغ فيه.
`Config.Text.Alpha`	`225`	شفافية النص، من 0 إلى 255.
`Config.Text.ColorBySeverity`	`true`	تلوين النص بلون درجة الخطورة. `false` = أبيض دائماً.
`Config.Text.White`	`255, 255, 255`	اللون المستخدم عندما يكون تلوين الخطورة معطلاً أو غير معروف.
`Config.Text.OnlyWhileAiming`	`false`	الرسم فقط أثناء ضغط المراقب على زر التصويب.

الكاميرا

تفتح اللوحة فوق واجهة شفافة وتتولى كاميرا اللعبة الباقي.

الخيار	القيمة الافتراضية	الغرض
`Config.Camera.AutoFrame`	`true`	قياس الشخصية من الرأس إلى القدمين وتأطيرها تلقائيًا. مُوصى به — يعمل مع أي نموذج شخصية.
`Config.Camera.Fill`	`0.88`	النسبة التي يملؤها الجسم من ارتفاع الشاشة عندما يكون خيار `AutoFrame` مفعلًا.
`Config.Camera.VerticalNudge`	`0.0`	ضبط دقيق بالمتر. القيم الموجبة تحرك الشخصية للأسفل على الشاشة.
`Config.Camera.Distance`	`3.35`	المسافة عن الشخصية — تُستخدم فقط عندما يكون `AutoFrame` معطلاً (`false`).
`Config.Camera.Height`	`0.95`	الارتفاع الذي تنظر إليه الكاميرا — يُستخدم فقط عندما يكون `AutoFrame` معطلاً (`false`).
`Config.Camera.SideOffset`	`0.45`	يدفع الشخصية إلى اليسار لكي لا تغطيها اللوحة أبدًا. `0` يضعها في المنتصف.
`Config.Camera.Fov`	`34.0`	القيمة الأقل تعطي طابع عدسة بورتريه مع تشوه أقل.
`Config.Camera.ZoomMin` / `ZoomMax` / `ZoomStep`	`1.60` / `4.60` / `0.20`	حدود التقريب والخطوة لكل ضغطة زر.
`Config.Camera.RotateSensitivity`	`0.6`	الدرجات التي تدور بها الشخصية لكل بكسل من سحب الماوس.
`Config.Camera.FreezePlayer`	`true`	تجميد الشخصية أثناء فتح اللوحة.
`Config.Camera.HideRadar`	`true`	إخفاء الخريطة المصغرة أثناء فتح اللوحة.
`Config.Camera.HotspotRefresh`	`30`	معدل تحديث (بالميللي ثانية) إرسال مواضع العظام إلى الواجهة. ارفعها إلى 50–60 في السيرفرات المزدحمة جدًا.

ℹ

عندما يكون خيار AutoFrame مفعلًا، يتم اشتقاق حدود التقريب من الإطار المقاس بدلاً من ZoomMin / ZoomMax، لكي تؤدي الأزرار دائمًا وظيفة منطقية بغض النظر عن حجم الشخصية.

الواجهة

config.lua

Config.UI = {
    Accent        = '#5b6cf0',  -- أي لون CSS
    Watermark     = true,       -- علامة مائية مرسومة يدويًا "Status" خلف الشخصية
    ShowSeverity  = true,
    ShowTypes     = true,
    CloseOnEscape = true,
}

الأنواع ودرجات الخطورة

كلاهما قائمتان بسيطتان. تتكيف الواجهة مع أي شيء تدخله فيهما؛ وتأتي التسميات من ملفات اللغة.

config.lua

Config.Types = {
    { id = 'injury',  icon = 'activity' },  -- التسمية: type_injury
    { id = 'bandage', icon = 'plus'     },
    { id = 'note',    icon = 'message'  },
}

Config.Severities = {
    { id = 'minor',    color = { r = 143, g = 214, b = 171 } },
    { id = 'moderate', color = { r = 195, g = 201, b = 209 } },
    { id = 'severe',   color = { r = 255, g = 154, b = 157 } },
}

خيار icon هو اسم أيقونة lucide يتم عرضها بواسطة الواجهة. إضافة مدخل جديد تتطلب وجود سطر مطابق لـ type_<id> أو sev_<id> في كل ملف لغة.

أجزاء الجسم

تتوفر ستة عشر منطقة افتراضيًا، وكل منها مثبتة على عظمة شخصية في GTA.

config.lua

{ id = 'head', bone = 31086, offset = { x = 0.0, y = 0.0, z = 0.28 } },

الحقل	المعنى
`bone`	رقم فهرس عظمة الشخصية التي يُثبت عليها التنبيه.
`offset`	يزيح النص العائم داخل العالم بعيدًا عن العظمة لكي لا يظهر داخل نموذج الشخصية. ارفع قيمة `z` إذا كان النص يتداخل مع الملابس. هذا الخيار لا يحرك المؤشر القابل للنقر.
`marker`	اختياري. يقوم بإزاحة المؤشر القابل للنقر داخل اللوحة فقط. إذا تركت هذا الخيار فارغًا، سيستقر المؤشر تمامًا على العظمة، وهو الوضع الصحيح في جميع الحالات تقريبا.

إزالة أي مدخل تخفي تلك المنطقة من كل مكان. وإضافة مدخل جديد تتطلب رقم فهرس عظمة صحيح وسطرًا مطابقًا لـ bp_<id> في كل ملف لغة.

متقدم

config.lua

Config.Table = 'bupa_syncstatus'  -- يُنشأ تلقائيًا عند التشغيل لأول مرة

جداول البحث في أسفل ملف config.lua (Config.BodyPartMap، Config.TypeMap، Config.SeverityMap) يتم إنشاؤها تلقائيًا من القوائم أعلاه عند

PreviousPermissions & Duration Next Discord Logging