librg

جعل تطوير الألعاب متعددة اللاعبين أكثر بساطة منذ عام 2017. النسخ المتماثل العالمي عبر الأنظمة الأساسية برأس واحد في C99 النقي.

_{تم تصميمه بالحب باستخدام zpl • مقدم إليك بواسطة @inlife و@zpl-zak ومساهمين آخرين}

مقدمة

librg هي مكتبة خفيفة الوزن تعمل كوسيط بين مكتبات نقل البيانات (الشبكات، وتدفق الملفات، وما إلى ذلك) ومنطق التطبيق/اللعبة الأساسي.

تشمل المسؤوليات الرئيسية للمكتبة ما يلي:

• تتبع الكيان (يتتبع الكيان الذي ينتمي إلى أي عالم وما هي الحالات التي يمتلكها)
• تتبع المالك (يتتبع أي مشارك يملك أي كيان)
• إدارة مجال الاهتمام (تتحكم في ما يمكن وما لا يمكن للمشارك رؤيته)
• النسخ المتماثل للعالم (يعيد إنشاء تمثيل محدود في العالم الوجهة لما يعتبر مرئيًا للمشارك في العالم المصدر)

تم إنشاء المكتبة لحل التعقيدات المتعلقة بإعداد وإدارة تدفق الألعاب متعددة اللاعبين وخوادم الألعاب المخصصة. لقد قطعت شوطا طويلا في التخلص من الأشياء غير الضرورية، ونحتها ببطء في شكلها الحالي، الذي يمكنك رؤيته واستخدامه اليوم.

لماذا كنت في حاجة إليها

بدون ليبرج

عادةً ما يتكون عالم الألعاب المتصلة بالشبكة من مجموعة من اللاعبين المتصلين بالشبكة ومجموعة من الكيانات المتصلة بالشبكة. البديل النموذجي لإعداد علاقات المزامنة بين الكيانات واللاعبين هو إعداد اتصالات كل شيء للجميع.

هذا هو الإعداد الأساسي الذي يجب اتباعه. ومع ذلك، مع تزايد عدد الكيانات، يصبح عرض النطاق الترددي غير فعال إلى حد ما.

مع ليبرج

باستخدام librg، يمكنك تقليل استخدام النطاق الترددي بشكل كبير من خلال بناء علاقات الكيانات القائمة على نصف القطر والرؤية. ستتم مزامنة الكيانات فقط مع اللاعبين المرئيين لهم.

فوائد

• دعم عوالم ثنائية وثلاثية الأبعاد بأحجام مختلفة
• دعم العالم الافتراضي
• طرق رؤية الكيانات المخصصة
• الاستعلام عن الكيان المتقدم
• أحداث تغييرات الحالة من كيان إلى كيان
• دعم LOD متصل بالشبكة (استنادًا إلى نصف قطر متغير)
• متعدد المنصات، وخفيف الوزن، ورأس واحد

تكامل الشبكات

تم إنشاء الواجهة الشاملة للمكتبة مع الأخذ في الاعتبار دعم معظم مكتبات الشبكة.

يجب أن تدعم مكتبة الشبكات ما يلي:

1. القدرة على إرسال واستقبال char * buffer
2. القدرة على قراءة أو ضبط حجم المخزن المؤقت
3. القدرة على تحديد من هو متلقي أو مرسل البيانات بمعرف صحيح

وهذا هو إلى حد كبير!

قائمة بأنواع المكتبات المدعومة:

• ENet
• GameNetworkingSockets
• yojimbo
• SLikeNet
• KCP
• Raknet
• Websocket
• WebRTC
• أي مكتبة أخرى تعتمد على UDP أو TCP

ملاحظة: يمكنك التحقق من مثال لتكامل الشبكة لـ enet.

تثبيت

librg هي مكتبة ذات رأس واحد، مما يعني استخدامها، ما عليك سوى الحصول على أحدث إصدار (أو محدد) من ملف الرأس المذكور من قسم الإصدارات في هذا المستودع، وإضافته إلى مشروعك، والبدء في الاستمتاع بالفوائد .

وبدلاً من ذلك، إذا كنت تشعر بالراحة في CLI الخاص بك، فيمكنك فقط القيام بما يلي؛

curl -L https://github.com/zpl-c/librg/releases/latest/download/librg.h > librg.h

# OR

wget https://github.com/zpl-c/librg/releases/latest/download/librg.h -O librg.h

التعليمات

1. هل هذه مكتبة شبكات؟

   • ليس حقا، لا. تم تصميمه ليتم استخدامه مع وضع الشبكات في الاعتبار، لكنه لا يتمتع بأي إمكانات شبكية بمفرده.

2. هل يمكنني استخدام أي مكتبة شبكات معها؟

   • نعم. كل ما تحتاجه هو القدرة على قراءة البيانات من وإلى المخزن المؤقت، وهو ما تدعمه معظم المكتبات. من الناحية النظرية، يمكن أن يكون أي مستوى منخفض مثل UDP النقي، وحتى WebSocket / WebRTC .

3. يحتوي المستودع على مجموعة من الملفات *.h و *.c ، ومع ذلك تقترح أنها مكتبة ذات رأس واحد، كيف يكون ذلك ممكنًا؟

   • تنقسم المكتبة إلى ملفات متعددة، لذلك يكون من الأسهل العمل معها أثناء التطوير، ومع ذلك، في كل مرة يتم إنشاء إصدار جديد، يتم إنشاء نسخة "مجمعة" من ملف الرأس ودفعها مباشرة إلى صفحة الإصدارات.

4. هل تقدم librg نظام كيان؟

   • لا، المكتبة لا تدير ولا تنشئ كياناتها الخاصة فعليًا، بل تتوقع منك توفير مقبض الكيان/الكائن الخاص بك لإرفاق بعض البيانات الداخلية به، وهو ما يسمى في سياق المكتبة "التتبع".

5. كيف أقوم بحزم البيانات، هل توفرون طرقًا لذلك؟

   • لا، المكتبة لا توفر أي طرق لتعبئة/تسلسل البيانات. يجب عليك استخدام بعض المكتبات الموجودة لذلك ( protobuf ، flatbuffers ، msgpack ، وما إلى ذلك)، أو قم بتنفيذ التنفيذ الخاص بك.

6. أرى أنك ذكرت الأجزاء، هل يعني ذلك أن لعبتي/تطبيقي يجب أن يعتمد على الأجزاء؟

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

التوثيق

لقراءة الوثائق التفصيلية حول المكتبة، والاطلاع على الأمثلة، ودليل البدء السريع، يرجى زيارة صفحة الوثائق الخاصة بنا.

بالإضافة إلى ذلك، يمكنك التحقق من مجلد التعليمات البرمجية/التطبيقات للحصول على أمثلة التعليمات البرمجية الفعلية.

الرسوم التوضيحية

النسخ العالمي

فيما يلي رسم توضيحي بسيط يحاول تكرار كيفية عمل المكتبة في عالم بسيط ثنائي الأبعاد مكون من قطع 4 × 4. بالنسبة لعالم ثلاثي الأبعاد ذي حجم أكبر، سيعمل كل شيء بطريقة مشابهة جدًا، فقط في ثلاثة أبعاد.

_{(اضغط على الصورة لعرضها بالحجم الكامل)}

البروتوكول العالمي

وتعرض هذه الصورة بنية البروتوكول الثنائي الأساسي المستخدم لتشفير البيانات وفك تشفيرها من/إلى. يمكن إدراج المخزن المؤقت الثنائي الناتج في أي مخزن مؤقت آخر، أو حفظه على القرص كملف، أو إرساله عبر الشبكة باستخدام أي طريقة متاحة. يتيح وضع البيانات المخصصة جنبًا إلى جنب مع كل كيان داخل الحزمة تخزين البيانات المعتمدة على السياق مما يعمل على توسيع الإمكانات ويسمح بتكرار الكيان بكفاءة في الذاكرة وعرض النطاق الترددي.

_{(اضغط على الصورة لعرضها بالحجم الكامل)}

الهجرة

إذا كنت قد استخدمت المكتبة قبل الإصدار v6.0.0 ، فمن المستحسن قراءة دليل الترحيل الموجود هنا.

يدعم

نحن نقوم باختبار المكتبة لمنصات مختلفة. يوفر هذا الجدول نوعًا من الوصف للتوافق. إذا قمت باختباره، وكانت نتيجتك مختلفة عن تلك الموجودة في الجدول، فلا تتردد في وصف المشكلة في المشكلات.

المنصة/النتيجة	ويندوز	ماك	لينكس	دائرة الرقابة الداخلية	أندرويد	راسبيري بي	أوبن بي إس دي	فري بي إس دي	إمسكريتن
❔				رنة	رنة	دول مجلس التعاون الخليجي، رنة	دول مجلس التعاون الخليجي، رنة	دول مجلس التعاون الخليجي، رنة
✅	مسفك، مينغو	دول مجلس التعاون الخليجي، رنة	دول مجلس التعاون الخليجي، رنة						emcc

أسطورة:

• ❔ - لم يتم اختبار المكتبة على هذه المنصة/المترجم بعد
• ✅ - تم تجميع المكتبة بنجاح، وتنفيذ جميع الاختبارات بشكل صحيح

تطوير

إذا كنت ترغب في المساهمة أو إضافة ميزات جديدة أو تحسينات أو تحسينات عامة، فإليك الإرشادات حول كيفية القيام بذلك:

1. استنساخ الريبو، fe: git clone https://github.com/zpl-c/librg.git
2. قم بتشغيل make لبناء جميع المشاريع والتحقق من أن كل شيء يعمل
3. تطوير ميزة وإضافة اختبارات لها في code/tests/
4. وفي النهاية قم بتشغيل make test مرة أخرى للتحقق

في حال كنت تعمل من خلال نظام التشغيل Windows ، و/أو لم تتمكن من استخدام make ، يمكنك أيضًا استخدام ملف التكوين cmake المدمج لإنشاء حل Visual Studio، للقيام بذلك:

1. mkdir build
2. cd build
3. cmake ../misc -G"Visual Studio 16 2019" (أو أي تكوين لديك)
4. cmake --open . (يفتح VS مع الحل)
5. وكرري الخطوات من الأعلى

بالنسبة للمطورين، فهو يوفر فوائد رائعة:

• تجميع ووقت التشغيل قابل للتكوين
• مكتوب بلغة C99 (لأسباب قابلية النقل)
• لا تبعيات خارجية
• تغطية اختبار الوحدة المدمجة