[1.5] [Sub-MOD] Xml Patch Helper add Japanese Translation

[1.5] [Sub-MOD] Xml Patch Helper add Japanese Translation

This Mod is adding a Japanese translation to the original Mod "Xml Patch Helper.

The original Mod was created by Smash Phil.
This Modmod does not include the core part of the original Mod.
Only Japanese translation files are included.

このツールModを使用すると、XPathベースのPatchOperationsをゲーム内で検証したり生成して保存できるため、PatchOperationのパッチ操作のxmlがどのような構文なのかを表示したり、パッチ操作の結果を正確に確認することができます。

RimWorldの開発Discordチャンネルで他のMod制作者たちを3年近く支援してきた私は、パッチ操作がどのように機能するのか、そしてXPathが具体的に何を選択しているのかを視覚化する実用的なツールを提供する方がModコミュニティによいと考えました。

これはModツールであり、ゲームプレイには直接影響しません。

あなたがもしRimWorldのパッチ操作について少し理解していれば、それほど複雑ではありません。パッチ画面の右側には、選択したパッチタイプが関連付けられたすべての入力フィールドが含まれており、Xpathの入力フィールドに何かを入力すると、その検索結果が左側の一致ウィンドウに表示されて情報が更新されます。

XPath検索を実行:
パッチ画面右側の入力フィールド「<xpath>」に入力したXpathをゲーム内ドキュメントから検索します。ボタンを押す必要性はなく、パスが正しければ結果は即時出ます。

大文字と小文字は別の文字扱いされるので、注意が必要です。詳細は「XML」と「xpath」で検索してみてください。

以下のRimWorld英語wikiにRimWorldで使用されるパッチ操作命令(PatchOperationAdd等)についての説明(英文)があるので一読すると良いでしょう。

RimWorld英語wiki Mod作成チュートリアル/パッチ操作
https://rimworldwiki.com/wiki/Modding_Tutorials/PatchOperations

XPathプロファイル:
作成したパッチが、ゲームに対して実際にパッチ操作を行った場合にかかる計算時間を、「プロファイルのサンプルサイズ」で指定された回数分(最大)までパッチ操作対象にパッチ操作を繰り返してパッチ操作にかかる平均時間を計算します。

ただし、計算時間が2分以上経過して反応が無く長すぎる場合、計算は強制終了します。平均計算時間がサンプルサイズに対して大きすぎる場合、ゲームがフリーズする可能性があります。

XmlDocを再生成:
Modで仮に作成しているゲーム内でのXMLドキュメント(XMLコード)を、パッチ操作を実行した後のドキュメントに置き換えます。

結果をダウンロード:
パッチ操作の一致部分の検索結果(XPathMatches)を「XmlPatchHelper_XPathResult.xml」として、以下のフォルダに出力します。

Windowsの場合:
%USERPROFILE%/Appdata/LocalLow/Ludeon Studios/RimWorld by Ludeon Studios/

Linuxの場合:
~/.config/unity3d/Ludeon Studios/RimWorld by Ludeon Studios/Saves/

macOSの場合:
~/Library/Application Support/RimWorld/

PatchOperation実行:
ゲーム内のXmlドキュメント(Doc)のコピーに対して、仮にパッチ操作を実行した場合、そのパッチ操作の結果がどのようになるかを、パッチ前とパッチ後で比較確認できるようになっています。

パッチを出力:
フィールドに入力した内容を使って、実際に使用可能なパッチXmlを「結果をダウンロード」と同じ場所に「XmlPatchHelper_PatchOperation.xml」として出力します。このファイルの名前を変更して、「Patches」フォルダに入れたModを作成したり、変更したいModフォルダー内に入れる事でパッチ操作を実行できます。

Ｑ：XPathプロファイルとは何のことですか？
ゲーム画面が「XPathをプロファイリング中…」のまま永遠にフリーズしているようです

Ａ：永遠ではありません。
サンプルサイズを指定して、Xpathを選択するのにかかる平均時間を計算しています。
調整可能ですが、計算時間がかかりすぎると（2分以上）自動的に切断されます。

Ｑ：XMLテキストの色が汚い!
Ａ：Mod設定で色を変更できます。

私(Smash Phil)はゲームも作っています！私(Smash Phil)のModを気に入ってくれたら、そちらも気軽にチェックしてみてください。

ゲーム名：Cursed Crew
開発Discordはこちら[discord.com]

Original mod : Xml Patch Helper
Original Mod author : Smash Phil
Steam Workshop Link : https://steamcommunity.com/sharedfiles/filedetails/?id=2810681278
Github Release Link[github.com]