أنور پآي
لديك فكرة لتغيير لعبة تحبها، لكنك لا تعرف كيف تبدأ؟ يجمع Universal Modder مهارات وأدوات تساعد وكيل الذكاء الاصطناعي على فهم اللعبة، واختيار طريقة تعديل مناسبة، والعمل على إضافة صغيرة يمكن اختبارها. وقد تكون البداية سلاحًا جديدًا، أو شكلًا مختلفًا لوحدة، أو تعديلًا في طريقة اللعب.
هذه مراجعة لتوثيق المشروع وملفات أمثلته، وليست تجربة تشغيل من فريق أنور پآي. لم نثبّت الإضافة أو نختبر تعديلًا داخل لعبة لإعداد المقال. الصورة من موارد المشروع، والخطوات التالية مسار موثّق مقترح، وليست نتائج اختبار نفّذناه. [1]
لمن هذا؟
هذا المقال للاعب يريد التعرف على صناعة التعديلات، أو Mods: إضافات تغيّر جزءًا من اللعبة بدل بناء لعبة جديدة كاملة. ويناسب أيضًا من يتعلم استخدام وكلاء البرمجة ويريد مشروعًا ملموسًا يرى أثره على الشاشة.
Universal Modder ليس نموذج ذكاء اصطناعي جديدًا. إنه مجموعة تعليمات وأدوات وقاعدة معرفة يستخدمها وكيل مثل Claude Code أو Codex. الوكيل يقترح الكود ويتعامل مع الملفات، بينما توفر الحزمة أدوات لفحص اللعبة ومعالجة الرسومات والنسخ الاحتياطي والتسجيل. [1][2]
فكرة المشروع أن تبدأ بوصف ما تريد، ثم يحدد الوكيل محرك اللعبة، أي البرنامج الذي يدير رسومها وسلوكها، وطريق التعديل المتاح. بعض الألعاب تملك أدوات رسمية أو أدوات مجتمع معروفة؛ غيرها يحتاج تحليلًا أعمق. لذلك فإن عبارة «أي لعبة» في اسم المهارة ليست ضمانًا بأن كل لعبة تقبل كل تعديل. [3]
للمبتدئ، أنصح بالبدء بمثال جاهز على لعبة تدعم التعديلات، ثم تغيير شيء واحد فيه. لا تبدأ بدمج لعبتين كاملتين أو بإعادة بناء نظام اللعب. في هذا المقال نستخدم مثال Terraria الموجود في المستودع لتوضيح أول نتيجة يمكنك استهدافها.
الحد الآمن للبداية: لعبة تملكها، وطور فردي غير متصل، وعالم تجريبي منفصل. لا تستخدم هذا المسار للغش على لاعبين آخرين أو لتجاوز أنظمة مكافحة الغش أو حماية الملكية. حتى امتلاك اللعبة لا يمنحك تلقائيًا حق إعادة توزيع ملفاتها أو رسومها. [4]
ماذا ستحتاج؟
لبداية على مثال Terraria:
نسخة تملكها من Terraria، ونسخة tModLoader من مصدرها الرسمي. tModLoader أداة تحميل تعديلات تتيح إضافة محتوى إلى اللعبة، ويذكر توثيق المثال أنها يجب أن تكون في مكتبة Steam لتعمل. [5]
وكيل برمجة متاح لديك، مثل Claude Code أو Codex. المشروع يوثّق أيضًا مسارات لـGemini CLI وCursor وCopilot وOpenCode؛ وجود هذه التعليمات ليس نتيجة اختبار أجريناه على كل وكيل. [1]
Git لتنزيل المستودع، وPython 3.10 أو أحدث لأدوات um. يوصي المشروع باستخدام uv لإدارة البيئة والاعتماديات. [1][6]
نسخة احتياطية من الحفظ، وشخصية وعالم مخصصان للتجربة. المثال يتضمن أسلحة تغيّر تضاريس العالم، فلا تختبره على عالمك الأساسي. [5]
على Windows، يمكنك متابعة تثبيت المثال من واجهة tModLoader. أوامر bin/um أدناه مناسبة لطرفية Linux أو macOS أو WSL؛ وWSL بيئة Linux تعمل داخل Windows. راجع مسار نظامك بدل نسخ أوامر نظام آخر دون تعديل.
هناك متطلبات إضافية حسب ما تختاره:
توليد موارد جديدة عبر fal: حساب ومفتاح API في المتغير FAL_KEY، مع مراجعة تكلفة النموذج وشروط مخرجاته. API وسيلة يتصل بها البرنامج بخدمة خارجية؛ لا تنشر المفتاح في مقال أو مستودع أو سجل تشاركه. لا نضع هنا سعرًا ثابتًا أو وعدًا بأن التوليد مجاني.
صور محلية: يضم المشروع um comfy للاتصال بخادم ComfyUI محلي، دون مفتاح fal لهذا المسار. تحتاج ComfyUI ونموذج صور مناسبًا وجهازًا قادرًا على تشغيله؛ وهذه ليست إعدادات تحصل عليها بمجرد تثبيت Universal Modder. [7]
تصيير نماذج ثلاثية الأبعاد إلى رسوم لعبة: Blender. تسجيل الفيديو ومعالجته: ffmpeg. ليست هذه كلها شروطًا لتجربة المثال الجاهز.
لا تحتاج إلى توليد صور مدفوعة كي تبدأ بالمثال المرفق؛ رسومه موجودة أصلًا في المستودع. واستخدام ComfyUI محليًا لا يعني أن جلسة وكيل البرمجة نفسها محلية: راجع ما ترسله إلى مزوّد النموذج، وما يحصل عليه أي خادم MCP، أي واجهة تتيح للوكيل استدعاء أدوات خارجية. [1][2]
النتيجة النهائية (صورة)
أول نتيجة تستهدفها هنا هي تشغيل Fal Arsenal، مثال تعديل Terraria المرفق بالمشروع، داخل عالم تجريبي. يضم المثال أسلحة وأعداء وزعيمًا جديدًا، ويذكر مطوّره أن الرسومات وُلّدت عبر fal ثم جرى تجهيزها للأبعاد التي تحتاجها اللعبة. [5]
الصورة تعرض ملفات PNG الأصلية من المستودع في ترتيب تحريري: Homing Missile Launcher وTesla Rifle وScrap Drone. الرسم الثالث يحتوي إطارين للتحريك، وليس عدوين مختلفين. هذه أمثلة موارد التعديل، وليست لقطة شاشة تثبت أننا شغّلنا اللعبة. نسبناها إلى أصحاب المشروع وأرفقنا ترخيص المستودع في حزمة المراجعة. [5][8]
ومن أمثلة المشروع الأخرى حضارة San Franciscans في Age of Empires II DE، بوحدات ورسوم جديدة. يذكر توثيقها اختبارًا داخل اللعبة، لكن لا ينبغي تحويل هذا المثال إلى وعد بأن الأداة تنجح بالنتيجة نفسها مع كل لعبة أو نسخة. متطلبات ذلك المثال مختلفة أيضًا، ومنها Python 3.11 أو أحدث. [9]
خطوات 1-2-3
1. جهّز الأدوات وحدد مهمة صغيرة
إذا كنت تستخدم Claude Code، يوثّق المشروع هذا المسار لتثبيت الإضافة من داخل جلسة Claude، وليس من طرفية النظام العادية: [1]
/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder
وللوصول إلى الملفات والأمثلة، نزّل المستودع:
git clone https://github.com/rehan-remade/universal-modder
cd universal-modder
راجع ملفات README.md وAGENTS.md قبل السماح للوكيل بتعديل جهازك. مسار تنزيل المستودع مفيد أيضًا للوكلاء الذين يقرؤون تعليمات AGENTS.md؛ لكنه لا يثبت وحده أن كل الأدوات أو اتصالات MCP أصبحت جاهزة. [2]
داخل المستودع، يمكنك طلب المساعدة ثم فحص الألعاب المثبتة:
./bin/um --help
./bin/um scan --list
./bin/um scan "terraria"
بحسب توثيق الأداة، الفحص يقرأ الملفات ويبحث عن إشارات المحرك وأدوات التعديل والحفظ والحماية. قد لا يجد لعبة مثبتة في مكان غير معتاد؛ يمكن تمرير مسار مجلدها بدل الاسم. وعدم اكتشاف حماية لا يثبت عدم وجودها، خصوصًا في الألعاب المتصلة أو التي تستخدم مشغّلًا خارجيًا. [3][10]
علامة اكتمال هذه المرحلة: تعرف اللعبة والنسخة، وطريق التعديل، وأين توجد ملفات الحفظ. إذا لم تعرف هذه المعلومات، لا تنتقل مباشرة إلى توليد الكود.
2. اطلب خطة، ثم وافق على نطاق التنفيذ
ابدأ بطلب محدود وواضح، مثل هذا المثال المقترح:
أملك Terraria وأريد تجربة مثال Fal Arsenal في طور فردي وعالم جديد. افحص المتطلبات وطريقة تثبيت المثال أولًا، وحدد ملفات الحفظ التي نحتاج إلى نسخها. اعرض خطة قبل أي تعديل. لا تستخدم خدمات توليد مدفوعة، ولا تثبّت أدوات داخل مجلد اللعبة، ولا تتحكم بالفأرة أو لوحة المفاتيح دون موافقتي.
المشروع يشجّع الوكيل على البحث في قاعدة المعرفة قبل البدء. ويمكنك الاطلاع على ملاحظاته السابقة بهذا الأمر: [11]
./bin/um kb search "terraria"
هذه الملاحظات سجلات خبرة يكتبها المشاركون: النسخ المستخدمة، والطريق الذي نجح، والمشكلات وكيف تحقّقوا من النتيجة. ليست ضمان توافق أو تدريبًا جديدًا للنموذج، وقد تختلف ظروفها عن جهازك.
بعد مراجعة الخطة، خذ نسخة احتياطية من المجلد الصحيح الذي حددته. لا تخمّن مسار الحفظ من مثال جهاز آخر. ثم اتبع تعليمات المثال المرفق: افتح Workshop > Develop Mods في tModLoader كي ينشئ مجلد ModSources، وانسخ إليه مجلد:
examples/terraria-tmodloader/FalArsenal
يعرض التوثيق المسار المعتاد على Windows على النحو الآتي؛ استخدم المجلد الذي أنشأته لعبتك فعليًا: [5]
Documents\My Games\Terraria\tModLoader\ModSources\
علامة اكتمال هذه المرحلة: يظهر FalArsenal ضمن واجهة تطوير التعديلات، وتبقى نسخة الحفظ الأساسية منفصلة عن تجربة التعديل.
3. ابنِ المثال واختبره داخل اللعبة
من واجهة tModLoader، اتبع المسار الموثّق:
Workshop > Develop Mods > FalArsenal > Build + Reload
ثم ادخل بشخصية تجريبية إلى عالم جديد، واستخدم أمر الدردشة الذي يوفّره المثال للحصول على العناصر: [5]
/arsenal
لا تعتبر نجاح البناء وحده نهاية الاختبار. تحقق داخل اللعبة من ظهور العناصر ورسومها، ومن عمل السلوك المقصود، وراجع السجل إذا حدث خطأ. توثيق المثال يقول إن اللعب المتعدد لم يُختبر؛ لذلك لا تنقل نجاحًا فرديًا محتملًا إلى ادعاء جاهزية اللعب الجماعي.
بعد أن تفهم المثال، اطلب من الوكيل تغييرًا صغيرًا يمكن مراجعته، مثل تعديل لون رسم أو قيمة معلنة لعنصر واحد، مع شرح الملفات التي سيغيّرها. اختبر هذا التغيير منفصلًا قبل إضافة وظائف أخرى.
وقبل مشاركة تعديلك، يوفّر المشروع فحصًا مساعدًا لملفات اللعبة والكود المفكك والأسرار: [12]
./bin/um publish check "<mod-folder>"
استبدل <mod-folder> بمجلد تعديلك. الأمر يفحص الحزمة؛ لا ينشرها نيابة عنك، ولا يمنحك حقوق توزيع مواد لا تملكها. راجع التراخيص وشروط اللعبة والمحتوى الذي خرج من خدمات التوليد، واطلب الموافقة قبل أي نشر.
مشاكل شائعة
الأداة لا تجد اللعبة. يذكر توثيق الفحص أن الألعاب خارج مكتبات المتاجر المعتادة قد تحتاج مسار المجلد صراحة. استخدم المسار الصحيح، وتحقق من النسخة والمشغّل بدل إعادة تثبيت اللعبة عشوائيًا. [3]
um غير معروف في الطرفية. داخل نسخة المستودع، استخدم ./bin/um في طرفية مناسبة. وإذا لم يكن uv متاحًا، يوضح المشغّل أنه ينتقل إلى Python النظام؛ عندها قد تكون الاعتماديات ناقصة. افحص متطلبات pyproject.toml، ولا تفترض أن وجود Python يكفي وحده. [6][13]
المثال لا يظهر أو البناء يتعثر. تأكد أنك نسخت مجلد FalArsenal إلى ModSources الذي أنشأه tModLoader، لا إلى مجلد التعديلات الجاهزة. راجع توافق النسخ وتعليمات المثال والسجل. وفي مثال المطوّر، عمل البناء عبر مسار -build من WSL، بينما تعثرت مرحلة تغليف أخرى بسبب FNA3D؛ هذه ملاحظة خاصة بذلك المسار وليست حكمًا عامًا على WSL. [5]
توليد الصور لا يعمل. مسار fal يحتاج مفتاحًا صالحًا وإعداد خدمة وتكلفة مناسبة؛ والمسار المحلي يحتاج خادم ComfyUI يعمل ونموذجًا متاحًا. لا تخلط بين الخيارين. لا ترسل مفتاحك إلى الوكيل في نص يمكن حفظه أو مشاركته؛ استخدم إعدادًا محميًا مناسبًا لأداتك. [1][7]
التعديل يعمل لكنه يغيّر العالم أكثر مما توقعت. المثال يتضمن تأثيرات تحفر التضاريس. لهذا نبدأ بعالم منفصل ونسخة احتياطية. لا تستخدم ملف حفظ مهمًا لمجرد أن البناء نجح. [5]
اللعبة تعرض نظام مكافحة غش أو يتطلب المسار تجاوز حماية. توقف عن تعديل العميل المحمي. ابحث عن أدوات رسمية تسمح بها اللعبة أو اختر لعبة أخرى للتعلم؛ لا تحاول التحايل لتكمل الشرح. قواعد السلامة المكتوبة في المشروع ليست عزلًا تقنيًا يمنع كل خطأ. [4]
مصطلحات
Mod: إضافة تغيّر محتوى اللعبة أو سلوكها.
وكيل برمجة: مساعد يعتمد على نموذج ذكاء اصطناعي ويستخدم أدوات لقراءة الملفات أو تعديلها أو تنفيذ أوامر ضمن صلاحياته.
محرك اللعبة: النظام الذي يشغّل الرسوم والمنطق والتفاعل.
Mod Loader: أداة تحميل مثل tModLoader توفر طريقًا لإدخال التعديل إلى اللعبة.
Sprite: صورة صغيرة يستخدمها الرسم ثنائي الأبعاد؛ وقد تحتوي ورقة الصور عدة إطارات للتحريك.
CLI: واجهة تكتب فيها أوامر نصية بدل استخدام أزرار برنامج.
MCP: واجهة تتيح للوكيل الاتصال بأدوات خارجية؛ إعدادها لا يثبت نجاح الاتصال أو أمان كل عملية.
fal وComfyUI: خيار خدمة لتوليد موارد، وخيار تشغيل سير توليد صور محلي، على الترتيب. يختلف ما تحتاجه وما يغادر جهازك بينهما.
ماذا بعد؟
ابدأ بالمثال الجاهز، ثم غيّر شيئًا واحدًا يمكنك وصف نتيجته بوضوح. سجّل النسخة، والملفات المعدلة، وما نجح وما فشل. هذا أقرب إلى تعلّم التعديل فعلًا من طلب «اصنع لعبة داخل لعبة» وانتظار نتيجة يصعب عليك تقييمها.
ما يميز Universal Modder هو جمع مسار العمل: فحص اللعبة، واختيار أداة المجتمع المناسبة، وبناء إضافة صغيرة، وتجهيز الموارد، والاختبار داخل اللعبة، ثم توثيق الخبرة. لكن قيمة ذلك تظهر في نتيجة قابلة للفحص على لعبتك، لا في طول قائمة الأدوات.
ولفهم جانب تحليل التطبيقات قبل التوسع، اقرأ مقالنا: كيف يساعد الذكاء الاصطناعي على فهم التطبيقات وبناء بدائل لها؟. ولتعلم قيادة وكيل البرمجة وفهم قراراته، اقرأ: تعلّم البرمجة والذكاء الاصطناعي يكتب معك الكود: VibeWise.
المصادر ونطاق المراجعة
راجعت المسودة توثيق المشروع وملفات أدواته عند مراجعة المصدر المحددة أدناه. لم ننفذ تثبيتًا أو توليدًا مدفوعًا أو تعديل ملفات لعبة أو اختبار لعب. أوامر المقال مستندة إلى التوثيق والملفات المرفقة؛ صور الموارد من المثال المنشور، ولا تشمل ملفات لعبة أصلية أو كودًا مفككًا.
[1] المستودع والتثبيت والمسارات المدعومة.
[2] تعليمات الوكلاء وحدود الأدوات.
[3] فحص اللعبة واختيار طريق التعديل.
[5] مثال Terraria: Fal Arsenal وطريقة بنائه وحدود اختباره.
[6] متطلبات أدوات Python.
[7] مسار ComfyUI المحلي ومتطلباته.
[8] مصدر رسوم المثال وترخيص MIT للمستودع. حقوق الألعاب والمواد الخارجية تبقى لأصحابها؛ ترخيص الأداة لا يرخصها تلقائيًا.
[9] مثال Age of Empires II DE وبيئته.
[10] شيفرة فحص الألعاب وإشارات الحماية.
[11] قاعدة المعرفة وما تعنيه الملاحظات الميدانية.
[12] فحص الحزمة قبل مشاركتها.
[13] مشغّل أدوات um.
لا تعليقات بعد. شارك سؤالك أو تجربتك مع هذا المحتوى.