مرجع مخطّط التخصيص

هذا المرجع الوحيد لـنموذج نوع الحقل والتهيئة في Caputchin، الأساس المشترك تحت كل سطح قابل للتخصيص:

• تخصيص اللعبة: لغة لعبة المتجر ومظهرها وإعدادها.
• مخطّطات اللعبة المخصّصة: المخطّط الذي تؤلّفه بنفسك للعبة مخصّصة.
• بيانات لعبة المتجر: كتل locales / skins / configurations التي يعلنها مؤلّف لعبة.
• تبييض علامة الأداة: المخطّط المدمج لغلاف الأداة.

الأربعة جميعًا تستخدم أنواع الحقول نفسها ونموذج التهيئة نفسه الموصوف هنا. يُبنى التخصيص من تهيئات، والتهيئة كيس حقول مكتوبة الأنواع.

أنواع الحقول حسب المحور

كل محور يسمح بمجموعة ثابتة من أنواع الحقول:

المظهر ليس ألوانًا وأصولًا فقط: يستطيع أيضًا كشف المقابض القياسية boolean، وnumber، وrange، وlist (مبدّل "ظلال"، وعدد نصف-قطر-الزاوية، وخيار "نمط"). تتصرّف هذه تمامًا كنظائرها في الإعداد وتُحلّ إلى قيمتها المكتوبة النوع (الـ boolean يبقى true، والـ number يبقى 8)؛ وقيم color والأصول تُحلّ إلى نصوص. المظهر لا يسمح بـ string أو link (النصّ الحرّ ينتمي للّغة؛ وهدف رابط إعدادٌ).

ما الذي يقبله كل نوع

يتحقّق Caputchin من كل قيمة حين تحفظ، فقيمة لا تناسب نوعها تُرفَض قبل أن تبلغ زائرًا.

المفاتيح المحجوزة

إلى جانب حقول محتواها، تحمل التهيئة بضعة مفاتيح بيانات وصفية محجوزة (كلٌّ مسبوق بشرطة سفلية) تتحكّم بكيف تُختار وتُحلّ، لا بما تعرضه. كيف تضبطها يعتمد على السطح: مؤلّف لعبة المتجر يكتبها حرفيًّا في caputchin.json؛ وفي محرّر لوحة التحكّم (الألعاب المخصّصة، والعلامة البيضاء) تضبطها عبر ضوابط ولا تكتب المفتاح أبدًا. في الحالتين المعنى نفسه.

مفاتيح البيانات الوصفية المحجوزة تُزال أثناء الحلّ: _extends و_default لا تبلغان اللعبة أبدًا، ولا يُسلَّم سوى البيانات الناجية (_lang، و_direction، و_theme) إضافةً إلى حقول المحتوى المسطّحة.

توسيع تهيئة

_extends يتيح لتهيئة وراثة كل قيمة من أخرى، فتؤلّف الحقول المختلفة فقط بدل تكرار تهيئة كاملة. اضبط _extends على اسم تهيئة أخرى في المحور نفسه؛ تبدأ التهيئة الموسِّعة من كل قيم تلك التهيئة وتتجاوز المفاتيح التي تضبطها بنفسها.

{
  "skins": {
    "presets": {
      "brand-light": { "_theme": "light", "accent": "#2da44e", "bg": "#ffffff" },
      "brand-light-warm": { "_extends": "brand-light", "accent": "#d97706" }
    }
  }
}

هنا brand-light-warm يرث bg من brand-light ويغيّر accent فقط.

تفصيلان:

• اختصار سمة المظهر. على تهيئة مظهر، يستطيع _extends بدلًا تسمية سمة (light أو dark) لا تهيئة. ذلك الشكل يُحلّ إلى أيّ تهيئة هي _default لتلك السمة، طريقة مريحة لتأسيس متغيّر على "المظهر الفاتح الافتراضي" دون تسميته.
• يُحلّ بعيدًا. يُتبَع _extends ثم يُزال؛ تستقبل اللعبة النتيجة المدموجة كليًّا، لا مفتاح _extends نفسه أبدًا.

من أين يأتي مخطّط

مجموعة الحقول التي تستطيع تهيئة ملؤها (مخطّطها) لها ثلاثة مصادر، كلها تستخدم أنواع الحقول نفسها أعلاه:

• لعبة المتجر: يأتي المخطّط من بيان مؤلّف اللعبة، مجلوبًا حين تفتح المحرّر. تتجاوز تهيئات اللعبة لكن لا تغيّر مخطّطها.
• لعبة مخصّصة: تعرّف المخطّط بنفسك في لوحة التحكّم، ثم تؤلّف تهيئات مقابله. انظر الألعاب المخصّصة.
• غلاف الأداة (العلامة البيضاء): مخطّط ثابت مدمج. تتجاوز تهيئاته؛ مجموعة الحقول ليست مُعلَنة من المؤلّف. انظر بيّض علامة الأداة.

التهيئات والحلّ

داخل محور، تُجمَّع الحقول في تهيئات مسمّاة، ويحلّ الخادم تهيئةً فعّالةً واحدةً لكل مجموعة من النطاقات المطبَّقة، مفتاح الموقع فوق الفريق فوق الافتراضي المضمَّن، محسوبًا لكل قيمة. المختارات تختلف بالمحور: اللغة تُختار بلغة متصفّح الزائر، والمظهر بتفضيل الزائر الفاتح أو الداكن (تهيئة وضعها any مؤهَّلة لأيٍّ)، والإعداد موثوق من الخادم (لا يستطيع الزائر اختياره). انظر النظرة العامة لنموذج النطاق.

انظر أيضًا

• نظرة عامة على تخصيص اللعبة: تسجيل الألعاب وإدارتها، إضافةً إلى أدلّة كل محور لـ الإعدادات، واللغة، والمظهر.
• مخطّط لوحة التحكّم للعبة مخصّصة: تأليف مخطّط بنفسك للعبة مخصّصة.
• بيان caputchin.json: إعلان هذه الكتل كمؤلّف لعبة المتجر.
• بيّض علامة الأداة: الأنواع نفسها مطبَّقةً على غلاف الأداة.