خصّص مظهر اللعبة

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

تخصيص المظهر متاح من باقة Alpha فما فوق (Alpha، وTroop، وApex).

اضبط الألوان والأصول والمقابض الأخرى

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

كيف يُختار مظهر وقت التشغيل

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

أولًا تقرّر الأداة أي مظهر تطلب:

1. سمة skin للأداة، إن ضبطتها الصفحة: اسم تهيئة تامّ (مثلًا midnight)، أو الاختصار light / dark.
2. وإلا، تفضيل نظام الزائر (prefers-color-scheme)، الذي يُحلّ إلى light أو dark.

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

ولأن تهيئة any مؤهَّلة للوضعين، تستطيع جعل مظهر واحد الافتراضي في كل مكان، أو إعطاء وضع مظهرًا مخصّصًا وترك مظهر any يغطّي الآخر. على علامة المظهر يظهر مظهر any تحت مجموعتي الفاتح والداكن، وتضبطه افتراضيًّا لأيٍّ منهما أو كليهما.

على عنصر <caputchin-game> تستطيع أيضًا تمرير كائن skin مضمَّن: كائن JSON مكتوب كقيمة السمة، مثلًا skin='{"primary":"#7c3aed"}'. ترسله الأداة إلى الخادم كإشارة مظهر ذلك التركيب، فيحلّله الخادم ويطبّقه فوق التهيئات المحلولة، فتتغلّب ألوانك وأصولك المضمَّنة على كل ما أعلاه (بما فيه تجاوزات فريقك ومفتاح موقعك). إنه خاصية في تركيبك أنت، فيعمل على أي باقة. خانة الاختيار <caputchin-widget> لا تقبل مظهرًا مضمَّنًا؛ سمة skin خاصتها تأخذ light / dark أو اسم تهيئة فقط. انظر فلسفتنا لماذا تأليف كل تضمين هذا مجاني.

الأصول: رفع أو ربط

خانة أصل (صورة، أو صوت، أو فيديو) تأخذ إمّا ملفًّا مرفوعًا أو رابطًا تلصقه:

• رفع: يخزّن Caputchin لقطة من الملفّ. مجمَّدة، فلن تتغيّر ما لم ترفع مجدّدًا.
• ربط: تلصق رابط https لملفّ تستضيفه. حيّ، فاستبدال الملفّ عند ذلك الرابط يحدّث اللعبة عند التحميل التالي.

ولأن اللعبة تعمل في إطار معزول، لا يُحمَّل أصل مربوط إلا إن كان أصله مسموحًا به. يتولّى Caputchin ذلك عنك: يسمح بالأصول التي تشير إليها تهيئات مظهرك بالضبط، ولا شيء سواها. لا تغيّر أنت أي سياسة بنفسك.

كل نوع أصل يقبل مجموعة هيئات ثابتة (مثلًا PNG، وJPEG، وWebP، وSVG، وGIF للصور). الهيئات الدقيقة وقواعد الألوان في مرجع المخطّط.

ما الذي ينطبق، وأين

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

كيف تبلغ قيمة مظهر اللعبة

يحلّ الخادم مظهرك (تجاوزاتك مدموجةً فوق المجموعة المضمَّنة) ويسلّم النتيجة إلى كود اللعبة نفسه، الذي يرسم نفسه بها. الألوان وروابط الأصول تصل كنصّ؛ والمبدّل يصل كـ true / false حقيقي، والعدد كعدد حقيقي، والخيار كالنصّ المختار. يقرّر مؤلّف اللعبة كيف تُستخدَم كل قيمة، فما الذي تغيّره خانة فعلًا متروك للّعبة. لا تكتب أي CSS للّعبة: تعمل في إطار معزول لا تستطيع تنسيقه من صفحتك.

غلاف الأداة (هيكل Caputchin حول اللعبة، وخانة الاختيار المستقلّة) مختلف: مظهره المحلول مكشوف أيضًا لصفحتك كخصائص CSS مخصّصة مسمّاة --cpt-skin-<token>، تستطيع قراءتها أو تجاوزها من نسق تنسيقك الخاص. ذلك السطح، وكيف تبيّض علامة الغلاف، مغطّى في نسّق الأداة بـ CSS. تلك المتغيّرات للغلاف وحده؛ لا تحمل مظهر لعبة.

انظر أيضًا

• نظرة عامة على تخصيص اللعبة: سجّل لعبة وأدِرها.
• الإعدادات واللغة: المحوران الآخران.
• مرجع المخطّط: قواعد الألوان، وهيئات الأصول، ونموذج التهيئة.
• نسّق الأداة بـ CSS: متغيّرات --cpt-skin-* للغلاف وأجزاء الظلّ.