كيفية إنشاء تعديل في Factorio: إضافة عناصر، وصفات، وأسماء باللغة العربية باستخدام Lua

في Factorio 2.0، سنقوم بإضافة عنصر تدريبي tm-practice-plate يُصنع من صفيحتين حديديتين. هذا مثال مباشر على إنشاء نموذج أولي لعنصر، ووصفة تصنيع، وتوطين وقراءتها في مجلد التعديلات (Mods). يستند هذا إلى تعديل الأساس (base) دون الاعتماد على محتوى Space Age، ويستخدم خريطة اختبار منفصلة بدلاً من حفظ المصنع الحالي.

1. إعداد مجلد التعديل والملفات

قد يختلف المجلد الذي يحتوي على ملف التنفيذ في Factorio عن مجلد بيانات المستخدم. ابحث عن مجلد mods في موقع بيانات المستخدم المذكور في المستندات الرسمية. تستخدم عمليات تثبيت Windows العادية %APPDATA%/Factorio/mods، ولكن التكوينات المحمولة والمخصصة تختلف. قم بعمل نسخة احتياطية من ملفات الحفظ وإعدادات التعديل الحالية، ثم قم بإنشاء مجلد باسم tm-practice_1.0.0.

tm-practice_1.0.0/
  info.json
  data.lua
  locale/
    en/strings.cfg
    ar/strings.cfg

2. إعلان التوافق في ملف info.json

الاسم (name) هو المعرّف الداخلي للتعديل ويتطابق مع الجزء الأمامي من اسم المجلد. يجب أن يتطابق الإصدار (version) مع _1.0.0 في المجلد. تم تثبيت factorio_version على 2.0 لتجنب الخلط بينه وبين بنية الإصدار 1.1. تتيح لك شروط التبعية (dependencies) لـ base استخدام النماذج الأولية للعبة الأساسية.

{
  "name": "tm-practice",
  "version": "1.0.0",
  "title": "TroubleMaker Practice Plate",
  "author": "TroubleMaker",
  "factorio_version": "2.0",
  "dependencies": ["base >= 2.0.0"],
  "description": "An original item and recipe tutorial."
}

3. إضافة العناصر ووصفات التصنيع في data.lua

انسخ النموذج الأولي لعنصر الصفيحة الحديدية الأساسية وامنحه اسماً جديداً وحجم تكديس جديداً. تشير الرموز (Icons) إلى المسار الداخلي للعبة الأساسية الذي يمتلكه المستخدم، لذلك لا تنسخ صور اللعبة إلى ملف ZIP. اكتب المكونات (ingredients) والنتائج (results) للوصفة بتنسيق type/name/amount الصريح في Factorio 2.0. اجعل enabled=true بحيث يمكن العثور عليه في خريطة الاختبار دون الحاجة إلى إلغاء قفل تكنولوجي منفصل.

local plate = table.deepcopy(data.raw.item["iron-plate"])
plate.name = "tm-practice-plate"
plate.order = "a[tm-practice-plate]"
plate.stack_size = 100

data:extend({
  plate,
  {
    type = "recipe",
    name = "tm-practice-plate",
    enabled = true,
    energy_required = 1,
    ingredients = {
      {type = "item", name = "iron-plate", amount = 2}
    },
    results = {
      {type = "item", name = "tm-practice-plate", amount = 1}
    }
  }
})

4. إضافة الأسماء المعروضة عبر التوطين (Locale)

أضف النص أدناه إلى locale/ar/strings.cfg. تأكد من مطابقة أسماء النماذج الأولية بدقة في أقسام item-name و recipe-name. إذا كانت سلاسل Lua ومفاتيح التوطين غير متطابقة، فقد يتم عرض معرف داخلي أو مفتاح غير معروف (Unknown key).

[item-name]
tm-practice-plate=صفيحة حديد تدريبية

[recipe-name]
tm-practice-plate=تصنيع صفيحة حديد تدريبية

[item-description]
tm-practice-plate=عنصر لتعلم صناعة التعديلات.

في ملف locale/en/strings.cfg، ضع عبارات باللغة الإنجليزية بنفس بنية المفاتيح مثل Practice plate و Make practice plate و An item for modding practice. احفظ الملفات بتنسيق UTF-8. إذا قمت بحفظ ملفات .cfg بتنسيق JSON، فلن تتم قراءتها.

5. تشغيل التعديل والتحقق من التصنيع

1. قم بتشغيل اللعبة وقم بتفعيل TroubleMaker Practice Plate من قائمة Mods.
2. تأكد من عدم وجود رسائل خطأ عندما تعيد اللعبة تشغيل نفسها لقراءة التعديل.
3. العب في وضع الحماية الجديد (sandbox) أو خريطة اختبار وقم بتحضير صفائح الحديد.
4. ابحث عن وصفة الصفيحة التدريبية في قائمة التصنيع وتأكد من تحويل صفيحتين حديديتين إلى عنصر واحد.
5. قارن ما إذا كان الاسم والوصف يظهران بالعبارات المخصصة للتوطين عند التبديل بين إعدادات اللغة العربية والإنجليزية.
6. قم بإنهاء اللعبة تماماً، وقم بتعطيل التعديل، ثم تحقق من التكوين الافتراضي في خريطة اختبار منفصلة.

6. ترتيب قراءة الأخطاء

إذا توقف تحميل التعديل، فابحث عن الخطأ الأول في ملف factorio-current.log. بالنسبة لأخطاء عدم وجود النموذج الأولي، تحقق من إملاء iron-plate وتبعية base، وبالنسبة لأخطاء الوصفة، تحقق من تنسيق results و ingredients أولاً. إذا لم يكن التعديل موجوداً في القائمة، فتأكد مما إذا كان مسار info.json موجوداً داخل مجلدين متداخلين. الأيقونة هي نفسها، لذا فهي ليست خطأ حتى لو كان مظهرها مطابقاً لصفيحة الحديد الأساسية. من الأسهل إجراء الاختبار بعد نجاح هذه الخطوة إذا كنت ترغب في إضافة رمز التصنيع الخاص بك، أو فتح التقنيات، أو التوازن.

7. الإزالة والمشاركة

إذا قمت بإزالة التعديل الذي يضيف عناصر، فقد تختفي تلك العناصر من ملف الحفظ. لا تقم بإيقاف تشغيله مباشرة في ملف حفظ مصنع مهم، بل تحقق منه أولاً في نسخة احتياطية. اجعل ملف ZIP القابل للمشاركة يحتوي على مجلد واحد فقط باسم tm-practice_1.0.0 وتأكد من تطابق name و الإصدار version. حدد الشروط التي تم اختبارها بها مع التعديلات الأخرى، واللعبة الداعمة 2.0، وتبعية base المستخدمة. بعد تحديث اللعبة، تحقق مرة أخرى من التحميل والتصنيع وعرض الاسم قبل نشر الإصدار الجديد.

المستندات الأصلية ومعايير التحقق

هذا دليل تمهيدي كتبه فريق إدارة TroubleMaker بعد مراجعة وثائق الأدوات الرسمية والمنشأة في 7 أكتوبر 2026. الرموز والرسوم التوضيحية هي أمثلة خاصة للشرح وليست نتيجة للتحقق من اللعب الفعلي لهذه اللعبة على هذا الخادم. تحقق من الإصدار الموضح في النص في ملف حفظ اختبار منفصل قبل النشر. قارن أحدث إصدار وتبعية لكل أداة من المصادر أدناه.

Factorio 2.0 모드 제작 튜토리얼

Factorio locale 공식 문서

Factorio recipe prototype

Factorio 모딩 문서