---
type: how-to
title: خصّص لغة اللعبة
summary: تجاوز نصوص اللعبة المترجَمة على علامة اللغة، مجمّعةً حسب اللغة؛ متاحة من باقة Alpha فما فوق.
---

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

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

## اضبط نصوص اللغة

افتح اللعبة على صفحة **الألعاب** لمفتاح موقع (أو الفريق)، ثم علامة **اللغة**. كل لغة تقدّمها اللعبة تهيئة، وكل تهيئة مجموعة نصوص مسمّاة (وسوم اللعبة ورسائلها). حرّر النصوص التي تريد تغييرها؛ اترك الباقي فتبقي صياغة اللعبة المضمَّنة.

حقول اللغة دائمًا نصّ عادي. لا شيء لاختياره سوى الكلمات.

## كيف تُختار لغة وقت التشغيل

تحمل كل تهيئة لغة **وسم لغة** (`en`، و`es`، و`fr`، وهكذا)، والتهيئات مجمّعة بذلك الوسم. اختيار واحدة يحدث على مرحلتين.

أولًا تقرّر الأداة أي لغة تطلب:

1. سمة `locale` للأداة، إن ضبطتها الصفحة (نيّة مؤلّف صريحة).
2. وإلا، لغة متصفّح الزائر (أول لغاته المفضّلة).
3. وإلا لا شيء، فيرتدّ الخادم إلى افتراضي اللعبة.

ثم يطابق الخادم تلك اللغة مقابل التهيئات، بعد دمج تجاوزاتك (مفتاح الموقع فوق الفريق فوق المجموعة المضمَّنة للعبة)، بهذا الترتيب:

1. تطابق وسم تامّ (`pt-BR` يجد تهيئة `pt-BR`).
2. اللغة الأساس (`pt-BR` يرتدّ إلى تهيئة `pt`).
3. التهيئة التي وسمتها **الافتراضية**.
4. أول تهيئة للعبة.

فلعبة بأي تهيئات تعرض دائمًا نصًّا حقيقيًّا، لا مفاتيح خامًا أبدًا. تَسِم تهيئة واحدة لكل لغة افتراضيةً في المحرّر.

على عنصر `<caputchin-game>` تستطيع أيضًا تمرير كائن `locale` مضمَّن: كائن JSON مكتوب كقيمة السمة، مثلًا `locale='{"start":"Go!"}'`. ترسله الأداة إلى الخادم كإشارة لغة ذلك التركيب، فيحلّله الخادم ويطبّقه فوق التهيئات المحلولة، فتتغلّب نصوصك المضمَّنة على كل ما أعلاه (بما فيه تجاوزات فريقك ومفتاح موقعك). إنه خاصية في تركيبك أنت، فيعمل على أي باقة. خانة الاختيار `<caputchin-widget>` لا تقبل locale مضمَّنًا؛ سمة `locale` خاصتها تأخذ وسم لغة أو اسم تهيئة فقط. انظر [فلسفتنا](/docs/understanding-caputchin/philosophy) لماذا تأليف كل تضمين هذا مجاني.

اتّجاه النصّ (من اليسار إلى اليمين أو من اليمين إلى اليسار) مشتقّ من وسم اللغة تلقائيًّا، فلغة من اليمين إلى اليسار تُعرَض صحيحةً بلا إعداد إضافي.

## أضف لغة أو وسّعها

تستطيع توسيع أي لغة تشحنها اللعبة: التهيئة الجديدة ترث كل نصّ من التي توسّعها، وتتجاوز ما تغيّره فقط. ولإضافة لغة لم تشحنها اللعبة، أنشئ تهيئة بوسم تلك اللغة واملأ النصوص.

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

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

## انظر أيضًا

- [نظرة عامة على تخصيص اللعبة](/docs/game-customization/overview): سجّل لعبة وأدِرها.
- [الإعدادات](/docs/game-customization/configurations) و[المظهر](/docs/game-customization/skin): المحوران الآخران.
- [مرجع المخطّط](/docs/references/customization-schema): نموذج التهيئة وأنواع الحقول.