例外が出る原因

例外を詳細を見ていると関数やら変数やらが見つからんって内容なんですが、その見つからんものの名前が「f_256764_」とか可読性が低いものになってたんですよね。

日本語/英語問わず例外名やら状況やらを入れて検索しているとココが見つかりました。

「プレイ用のjarパッケージはメンバ名にマッピングが施されるためそのままでは開発環境に入らないです」と今の僕には意味が分からないことが書いてあって、解決策としてmodのソースを自分のプロジェクトにぶっこめと。

いやー、一部APIとかで他modのソースを含んでるソースは見たことありますが、併用modのソースをまるごと含んでるmodなんて見たことなくて、まぁでもGitに上げる前にそこだけ除外してるとか、そんな感じなのかなとChatGPTくんに補助してもらいながら試したけど、むしろエラー範囲が拡大しただけで全く解決できず。

で、さらに検索を続けるとこんな記事を見つけました。 開発環境にはソレ用のdev版を入れる、と書いてあるんですね。

つまりですね、

• 普通にビルドしたJARファイルは難読化されている
• 開発環境では難読化されていない
• そのまま開発環境に入れると難読化のせいで参照先が見つからない
• 開発環境では難読化前のdev版が必要

ということみたいです。

通常のプレイで使っているのは難読化済みのObfuscated版で、難読化されていないものがDeobfuscated版。 略してdeobf版とかdev版とか呼ぶみたい。

deobf版の入手方法

昔、JARファイルの末尾に「-dev」みたいなのがくっついたmodを見た事あった気がしたんですが、今回チェックした3つのmodでは見つからず。 他のmodでも最近は見たことない気がします。

そこでChatGPTくんに聞いてみると、

• そのmodのソースコードを入手してこい
• ビルド時にdeobfオプションを付けてビルドしろ

とのことでした。

このやり方は嘘ではなかったんですが、とてもとても効率が悪いです。 後で簡単なやり方が出てくるので興味ない人はすっ飛ばしてください。

tasks.register('buildDeobf', Jar) {
  group = 'build'
  archiveClassifier.set('deobf')
  from sourceSets.main.output
  
  finalizedBy 'reobfJar'
}

deobf版の簡単入手

ソースからdeobf版をビルドする方法を学んだわけですが、

たかだか併用modのテストをするだけでこのコストはありえないと思ったんですよ。 こんなにめんどくさくて、ソース公開が前提で、しかもローダ(Forge)が一致したバージョンのソースを入手してこないといけないとか、どう考えてもハードルが高すぎますよ。

と思ってですね、ChatGPTくんをかなり問い詰めたんですけど答えは出てこなくて。

mod開発のきっかけになったProductive Beesのソースを見てたらこんなのを見つけたんですよ。

dependenciesのところにこんな↓コードがあります。

implementation fg.deobf("curse.maven:jei-238222:4712868")
implementation fg.deobf("curse.maven:jade-324717:5072729")
implementation fg.deobf("curse.maven:the-one-probe-245211:4579432")
implementation fg.deobf("curse.maven:emi-580555:5204261")
implementation fg.deobf("curse.maven:curios-309927:4985525")
implementation fg.deobf("curse.maven:corail-woodcutter-331983:4573934")
implementation fg.deobf("curse.maven:create-328085:4626108")

jei、the-one-probe、curios、createと見たことあるmodの名前が挙がってます。 しかも「deobf」とついてて、あたかもdeobf版のバイナリをネットからダウンロードしてきてるような書き方です。

これについて調べていくと

後ろの部分の意味はおそらくmodのIDとバージョンかなと思って、IDはともかくバージョンがmodページで表記のものとは全然違います。 最初はそのmodを使用してる別modのソースからコード取得しようとしてたんですが、

例えば、Productive BeesのCurseforgeのダウンロードページを開いてもらうと、ここは基本的にmodのダウンロードに使うと思うんですが、「Curse Maven Snippet」というのがちょっと下にあるんですね。 ここを右の矢印ボタンで展開すると、こんな↓コードが表示されました。

implementation fg.deobf("curse.maven:productivebees-377897:5566102")

というわけで、別に自分でコンパイルする必要なんかなくて、併用テストしたいmodはbuild.gradleを開いて、dependenciesのところにこんな↓風に追記してやればいいだけみたいです。

dependencies {
  minecraft "net.minecraftforge:forge:${minecraft_version}-${forge_version}"

  implementation fg.deobf("curse.maven:official-divinerpg-363543:5049334")
}

このままだと参照リポジトリがなくてエラーが出るので、repositoriesにこれ↓を追加してください。

repositories {
  maven { url "https://www.cursemaven.com" }
}

このやり方だと非常に楽なので、ぽんぽんmodを追加できるようになりました。 テスト用にJEIとかずっと欲しかった。

この問題で2週間近く頭を悩ませたのに、検索しても文献が見つからず(オレが無能)、ChatGPTくんに聞いても分からず(ChatGPTくんが無能)。 やっぱり簡単な導入方法があったわけです。

最後に

開発環境にmodを入れるやり方をまとめました。

たったこれだけのことでこんなにも苦労するとは思ってもみませんでした。 やり方が分かれば簡単。

注意点として、今回のことは依存mod(ライブラリとか前提modとかいうやつ)を設定するものではありません。 あくまで開発環境で動くmodの導入だけ。

依存modはまた別の設定が必要そうなので、開発シリーズが続くならその時に。