ملاحظة: اعتبارًا من 21 مايو 2023

تم إلغاء هذا المشروع بالكامل ولن يتلقى أي تحديثات جديدة لأنني لم أعد جزءًا من مجتمع HOI4 بعد الآن وتحولت قاعدة التعليمات البرمجية إلى حالة من الفوضى، مما يجعل من المستحيل تحسين الأمور دون إعادة كتابة الأمر بأكمله (شكرًا لـ C++) . اللغة وظيفية ولكنها بطيئة للغاية، وعربة كبيرة، ولا ينبغي استخدامها على محمل الجد. أخطط لإنشاء لغة ذات بناء جملة مشابه لـ HPL ولكنها لن تركز على HOI4، وستكون الواجهة الخلفية مختلفة تمامًا.

README.md الأصلي

شعار HPL
الحل الحديث المطور لتعديل HOI4.

ما هو HPL؟

لغة البرمجة HOI4 (HPL) هي لغة برمجة مترجمة خاصة بالمجال تم تصميمها لتطوير تعديل HOI4 العاقل. هدفها الرئيسي هو تحسين تجربة تعديل HOI4 الحالية بشكل كبير من خلال إعادة صياغة بنية HOI4 لتكون أكثر سهولة في الاستخدام وتوفير ميزات جديدة لتطوير أكثر كفاءة وأسرع، كل ذلك مع منح المستخدم مساحة كبيرة للتخصيص.

لماذا HPL؟

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

لقد حاول الأشخاص تحسين تجربة المطورين من خلال إنشاء أدوات CLI وGUI للقيام بكل شيء للمطورين، ولكن في أغلب الأحيان تفشل هذه المشاريع لأسباب عديدة، أو تكون محدودة للغاية أو لا قيمة لها. ومع ذلك، يعد إنشاء لغة مناسبة لتعديل HOI4 أحد أفضل الحلول لهذه المشكلة، حيث يمكن للغة مثل HPL أن توفر الكثير من الخيارات للمطورين مع الطريقة التي يريدون بها حل المشكلات المتعلقة بتعديل HOI4 مع تحديثها باستمرار. يمكنك استخدام HPL لإنشاء مجموعة من البرامج النصية الصغيرة والفعالة، أو حتى إنشاء بيئات تطوير كاملة.

لن تركز HPL فقط على تحقيق التوافق الكامل مع تعديل HOI4، ولكن أيضًا لتحسين تعديل HOI4 نفسه. بدلاً من الحاجة إلى عشرات الأسطر من التعليمات البرمجية لحدث بسيط (أو حتى أكثر)، ستتمكن HPL من تقديم نفس النتيجة ولكن مع سطور أقل بشكل كبير من التعليمات البرمجية، مما يؤدي إلى تحسين تجربة التطوير بشكل كبير في هذه العملية. يعمل HPL أيضًا على تقليل عدد الأحرف والكلمات التي يتعين عليك كتابتها في كل سطر باستخدام هذا.

أمثلة

عام - يعرض ميزات البرمجة العامة لـ HPL وما يمكنك فعله به.

البلد - يخلق أمة.

الحدث - مثال على إنشاء أحداث HOI4 بسيطة.

مجموعة ميزات HPL

نظرة سريعة على معظم الميزات في HPL:

إنشاء وتحرير المتغيرات.
الأنواع الرئيسية ( string ، int ، float ، bool ، scope ) والنوع العام auto .
ملحق VSCode الذي يوفر تسليط الضوء على بناء الجملة، وملء التعليمات البرمجية التلقائية وغيرها من الميزات المفيدة (انقر هنا لمزيد من المعلومات).
الكثير من الوظائف الأساسية للمساعدة في hoi4modding، مثل الوظائف التي تساعد في تحويل الصور إلى .dds وتغيير حجم الصور وإنشاء/إزالة الملفات والمجلدات وما إلى ذلك.
المكتبات القياسية لإنشاء تعديلات HOI4.
تمت إعادة صياغة نطاقات HOI4 بالكامل لتسهيل استخدامها للمطورين (يُطلق عليها اسم HOI4 Scripting+ Mode - HSM).
قم بتعريف الوظائف مع أنواع الإرجاع.
تنفيذ المهام والحصول على عوائدها.
معلمات الوظيفة خارج الترتيب.
if تصريحات.
f-string .
C + للجمع بين السلاسل.
الهياكل القائمة على C.
أوضاع التصحيح والتسجيل.
عملية حسابية بسيطة ( ++ , -- , += , -= , = , /= , %= ).
يتعامل مع كافة التعريب بالنسبة لك.

حالة تنفيذ تعديل HOI4

إنشاء descriptor.mod .
إنشاء الحدث (تم عمليا).
خلق الأمة (بدأ إلى حد ما).
دعم الترجمة المناسب للغات الأخرى.
تعديل القرار.
تعديل شجرة التركيز.

بناء وتركيب HPL

ملحوظة: النظام الأساسي المستهدف الرئيسي لـ HPL حاليًا هو Windows 10 والإصدارات الأحدث. ونتيجة لذلك، قد تحتوي إصدارات Unix من HPL (خاصة إصدارات Linux) على أخطاء أو تكون غير مستقرة. أيضًا، سيتم توفير ودعم ثنائيات x86 فقط لأنظمة التشغيل Windows وMacOS وLinux.

قائمة متطلبات التثبيت:

سي++20
Clang (أبل Clang على نظام MacOS)
يصنع

خطوات البناء:

git clone https://github.com/EimaMei/HPL/tree/canary.git
cd HPL
make

تثبيت

في الوقت الحالي، يحتوي Windows فقط على برنامج تثبيت.

لتثبيت HPL على نظام التشغيل Windows، كل ما عليك فعله هو تشغيل البرنامج النصي installer.ps1 في PowerShell مرة واحدة وسيقوم بإعداد كل شيء لك

ملحق HPL Visual Studio Code

لجعل التطوير باستخدام HPL أكثر تنوعًا ومتعة وحداثة، أنشأ المبرمج Allyedge امتداد VSC للبرمجة في HPL. في الوقت الحالي، يحتوي فقط على أداة تمييز بناء الجملة وبعض ميزات دعم اللغة الأساسية، ولكن في المستقبل سيكون لديه المزيد من الميزات لجعل التطوير أسهل (فكر في الأمر مثل ملحق C/C++ VSC).

لتنزيله، يمكنك فقط البحث عن "HPL" في السوق وتنزيل النتيجة الأولى، أو الانتقال إلى هذا الرابط.