التثبيت

المونيتور يستبدل txAdmin الذي يأتي مع ملفات السيرفر (artifacts). ريسورس txAdmin اسمه دائمًا monitor.

1. النسخ الاحتياطي

خذ نسخة احتياطية من مجلد txData ومن مجلد monitor الأصلي قبل استبدال أي شيء.

2. استبدال مجلد monitor

txAdmin المدمج موجود في ملفات السيرفر:

<artifacts>/citizen/system_resources/monitor

1. أوقف السيرفر.
2. غيّر اسم المجلد الأصلي إلى monitor_backup.
3. انسخ مجلد monitor الخاص بـ MG مكانه.

تحديث ملفات السيرفر

تحديث ملفات السيرفر (artifacts) يُرجع txAdmin الأصلي. بعد كل تحديث، انسخ مجلد monitor الخاص بـ MG مرة أخرى.

3. إضافة الصلاحيات في server.cfg

المونيتور يدير صلاحيات الأدمن داخل اللعبة، لذلك يحتاج صلاحية إضافة وحذف الـ aces:

add_ace resource.monitor command.add_ace allow
add_ace resource.monitor command.remove_ace allow
add_ace resource.monitor command.add_principal allow
add_ace resource.monitor command.remove_principal allow

4. سطر الأنتي تشيت

أول سطرين في fxmanifest.lua يحمّلان WaveShield:

shared_script '@WaveShield/resource/include.lua'
shared_script '@WaveShield/resource/waveshield.js'

لا تستخدم WaveShield؟

احذف هذين السطرين، وإلا لن يعمل المونيتور.

5. تشغيل السيرفر

أعد تشغيل السيرفر بالكامل. لا تعد تشغيل ريسورس monitor وحده أبدًا.

عند التشغيل، يطبع الكونسول تقرير توافق يوضح الفريموورك والإنفنتوري والريسورسات الأخرى التي تم التعرف عليها.

6. الإعداد

• افتح بورت 40120 لتستخدم لوحة الويب من جهازك الشخصي.
• اضبط بوت الديسكورد وتسجيل الدخول بالرتب لفريق الإدارة.
• راجع config.lua. كل شيء مضبوط على auto، فغالبًا تحتاج فقط تغيير مكان المستشفى:

Config.QBXBridge = {
  Hospital = {
    coords = vector4(-917.0033, -766.269, 17.9402, 0.0),
  }
}

فرض نظام معيّن

إذا اختار التعرف التلقائي ريسورس خاطئ، اكتب اسمه بالضبط:

Config.Compatibility.Framework = 'qb-core'
Config.Compatibility.Inventory = 'qb-inventory'
Config.Compatibility.Appearance = 'illenium-appearance'

استخدم false أو 'none' لإيقاف نوع معيّن. أعد تشغيل السيرفر بالكامل بعد التغيير.

أعمدة قاعدة بيانات مخصصة

إذا كان الفريموورك عندك يستخدم أسماء جداول أو أعمدة مختلفة، حددها في Config.Compatibility.Database:

Database = {
  PlayersTable = 'players',
  VehiclesTable = 'player_vehicles',
  CitizenIdColumn = 'citizenid',
  LicenseColumn = 'license',
  MoneyColumn = 'money',
  JobColumn = 'job',
  GangColumn = 'gang',
  CharInfoColumn = 'charinfo'
},

إعدادات المركبات

VehicleDefaults = {
  Garage = 'pillboxgarage',  -- garage for vehicles given with /givecar
  State = 1,
  PlatePrefix = 'TX'
},

Garage هو الكراج الذي توضع فيه المركبات المعطاة بأمر /givecar.

حل المشاكل

• /pedmenu يفتح قائمة خاطئة: سكربت الملابس عندك يسجّل أمر /pedmenu خاص به. أوقفه هناك (Config.EnablePedMenu = false) ليصبح الأمر لـ txAdmin.
• الإجراءات لا تعمل: راجع تقرير التوافق عند التشغيل، وافرض الريسورس الصحيح في Config.Compatibility.
• اللوحة ما زالت txAdmin القديم: مجلد monitor الأصلي ما زال في ملفات السيرفر. كرر الخطوة 2.