Agency-Admin لوحة الويب
لوحة إدارة لـ FiveM بتصميم Agency مع لوحة ويب كاملة على حاسوبك.

1 لوحة الويب في Agency Companion
يوفر Agency-Admin لوحة إدارة كاملة لجهاز الكمبيوتر: companion.agencyg.de/app/admin. تعمل داخل Agency Companion في متصفحك وتصل إلى خادمك عبر وسيط Agency المشفر، تماماً مثل تطبيق الهاتف. لا حاجة إلى فتح أي منفذ ولا يُستضاف أي شيء على خادم اللعبة.
| الصفحة | ما يمكنك فعله |
|---|---|
| لوحة المعلومات | اللاعبون المتصلون، زمن التكرار (tick)، مدة التشغيل، الموارد، الأموال في المدينة، الإجراءات الأخيرة |
| اللاعبون | كل إجراء إداري من لوحة اللعبة، الرسائل والتحذيرات، عرض مباشر لشاشة اللاعب |
| وحدة التحكم المباشرة | وحدة تحكم الخادم كاملة، وأوامر تُنفَّذ بصفة وحدة تحكم الخادم |
| الموارد | تشغيل أي مورد وإيقافه وإعادة تشغيله، وإعادة فحص قائمة الموارد |
| الإعدادات | ملفات الإعدادات لكل مورد على خادمك، تُحرَّر كإعدادات أو ككود |
| الملفات | مدير ملفات مع محرر لمواردك |
| الحظر، سجل الإجراءات، الفريق والرتب، التحكم بالخادم | الحظر دون اتصال، سجل كل إجراء إداري، إعادة تشغيل الخادم أو إيقافه مع عدّ تنازلي |
لوحة الويب مصممة لجهاز الكمبيوتر. على الهاتف أو الجهاز اللوحي استخدم تطبيق Agency Companion، ففيه وحدة الإدارة مدمجة.
2 الاتصال
داخل اللعبة افتح قائمة الإدارة، وانتقل إلى Web Panel ثم انقر فتح في المتصفح، أو اكتب /webpanel. يفتح المتصفح اللوحة ويسجّل دخولك فوراً.
على جهاز كمبيوتر آخر افتح companion.agencyg.de/app/admin وأدخل الرمز المكوَّن من 6 أرقام من صفحة Web Panel. الرمز صالح لمدة 5 دقائق.
يمكنك ربط أي عدد من الخوادم التي تديرها والتبديل بينها داخل اللوحة. كل اتصال هو جهاز مقترن، ويمكنك تسجيل خروجه داخل اللعبة من Settings > Companion.
3 الصلاحيات والأمان
يحتفظ المتصفح برمز جهاز مثل التطبيق. يُتحقق من كل نقرة مباشرة على خادمك وفق رتبة المسؤول وصلاحياته، بنفس حد المعدل وسجل الإجراءات المستخدمين داخل اللعبة.
| الصلاحية | ما تتيحه | موروثة |
|---|---|---|
companion_console | وحدة التحكم المباشرة والموارد | نعم |
server_power | إعادة تشغيل الخادم وإيقافه | لا، الرتبة العليا فقط والرتب التي تحددها |
web_files | الملفات والإعدادات | لا، الرتبة العليا فقط والرتب التي تحددها |
دون التواجد في اللعبة. مثل txAdmin، تعمل لوحة الويب أيضاً حين لا تكون على الخادم. يتذكر Agency-Admin صلاحيات كل مسؤول منذ آخر مرة دخل فيها اللعبة، حتى لو جاءت من ACE أو من الإطار (صلاحيات QBCore، مجموعات ESX)، ويبقيها محدّثة أثناء لعبهم. المسؤول الذي يبقى على الخادم ثلاث دقائق دون صلاحية الوصول إلى اللوحة تُحذف صلاحياته المتذكَّرة. أما الصلاحيات التي تحددها للاعب في اللوحة وتعيينات الرتب فلها الأولوية دائماً.
تُنفَّذ وحدة التحكم وإعادة فحص الموارد وإعادة تشغيل الخادم كأوامر وحدة تحكم. وتحتاج إلى سطر واحد في server.cfg:
add_ace resource.Agency-Admin command allow
4 إعدادات كل مورد
تعرض صفحة الإعدادات ملفات الإعدادات لكل مورد على خادمك، من أي مطوّر، وتعثر عليها تلقائياً: config.lua وshared/config.lua وconfig/*.lua وsettings.lua وconfig.json وكل ملف إعدادات يذكره ملف fxmanifest.lua الخاص بالمورد. لا يحتاج أي مورد إلى تسجيل أي شيء.
| العرض | ما يعرضه |
|---|---|
| الإعدادات | كل قيمة بسيطة (true أو false، أرقام، نصوص) على شكل مفتاح تبديل أو حقل، مع التعليق من الملف بجانبها، مجمّعة حسب القسم. تعديل قيمة يغيّر ذلك السطر وحده، ويبقى التنسيق والتعليقات كما هي. |
| الكود | الملف كاملاً مع تلوين الصياغة. |
يتحقق الحفظ من الصياغة على الخادم أولاً، فلا يُكتب ملف config.lua معطوب أبداً. تُحفظ النسخة القديمة قبل كل عملية حفظ (آخر 15 نسخة لكل ملف، في Agency-Admin/config_backups). يعيد الحفظ وإعادة التشغيل تشغيل المورد فوراً، وتستعيد الإصدارات السابقة نسخة قديمة.
تظهر الإعدادات المشفرة بواسطة FiveM Escrow مع رمز قفل ولا يمكن تحريرها.
5 إصدارات FXServer الأحدث: سطر واحد لكل مورد
تعزل إصدارات FXServer من حوالي 25770 فصاعداً نظام الملفات: لا يستطيع مورد الكتابة في مورد آخر إلا إذا سمح server.cfg بذلك قبل بدء الخادم. يتجاهل الخادم العامل هذه الأسطر. أضف سطراً لكل مورد تريد حفظ إعداداته من اللوحة، ثم أعد تشغيل الخادم مرة واحدة:
add_filesystem_permission Agency-Admin write qb-core
add_filesystem_permission Agency-Admin write Agency-Housing
عندما يكون سطر ناقصاً، تخبرك اللوحة بذلك عند الحفظ وتعرض الأسطر الدقيقة لنسخها، لهذا المورد أو لكل الموارد التي لها إعدادات دفعة واحدة. في txAdmin تلصقها في CFG Editor.
6 الملفات
تفتح صفحة الملفات كل مورد على خادمك مع مدير ملفات ومحرر: تصفّح الملفات والمجلدات وافتحها وعدّلها واحفظها وأنشئها وأعد تسميتها واحذفها، مع نفس السطر الواحد لكل مورد من القسم 5 للحفظ داخل الموارد الأخرى.
لا تسمح إصدارات FXServer الأحدث لأي مورد بقراءة مجلد الخادم أو server.cfg أو مجلدات الفئات مثل [standalone]. لذلك تعرض اللوحة فوق الموارد المجلدات المبنية من مواردك المثبتة، للقراءة فقط، مع ملاحظة. داخل المورد تعمل كالمعتاد. يُحرَّر server.cfg في txAdmin، في CFG Editor.
لا تُفتح الملفات الأكبر من Config.WebPanelFiles.MaxEditKb (1024 KB افتراضياً) في المحرر. يحوّل Config.WebPanelFiles.ReadOnly = true مدير الملفات إلى عارض فقط.