Agency-Housing: ابنِ منازل FiveM داخل اللعبة، لا في ملف إعدادات

المنازل تُبنى داخل المدينة

Agency-Housing نظام إسكان يعتمد على قاعدة بيانات لـ FiveM، وتُنشأ المنازل داخل اللعبة عبر أداة إنشاء بدلًا من ملف إعدادات مليء بالإحداثيات. ينفّذ المسؤول /acreatehouse، ويضع المدخل في موقعه، ويحدد حدود العقار، ويختار القالب الداخلي، ويسمي المنزل ويحدد سعره ثم يحفظه. ومنذ تلك اللحظة يصبح المنزل متاحًا لكل لاعب ويُخزّن في MySQL.

يكتشف السكربت QBCore وQBox وESX تلقائيًا، ويعمل مستقلًا بالكامل من دون أي إطار عمل. تُنشئ جداول قاعدة البيانات نفسها عند التشغيل الأول.

أداة الإنشاء

• المدخل: يُوضع تمامًا في موقع المسؤول.
• حدود العقار: تُحدد من الجو وتُخزّن كـ PolyZone.
• الداخلية: واحدة من 18 قالبًا داخليًا، أو داخلية مخصصة تُسجل داخل اللعبة.
• علامات الخريطة: تُضبط لكل منزل.

تتوفر القوائم بسبعة ألوان تمييز، لتتناسب واجهة الإسكان مع مظهر خادمك.

ما الذي يمكن للمالكين فعله

• شراء المنازل وبيعها، مع إمكانية ضبط المبالغ المستردة والحد الأقصى لكل لاعب.
• منح مفاتيح للاعبين آخرين واستعادتها منهم.
• تأثيث كامل قطعة الأرض بما يصل إلى 60 عنصرًا.
• قفل وفتح أبواب MLO الحقيقية التي يملكون مفاتيحها.
• استخدام نقاط المرآب والتخزين وخزانة الملابس، وتركيب ترقيات المنازل.
• الرد على جرس الباب.

مفتاحان ينجزان معظم المهام: F7 يفتح قائمة السكن و F3 يفتح قائمة المالك في عقارك. E يدخل إلى المنزل عند علامة الباب، ويرد على جرس الباب، ويقفل أبواب MLO أو يفتحها. تبدأ كل الأوامر بحرف "a"، مثل /ahousing و /ahousemenu، لذلك لا تتعارض مطلقًا مع الموارد الأخرى.

خزانة ملابس خاصة بها

منذ الإصدار 1.0.2، يتضمن Agency-Housing خزانة ملابس مدمجة. يحفظ اللاعبون ما يرتدونه باسم، ثم يعيدون ارتداءه عند أي خزانة ملابس في منازلهم، بحد أقصى 20 زيًا لكل لاعب. لا حاجة إلى سكربت ملابس، فهو يعمل مع جميع أطر العمل وبوضع standalone. وعند تثبيت illenium-appearance أو qb-clothing، يتعرف عليهما السكربت تلقائيًا. يفتح المشرفون خزانة الملابس المدمجة في أي مكان باستخدام /ahwardrobe.

أي إطار عمل، أو من دون إطار على الإطلاق

عند ترك الإعداد على auto، يختار السكربت إطار العمل تلقائيًا، حتى لو بدأ متأخرًا، وتعرض وحدة التحكم ما تم العثور عليه عند كل بدء تشغيل. إذا لم يكن QBCore أو QBox أو ESX مثبتًا، فسيعمل بوضع standalone: يجري تمييز اللاعبين عبر ترخيص Rockstar الخاص بهم، ويُحدَّد المشرفون عبر ACE أو قائمة تراخيص في الإعدادات، وتمر الأموال عبر ثلاث دوال ربط بسيطة. وإذا فضّلت، يمكنك جعل المنازل مجانية ببساطة.

تعمل عمليات شراء المنازل وبيعها، والمفاتيح، والأثاث، والترقيات، وأبواب MLO، وجرس الباب، وتطبيق Companion، وتحفظ البيانات كما هو الحال تمامًا على خادم يستخدم إطار عمل.

يجري اكتشاف نظام التخزين بالطريقة نفسها. وهو يعمل مع ox_inventory وqb-inventory 1 و2 وqs وps وlj وjpr. أما على الخادم الذي لا يحتوي على نظام مخزون، فلن تظهر نقطة التخزين.

لا حاجة إلى استيراد SQL

يُنشأ كل جدول وكل عمود جديد عند بدء التشغيل الأول، على MariaDB وMySQL 8. وللخوادم التي لا يملك فيها مستخدم قاعدة البيانات صلاحية إنشاء الجداول، sql/install.sql ما يزال مضمّنًا.

إدارة المنازل من العالم الحقيقي

يعمل Agency-Housing مع تطبيق Agency Companion المجاني على iOS وAndroid وiPad وMac وApple Watch. يستطيع اللاعبون قفل الأبواب وفتحها، وتسليم المفاتيح واستعادتها، والرد على جرس الباب، وشراء المنازل وبيعها، وتحديد مسار إلى أي من عقاراتهم. ويمكن لفريق الإدارة الانتقال الفوري، وإدراج المنازل للبيع أو حذفها.

تتم عملية الاقتران عبر /ahconnect، وهي قصيرة /ahc، باستخدام رمز QR أو رمز من ستة أرقام. يحتاج الخادم إلى اتصال HTTPS صادر إلى api.agencyg.de.

التحديث إلى 1.0.2

التحديث مجاني لكل من يملك Agency-Housing بالفعل. يتضمن الإعداد كتلة standalone جديدة وخيارات جديدة لخزانة الملابس، لذا احتفظ بنسخة احتياطية من قيمك، واستخدم ملف config.lua الجديد، وأعِد ضبطها. ستبقى المنازل والمفاتيح والأثاث وعمليات الاقتران بتطبيق Companion كما هي بعد التحديث، ولا يلزم استيراد أي شيء. لقد تغيّر ملف manifest، لذا نفّذ refresh قبل إعادة تشغيل المورد، أو أعد تشغيل الخادم.

احصل على Agency-Housing

يتوفر Agency-Housing في متجر Agency Scripts، و الوثائق يسرد جميع الأوامر وخيارات الإعدادات وعمليات التصدير.