注: 2023 年 5 月 21 日現在

このプロジェクトは完全にキャンセルされ、私はもう実際には HOI4 コミュニティの一員ではなく、コードベースが混乱して全体を書き直さない限り改善することが不可能になったため、新しい更新は受信されません (C++ に感謝) 。この言語は機能しますが、非常に遅く、大きなバグがあるため、真剣に使用するべきではありません。おそらく HPL に似た構文を持つ言語を作成する予定ですが、それは HOI4 に焦点を当てたものではなく、バックエンドは完全に異なります。

オリジナルの README.md

HPLのロゴ
HOI4 改造に対する最新の開発者向けソリューション。

HPLとは何ですか?

HOI4 プログラミング言語 (HPL) は、健全な HOI4 改造開発用に作成されたドメイン固有のインタープリタープログラミング言語です。その主な目標は、HOI4 の構文をよりユーザーフレンドリーな構文に再加工し、より効率的かつ迅速な開発のための新機能を提供することで、現在の HOI4 改造エクスペリエンスを大幅に改善すると同時に、ユーザーに十分なカスタマイズの余地を与えることです。

なぜ HPL なのか?

HOI4 改造シーンが苦しんでいることの 1 つは、クラウゼヴィッツ言語に熟練した HOI4 プログラマーの供給が少ないことです。その理由は、学ぶのは簡単ですが、MOD の単純な部分と複雑な部分の両方を使用したりデバッグしたりするのは非常に面倒だからです。また、開発者のエクスペリエンスを大幅に向上させる単純なプログラミング言語機能が多数欠けていることも役に立ちません。

人々は開発者のためにあらゆることを行う CLI や GUI ツールを作成して開発者エクスペリエンスを向上させようとしましたが、多くの場合、それらのプロジェクトはさまざまな理由で失敗するか、制限が多すぎるか、まったく価値がありません。ただし、HOI4 モッディングに適切な言語を作成することは、この問題に対する最良の解決策の 1 つです。HPL のような言語は、開発者に HOI4 モッディング関連の問題を解決する方法について多くのオプションを提供し、同時に更新され続けるためです。 HPL を使用すると、小さくても効果的なスクリプトを多数作成したり、開発環境全体を作成したりできます。

HPL は、HOI4 MOD との完全な互換性を実現するだけでなく、HOI4 MOD 自体の最適化にも注力します。単純なイベントに数十行のコード (またはそれ以上) を必要とする代わりに、HPL は大幅に少ないコード行で同じ結果を提供できるため、そのプロセスにおける開発エクスペリエンスが大幅に向上します。 HPL を使用すると、1 行に書かなければならない文字数や単語数も削減されます。

例

一般 - HPL の一般的なプログラミング機能と、それを使用して何ができるかを示します。

country - 国家を作成します。

イベント - 単純な HOI4 イベントの作成例。

HPL の機能セット

HPL のほとんどの機能の簡単な概要:

変数を作成および編集します。
主要な型 ( string 、 int 、 float 、 bool 、 scope ) とジェネリック型auto 。
構文の強調表示、自動コード入力、その他の便利な機能を提供する VSCode 拡張機能 (詳細についてはここをクリック)。
画像の.ddsへの変換、画像のサイズ変更、ファイルやフォルダーの作成/削除などを支援する関数など、hoi4modding に役立つコア関数が多数あります。
HOI4 MOD を作成するための標準ライブラリ。
HOI4 スコープは、開発者にとって使いやすいように完全に作り直されました (HOI4 Scripting+ Mode - HSM と呼ばれます)。
戻り値の型を指定して関数を宣言します。
関数を実行し、その戻り値を取得します。
関数パラメータの順序が正しくありません。
ifステートメント。
Python のf-string 。
C の+で文字列を結合します。
C ベースの構造。
デバッグモードとロギングモード。
単純な計算 ( ++ 、 -- 、 += 、 -= 、 = 、 /= 、 %= )。
すべてのローカリゼーションを処理します。

HOI4 MOD導入状況

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スクリプトを 1 回実行するだけで、すべてがセットアップされます。

HPL Visual Studio コード拡張機能

HPL での開発をよりカラフルで楽しく、モダンにするために、プログラマー Allyedge は HPL でプログラミングするための VSC 拡張機能を作成しました。今のところ、構文ハイライトといくつかの基本的な言語サポート機能しかありませんが、将来的には、開発をさらに容易にするためにさらに多くの機能が追加される予定です (C/C++ VSC 拡張機能のようなものだと考えてください)。

ダウンロードするには、マーケットプレイスで「HPL」を検索して最初の結果をダウンロードするか、このリンクにアクセスしてください。