البدء

اشتريت الإضافة للتو (أو على وشك ذلك). الـ10 دقائق التالية ستأخذك من «zip محمَّل» إلى «الذكاء الاصطناعي يبني لي Blueprints». هذه الرحلة بأكملها.

سنمر بها بالترتيب:

1. تثبيت الإضافة في محرّكك
2. تفعيل ترخيصك
3. فتح نافذة الإضافة
4. إرسال أول موجِّه AI

إن علقت في خطوة، اقفز إلى استكشاف الأخطاء في الأسفل.

---

قبل أن تبدأ — ما تحتاجه

الشيء	لماذا
Unreal Engine 5.4 أو 5.5 أو 5.6 أو 5.7	تعمل الإضافة داخل المحرّر
Windows أو macOS أو Linux	الثلاثة تعمل
Order ID من FAB Marketplace أو مفتاح ترخيص من موقعنا	يفعّل الإضافة على جهازك

تلك القائمة بأكملها. لا تحتاج إلى مفتاح API، ولا تحتاج إلى تثبيت Python أو أي شيء آخر. تأتي الإضافة باستخدام AI مجاني مدمج — يمكنك تجربته فور انتهاء التفعيل.

---

الخطوة 1 — تثبيت الإضافة

اشتريت الإضافة على FAB Marketplace. الآن نُثبّتها في محرّكك.

1. افتح Epic Games Launcher.
2. اذهب إلى Library الخاصة بك.
3. اعثر على الإضافة في مشترياتك واضغط Install to Engine.
4. اختر إصدار المحرّك للتثبيت عليه (5.4 أو 5.5 أو 5.6 أو 5.7). يمكنك التثبيت على أكثر من واحد — اختر ما ستستخدمه.
5. انتظر اكتمال التثبيت. عادةً 1-2 دقيقة.

الآن افتح مشروع Unreal Engine الخاص بك:

6. اذهب إلى Edit → Plugins في القائمة العلوية.
7. ابحث عن “Ultimate Engine Co-Pilot”.
8. ضع علامة على المربع لتفعيلها.
9. سيطلب منك المحرّر إعادة التشغيل. اضغط Restart Now.

عند عودة المحرّر، تكون الإضافة مثبتة لكن لم تُفعَّل بعد. الخطوة التالية.

---

الخطوة 2 — تفعيل ترخيصك

في المرة الأولى التي يُفتح فيها المحرّر مع تفعيل الإضافة، تظهر نافذة تفعيل. هناك طريقتان — اختر التي تناسب طريقة شرائك.

إن اشتريت من FAB Marketplace

1. اضغط تبويب FAB Marketplace.
2. اكتب عنوان البريد الإلكتروني الذي استخدمته على FAB.
3. اكتب FAB Order ID الخاص بك. يبدأ بـA متبوعاً بـ16 رقماً، مثل A1234567890123456. تجده في البريد الإلكتروني الذي أرسله FAB إليك عند الشراء.
4. اضغط Submit Order.
5. انتظر. التحقق ينتهي عادةً في أقل من 5 دقائق — تتفقد الإضافة تلقائياً. تتحدّث النافذة عند تفعيلك.

إن اشتريت من موقعنا

1. اضغط تبويب Website Purchase.
2. اكتب مفتاح الترخيص الخاص بك. يبدو مثل XXXXX-XXXXX-XXXXX-XXXXX.
3. اضغط Activate License.

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

---

الخطوة 3 — افتح الإضافة

افتح نافذة الإضافة من:

• قائمة Window → Ultimate Engine Co-Pilot، أو
• أيقونة الإضافة في شريط الأدوات العلوي

تفتح النافذة بأربع علامات تبويب رئيسية في أعلى اليسار:

علامة التبويب	لما هي
Blueprint Architect	الدردشة الرئيسية. تكتب ما تريد، ويبنيه الذكاء الاصطناعي.
Project Scanner	فهرسة كامل مشروعك حتى يستطيع الذكاء الاصطناعي الإجابة عن أسئلة بشأن أي شيء فيه.
Tools	وصول سريع لأدوات الإضافة — توليد الصور، توليد الـmesh، توليد الصوت، والمزيد.
Learn	دورات مدمجة، tutorials، وskill tree لإرشادك عبر الإضافة.

ستلاحظ أيضاً أيقونة الترس في أعلى اليمين وزر Settings في أسفل اليسار — كلاهما يفتحان نفس لوحة Settings. هناك تضبط مزوّدي AI، الـthemes، الصوت، وكل شيء آخر.

شريط أسفل اليسار يحتوي أيضاً اختصارات لـInstructions، GDD، وAI Memory — ميزات ستلتقي بها لاحقاً. لأول موجِّه لك، اضغط Blueprint Architect.

---

الخطوة 4 — جرّب أول موجِّه

أنت في الدردشة. في صندوق الرسائل بالأسفل، اكتب:

Create a third person character with movement and a health system

اضغط Enter (أو اضغط Send).

سترى الذكاء الاصطناعي يعمل في الوقت الفعلي:

• تظهر فقاعة رسالة بخطة الذكاء الاصطناعي
• تتدفّق tool calls وهو ينشئ Blueprint، ويضيف components، ويضبط variables، ويُسلك المنطق
• عند الانتهاء، يكون لديك Blueprint عامل في مشروعك

هذا هو. أنت تعمل.

إن أردت شيئاً أكثر تحديداً، جرّب أحد هذه:

Make me a UI widget with a health bar that fills based on a player variable

Create a Niagara system that emits sparks when an actor takes damage

Build a save system that stores player position and inventory

يتعامل الذكاء الاصطناعي مع كل ذلك.

---

ما تحصل عليه مجاناً

تأتي الإضافة باستخدام AI مجاني مدمج. يمكنك استخدامه فوراً — لا تسجيل، ولا مفتاح API، ولا دفع. خياران مجانيان مدمجان:

• Blueprints Lab 1.1 — الأقوى، للمهام الكبيرة
• Blueprints Lab 0.9 — الأسرع، لتعديلات سريعة

لكل خيار حد استخدام يومي. إن وصلت إليه، يمكنك إما الانتظار حتى يعاد ضبط الحد، أو إعداد مزوّد AI خاص بك (ندعم OpenAI، Claude، Gemini، DeepSeek، والمزيد — انظر مزوّدو AI).

Slots المزوّدين واختصار ALT+1 إلى ALT+9

تمنحك الإضافة 9 slots للمزوّدين، قابلة للتبديل بـALT الأيسر + 1 إلى ALT الأيسر + 9. كل slot قابل للتهيئة باستقلال — يمكنك ضبط slot لاستخدام الـfree tier، وآخر لمفتاح Claude API الخاص بك، وآخر لتشغيل LLM محلي، وآخر لقيادة عميل CLI مثل Claude Code، وهكذا.

اضغط ALT+3 في أي وقت ويتحوّل الـslot النشط إلى slot 3. تظهر toast صغيرة تأكّد التبديل (مثلاً “Switched to: Claude API”). يطبَّق التغيير على الرسالة التالية التي ترسلها — أي رد ينتجه الذكاء الاصطناعي حالياً ينتهي عبر الـslot القديم، ويخرج موجِّهك التالي عبر الجديد. هذا يتيح لك التبديل بين الرخيص-والسريع والقوي-والمكلف بضغطة زر واحدة دون كسر تدفق المحادثة.

---

المحرّكات والمنصّات المدعومة

إصدار المحرّك	الحالة
Unreal Engine 5.4	مدعوم
Unreal Engine 5.5	مدعوم
Unreal Engine 5.6	مدعوم
Unreal Engine 5.7	مدعوم

المنصّة	الحالة
Windows	مدعومة
macOS	مدعومة
Linux	مدعومة

الإضافة للمحرّر فقط — تساعدك في بناء الألعاب لكنّها لا تُضمَّن في الألعاب التي تشحنها. لا يحتاجها لاعبوك أبداً.

---

تحديث الإضافة

هناك نوعان من التحديثات.

إصدارات إضافة جديدة

عندما نُصدر إصداراً جديداً بإصلاحات أو ميزات جديدة:

1. افتح Epic Games Launcher.
2. اذهب إلى Library → اضغط Installed Plugins تحت إصدار محرّكك.
3. إن توفّر تحديث، سترى زر Update بجوار الإضافة.
4. اضغط Update وانتظر التثبيت.
5. أعد تشغيل Unreal Editor.

تحديثات المحتوى السحابية

تتحدّث بعض الأشياء تلقائياً في الخلفية — ملفات موجِّهات AI، توثيق الأدوات، قوائم النماذج. لا تحتاج إعادة تثبيت أي شيء للحصول عليها. تتزامن في المرة التالية التي تشغل فيها المحرّر مع الإضافة محمّلة.

يمكنك رؤية إصدار الإضافة الحالي (وحالة التحديثات السحابية) في Settings → Updates.

---

إزالة الإضافة أو إعادة تثبيتها

إن سار شيء ما خطأً وأردت بداية نظيفة:

الخطوة 1 — أزِل من المحرّك

1. افتح Epic Games Launcher.
2. اذهب إلى Library → Installed Plugins.
3. اعثر على الإضافة واضغط Remove.

الخطوة 2 — احذف الملفات المتبقية (مسار Windows مُبيَّن)

بعد الإزالة، تحقّق من عدم وجود متبقّيات. افتح File Explorer واذهب إلى:

C:\Program Files\Epic Games\UE_5.X\Engine\Plugins\Marketplace\UltimateBlueprintGenerator

استبدل 5.X بإصدار محرّكك. إن كان المجلد لا يزال هناك، احذفه.

تنبيه بشأن اسم المجلد: علامة الإضافة الموجَّهة للمستخدم هي Ultimate Engine Co-Pilot، لكن المجلد على القرص يحتفظ باسم أقدم (UltimateBlueprintGenerator). هذا متعمَّد — إعادة تسمية تخسر إعداداتك المحفوظة.

الخطوة 3 — أعد التثبيت

عُد إلى FAB Library الخاصة بك، اعثر على الإضافة، اضغط Install to Engine، واختر إصدار محرّكك. ستحصل على نسخة جديدة.

تفعيلك ما زال يسري — لست مضطراً لإدخال مفتاح الترخيص أو order ID من جديد.

---

استكشاف الأخطاء

نافذة التفعيل لا تظهر. لا تظهر الإضافة نافذة التفعيل إلا في أول إطلاق بعد التفعيل. افتح نافذة الإضافة يدوياً (Window → Ultimate Engine Co-Pilot) — سيظهر التفعيل في لوحة Settings تحت License.

التحقق يستغرق أكثر من 5 دقائق. يحدث في FAB أحياناً تأخير. يمكنك إبقاء نافذة التفعيل مفتوحة — تتفقّد تلقائياً كل 30 ثانية. إن مرّت 30 دقيقة دون نتيجة، تحقّق مرتين أن order ID والبريد اللذين أدخلتهما يطابقان تماماً ما هو على إيصال FAB.

الإضافة لا تظهر في قائمة Plugins. تأكّد أنك ثبّتها في إصدار المحرّك الصحيح. يمكنك التثبيت على إصدارات متعددة — كل تثبيت منفصل. أعد تشغيل المحرّر بعد التفعيل.

الـAI المجاني يظهر “rate limited” فوراً. ربما استخدمت حصّتك اليومية في مشروع آخر. تُعاد الحصص في منتصف الليل بـUTC. أثناء انتظارك، يمكنك توصيل مزوّد AI خاص بك في Settings → AI Models — انظر مزوّدو AI.

إن واجهت شيئاً غير موجود في هذه القائمة، تغطّي الأسئلة الشائعة المزيد من الحالات الحدودية. ما زلت عالقاً؟ تواصل معنا على Discord.

---

ماذا تقرأ بعد

الآن وقد أصبحت تعمل، أكثر القراءات فائدة:

• Blueprint Architect — دردشة الذكاء الاصطناعي بالتفصيل، بما في ذلك أنماط التفاعل الأربعة (just chat، ask before edit، plan، auto edit)
• مزوّدو AI — كيفية استخدام مفتاح OpenAI / Claude / Gemini الخاص بك للاستخدام غير المحدود
• Project Scanner — فهرسة كامل مشروعك ليتمكّن الذكاء الاصطناعي من الاستدلال عن أي شيء فيه

أهلاً بك على متننا.