Agency-Banking: مصرف متكامل لـFiveM، مع إطار عمل أو بدونه

بنك متكامل لمدينتك

يحوّل Agency-Banking كل فرع بنك وكل صرّاف آلي إلى تطبيق مصرفي متكامل. يرى اللاعبون رصيد البنك والنقد جنبًا إلى جنب، ويرسلون الأموال ويديرون البطاقات والودائع لأجل والاستثمارات في مكان واحد. يعمل على QBCore أو Qbox أو ESX، وعلى الخادم الذي لا يستخدم إطار عمل، يحتفظ بحساباته الخاصة. المورد الوحيد المطلوب هو oxmysql.

كل شيء في القائمة

• المحفظة: رصيد البنك والنقد، والإيداعات والسحوبات.
• التحويلات: حسب معرّف الخادم أو إلى لاعب يقف بالقرب منك.
• البطاقات: بطاقات مصرفية بأربعة ألوان.
• رمز PIN للصراف الآلي: قفل لمدة 60 ثانية بعد خمس محاولات خاطئة.
• الودائع لأجل: 7 أو 14 أو 30 يومًا افتراضيًا، بأسعار تحددها إعدادات الخادم وليس اللاعب.
• الأسواق: تداول الأسهم والعملات الرقمية.
• سجل النشاط: سجل كامل للحساب.

اكتشاف إطار العمل أو الوضع المستقل

اترك إعداد إطار العمل على الوضع التلقائي، وسيكتشف البنك QBCore أو Qbox أو ESX بنفسه، حتى لو بدأ أحدها متأخرًا. عند كل تشغيل، تعرض وحدة تحكم الخادم إطار العمل الذي اكتشفه البنك أو تؤكد أنه يعمل بوضع standalone. لا يُختار وضع standalone إلا إذا لم يكن أي منها مثبتًا.

في وضع standalone، يُعرَف اللاعبون من خلال ترخيص Rockstar، ويُحدَّد المسؤولون عبر ACE أو قائمة تراخيص في الإعدادات. يحتفظ البنك نفسه بالأرصدة والنقد. عند تثبيت Agency-Phone، يشترك الهاتف والبنك في الرصيد نفسه، ويمكن للخوادم التي تستخدم نظام أموال خاصًا بها ربطه عبر بضعة hooks في الإعدادات.

نظام الأموال لبقية سكربتاتك

تعمل صادرات الخادم بالطريقة نفسها على جميع أطر العمل. وعلى خادم standalone، تكون هي نظام الأموال: يدفع متجر أو وظيفة أو مرآب للاعبين ويخصم منهم عبر البنك، ويعرض البنك المفتوح الرصيد الجديد فورًا.

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

تتوفر المجموعة نفسها للنقد باستخدام AddCashMoney و RemoveCashMoney، إلى جانب GetBankBalance, GetCashBalance, AddTransaction لسجل النشاط و GetFramework. على QBCore وESX، يتابع البنك المفتوح تغييرات أموال إطار العمل تلقائيًا. بعد أي تغيير آخر، شغّل agency_banking:client:MoneyChanged لذلك اللاعب.

التحقق على الخادم

تُتحقَّق على الخادم من المدفوعات وأسعار الفائدة والودائع لأجل والبطاقات والمعاملات، لذا لا يستطيع عميل معدّل إنشاء الأموال أو الوصول إلى بطاقات اللاعبين الآخرين. لا يمنح اقتران Companion أي صلاحيات مصرفية بحد ذاته: يُعاد التحقق من كل إجراء مالي صادر عن التطبيق على الخادم.

تصميمان وشريط لضبط الحجم

تتبع القائمة تصميم Agency: لوحة داكنة ثابتة، ولمسات ذهبية، وأزرار بشكل كبسولة، وتمييز ذهبي ينزلق على طول الشريط الجانبي. ويمكن للخوادم التي تفضّل المظهر الأزرق الكلاسيكي تبديل إعداد التصميم إلى v1 مع الاحتفاظ بكل الميزات.

يمكن لكل لاعب تغيير حجم البنك من 60 إلى 150 بالمئة بخطوات قدرها 1 بالمئة من الإعدادات، ويحتفظ كل لاعب بحجمه الخاص. يدعم البنك 13 لغة ويفتح عند العلامات أو عبر qb-target أو ox_target.

الإعداد والتحديثات

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

التحديثات مجانية لكل من يملك Agency-Banking بالفعل. تبقى الحسابات والبطاقات والمعاملات والودائع الثابتة وعمليات الاقتران مع Companion محفوظة بعد التحديث. استخدم ملف config.lua الجديد بدلًا من استبداله بالقديم، وشغّل refresh قبل إعادة تشغيل المورد عند تغيير manifest.

الخدمات المصرفية على الهاتف الحقيقي

يتوافق Agency-Banking مع تطبيق Agency Companion المجاني على iOS وAndroid، بشكل مستقل ومن دون الحاجة إلى Agency-Phone: الرصيد والتحويلات والبطاقات والودائع الثابتة ورقم PIN للصراف الآلي أثناء التنقل. يقترن اللاعبون عبر /abconnect، وهي قصيرة /abc، أو باستخدام رمز QR داخل قائمة البنك.

احصل على Agency-Banking

يتوفر Agency-Banking في متجر Agency Scripts، و الوثائق يشمل الإعدادات وعمليات التصدير والأحداث.