توثيق Pulse Phone
Pulse Phone — البدء السريع
ثبّت ريسورسًا واحدًا اسمه phone. احتفظ بالـ framework والسكربتات المدعومة الموجودة لديك؛ وسيكتشفها Pulse عند تشغيله.
PhoneHub + Pulse إصدار منفصل بترخيص خاص به ونسخة خاصة به من هذا الهاتف. إذا اشتريت ذلك الإصدار، اتبع دليل التثبيت الخاص به بدلًا من هذا: السيرفر يشغّل ريسورس هاتف واحدًا.
1. افحص سيرفرك
| ماذا | مطلوب؟ |
|---|---|
| تفعيل OneSync، وإصدار اللعبة 2699 أو أحدث | مطلوب |
| قاعدة بيانات: oxmysql (أو mysql-async، ghmattimysql) على MariaDB 10.6+ أو MySQL 8 | يُنصح به. بدون ريسورس SQL يحفظ الهاتف بياناته في مخزن key/value الخاص بالسيرفر |
| ريسورس صوت واحد: pma-voice أو mumble-voip أو SaltyChat أو TokoVOIP أو YACA | يُنصح به. بدونه تتصل المكالمات لكن بدون صوت |
| screenshot-basic | يُنصح به، حتى تتمكن الكاميرا من حفظ الصور. الريسورس الأصلي يعمل |
| framework وinventory | اختياري. بدونهما يعمل الهاتف بوضع standalone |
شغّل قاعدة البيانات والـ framework والـ inventory وريسورس الصوت وscreenshot-basic قبل Pulse. راجع المتطلبات والـ framework الخاص بك للترتيب الصحيح.
خذ نسخة احتياطية من قاعدة بياناتك قبل أول تشغيل. ينشئ Pulse جداوله الخاصة. إذا ترك هاتف آخر جداول بنفس الأسماء، يُعاد تسميتها إلى old_<name> (لا يُحذف شيء)؛ والتفاصيل في المتطلبات.
2. انسخ مجلد phone
حمّل مشترياتك من حسابك على Cfx.re. انسخ مجلد phone الذي يحتوي على fxmanifest.lua إلى resources في سيرفرك. احتفظ باسمه. يجب أن يتبع مفتاح سيرفرك للحساب الذي يملك الـ asset.
الرفع عبر FTP (سيرفر مستضاف): استخدم وضع Binary (في FileZilla: Transfer > Transfer Type > Binary)، أو ارفع الـ zip وفك ضغطه على السيرفر. وضع Auto يغيّر الملفات المقفلة فيرفض الهاتف التشغيل؛ والأعراض والحل في حل المشاكل. يجب أن يطابق المجلد الذي ترفعه هذا الجدول؛ وفحص بدء التشغيل يذكر أي ملف مفقود أو بحجم خاطئ.
محتوى تنزيل Pulse Phone 1.4.2:
| المجلد أو الملف | الملفات | الحجم |
|---|---|---|
ui/ |
3,932 | 78.3 MB |
stream/ |
40 | 30.5 MB |
config/ |
138 | 23.2 MB |
d6c1e95a/ (الكود المقفل؛ يختلف اسمه من إصدار إلى آخر) |
7 | 5.5 MB |
data/ |
2 | 1.4 MB |
bridge/ |
55 | 0.5 MB |
guides/ |
13 | 0.2 MB |
phone.sql |
1 | 0.2 MB |
fxmanifest.lua |
1 | 6 KB |
مجلد phone كاملًا |
4,204 | 139.7 MB |
تحدّث تثبيتًا موجودًا؟ اتبع التحديث أولًا للحفاظ على الإعدادات ووسائط اللاعبين. أوقف ريسورس الهاتف السابق قبل الانتقال إلى Pulse.
3. أضف عناصر الـ inventory
افتح أنظمة الـ Inventory واتبع التعليمات الخاصة بالـ inventory الذي تستخدمه. التعريفات والصور المرفقة موجودة في config/items/. ادمج الإدخالات في الـ inventory الخاص بك؛ ولا تستبدل ملف العناصر بالكامل.
الـ inventory الافتراضي لـ ESX وQBCore يمكنهما تسجيل التعريفات الناقصة تلقائيًا. أنظمة inventory أخرى قد تتطلب الإدخالات المرفقة. انسخ صور العناصر إلى المكان الذي يتوقعه الـ inventory لديك. وضع standalone بدون inventory لا يحتاج إلى عناصر.
4. شغّل Pulse
أبقِ الاكتشاف التلقائي في config/config.lua. القسم الأول يحتوي على الـ framework، واللغة، واختيار الـ inventory، وعنصر الهاتف، والمفاتيح. الإعدادات الاختيارية مفهرسة في الإعدادات.
أضف هذا بعد الـ dependencies الموجودة لديك في server.cfg:
ensure phone
add_ace group.admin phone.admin allowأعِد تشغيل السيرفر. ينشئ Pulse جداول قاعدة البيانات عندما يكون اتصال SQL متاحًا. اقرأ فحصه في الكونسول واتبع أي تعليمات تصحيحية. شغّل phone:health لتكراره.
5. افتح هاتفك
ادخل كمسؤول، وافتح F8 واكتب phone:setup. أكّد الـ framework والـ inventory المكتشفين، ثم أكمل الإعداد الموجَّه. اضغط F1 أو استخدم /phone لفتح الهاتف. إذا كانت إعداداتك تتطلب عنصرًا، اشترِ هاتفًا واستخدم علبته من الـ inventory أولًا.
الإعدادات المحفوظة في Settings → Server تتجاوز الإعدادات المطابقة في الملفات. أعِد تعيين أي تجاوز محفوظ هناك إذا أردت أن تُطبَّق قيمة الملف مجددًا.
6. اختياري: screenshot-basic الأخف
يحتوي تحميلك أيضًا على مجلد screenshot-basic. وهو screenshot-basic من CitizenFX (بترخيص MIT) مع تغيير واحد: النسخة الأصلية تعيد رسم صورة اللعبة لطبقة الالتقاط في كل إطار، حتى عندما لا يلتقط أحد صورة، وهذه النسخة ترسم فقط أثناء التقاط صورة. اسم الريسورس، والـ exports الخاصة به (requestScreenshot، requestScreenshotUpload، requestClientScreenshot) وأحداثه لم تتغير، ويأتي مبنيًا مسبقًا، فلا يحتاج إلى بناء نفسه عند أول تشغيل. الملفات المتغيرة مذكورة في screenshot-basic/ZERODEV-CHANGES.md.
يعمل Pulse مع أي من النسختين، لذا هذه الخطوة اختيارية. سكربتات أخرى على سيرفرك تستخدم screenshot-basic أيضًا، لذا قم بالتبديل على سيرفر اختبار أولًا إذا كان لديك واحد:
- أعِد تسمية مجلد
screenshot-basicالحالي (مثلًا إلىscreenshot-basic.bak) وانقله خارجresources، حتى تتمكن من إعادته. - انسخ نسختنا إلى
resourcesبنفس الاسم،screenshot-basic، واحتفظ بنفس السطرensure screenshot-basic. - أعِد تشغيل السيرفر وجرّب كل سكربت يلتقط صورًا للشاشة: كاميرا الهاتف، وأي أداة تقارير أو أدلة أو bodycam تشغّلها.
- إذا تصرّف أي شيء بشكل مختلف، احذف نسختنا، وأعِد مجلدك القديم باسم
screenshot-basicوأعِد التشغيل.
أعدّ الميزات التي تستخدمها
- المكالمات والفيديو والـ Live: ريسورسات الصوت المدعومة، وأزرار التحكم بالمكالمات، وإعداد اتصال الفيديو للإنتاج.
- الصور والفيديوهات: التخزين المدمج، وFiveManage، وخيارات رفع أخرى. مفاتيح الخدمات الخاصة تبقى في إعدادات سيرفرك. على سيرفر مستضاف لا يمكن الوصول إلى منفذ الويب فيه، تحتاج الصور إلى FiveManage: سطران في
server.cfg(set phone_media_provider "fivemanage"وset phone_fivemanage_token "<token>"). - الإعدادات: المتاجر، والتطبيقات، والإكسسوارات، واللغات، والميزات الاختيارية.
- حل المشاكل: ابحث عن العَرَض واتبع حله.
- تكاملات المطورين: السكربتات المخصصة وإعدادات الاتصال المتقدمة.
التثبيت العادي لا يتطلب تعديل bridge/ أو ui/ أو stream/. أبقِ الريسورس كاملًا معًا، بما في ذلك ملفات الموديل والخريطة.