콘텐츠로 이동
RTM Wiki Logo RTM Wiki

トラブルシューティング

이 콘텐츠는 아직 번역되지 않았습니다.

このページでは、RealTrainMod (RTM)のアドオン制作の際に陥ることの多いトラブルについて、そのミスの内容と対処法について説明します。

簡易トラブル診断

Section titled “簡易トラブル診断”
Noクラッシュレポートの内容Yes の場合No の場合
1クラッシュする215
2クラッシュレポートが読める次の項目Minecraftがクラッシュする場合
3クラッシュレポートに「FileNotFoundException」って書いてあるJSONのファイルパスの指定が間違ってるかも次の項目
4クラッシュレポートに「MALFORMED」って書いてあるマルチバイト文字を含むファイル名のファイルがあるかも次の項目
5クラッシュレポートに「Can’t load model (ホニャララ.json)」って書いてあるJSONの文法が間違ってるかも次の項目
6クラッシュレポートに「Can’t load model (モデル名)」って書いてあるモデルファイルが間違ってるかも次の項目
7クラッシュレポートに「Can’t find model file」って書いてあるモデルファイルの場所が間違ってるかも次の項目
8クラッシュレポートに「Can’t find model file」って書いてあるモデルファイルの場所が間違ってるかも次の項目
9クラッシュレポートに「On construct ModelSet」って書いてあるJSONの設定が間違ってるかも次の項目
10クラッシュレポートに「Can’t load class」って書いてあるなんか重大な間違いをしてるかも次の項目
11クラッシュレポートに「Can’t load class」って書いてあるなんか重大な間違いをしてるかも次の項目
12クラッシュレポートに「Failed to load script」って書いてあるスクリプトで間違ってるかも次の項目
13クラッシュレポートに「Script exec error」って書いてあるスクリプトで間違ってるかも次の項目
14どれも違うKaizPatchXを使ってないかも不明です コメント欄かWikiのGitHubでIssueを建てて知らせてくれると嬉しいかも
15モデル選択画面に出てくる不明です コメント欄かWikiのGitHubでIssueを建てて知らせてくれると嬉しいかもJSONのファイル名が必要な形式でない

アドオン制作のトラブルの種類

Section titled “アドオン制作のトラブルの種類”

RealTranMod（RTM）のアドオン制作においては、様々な内容のトラブルが発生する可能性があります。
これらのトラブルには、それぞれたくさんの原因と対処法がありますが、Minecraftがクラッシュするかどうかで、大きく2つに大別することができます。

Minecraftがクラッシュする場合

Section titled “Minecraftがクラッシュする場合”

これは、RTMがアドオンの存在を認識しているが、何らかの要素（ディレクトリ構成、ファイル内容など）が誤っているために発生するものです。

主に、JSONでの設定のミスや、ファイル内容が想定される内容と異なっており、その不具合を許容できない場合に発生します。
クラッシュレポートから原因となるミスの内容を読み取ることができるため、比較的簡単に対処することができます。

Minecraftがクラッシュしない場合

Section titled “Minecraftがクラッシュしない場合”

これには、2つの可能性があります。

一つ目は、アドオンの内容が根本的に間違っており、それをアドオンとして認識できていない場合です。
主に、RTMが適切なJSONファイルを発見できなかった場合に発生します。

もう一つは、アドオンとして認識されていてかつ、RTMが問題の存在を認識できていない場合です。
3Dモデルの描画や、テクスチャがおかしいなど、何かしらの表示や動作が意図しない状態である場合が相当します。

トラブルの原因の特定

Section titled “トラブルの原因の特定”

具体的なトラブルの内容と、その原因の特定方法を説明します。

Minecraftがクラッシュする場合

Section titled “Minecraftがクラッシュする場合”

この場合には、クラッシュレポートの内容から比較的容易に原因を推定することができます。

終了コード

Section titled “終了コード”

初心者にありがちな勘違いとして、よく、「終了コード」の数字がクラッシュの内容を表す文字列だと考えている場合があります。

もちろん、この数字にも意味がないわけではありません。
ですが、所詮数桁の数字でしかないことからもわかるように、具体的なミスの内容や原因を特定できる情報ではありません。1

クラッシュレポート

Section titled “クラッシュレポート”

クラッシュの原因の特定には、ほとんどの場合、クラッシュレポートが必要です。

クラッシュレポートは、Minecraftが異常終了（クラッシュ）した際に、その原因を特定するために自動生成されるログファイルです。
クラッシュを引き起こしたエラーが発生した原因や、そこに至るまでの実際のプログラムの実行過程の内容が詳細に記載されています。

この記載内容を確認することで、アドオンの処理のどの部分でどのようなエラーが発生したのかを読み取ることができます。

クラッシュレポートを確認する方法
Section titled “クラッシュレポートを確認する方法”

クラッシュレポートを閲覧し、内容を確認するには、2つの方法があります。

わかりやすい方法は、ランチャーから開く方法です。
クラッシュが発生した際、ランチャーのクラッシュを通知するポップアップの下部にある、「クラッシュレポートを表示」をクリックすることで開くことができます。

また、クラッシュレポートのファイルは、Minecraftの起動構成を設定したディレクトリにある、crash-reportsディレクトリに、以下のような名前のTXT形式（.txt）のテキストファイルとして生成されます。

crash-YYYY-MM-DD_HH.MM.SS.txt

このファイルを適切なアプリケーションで開くことでも、クラッシュレポートの内容を確認することができます。

クラッシュレポートの読み方

Section titled “クラッシュレポートの読み方”

クラッシュレポートを確認することができたら、その内容を読んで原因を探す必要があります。

初心者の場合には、クラッシュレポートのすべてを読む必要はなく、重要な部分のみを読むだけで十分です。
原因の特定に重要な、実際のエラーメッセージなどの内容は、章や段落の最初にある英文の部分に記載されています。

この部分は、Modの開発者がエラーが起きた際に、その内容をわかりやすく伝えるためにプログラムの中に準備した通知です。
RTMに限らず、多くのModやソフトウェアでは、エラーの内容を端的に示す通知があらかじめ準備されています。

この英文を読むことで、大まかにどのような原因なのかを特定することができます。

クラッシュレポートの内容

Section titled “クラッシュレポートの内容”

クラッシュレポートの内容について、実際の例を挙げて説明します。

冒頭
Section titled “冒頭”
crash-YYYY-MM-DD_HH.MM.SS.txt
---- Minecraft Crash Report ----
// Shall we play a game?


Time: 25/07/22 22:18
Description: Loading RTM ModelPack

ここでは、エラーが発生した状況が大まかに記載されています。

  • Time: クラッシュが発生した時間
  • Description: クラッシュが発生した状況

この例では、Loading RTM ModelPackと記載されているので、Minecraftの起動の際、RTMがアドオンを読み込んでいる最中に発生したものだとわかります。

クラッシュが発生する状況

  • Loading RTM ModelPack: Minecraftの起動時にアドオンをロードしている最中
  • Rendering screen: 不明
  • Rendering entity in world: 不明
  • Initializing game: 不明
エラーメッセージ
Section titled “エラーメッセージ”
crash-YYYY-MM-DD_HH.MM.SS.txt
jp.ngt.rtm.modelpack.ModelPackException: On construct ModelSet (exampleTrain)

冒頭の次に続くこのような部分は、Minecraftが検知したクラッシュ原因です。
この部分に、実際のエラーが記載されており、原因の特定において最も重要な部分です。

この例では、On construct ModelSet ([JSONで設定したtrainName])と記載されているため、その車両の内容が原因でエラーが発生した可能性が高いと考えることができます。

ちなみに、ModelSetはRTMで追加される各モデルの設計図のようなものです。
その設計図をもとにファイルを取得、解析して車両データを構築している最中にエラーが発生したということになります。

スタックトレース
Section titled “スタックトレース”
crash-YYYY-MM-DD_HH.MM.SS.txt
  at jp.ngt.rtm.modelpack.ModelPackManager.getNewModelSet(ModelPackManager.java:144)
  at jp.ngt.rtm.modelpack.ModelPackManager.registerModelset(ModelPackManager.java:78)
  at jp.ngt.rtm.modelpack.ModelPackLoadThread.loadModelFromConfig(ModelPackLoadThread.java:172)
  at jp.ngt.rtm.modelpack.ModelPackLoadThread.runThread(ModelPackLoadThread.java:149)
  at jp.ngt.rtm.modelpack.ModelPackLoadThread.run(ModelPackLoadThread.java:99)

プログラムのどの部分で処理が行われ、エラーの発生に至ったかが記録されています。

実際にRTMのプログラムを確認し、スタックトレースと見比べながら処理の流れを追うことで、より詳細に内容を知ることもできます。
ですが、そのような対処が必要な場合は稀なので、多くの場合この部分は無視できます。

連鎖するエラー
Section titled “連鎖するエラー”
crash-YYYY-MM-DD_HH.MM.SS.txt
⠀
Caused by: java.lang.reflect.InvocationTargetException
  at sun.reflect.GeneratedConstructorAccessor70.newInstance(Unknown Source)
  at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
  at java.lang.reflect.Constructor.newInstance(Constructor.java:422)
  at jp.ngt.rtm.modelpack.ModelPackManager.getNewModelSet(ModelPackManager.java:135)
  ... 4 more


Caused by: net.minecraftforge.client.model.ModelFormatException: Can't load model : example.mqo
  at jp.ngt.rtm.modelpack.ModelPackManager.loadModel(ModelPackManager.java:223)
  at jp.ngt.rtm.render.ModelObject.<init>(ModelObject.java:44)
  at jp.ngt.rtm.modelpack.modelset.ModelSetTrainClient.registerBogieModel(ModelSetTrainClient.java:50)
  at jp.ngt.rtm.modelpack.modelset.ModelSetTrainClient.<init>(ModelSetTrainClient.java:38)
  ... 8 more


Caused by: net.minecraftforge.client.model.ModelFormatException: Failed to load model : minecraft:models/example.mqo
  at jp.ngt.ngtlib.renderer.model.ModelLoader.loadModel(ModelLoader.java:57)
  at jp.ngt.ngtlib.renderer.model.ModelLoader.loadModel(ModelLoader.java:24)
  at jp.ngt.rtm.modelpack.ModelPackManager.loadModel(ModelPackManager.java:218)
  ... 11 more


Caused by: java.io.FileNotFoundException: minecraft:models/example.mqo
  at net.minecraft.client.resources.FallbackResourceManager.func_110536_a(SourceFile:51)
  at net.minecraft.client.resources.SimpleReloadableResourceManager.func_110536_a(SimpleReloadableResourceManager.java:67)
  at jp.ngt.ngtlib.io.NGTFileLoader.getInputStream(NGTFileLoader.java:330)
  at jp.ngt.ngtlib.renderer.model.ModelLoader.loadModel(ModelLoader.java:33)
  ... 13 more

このようなさらなるエラーメッセージとスタックトレースが、一つ目のエラーメッセージとスタックトレースに続けて記録される場合があります。

これは、エラーが連鎖していることを示しており、下に記載されるものほどより細かいレベルで発生したエラーを記録しています。

  • この例では、まず、2番目のエラーとしてInvocationTargetException と記載されています。
    これはエラーのラッパーです。
    原因の特定にはあまり重要ではないので無視できます。
  • 次に、3番目のエラーとして、ModelFormatException: Can't load model : [エラーが発生したファイル名]と記載されています。
    これによって、そのファイルの解析でエラーが起きたことがわかります。
  • 4番目のエラーとして、ModelFormatException: Failed to load model : minecraft:models/[エラーが発生したファイル名]と記載されています。
    これによって、そのファイルの取得に失敗したことがわかります。
  • 最後に、5番目のエラーとして、FileNotFoundException: minecraft:models/[エラーが発生したファイル名]と記載されています。
    これによって、そのファイルが存在しなかったことがわかります。

このようにして、クラッシュレポートの内容から、クラッシュした原因を特定することができます。

発生するエラーの一覧

Section titled “発生するエラーの一覧”

これらは、クラッシュレポートに記録されるエラーメッセージの一覧です。

  • jp.ngt.ngtlib.io.NGTFileLoadException: Can't load json : json ([エラーメッセージ])
    JSONの書式が不正な場合に発生
    • JSONの文法間違いなど
  • jp.ngt.rtm.modelpack.ModelPackException: Can't load model [JSONファイルの絶対パス]
    JSONのファイル名が不正な場合に発生
    • 存在しないモデルタイプ名を指定など

Minecraftがクラッシュしない場合

Section titled “Minecraftがクラッシュしない場合”

Minecraftがクラッシュしない場合は、その原因が明らかでない限り、特定が比較的難しくなります。

RTMがアドオンを認識できていない場合

Section titled “RTMがアドオンを認識できていない場合”

以下のような場合に、RTMがアドオンを認識できていない場合があります。

JSONのファイル名が必要な形式でない
Section titled “JSONのファイル名が必要な形式でない”

RTMのアドオンのJSONファイルは、アンダーバー_(U+005F)で区切られたモデル名を含むファイル名である必要があります。
これに準ずる名前でない場合には、アドオンとして認識されません。

正当なJSONファイル名については、ディレクトリ構成とファイル名#モデル設定用JSONファイルを参照してください。

RTMがアドオンを認識できている場合

Section titled “RTMがアドオンを認識できている場合”

非常に多くの可能性が考えられますが、以下に発生する事象の一覧と原因を記載します。

3DCG制作ソフトでのモデルの描画とRTMでのモデルの描画が異なる場合
Section titled “3DCG制作ソフトでのモデルの描画とRTMでのモデルの描画が異なる場合”

RTMは3Dモデルを独自の機構で解析、描画するため、3DCG制作ソフトでの描画結果と、RTMでの描画結果が異なる場合があります。

ポリゴンの形状が異なっている
Section titled “ポリゴンの形状が異なっている”

原因: 多角形ポリゴンを使用している

RTMでは多角形ポリゴンをロードすることが可能ですが、そのままロードするのではなく、三角形に分割されます。
その際に、本来のポリゴンの形状を考慮せず画一的に処理されるため、本来と異なる形状に分割される可能性があります。

ポリゴンが暗くなる
Section titled “ポリゴンが暗くなる”

原因: 凹四角形を使用している

四角形ポリゴンも三角形に分割されるため、多角形ポリゴンと同様の理由で意図しない描画結果になる可能性があります。

スムージングが意図しない結果になる
Section titled “スムージングが意図しない結果になる”

原因: 法線を編集している

3Dモデルデータの法線情報は解析されず、独自に法線を生成します。
そのため、法線の編集が適用された状態の3D制作ソフトでの見た目とは異なる見た目になる可能性があります。

意図せずソフトエッジになる
Section titled “意図せずソフトエッジになる”

原因: スムージンググループ、法線の分割、ハードエッジなどを指定している

これらについての情報は全て解析されず、同じ座標の2頂点からなるエッジを含むポリゴンの間は、常にソフトエッジとして処理されます。
頂点を同じ座標に配置しつつ、ハードエッジを使用したい場合には、適切なスムージング角度を指定するか、オブジェクトを分割する必要があります。

マッピングがずれる・ポリゴンが重なっていないのにZファイティングが発生する
Section titled “マッピングがずれる・ポリゴンが重なっていないのにZファイティングが発生する”

原因: UV座標をピクセルの境目に設定している

3D制作ソフトとRTMでの処理の違いにより、わずかにマッピングに誤差が生じるようです。
ほんの少しUV座標を移動すれば問題ありません。

テクスチャがおかしい
Section titled “テクスチャがおかしい”

原因: テクスチャのパスの指定を間違えている

設定したファイルパスがテクスチャとして認識できる拡張子の存在するファイルであった場合には、クラッシュは発生しません。

また、RTMのバージョンによっては、テクスチャに存在しないファイルパスを指定した場合にもクラッシュが発生しません。
その際には、#ff00ffと#000000の市松模様のテクスチャが適用されます。

その他
Section titled “その他”

トラブルの解決

Section titled “トラブルの解決”

トラブルの原因を特定することができたら、それを解決することができます。

原因の特定がそのまま解決方法に結び付く場合もありますが、そうでない複雑なトラブルの可能性もあります。

補足

Section titled “補足”

この解説では、わかりやすく「エラー」という言葉を用いていますが、これらのほとんどは正確には「例外 Exception」です。
Javaでは、ErrorとExceptionを明確に区別しますが、RTMのアドオン制作のミスによって発生するのはほぼすべてExceptionであり、両者を区別する必要はないため、わかりやすさを優先し全てエラーとしています。

関連サイト

Section titled “関連サイト”

Footnotes

Section titled “Footnotes”

  1. Javaでは、終了コードは0が正常な終了であり、それ以外のステータスは異常終了を表します。
    参考：Java の System.exit() ↩