مخطّط لوحة التحكّم للعبة مخصّصة
لعبة المتجر تشحن بيان caputchin.json يعلن أيّ حقول تستطيع كل تهيئة تخصيص ضبطها. لعبة مخصّصة لا بيان لها، فـتعلن ذلك المخطّط على لوحة التحكّم بدلًا. تعرّفه مرة لكل لعبة مخصّصة، لكل محور، ثم تؤلّف تهيئات مقابله؛ من هناك يُحلّ ويُطبَّق تمامًا كلعبة المتجر على مستويات الباقات نفسها.
هذه الصفحة مرجع ذلك المخطّط. لتأليف اللعبة نفسها، انظر ابنِ لعبة مستضافة ذاتيًّا؛ ولتدفّق التسجيل من جانب العميل، انظر الألعاب المخصّصة.
مخطّط واحد لكل محور
مخطّط لعبة مخصّصة مُعلَن لكل محور، والمحاور الثلاثة مستقلّة:
| المحور | ما الذي يخصّصه | المخطّط |
|---|---|---|
| اللغة | نصوص اللعبة المترجَمة. | ضمنيّ: حقول اللغة دائمًا نصّ عادي، فلا شيء لإعلانه؛ تؤلّف تهيئات نصوص مباشرةً. |
| المظهر | الألوان، والأصول البصرية، ومقابض العرض. | تعلن حقول اللون، والأصل، والقياسي (مبدّل / عدد / مدى / خيار) التي تستطيع تهيئة مظهر ضبطها. |
| الإعداد | خيارات اللعب (الصعوبة، والعدّات، والمبدّلات). | تعلن حقول الخيارات التي تستطيع تهيئة إعداد ضبطها. |
تعرّف مخطّطًا فقط للمحاور التي تستخدمها لعبتك فعلًا. محور بلا مخطّط ببساطة لا حقول قابلة للتخصيص من ذلك النوع له.
أنواع الحقول
المخطّط مجموعة حقول مسمّاة، لكلٍّ نوع. أنواع الحقول هي المجموعة نفسها التي يستخدمها بقية التخصيص؛ مرجع مخطّط التخصيص هو الوصف الموثوق لكل نوع والقيم التي يقبلها. باختصار:
| النوع | القيمة |
|---|---|
string | نصّ حرّ. |
boolean | true أو false. |
number | أي عدد منتهٍ. |
range | عدد ضمن حدّ أدنى وأقصى. |
list | واحد من مجموعة خيارات ثابتة. |
link | رابط http/https. |
color | لون ست عشري أو rgb(). |
image | رابط صورة أو رفع. |
audio | رابط صوت أو رفع. |
video | رابط فيديو أو رفع. |
اللغة تستخدم string فقط (والحلّال لا يتحقّق من مخطّط لغة البتّة). المظهر والإعداد يتحقّقان من القيم المؤلَّفة مقابل المخطّط الذي تعلنه ويُسقطان القيم التي لا تناسب نوعها.
النطاق: أين يقيم مخطّط
مخطّط اللعبة المخصّصة مضبوط عند نطاق، فريق أو مفتاح موقع، نموذج النطاق نفسه كـ التجاوزات. حين يعلن فريق وأحد مفاتيح مواقعه مخطّطًا للّعبة والمحور نفسيهما، يستبدل مخطّط مفتاح الموقع مخطّط الفريق لذلك المحور (استبدال للمحور كله، لا دمج حقلًا بحقل). يعكس هذا كيف يُحلّ بقية التخصيص بمبدأ الأخصّ يفوز.
الأصول مطلقة
ولأنك تستضيف اللعبة القابلة للّعب بنفسك، لا حزمة منصّة لحلّ مسار أصل نسبيّ مقابلها. أي قيمة image، أو audio، أو video في تهيئة مظهر يجب أن تكون رابطًا مطلقًا. (لعبة المتجر تستطيع استخدام مسارات نسبية للحزمة؛ ولعبة مخصّصة لا تستطيع.)
كيف تبلغ تهيئة اللعبة
بمجرّد وجود المخطّط والتهيئات، يحلّ Caputchin تهيئة واحدة لكل محور لكل زائر (الأخصّ يفوز عبر مفتاح الموقع، والفريق، وافتراضياتك) ويسلّم القيم المحلولة إلى لعبتك عبر سياق مصنع اللعبة: ctx.locale، وctx.skin، وctx.config. تقرأ لعبتك أسماء حقولها الخاصة من تلك الكائنات. المخطّط هو ما يجعل محرّر لوحة التحكّم يعرض المُدخَلات الصحيحة وما يتحقّق من القيم قبل أن تبلغ زائرًا أبدًا.
انظر أيضًا
- مرجع مخطّط التخصيص: كل نوع حقل وقيمه المقبولة، كاملًا.
- الألعاب المخصّصة: تسجيل لعبة مخصّصة وتعريف مخطّطها.
- ابنِ لعبة مستضافة ذاتيًّا: قراءة التهيئات المحلولة من سياق المصنع.
- تجاوزات الفريق: نموذج النطاق الذي يتبعه المخطّط.