دوامة
1.12.6
Vortex هو مدير التعديل الحالي من Nexus Mods. لقد تم تصميمه لجعل تعديل لعبتك بسيطًا قدر الإمكان للمستخدمين الجدد، مع الاستمرار في توفير التحكم الكافي للمحاربين القدامى الأكثر خبرة في مشهد التعديل.
يهدف نهجنا مع Vortex إلى القيام بمهام معقدة مثل فرز ترتيب التحميل الخاص بك أو إدارة ملفات التعديل الخاصة بك وأتمتة أكبر قدر ممكن من العملية بهدف تحقيق لعبة معدلة مستقرة بأقل جهد. نريد مساعدتك في قضاء وقت أقل في التعديل ووقت أطول في لعب ألعابك.
دعم الألعاب المتعددة - مع دعم التعديل لأكثر من 250 لعبة مختلفة والعد، يعد Vortex هو مدير التعديل الأكثر تنوعًا المتاح. يتضمن ذلك ألعابًا مثل Skyrim، وFallout 3، وFallout 4، وFallout: New Vegas، وCyberpunk 2077، وBaldur's Gate 3، وStarfield، وStardew Valley، وBannerlord، وWitcher 3، وElden Ring، وThe Sims 4، وMonster Hunter: World، وOblivion، وPalworld. ، بليد والشعوذة، فالهايم، تراث هوجورتس، 7 أيام للموت.
التكامل الوثيق مع Nexus Mods - تم تصميم Vortex للتفاعل بسلاسة مع Nexus Mods مما يسمح لك بسهولة العثور على التعديلات وتثبيتها وتشغيلها من موقعنا، والتعرف على الملفات الجديدة والحصول على آخر الأخبار.
أصبح التعديل سهلاً - يقوم نظام الفرز التلقائي المدمج بإدارة ترتيب التحميل الخاص بك ويساعدك على حل تعارضات التعديل من خلال ميزات إدارة المكونات الإضافية القوية وسهلة الاستخدام.
ملفات تعريف التعديل - يمكنك بسهولة إعداد ملفات تعريف التعديل المستقلة والتبديل بينها وإدارتها، مما يتيح لك استخدام مجموعة التعديلات التي تريدها في عملية تشغيل معينة.
واجهة مستخدم حديثة وسهلة الاستخدام - تتميز Vortex بواجهة قابلة للتخصيص بالكامل، وتتيح لك الوصول بسرعة وسهولة إلى الأدوات وإدارة الألعاب والمكونات الإضافية والتنزيلات وحفظ الألعاب.
الامتدادات والمكونات الإضافية - تم إصدار Vortex بموجب ترخيص GPL-3 مما يمنح مجتمعنا القدرة على كتابة الامتدادات والأطر التي يمكنها بعد ذلك التفاعل مع Vortex، مما يضيف إلى وظائفه باستمرار.
للبدء، يمكن تنزيل Vortex من Nexus Mods أو من GitHub. بعد تنزيل برنامج التثبيت، ما عليك سوى تشغيله واتباع التعليمات.
يمكن العثور على معلومات إضافية حول Vortex والأدلة في Vortex Wiki.
لبدء التطوير على Vortex، يرجى استخدام هذه الطريقة الآلية في الغالب لتنزيل جميع التبعيات وتثبيتها، واستنساخ Vortex repo من GitHub ثم إنشائه بحيث يمكن تشغيله من المصدر. يتم تثبيت معظم التبعيات باستخدام Scoop.
ابدأ تشغيل بوويرشيل بالنقر فوق الزر "ابدأ" وكتابة powershell .
قم بتشغيل Invoke-WebRequest "https://raw.githubusercontent.com/Nexus-Mods/Vortex/master/bootstrap.ps1" -OutFile bootstrap.ps1 لجلب البرنامج النصي bootstrap
بشكل افتراضي، سيقوم هذا البرنامج النصي ببناء Vortex في C:buildvortex . إذا كنت ترغب في وضعه في مكان آخر، فقم بتحرير البرنامج النصي لتغيير دليل البناء قبل تشغيله.
ستحتاج على الأرجح إلى السماح بتشغيل البرامج النصية. يمكن ضبط ذلك باستخدام Set-ExecutionPolicy Unrestricted ولكن يلزم وجود بوويرشيل مع وصول المسؤول.
قم بتشغيل البرنامج النصي ( .bootstrap.ps1 )
يهدف القسم التالي إلى توضيح وشرح بعض قرارات التطوير.
تختلف سلسلة أدوات إنشاءات التطوير وإصدارات الإصدارات تمامًا.
في تصميمات التطوير، يتم استخدام مترجم الآلة الكاتبة (tsc) مباشرة لنقل كل ملف .ts إلى .js بشكل فردي، ويقوم الإلكترون بتشغيل هذه الملفات مباشرة، ويتم تحميل التبعيات من node_modules .
في إصدارات الإصدار، نستخدم webpack وts-loader لدمج جميع ملفات .ts والتبعيات في ملفين جافا سكريبت (أحدهما للعملية الرئيسية/المتصفح، والآخر للعارض). يتم استخدام electron-builder لتجميع التعليمات البرمجية والأصول، وإنشاء مثبت nsis، وإدراجه في مثبت exe وتوقيعها (وجميع الملفات التنفيذية وملفات dll التي نشحنها). توجد ملفات تكوين متعددة لمنشئ الإلكترون لمتغيرات متعددة، ويتم استخدام "نقرة واحدة" و"متقدم" فقط لإنشاءات الإصدار، وقد تكون الملفات الأخرى في حالات مختلفة من العطل (على الرغم من أن ci يجب أن يعمل أيضًا)
ونتيجة لذلك، يكون العمل مع تصميمات التطوير أسهل ويكون البناء أسرع بكثير ولكن وقت التشغيل يكون أبطأ.
علاوة على ذلك، نحن نستخدم بنية مكونة من حزمتين، مما يعني أن الملف /package.json يتم استخدامه لجميع عمليات التطوير وبيئة البناء للإصدارات (على سبيل المثال، يتحكم هذا الملف دائمًا في الإصدار الإلكتروني المستخدم/المجمع) بينما يقرر /app/package.json الإعدادات (الاسم، الإصدار، التبعيات) لإصدارات الإصدار فقط. نحن نستخدم برنامجًا نصيًا مخصصًا ( checkPackages.js ) للتأكد من أن التبعيات للإصدار هي مجموعة فرعية من تبعيات build env وأنها تستخدم نفس الإصدار لتجنب المشكلات التي لم تحدث أثناء الاختبار بسبب التبعيات المختلفة.
من ناحية أخرى، يتم إنشاء الامتدادات المجمعة بنفس الطريقة بين التطوير والإصدار: يتم إنشاؤها دائمًا باستخدام حزمة الويب ولكل منها إعداد البناء الخاص بها - باستثناء امتدادات الألعاب البسيطة التي هي بالفعل ملفات js فردية، يتم نسخها ببساطة.
لا تزال قاعدة التعليمات البرمجية هذه تستخدم الغزل 1 (الكلاسيكي). أي محاولة لاستخدام الغزل 2 أو 3 انتهت بأخطاء لا معنى لها (تبعيات مفقودة مدرجة بوضوح، عمليات تثبيت متتالية تؤدي إلى فقدان الحزم) مع عدم وجود طريقة معقولة للتحقق من السبب. npm و pnpm بطيئان جدًا بالمقارنة. نحن لا نستخدم حقًا أي ميزات خاصة بالغزل (مساحات العمل؟) لذا لا ينبغي أن يكون التبديل صعبًا للغاية ولكن في الوقت الحالي يعمل الغزل "الكلاسيكي".
في وقت كتابة هذا التقرير، لا يدعم الإلكترون وحدات ES، لذلك يتم نقل كل شيء إلى commonjs. ويؤدي هذا إلى عدم إمكانية استخدام بعض المكتبات المحدثة التي تدعم esm فقط (مثل الإصدارات الجديدة من d3). وهذا يعني أيضًا أن الواردات غير المتزامنة ( const foo = await import('bar') ) هي في الواقع متزامنة في وقت التشغيل. لا يهم حقًا نظرًا لأنه يتم دمج كل شيء في ملف واحد عند إنشاء الإصدار على أي حال وليس هناك حاجة حقًا إلى تقسيم التعليمات البرمجية.
يرجى الإبلاغ عن المشكلات على GitHub وتضمين المعلومات التالية على الأقل:
الإصدار الدقيق من Vortex الذي تستخدمه
نظام التشغيل الخاص بك
ماذا كنت تفعل عندما حدث الخطأ
ما هو الخطأ بالضبط (التعطل؟ رسائل الخطأ؟ السلوك غير المتوقع؟)
إذا تلقيت أي رسالة خطأ، قم بتضمين رسالة الخطأ الكاملة والدقيقة. لا تقم بإعادة الصياغة، ولا تترك المعلومات التي تبدو غامضة أو غير مهمة بالنسبة لك
ملف السجل (انظر أدناه)
من الناحية المثالية أيضًا حالة التطبيق (انظر أدناه)
يتم تخزين كافة البيانات التي ينشئها العميل (بما في ذلك الإعدادات والسجلات) في:
| نوع البناء | موقع | المسار المشترك |
|---|---|---|
| يطلق | %AppData%Vortex | C:Users |
| ديف | %AppData%vortex_devel | C:Users |
إذا كنت بحاجة إلى الإبلاغ عن خطأ ما، فقد تكون المسارات التالية داخل هذا الدليل مفيدة بالإضافة إلى رسالة الخطأ المعروضة على الشاشة:
vortex.log (يتم تدوير السجلات بحجم معين، وهذا هو الأحدث)
state باستثناء global_account (الذي يحتوي على مفاتيح وكلمات مرور ومعلومات حساسة للغاية)
TODO: الخطوات اليدوية مع التبعيات والإصدارات
قم بتنزيل Vortex من Nexus Mods
GitHub للحصول على كود المصدر والمشكلات وطلبات السحب.
Vortex Forum أو Discord للحصول على الدعم والمناقشات مع المجتمع والفريق.
Vortex Wiki لقاعدة المعرفة والمقالات واستكشاف الأخطاء وإصلاحها
هيكل المشروع للحصول على نظرة عامة حول كيفية تنظيم قاعدة التعليمات البرمجية.
غالبية كود Vortex مفتوح المصدر. نحن ملتزمون بعملية تطوير شفافة ونقدر بشدة أي مساهمات. سواء كنت تساعدنا في إصلاح الأخطاء أو اقتراح ميزات جديدة أو تحسين وثائقنا أو نشر الكلمة - فنحن نود أن تكون جزءًا من مجتمع Vortex.
تقرير الأخطاء: إذا رأيت رسالة خطأ أو واجهت مشكلة أثناء استخدام Amplication، فيرجى إنشاء تقرير بالأخطاء.
طلب ميزة: إذا كانت لديك فكرة أو إذا كانت هناك قدرة مفقودة من شأنها أن تجعل التطوير أسهل وأكثر قوة، فيرجى إرسال طلب ميزة.
ملحق المراجعة: إذا كنت تقوم بإنشاء ملحق لعبة وتحتاج إلى مراجعته، فيرجى إرسال طلب ملحق المراجعة.
هذا المشروع مرخص بموجب ترخيص GPL-3.0.
