توثيق Pulse Phone
المتطلبات
2. المتطلبات
| ماذا | مطلوب؟ | ما يحدث بدونه |
|---|---|---|
| تفعيل OneSync | مطلوب | يفشل فحص بدء التشغيل مع OneSync ... off. أضف set onesync on. |
| إصدار اللعبة 2699 أو أحدث | مطلوب | لا يتم تحميل موديل الهاتف (stream). اضبط sv_enforceGameBuild. |
| oxmysql (أو ghmattimysql، mysql-async) على MariaDB 10.6+ أو MySQL 8 | يُنصح به | عند عدم تشغيل أي ريسورس SQL، تُحفظ البيانات في مخزن key/value الخاص بالسيرفر. وهو دائم، لكن لا يمكنك الاستعلام منه، ومع أكثر من 30 لاعبًا تقريبًا يجب أن تستخدم قاعدة بيانات. |
| سكربت صوت: pma-voice أو mumble-voip أو SaltyChat أو TokoVOIP أو YACA | يُنصح به | تتصل المكالمات لكن بدون صوت. |
| screenshot-basic | يُنصح به (الريسورس الأصلي، أو النسخة الأخف في تحميلك: راجع البدء السريع، الخطوة 6) | تؤطّر الكاميرا اللقطات لكنها لا تستطيع حفظ الصور. |
| framework | اختياري | يعمل الهاتف بوضع standalone: الهواتف مرتبطة بـ licence اللاعب، والهاتف يحتفظ ببنك خاص به. |
كتلة server.cfg كاملة:
set onesync on
set sv_enforceGameBuild 2699 # or newer
ensure oxmysql
# ... your framework, then your inventory, banking, garage and housing scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
# ... scripts that use the phone ...قاعدة البيانات. أي مخزن يستخدمه الهاتف يتحدد عند كل تشغيل:
| سيرفرك | أين يحفظ الهاتف بياناته |
|---|---|
| oxmysql أو mysql-async أو ghmattimysql يعمل، وقاعدة البيانات تستجيب | قاعدة البيانات. تُنشأ الجداول عند أول تشغيل وتُضاف الجديدة تلقائيًا بعد كل تحديث. |
| لا يعمل أي ريسورس SQL إطلاقًا | مخزن key/value الخاص بالسيرفر، تلقائيًا. وهو دائم بعد إعادة التشغيل لكن لا يمكن الاستعلام منه. مع أكثر من 30 لاعبًا تقريبًا، أو إذا حذّر الكونسول من أن حفظ المخزن بطيء، استخدم قاعدة بيانات. |
| ريسورس SQL يعمل، لكن قاعدة البيانات لا تستجيب خلال 30 ثانية | لا يُحفظ شيء حتى تستجيب. يوضح الكونسول السبب، ويعيد الهاتف المحاولة كل 15 إلى 60 ثانية ويُكمل التشغيل بنفسه بمجرد أن تستجيب قاعدة البيانات. |
في الحالة الأخيرة يمكنك أن تطلب من الهاتف استخدام مخزن key/value بدلًا من ذلك عبر set phone_db_fallback "kvp" في server.cfg؛ تلك البيانات تبقى في مخزن key/value ولا تُنسخ إلى قاعدة البيانات لاحقًا أبدًا، لذا استخدمه على سيرفر اختبار، وليس كحل التفافي لاتصال معطّل. كل استعلام له أيضًا مهلة 10 ثوانٍ: الاستعلام الذي لا تستجيب له قاعدة البيانات أبدًا يُبلَّغ عنه كفاشل للتطبيق الذي طلبه، ويذكر الكونسول ذلك الاستعلام مرة واحدة.
قواعد البيانات المدعومة: MariaDB 10.6 أو أحدث، أو MySQL 8.0 أو أحدث. ملف phone.sql لكل إصدار يُختبر على قاعدة بيانات MariaDB جديدة تعمل بوضع SQL الخاص بـ MySQL 8 قبل بناء الحزمة. الإصدارات الأقدم (MariaDB 10.4 أو 10.5، وMySQL 5.7) غير مختبرة وغير مدعومة، حتى لو كانت قد تعمل.
ملف phone.sql مخصص فقط للاستضافات التي لا تسمح للريسورس بإنشاء الجداول. لا يُذكر فيه أي collation: يُطبَّق الافتراضي utf8mb4 الخاص بسيرفرك، كما يحدث عندما ينشئ الهاتف الجداول بنفسه. تشغيله آمن على قاعدة بيانات موجودة، وتشغيل الملف الجديد مرة أخرى بعد التحديث يضيف فقط ما هو ناقص.
يمكن أن يبقى sv_stateBagStrictMode مفعّلًا. كل ما يراه اللاعبون الآخرون من الهاتف (حركة الإمساك، والهاتف في اليد، وشاشته، والكشاف) يضبطه السيرفر بعد التحقق من القيمة، وليس لعبة اللاعب أبدًا.
تغيير الهاتف
جداول هاتف آخر. إذا ترك هاتف استخدمته سابقًا جداول بنفس الأسماء (مثلًا phone_messages)، يُعاد تسميتها إلى old_<name> عند أول تشغيل، حتى يتمكن Pulse Phone من إنشاء جداوله. لا يُحذف شيء. إذا كان مستخدم قاعدة البيانات لا يملك صلاحية إعادة تسمية الجداول، يُظهر فحص بدء التشغيل [FAIL] Database مع أسماء الجداول: امنح المستخدم صلاحيات ALTER، أو أعِد تسمية كل جدول إلى old_<name> في أداة قاعدة البيانات لديك (HeidiSQL، phpMyAdmin)، وأعِد التشغيل.