Caputchin
تطوير لعبة مخصّصة

مخطّط لوحة التحكّم للعبة مخصّصة

لعبة المتجر تشحن بيان caputchin.json يعلن أيّ حقول تستطيع كل تهيئة تخصيص ضبطها. لعبة مخصّصة لا بيان لها، فـتعلن ذلك المخطّط على لوحة التحكّم بدلًا. تعرّفه مرة لكل لعبة مخصّصة، لكل محور، ثم تؤلّف تهيئات مقابله؛ من هناك يُحلّ ويُطبَّق تمامًا كلعبة المتجر على مستويات الباقات نفسها.

هذه الصفحة مرجع ذلك المخطّط. لتأليف اللعبة نفسها، انظر ابنِ لعبة مستضافة ذاتيًّا؛ ولتدفّق التسجيل من جانب العميل، انظر الألعاب المخصّصة.

مخطّط واحد لكل محور

مخطّط لعبة مخصّصة مُعلَن لكل محور، والمحاور الثلاثة مستقلّة:

المحورما الذي يخصّصهالمخطّط
اللغةنصوص اللعبة المترجَمة.ضمنيّ: حقول اللغة دائمًا نصّ عادي، فلا شيء لإعلانه؛ تؤلّف تهيئات نصوص مباشرةً.
المظهرالألوان، والأصول البصرية، ومقابض العرض.تعلن حقول اللون، والأصل، والقياسي (مبدّل / عدد / مدى / خيار) التي تستطيع تهيئة مظهر ضبطها.
الإعدادخيارات اللعب (الصعوبة، والعدّات، والمبدّلات).تعلن حقول الخيارات التي تستطيع تهيئة إعداد ضبطها.

تعرّف مخطّطًا فقط للمحاور التي تستخدمها لعبتك فعلًا. محور بلا مخطّط ببساطة لا حقول قابلة للتخصيص من ذلك النوع له.

أنواع الحقول

المخطّط مجموعة حقول مسمّاة، لكلٍّ نوع. أنواع الحقول هي المجموعة نفسها التي يستخدمها بقية التخصيص؛ مرجع مخطّط التخصيص هو الوصف الموثوق لكل نوع والقيم التي يقبلها. باختصار:

النوعالقيمة
stringنصّ حرّ.
booleantrue أو false.
numberأي عدد منتهٍ.
rangeعدد ضمن حدّ أدنى وأقصى.
listواحد من مجموعة خيارات ثابتة.
linkرابط http/https.
colorلون ست عشري أو rgb().
imageرابط صورة أو رفع.
audioرابط صوت أو رفع.
videoرابط فيديو أو رفع.

اللغة تستخدم string فقط (والحلّال لا يتحقّق من مخطّط لغة البتّة). المظهر والإعداد يتحقّقان من القيم المؤلَّفة مقابل المخطّط الذي تعلنه ويُسقطان القيم التي لا تناسب نوعها.

النطاق: أين يقيم مخطّط

مخطّط اللعبة المخصّصة مضبوط عند نطاق، فريق أو مفتاح موقع، نموذج النطاق نفسه كـ التجاوزات. حين يعلن فريق وأحد مفاتيح مواقعه مخطّطًا للّعبة والمحور نفسيهما، يستبدل مخطّط مفتاح الموقع مخطّط الفريق لذلك المحور (استبدال للمحور كله، لا دمج حقلًا بحقل). يعكس هذا كيف يُحلّ بقية التخصيص بمبدأ الأخصّ يفوز.

الأصول مطلقة

ولأنك تستضيف اللعبة القابلة للّعب بنفسك، لا حزمة منصّة لحلّ مسار أصل نسبيّ مقابلها. أي قيمة image، أو audio، أو video في تهيئة مظهر يجب أن تكون رابطًا مطلقًا. (لعبة المتجر تستطيع استخدام مسارات نسبية للحزمة؛ ولعبة مخصّصة لا تستطيع.)

كيف تبلغ تهيئة اللعبة

بمجرّد وجود المخطّط والتهيئات، يحلّ Caputchin تهيئة واحدة لكل محور لكل زائر (الأخصّ يفوز عبر مفتاح الموقع، والفريق، وافتراضياتك) ويسلّم القيم المحلولة إلى لعبتك عبر سياق مصنع اللعبة: ctx.locale، وctx.skin، وctx.config. تقرأ لعبتك أسماء حقولها الخاصة من تلك الكائنات. المخطّط هو ما يجعل محرّر لوحة التحكّم يعرض المُدخَلات الصحيحة وما يتحقّق من القيم قبل أن تبلغ زائرًا أبدًا.

انظر أيضًا

في هذه الصفحة