tl;dr
Language support for Java ™ for Visual Studio Code の Gradle が使用するJDKは JAVA_HOME で指定できないので、指定したい場合は直接 java.import.gradle.java.home で指定すること！
流れ
- 自作のModである offers-hud を Minecraft 1.20.6 に対応させたかった
- 方法を調べた
- fabric-loomを1.6に更新
- Gradleを8.6に更新
- JDKを21に更新
- JDK 21 インストール
- 環境変数
JAVA_HOME設定 - コード上の変更
- 各依存(Minecraft, fabric-api, fabric-loader)のバージョンを 1.20.6 向けに更新
- ここで動かなくなった！！！！！
症状
少なくとも、どちらも1.20.4までは見たことがなかった
各Javaのソースコードの真上に以下のエラーが発生していた
Source.java is a non-project file, only syntax errors are reported
- 読んだ通り、本当にシンタックスのチェックしか行ってくれない
- Minecraftなどの巨大なゲームのModdingをする時、各種補完の力によってコーディングを進めていく他ない場面は多々あるため、これは本当に困る
また、Run and Debug で Minecraft Client を起動しようとした時に以下のようなエラーが発生さた
ConfigError: The project 'project-name' is not a valid java project.
- validなプロジェクトではない……？
状況の確認
- ターミナルで直接実行する
./gradlew buildは問題なく実行可能 SourceSetは正しく指定されていることが確認できた*2- ここが正しく指定されていなければ各javaファイルはプロジェクトのものだと認識されない
- つまり、VSCodeだけがプロジェクトを正しく読み込めていないっぽい
原因(推測込み)
- Minecraft の 1.20.6 から要求されるJavaランタイムが21になった
- Gradleのプラグインのfabric-loomがMinecraftの各classファイルをデコンパイルする段階で、使用しているJDKがclassファイルのmajor versionに対応しておらず終了した(推測)
- が、なんとこれを利用者に伝えてくれないっぽい
- 少なくともログを見てもエラーは出力されていなかった
どうすればよいか
.vscode/settings.jsonに次のようなエントリーを追加する
"java.import.gradle.java.home": "C:\\Program Files\\Java\\jdk-21",
- を見るに、Gradleのデーモンが使用するJDKは別途指定する必要がありそうだった
なぜこれまでは発生していなかったのか
- これまでのMinecraftのバージョンで期待されていたJavaのバージョンは17以下だった
- https://github.com/redhat-developer/vscode-java/wiki/JDK-Requirements 曰く、何も指定していない場合は JDK 17 でGradleのデーモンを動かすらしい
- classファイルのメジャーバージョン的には妥当なので問題なく動く
結果
動く
余談
- 今回のMinecraftのアップデート、パッチバージョンのアップデートにしては巨大すぎてヤバい
- 主に以下の2つ？
- コンポーネントの概念をメインに使い始めるようになる
- NBTの扱いがこれまでと変わるからそういうことやってる部分全部変えないといけなさそう
- パケットのやり取りのより画一的な対応
- とか
- コンポーネントの概念をメインに使い始めるようになる
- 主に以下の2つ？
- Modderのみんな、がんばれ
*1:JSのパッケージマネージャーと同名だが、両者に関係はない
*2:https://chat.openai.com/share/1c6ef71a-a287-40b8-a5b1-42fec87f7be7
