التوثيق

كل ما تحتاجه لتصبح منتجًا مع Numivo: من التثبيت وحتى قواعد الأنواع المتقدمة. لـ Unreal Engine 5 و Unity.

نظرة عامة

Numivo مجموعة أدوات محرر لتصميم المراحل. تتألف من ثلاثة أجزاء: خدمة سطح المكتب (تدير مكتبتك وإعداداتك الجاهزة)، وإضافة المحرك (Unreal أو Unity)، والنواة المشتركة التي تربط بينهما.

أهم مبدأ: Numivo غير مرئي أثناء التشغيل. كل ما تضعه يُخبز إلى أصول محرك أصلية: مجسمات مُنسَّخة، ونباتات، ومواد قياسية. ولا يحمل بناؤك النهائي أي اعتمادية على Numivo.

التثبيت

نزّل المثبّت المناسب لنظامك من صفحة التثبيت. يهيّئ المثبّت خدمة سطح المكتب، ويستطيع تثبيت إضافة المحرك تلقائيًا.

التثبيت اليدوي في Unity عبر Package Manager باستخدام رابط Git:

// Unity → Window → Package Manager → “+” → Add package from git URL
https://github.com/numivo/com.numivo.leveldesign.git#v1.4.0

أما في Unreal فيمكنك بدلًا من ذلك نسخ الإضافة يدويًا إلى مجلد إضافات المحرك وتفعيلها من Edit → Plugins.

البدء السريع: أول مشهد لك في 5 دقائق

بعد التثبيت، افتح لوحة Numivo (Window → Numivo). وأسرع طريق إلى مشهد مزروع:

  1. اسحب من 3 إلى 5 أصول أشجار من متصفح المحتوى إلى نوع جديد باسم «الأشجار».
  2. اضبط الكثافة على نحو 60 % وحُدّ الميل بين 0 و35°.
  3. اختر حجم الفرشاة بعجلة الفأرة وارسم على التضاريس.
  4. أنشئ نوعًا ثانيًا باسم «الصخور» وامنحه القاعدة تجنّب: الأشجار (نصف قطر 2 م).
  5. اضغط B لوضع الدمج وأذِب الصخور في التضاريس.
نصيحة: كل حقل رقمي يقبل النقطة والفاصلة كفاصل عشري، بما في ذلك من لوحة الأرقام.

توزيع الأصول على الأسطح

يضع التوزيع الأصول على الأسطح بطريقة معقولة فيزيائيًا. ولكل نوع (مجموعة أصول) قواعده الخاصة: الكثافة، وأقنعة الميل والارتفاع، والتجميع، والعلاقات مع الأنواع الأخرى.

أهم المعاملات:

المعاملالأثر
الكثافةعدد النسخ المستهدف لكل متر مربع، معدَّلًا بقوة الفرشاة.
قناع الميلنطاق الميل المسموح به بالدرجات. ولا يُوضع شيء خارجه.
التجميع0 = توزيع متساوٍ، 1 = تجمّع طبيعي قوي.
المحاذاة مع العمودتميل النسخ مع السطح بدل الوقوف عموديًا.

الرسم: زر الفأرة الأيسر يوزّع، وShift مع السحب يمحو، وعجلة الفأرة تغيّر حجم الفرشاة. وكل ضربات الفرشاة تشكّل خطوة تراجع واحدة.

دمج المجسمات

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

اختر مجسمًا، واضغط B، ثم حرّك مؤشر مسافة الدمج. يتحكم منحنى التلاشي في مدى نعومة تدرّج الانتقال. ويعرض خيار «معاينة الحواف» خريطة حرارية فوق منطقة الانتقال.

يحتاج الدمج إلى صلاحية قراءة كسوة التضاريس. وفي مستويات World Partition داخل UE يجب أن تكون الخلايا المعنية محمّلة.

الشبكات

توزّع أداة الشبكات الأصول في أنماط منتظمة: مستطيل، ودائرة، ومضلّع (عدد أضلاع قابل للضبط: 6 أضلاع تعطي شكلًا سداسيًا) وخلايا منحنيات حرة.

يمكن لكل خلية أن تدور تدريجيًا («spin»)، وأن تُزاح عشوائيًا، وأن تُسقط على السطح. والأقنعة تقصّ الخلايا بدقة، وهي مثالية للساحات والمقابر ومزارع الطاقة الشمسية والبساتين.

القياس

تقيس أداة القياس (M) من نقطة إلى نقطة، أو على شكل سلاسل، أو كأقل مسافة بين جسمين. والالتقاط يثبّت على الرؤوس والحواف والشبكة.

تُحفظ القياسات بأسماء في قائمة القياسات ويمكن تصديرها بصيغة CSV. وعند مغادرة الأداة تختفي كل الخطوط الإرشادية، ولا يبقى أي أثر في المشهد.

متصفح المحتوى

يفهرس المتصفح مكتبة أصولك محليًا (SQLite) ويظل سلسًا حتى بعد تجاوز مليون عنصر: النتائج مُحوَّلة إلى عرض افتراضي، والصور المصغّرة تُولَّد عبر خط معالجة يعمل في الخلفية.

يفهم البحث الأسماء والمسارات، وعند تفعيل الوسم بالذكاء الاصطناعي يفهم أيضًا أوصافًا حرة مثل «صخرة مغطاة بالطحالب». الوسم بالذكاء الاصطناعي اختياري؛ وبدونه لا يغادر أي أصل جهازك أبدًا.

الأنواع والإعدادات الجاهزة

تجمع الأنواع الأصول مع قواعدها. وتتحكم العلاقات بين الأنواع في تعايشها: تجنّب يبقي مسافة، وانجذاب يسعى إلى القرب. وهكذا تنمو الفطريات عند جذوع الأشجار بينما تبقى الممرات خالية.

يمكن حفظ إعداد كامل ومشاركته كإعداد جاهز، وهو ملف JSON ينتقل بين Unreal و Unity:

{
  "species": [{
    "name": "Pine",
    "density": 0.6,
    "slope": [0, 35],
    "clustering": 0.7,
    "relations": [{ "type": "avoid", "target": "Rocks", "radius": 2.0 }]
  }]
}

الاختصارات

الاختصارالإجراء
Sفرشاة التوزيع
Bوضع الدمج
Mأداة القياس
Gأداة الشبكات
Mouse wheelتغيير حجم الفرشاة
Shift + Dragالمحو
Ctrl / Shift + Sliderخطوات مؤشر دقيقة / خشنة
Ctrl + Zالتراجع عن آخر ضربة

حل المشكلات

اللوحة لا تعثر على خدمة سطح المكتب.

تستمع الخدمة محليًا على المنفذ 47615. تحقق مما إذا كان جدار حماية يحجب الاتصالات المحلية، ثم أعد تشغيل الخدمة من أيقونة شريط المهام.

الإضافة مفقودة بعد تحديث المحرك.

تُثبَّت تحديثات المحرك في مجلد جديد. شغّل مثبّت Numivo مرة أخرى، سيكتشف الإصدار الجديد وينسخ الإضافة إليه.

الصور المصغّرة تبقى رمادية.

يعمل خط معالجة الصور المصغّرة بأولوية منخفضة. ومع المكتبات الضخمة جدًا قد تستغرق المرحلة الأولى بعض الوقت؛ ويظهر التقدّم في أسفل المتصفح.

التوزيع يبدو مختلفًا في البناء عنه في المحرر.

تأكد من تنفيذ الخبز قبل البناء (Bake to Native). فنسخ المعاينة غير المخبوزة موجودة في المحرر فقط.