AI Games Studio
ملفات محلية وخطوات قابلة لإعادة التنفيذ

جهّز الأدوات.
واحتفظ بالتحكم.

يعرّف الموقع العام بالمشروع. أما Studio فهو تطبيق محلي منفصل لتعديل الموارد والسلوكيات. ابدأ بـGit وNode والمتصفح، ثم أضف بقية الأدوات حسب هدفك.

1. ثبّت الأدوات المطلوبة

ثبّت Git وNode 24 ثم أعد فتح الطرفية. يُستحسن VS Code. يحتاج جسر MCP إلى uv وPython 3.12. لإنشاء تصيير جديد ثبّت Blender، ولتعديل مشروع المحرك ثبّت Cocos Dashboard ثم Creator 3.8.8.

Git · Node.js · VS Code · uv · Blender · Cocos Creator

2. افتح بيئة العمل المحلية

نفّذ الأوامر التالية من المجلد الذي اخترته. اترك الطرفية تعمل وافتح http://127.0.0.1:4780. أوقف الخادم بواسطة Ctrl+C. في PowerShell استخدم npm.cmd عند حظر ملفات .ps1.

git clone https://github.com/Adnen-Ben-Abdelaali/ai-games-studio.git
cd ai-games-studio
npm ci
npm run demo
npm start

3. اربط Codex بواسطة MCP

استبدل المسار التالي بمسارك الفعلي. يتطلب الأمر واجهة Codex لسطر الأوامر. إذا لم تتوفر، أضف قسم Studio فقط من docs/mcp.example.toml إلى إعداداتك الحالية. أعد توصيل العميل واترك Studio يعمل. يوفر الجسر 12 أداة؛ لا توجد محادثة Codex مدمجة داخل Studio.

uv python install 3.12
codex mcp add ai-games-studio -- uv run --python 3.12 --with "mcp==1.30.0" python /absolute/path/to/ai-games-studio/tools/studio_mcp.py

4. اربط المخططات والكود بالسلوكيات

تمثل البطاقات والعروض الستة، الحالات والنشاط والتسلسل والتوقيت والفئة والكائن، وصيغة studioBehavior النموذج نفسه. احفظ البطاقات، أو استخدم Update diagram & code للفعل، أو Apply code بعد تعديل الصيغة. يجب استيراد تعديل VS Code أو تطبيقه عبر Codex باستخدام update_behavior_code. لا يتحول تعديل HTML أو Cocos عشوائي تلقائيًا إلى UML.

4. اربط المخططات والكود بالسلوكيات

5. جهّز الصور في Blender

ثبّت إضافة MCP for Blender وفعّلها وشغّل خادمها المحلي. في Studio جرّب الزجاجة الأصلية وglow-turn-glow و24 إطارًا بحجم 192 بكسل بمعدل 8 إطارات في الثانية. ينشئ Prepare with Blender مشهدًا ويصدر PNG شفافة وأطلسًا ومعاينة. تحقّق من حقوق النموذج الخارجي قبل استخدامه وإعادة توزيعه.

uvx mcp-for-blender==2.2.6 install-addon
codex mcp add blender -- uvx mcp-for-blender==2.2.6

6. عدّل وصدّر في Cocos

استورد examples/cocos-native في Creator 3.8.8. افتح assets/StudioGame.scene وانتظر اكتمال الاستيراد قبل فحص الأنواع في VS Code. عاين ثم اختر Project → Build → Web Mobile أو Web Desktop. يختلف هيكل المشروع المصدّر من Studio عن المثال الأصلي. اختبر المتصفحات والأجهزة المستهدفة.

7. انشر الموقع الثابت

ينسخ البناء الصفحات الإنجليزية والفرنسية والعربية والصور واللعبة والفيديو مع مسارات الترجمة إلى website/dist. انشر محتوياته كاملة على الخادم وتحقّق من HTTPS والروابط والفيديو. لا تنشر خادم Studio المحلي أو .studio-data أو منافذ MCP.

npm run build:site
npm run check:site

اقرأ تعليمات تسليم النشر ↗

افتح الدليل العربي الكامل ↗