หมายเหตุ: ณ วันที่ 21 พฤษภาคม 2023

โปรเจ็กต์นี้ถูกยกเลิกโดยสิ้นเชิงและจะไม่ได้รับการอัปเดตใหม่ใด ๆ เนื่องจากฉันไม่ได้เป็นส่วนหนึ่งของชุมชน HOI4 อีกต่อไป และโค้ดเบสก็กลายเป็นเรื่องยุ่งเหยิง ทำให้เป็นไปไม่ได้เลยที่จะทำสิ่งต่าง ๆ ให้ดีขึ้นโดยไม่ต้องเขียนใหม่ทั้งหมด (ขอบคุณ C ++) . ภาษาใช้งานได้แต่ช้ามาก มีปัญหาใหญ่ และไม่ควรใช้อย่างจริงจัง ฉันวางแผนที่จะสร้างภาษาที่มีไวยากรณ์คล้ายกับ HPL แต่จะไม่เน้นที่ HOI4 และแบ็กเอนด์จะแตกต่างไปจากเดิมอย่างสิ้นเชิง

README.md ต้นฉบับ

โลโก้เอชพีแอล
โซลูชันนักพัฒนาที่ทันสมัยสำหรับการปรับแต่ง 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 ของ Python
C's + เพื่อรวมสตริง
โครงสร้างแบบ C
โหมดการแก้ปัญหาและการบันทึก
คณิตศาสตร์อย่างง่าย ( ++ , -- , += , -= , = , /= , %= )
จัดการการแปลทั้งหมดให้กับคุณ

สถานะการใช้งานการดัดแปลง HOI4

การสร้าง descriptor.mod
การสร้างกิจกรรม (ทำได้จริง)
การสร้างชาติ (ค่อนข้างเริ่มต้น)
รองรับการแปลอย่างเหมาะสมสำหรับภาษาอื่น
การดัดแปลงการตัดสินใจ
การดัดแปลงต้นไม้โฟกัส

การสร้างและติดตั้ง HPL

หมายเหตุ: ปัจจุบันแพลตฟอร์มเป้าหมายหลักสำหรับ HPL คือ Windows 10 ขึ้นไป ด้วยเหตุนี้ HPL เวอร์ชัน Unix (โดยเฉพาะรุ่น Linux) อาจมีจุดบกพร่องหรือไม่เสถียร นอกจากนี้ จะมีการจัดเตรียมและรองรับเฉพาะไบนารี x86 สำหรับ Windows, MacOS และ Linux เท่านั้น

รายการข้อกำหนดสำหรับการติดตั้ง:

ค++20
เสียงดังกราว (Apple Clang บน MacOS)
ทำ

ขั้นตอนในการสร้าง:

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

การติดตั้ง

ขณะนี้มีเพียง Windows เท่านั้นที่มีตัวติดตั้ง

หากต้องการติดตั้ง HPL บน Windows สิ่งที่คุณต้องทำคือเรียกใช้สคริปต์ installer.ps1 ใน PowerShell หนึ่งครั้ง จากนั้นสคริปต์จะตั้งค่าทุกอย่างให้คุณ

ส่วนขยายรหัส HPL Visual Studio

เพื่อให้การพัฒนาด้วย HPL มีสีสัน สนุกสนาน และทันสมัยมากขึ้น โปรแกรมเมอร์ Allyedge ได้สร้างส่วนขยาย VSC สำหรับการเขียนโปรแกรมใน HPL สำหรับตอนนี้มีเพียงปากกาเน้นข้อความไวยากรณ์และคุณสมบัติสนับสนุนภาษาพื้นฐานบางอย่างเท่านั้น อย่างไรก็ตามในอนาคตจะมีคุณสมบัติเพิ่มเติมมากมายเพื่อทำให้การพัฒนาง่ายยิ่งขึ้น (ลองคิดดูว่ามันเหมือนกับส่วนขยาย C/C++ VSC)

หากต้องการดาวน์โหลด คุณสามารถค้นหา 'HPL' ในตลาดและดาวน์โหลดผลลัพธ์แรก หรือไปที่ลิงก์นี้