---
type: reference
title: مخطّط لوحة التحكّم للعبة مخصّصة
summary: كيف تعلن لعبة مخصّصة حقولها القابلة للتخصيص على لوحة التحكّم، لكل محور، إذ لا بيان لها، وأنواع الحقول التي يقبلها كل محور.
---

لعبة المتجر تشحن بيان `caputchin.json` يعلن أيّ حقول تستطيع كل تهيئة تخصيص ضبطها. لعبة مخصّصة لا بيان لها، فـ**تعلن ذلك المخطّط على لوحة التحكّم** بدلًا. تعرّفه مرة لكل لعبة مخصّصة، لكل محور، ثم تؤلّف تهيئات مقابله؛ من هناك [يُحلّ ويُطبَّق](/docs/game-customization/overview) تمامًا كلعبة المتجر على مستويات الباقات نفسها.

هذه الصفحة مرجع ذلك المخطّط. لتأليف اللعبة نفسها، انظر [ابنِ لعبة مستضافة ذاتيًّا](/docs/custom-game-development/self-hosted-game)؛ ولتدفّق التسجيل من جانب العميل، انظر [الألعاب المخصّصة](/docs/game-customization/custom-games).

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

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

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

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

## أنواع الحقول

المخطّط مجموعة حقول مسمّاة، لكلٍّ نوع. أنواع الحقول هي المجموعة نفسها التي يستخدمها بقية التخصيص؛ [مرجع مخطّط التخصيص](/docs/references/customization-schema) هو الوصف الموثوق لكل نوع والقيم التي يقبلها. باختصار:

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

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

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

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

## الأصول مطلقة

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

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

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

## انظر أيضًا

- [مرجع مخطّط التخصيص](/docs/references/customization-schema): كل نوع حقل وقيمه المقبولة، كاملًا.
- [الألعاب المخصّصة](/docs/game-customization/custom-games): تسجيل لعبة مخصّصة وتعريف مخطّطها.
- [ابنِ لعبة مستضافة ذاتيًّا](/docs/custom-game-development/self-hosted-game): قراءة التهيئات المحلولة من سياق المصنع.
- [تجاوزات الفريق](/docs/troops/overrides): نموذج النطاق الذي يتبعه المخطّط.