اشحن لعبة إلى Marketplace
لعبة Marketplace لعبة تبنيها مرة ويستطيع أي أحد تضمينها: تنشر مستودع GitHub عامًّا، فتفهرسه المنصّة، ويبلغها المستخدمون بمعرّف لعبتها بلا تدخّل منك. هذا الطرف المقابل من اللعبة المخصّصة، التي تستخدمها أنت وحدك وتستضيفها بنفسك. هذا القسم هو الدليل المفصّل، ابنِ-وانشر، لمسار Marketplace.
إن أردت لعبة لمفاتيح مواقعك أنت فقط، فأنت تريد تطوير لعبة مخصّصة بدلًا. تعال هنا حين تريد توزيع لعبة إلى كل مستخدم Caputchin.
خطّ الأنابيب كله
كل صندوق يقابل صفحةً في هذا القسم:
| القطعة | ما هي | الصفحة |
|---|---|---|
| اللعبة | حزمة JS مكتفية بذاتها مبنيّة مقابل SDK اللعبة تعمل في إطار iframe المعزول للأداة. | ابنِ لعبة Marketplace، ومرجع الـ SDK |
| البيان | caputchin.json في جذر المستودع يصف اللعبة، وتهيئاتها، وحزمتها. | بيان caputchin.json |
| عقد إعادة التشغيل | run(seed, trace) -> verdict حتمي يعيد الخادم تشغيله للوصول إلى القرار الموثوق. | عقد إعادة التشغيل |
| عدّة المحرّك | عدّة تأليف اختيارية تنتج run مطابقًا من مُختزِل عادي. | عدّة engine-kit |
| النشر | وسِم المستودع، فيكتشفه المفهرِس ويثبّته، واختياريًّا أتمِته بـ CI. | انشر إلى Marketplace |
قابلة لإعادة التشغيل مقابل غير قابلة
أهمّ فكرة واحدة على هذا المسار: تستطيع لعبة Marketplace حراسة التحقّق فقط إن كانت قابلة لإعادة التشغيل على الخادم. حين يبتلع المفهرِس لعبتك يشغّل فحصًا ذاتيًّا لإعادة التشغيل: يحمّل أداة run بلا واجهة في عازل مختوم ويؤكّد أنها تنتج حُكمًا صالحًا.
- يجتاز الفحص الذاتي ← اللعبة قابلة لإعادة التشغيل: تُعاد جولة لاعب حقيقي على الخادم للوصول إلى القرار، فتستطيع اللعبة حراسة مفتاح موقع.
- يفشل الفحص الذاتي ← تُظهر اللعبة غير قابلة للإعادة. ما زالت مدرَجة وقابلة للتضمين، لكن كتجربة استخدام فقط (لا بوّابة أمان) حتى تنشر نسخة تجتاز. المواقع التي على نسخة أقدم قابلة لإعادة التشغيل تبقي تلك اللقطة بالضبط.
لهذا الحتمية ليست صقلًا اختياريًّا: إنها الخطّ بين لعبة تستطيع حراسة مفتاح موقع وأخرى زخرفية فحسب.
كيف تختلف لعبة Marketplace عن لعبة مخصّصة
| لعبة Marketplace | لعبة مخصّصة | |
|---|---|---|
| من يستطيع تضمينها | أي أحد، بمعرّف اللعبة | أنت وحدك |
| الاستضافة | مثبَّتة من المنصّة من GitHub / npm خاصتك | تستضيف الحزمة (game-src) |
| مخطّط التخصيص | مُعلَن في caputchin.json | مُعلَن على لوحة التحكّم |
| أداة إعادة التشغيل | مفهرَسة من run في البيان | مرفوعة على لوحة التحكّم |
| الاكتشاف | Marketplace قابل للتصفّح | لا شيء |
من أين تبدأ
إن لم تبنِ لعبة Caputchin قطّ، فاقرأ ابنِ لعبة Marketplace من أعلى إلى أسفل، ثم عقد إعادة التشغيل. حين تكون جاهزًا للشحن، اتبع انشر إلى Marketplace. عدّة المحرّك اختيارية ويمكن تخطّيها كليًّا.
انظر أيضًا
- ابنِ لعبة Marketplace: درس البناء.
- عقد إعادة التشغيل: ما الذي يجعل لعبة قابلة لإعادة التشغيل.
- انشر إلى Marketplace: وسِم، وافهرس، وأتمِت.
- تطوير لعبة مخصّصة: البديل المستضاف ذاتيًّا، لمفاتيحك-فقط.