# مقدمة

اضبط متاجر الوشم، واربط اقتصاد خادمك، وأضف الحزم المثبّتة لديك. يتضمن المورد كتالوجًا أساسيًا، ويتيح تخصيص المناطق المسلّمة مفتوحة عبر Asset Escrow.

## ابدأ من هنا

| الدليل | ما ستجده فيه |
| --- | --- |
| [التثبيت](https://docs.cxgstudios.com/docs/ar/01-cxg-tattoos/02-instalacion.md) | المتطلبات، وترتيب التشغيل، والتحقق الأولي. |
| [الإعداد](https://docs.cxgstudios.com/docs/ar/01-cxg-tattoos/03-configuracion.md) | اللغة، ونظام الهوية، والمتاجر، والمستويات، والمخططات، والكاميرا، وملابس المعاينة. |
| [الكتالوج والحزم](https://docs.cxgstudios.com/docs/ar/01-cxg-tattoos/04-catalogo.md) | وشوم JSON، والمصادر الاختيارية، والتعيينات، والصور المصغرة. |
| [التكاملات](https://docs.cxgstudios.com/docs/ar/01-cxg-tattoos/05-integraciones.md) | الأذونات، والمدفوعات، وتهيئة الجسور المفتوحة. |
| [تخصيص الواجهة](https://docs.cxgstudios.com/docs/ar/01-cxg-tattoos/06-interfaz.md) | ملفات NUI المسلّمة والتغييرات التي تتطلب ملفات مصدر الواجهة. |

## الملفات التي يمكنك تحريرها

| المسار داخل المورد | الاستخدام |
| --- | --- |
| `config.lua` | إعدادات الخادم وعمليات الاستدعاء المخصصة. |
| `shared/tattoos.json` | الكتالوج الأساسي القابل للتحرير. |
| `bridge/**/*.lua` | تكاملات المظهر والأذونات والمدفوعات. |
| `ui/**/*` | الواجهة وصورها، ضمن الملفات المرفقة. |

هذه هي المناطق المستثناة من Asset Escrow التي تغطيها الأدلة. تشير أمثلة المسارات إلى مجلد المورد المثبّت.

تتضمن حزمة التوزيع الحالية الواجهة المبنية في `ui/dist/` والصور المصغرة الأساسية في `ui/public/ImagenesVanilla/`. يتيح استثناء `ui/` تحرير الملفات المرفقة؛ لكنه لا يعني أن الحزمة تتضمن ملفات مصدر React أو أدوات البناء.

## الحزم الاختيارية

يمكنك استخدام cxg-tattoos من دون حزم خارجية، أو مع بعضها، أو مع كلها. ثبّت وشغّل الحزم المتوفرة لديك فقط. الحزم الغائبة أو المتوقفة لا تعطل المورد، لكن وشومها لن تظهر في المتجر. يظل الكتالوج الأساسي متاحًا.

## قبل تغيير الإعدادات

احفظ نسخة من الملفات المفتوحة التي ستعدلها. تتطلب تغييرات الإعداد والجسور إعادة تشغيل المورد. أما المتاجر والكتالوج والقواعد التي تديرها اللوحة بالفعل، فراجع تعليمات كل دليل بشأنها: القيم الأولية في الملف لا تستبدل تلقائيًا الإعدادات المحفوظة.