HPL

註：截至 2023 年 5 月 21 日

這個專案已經完全取消，不會收到任何新的更新，因為我不再是HOI4 社群的真正成員，而且程式碼庫已經變得一團糟，如果不重寫整個東西就不可能讓事情變得更好（感謝C++） 。該語言是實用的，但速度非常慢，有很大的錯誤，不應該被認真使用。我確實計劃製作一種語法類似於 HPL 的語言，但它不會以 HOI4 為重點，並且後端將完全不同。

原始README.md

現代的鋼鐵雄心 4 模組開發解決方案。

什麼是 HPL？

HOI4 程式語言 (HPL) 是一種特定於領域的解釋器程式語言，專為健全的 HOI4 模組開發而設計。其主要目標是透過將HOI4 的語法重新設計為更用戶友好的語法，並提供新功能以實現更高效、更快的開發，同時為用戶提供足夠的可自訂空間，從而大幅改善當前的HOI4 改裝體驗。

為什麼選擇 HPL？

HOI4 改裝場景面臨的問題之一是熟練克勞塞維茨語言的 HOI4 編碼員的供應不足。原因是，雖然它很容易學習，但對於模組的簡單和複雜部分來說，使用和調試確實很乏味。同樣無濟於事的是，它缺乏一系列簡單的程式語言功能，而這些功能可以大大改善開發人員的體驗。

人們試圖透過創建 CLI 和 GUI 工具來為開發人員做所有事情來改善開發人員體驗，但這些專案往往要么由於多種原因而失敗，要么功能太有限，要么毫無價值。然而，為HOI4 模組創建合適的語言是解決此問題的最佳解決方案之一，因為像HPL 這樣的語言可以為開發人員提供許多選擇，讓他們知道如何解決HOI4 模組相關問題，同時不斷更新。您可以使用 HPL 創建一堆小而有效的腳本，甚至創建整個開發人員環境。

HPL 不僅會專注於實現 HOI4 模組的完整相容性，還會優化 HOI4 模組本身。 HPL 不再需要數十行（甚至更多）簡單事件的程式碼，而是能夠提供相同的結果，但程式碼行數顯著減少，從而在此過程中顯著改善開發體驗。 HPL 甚至可以減少每行需要寫入的字元和單字數量。

範例

一般 - 顯示 HPL 的一般程式設計功能以及您可以用它做什麼。

國家——創建一個國家。

event - 建立簡單 HOI4 事件的範例。

HPL 的功能集

HPL 中大多數功能的快速概述：

• 建立和編輯變數。
• 主要型別（ string 、 int 、 float 、 bool 、 scope ）和泛型型別auto 。
• VSCode 擴展，提供語法突出顯示、自動程式碼填充和其他有用的功能（按此處了解更多資訊）。
• 大量的核心功能可協助 hoi4modding，例如協助將影像轉換為.dds 、調整影像大小、建立/刪除檔案和資料夾等的功能。
• 用於創建 HOI4 mod 的標準庫。
• HOI4 範圍經過完全重新設計，使其更易於開發人員使用（稱為 HOI4 腳本 + 模式 - HSM）。
• 聲明具有返回類型的函數。
• 執行函數並獲取其返回。
• 函數參數亂序。
• if語句。
• Python 的f-string 。
• C 的+用於組合字串。
• 基於C的結構。
• 調試和記錄模式。
• 簡單的數學（ ++ 、 -- 、 += 、 -= 、 = 、 /= 、 %= ）。
• 為您處理所有本地化工作。

HOI4模組實施情形

• descriptor.mod創建。
• 事件建立（已實際完成）。
• 國家創建（有點開始）。
• 對其他語言的適當本地化支援。
• 決策修改。
• 焦點樹改裝。

建置和安裝 HPL

注意：目前 HPL 的主要目標平台是 Windows 10 及更高版本。因此，HPL 的 Unix 版本（尤其是 Linux 版本）可能包含錯誤或不穩定。此外，僅提供和支援適用於 Windows、MacOS 和 Linux 的x86二進位檔案。

安裝要求清單：

• C++20
• Clang（MacOS 上的 Apple Clang）
• 製作

建置步驟：

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

安裝

目前只有 Windows 有安裝程式。

要在 Windows 上安裝 HPL，您只需在 PowerShell 中執行installer.ps1腳本一次，它就會為您設定所有內容

HPL Visual Studio 程式碼擴充

為了讓 HPL 開發更加豐富多彩、有趣和現代，程式設計師 Allyedge 創建了一個用於 HPL 程式設計的 VSC 擴充功能。目前它只有語法螢光筆和一些基本的語言支援功能，但將來它將擁有更多功能，使開發變得更加容易（將其視為 C/C++ VSC 擴展）。

要下載它，您只需在市場中找到“HPL”並下載第一個結果，或訪問此連結。

製作人員

SOIL2（分叉版本）- 用於convertToDds核心功能（HPL 使用 SOIL2 的修改版本來刪除不需要的 OpenGL 要求）。

Allyedge - 用於建立 HPL VSC 擴充。 （順便說一句，這傢伙實際上是畏縮的）