クロスモッド互換性トークン（CMCT）

クロスMod互換性トークンは、特別なカスタムContent Patcherトークンを追加します。これにより、（Mod作者であれば）他のMod（Content Patcher専用ではないModも含む）の設定値、翻訳、動的トークンにアクセスできるようになります。これらのトークンは、前述の値のいずれかに応じて変更を加える必要があるなど、他の方法で自分のModと他のModの完全な互換性を確保できない場合に役立ちます。

インストール

• SMAPIの最新バージョンをインストールする.
• Mod を Stardew Valley/Mods に抽出します。
• SMAPI を使用してゲームを実行します。
  

プレイヤー向け使用法
このMODは単体では何もしません。他のMODで必要とされない場合、ユーザーとしてインストールしてもメリットはありません。

コンテンツパッチャーMod作者向け使用方法
この mod は 4 つのトークンを追加します:

• Spiderbuttons.CMCT/Config
• Spiderbuttons.CMCT/翻訳
• Spiderbuttons.CMCT/ダイナミック
• Spiderbuttons.CMCT/アセット
  

これらのトークンはそれぞれ、設定値、翻訳文字列、動的トークン値、または内部アセットキーを取得できます。これら4つすべて 必要とする 入力引数。最初の入力引数は常に、値を取得しようとしているmodのUniqueIDになります。2番目の入力引数は、対象となるトークンによって異なります。

• Config: 検索する設定値の名前。設定値がネストされている場合は、JSON構造に基づいた完全な設定パスを含める必要があります。
• 翻訳: 必要な翻訳のi18nキー。現在選択されている言語の翻訳が常に取得されます。
• ダイナミック: 動的トークンの名前。
• アセット: 他のMODからのアセットの相対パス 彼らの manifest.json ファイル。
  

これらのトークンのいずれかを使用すると、 しなければならない 他のMODを依存関係として設定します。設定しないと かもしれない うまく動作しますが、奇妙なエラーが発生する可能性もあります。以下に、トークンごとに1つずつ、4つの例を示します。 何でも検索, ハットマウスレイシー、 そして ボタンのエクストラブック デモンストレーション用:

• {{Spiderbuttons.CMCT/Config: Pathoschild.LookupAnything、Controls.ToggleSearch}}
• {{Spiderbuttons.CMCT/翻訳: ichortower.HatMouseLacey, houseDisplayName}}
• {{Spiderbuttons.CMCT/Dynamic: ichortower.HatMouseLacey、レイシー}}
• {{Spiderbuttons.CMCT/アセット: Spiderbuttons.ButtonsExtraBooks、assets/Books/sheet.png}}
  

制限事項
現在、制限事項として考えられるのは主に 2 つあります。

• トークンを入力として受け取る翻訳 (つまり、i18n 自体の中に独自の {{tokens}} を持つ i18n 値) は正しく動作せず、中括弧で囲まれたトークンが残っているリテラル文字列のみが取得されます。
• 動的トークンは、ゲームの起動時ではなく、セーブデータの読み込み時にのみ初期化されます。これは、あなたにとって全く問題にならないかもしれません。
  

ダイナミックトークンを使用する必要があることも言及しておく価値がある。 できるだけ控えめにContent Patcherの仕組みについて技術的な話はさておき、トークンの実装方法により、他のモジュールからチェックしている動的トークンが変更されていなくても、変更を伝播させる必要があるというシグナルが常に送信されます。これは、トークンがデフォルトで行われるようにOnDayStartのみを更新する場合はそれほど問題ではありませんが、OnTimeChangeやOnLocationChangeで更新する場合は、コストが高くなる可能性があります。

ソースコード