HS2 Animation eXtension v2.1

申し訳ありませんが、私は日本語を一切話すことができません。ただ、以前からこちらのサイトのMODを数多く楽しませていただいておりましたので、今回、自作のMODをこちらにも投稿させていただきたいと思い、クロス投稿いたしました。

元々は Illusion Discord に投稿されたものです：https://discord.com/channels/446784086539763712/1483577760554291251/1483577760554291251

このModの本来の機能に関する説明については、こちらの元の説明をご参照ください。

従来の機能に加え、本ModはHS2内の**すべて**のアニメーションをゲーム全体で自由に利用可能にする機能を追加しました。これにより、椅子の上でソファ用のアニメーションを再生したり、浴槽の外で入浴用のアニメーションを再生したりといったことが可能になります。HS2の**すべて**のアニメーションは、「依存（執着）」パラメータが最大値に達している女の子であれば、**大半**のマップ上で実行できるようになっているはずです。

さらに、本Modは Mr. C 氏が RoomGirl（RG）のアニメーション移植に関して進めていた作業をさらに発展させたものとなっています。4P（4人プレイ）用を除くRGの**すべて**のアニメーションが移植され、それらすべてに対して代替モーション（Alt）が作成されました。また、音声同期の問題も全体的に修正されています（修正を適用するための追加手順については、以下の注記をご参照ください）。Mr. C 氏の例に倣い、私が移植したアニメーションも Studio モードのリストに追加しました。これらは、彼が作成した既存のリストの一番下に配置されています。

今回追加された新しいファイル群は、Mr. C 氏による最新のファイルセットと同じ場所に配置してください。本Modの機能の大部分は、彼のファイルがなくても動作するはずですが、私が行った動作確認テストはすべて、彼の最新の有料版リリースを導入した環境下で行われました。そもそも「RGのアニメーションをHS2に移植できる」という手法を確立したのは Mr. C 氏ですので、ぜひ彼に[いくらかの支援金（チップ）を贈ってあげてください](https://www.patreon.com/c/MrCsModsAndGames/home)。5ドルのティアに登録して有料版の .zip ファイルをダウンロードし、その後すぐに登録を解除（退会）するだけでも構いません。それくらいの対価を受け取る価値は、彼にあると私は考えています。どうしても無理な場合は、最新の無料版（Ver.1.54.1）をご利用ください。その場合、以下の3つのアニメーションのみが欠落することになります。「椅子での自慰」「立ち自慰」「机の角での自慰」です。

こちらからダウンロード

新規インストール

zipファイルを解凍し、HS2のルートディレクトリ（ゲーム本体のフォルダ）にコピー＆ペーストするだけで完了です。既存のファイルの上書きは発生しないため、事前のバックアップは不要です。
-# ただし、新しい「HS2_BetterPenetration.dll」に関しては例外です。このファイルはzipファイルのルート階層に配置してあります。使用を強く推奨するファイルですが、もし導入する場合は、既存の同名ファイルを上書きすることになります。万が一不具合が生じた際に元の状態に戻せるよう、上書きする前に**必ず既存の.dllファイルのバックアップを作成してください**。このファイルは「\BepInEx\plugins」フォルダ内に配置する必要があります。

アップグレード（更新）

本MODのバージョン2.0より前のバージョンをすでに導入している場合は、追加の手順が必要です。以下の「Upgrading（アップグレード）」の項目を参照してください。

アンインストール

本MODによって追加されたファイルをすべて削除するだけで完了です。既存のファイルの上書きは発生していないため、事前のバックアップは不要です。
-# こちらも同様に、もし「HS2_BetterPenetration.dll」を導入していた場合は、そのファイルも忘れずに削除してください。

既知の不具合

•  手のサブアニメーション（指などの細かい動き）に関する不具合が依然として残っています。原因は単純なもので、IDを変更しただけでアニメーションが壊れてしまう（他の変更は一切加えていないにもかかわらず）という現象が起きています。おそらく、アニメーションを構成する参照チェーンのどこかで、参照先を修正する必要があるのだと思われます。この問題は複数のアニメーションに影響しており、目立つものもあれば、ほとんど気にならないものもあります。原因を特定し修正できれば、基本的にはすべてのアニメーションが一括で修復されるはずです。
• 以下の4つのアニメーションには音声（SE）が実装されていません：”[MrC][RG] Sofa Kiss Cwgrl.”、”[MrC][RG] Anal Sofa Kiss Cwgrl.”、”[MrC][RG] Table Miss. 4″、”[MrC][RG] Anal Table Miss. 4″。これは、既存のアニメーションの中に「挿入（ペネトレーション）」と「キス」の要素を**両方とも**兼ね備えたアニメーションが存在しないためです。修正リストには加えており、いずれ解決したいと考えていますが、既存の素材を組み合わせて新たに作り直す作業が必要になる見込みです。
• アニメーション一覧の表示順序が乱雑になってしまっています。これは、私の作成したMOD用ファイルをIllusion社製のゲーム本体ファイルから完全に分離したことによるトレードオフ（副作用）です。現在、解決策を検討・開発中です。

注意事項

1. 以前のバージョンと同様、本MODを快適に利用するには、**ユーザーご自身**が「BetterHScenes」を使用して微調整（IK調整など）を行うことが強く推奨されます。ゲーム内で「N」キーを押すことで「BetterHScenes」のメニューを呼び出すことができます。ゲーム本体に標準搭載されているIK調整機能でも同様の調整は可能だと思われますが、現時点ではそちらへの対応（サポート）は行っていません。
2. このModには、更新された “HS2_BetterPenetration.dll” ファイルが含まれています。これにより、一部の新しいアニメーションで使用される（また、今後追加される多くのアニメーションでも使用される予定の）**アナル・フィンガリングおよび自慰行為用のコライダー**が導入されます。このファイルの使用は必須ではありませんが、**すべて**のアニメーションにコライダーを適用するためには必要となります（Mr. C氏のアニメーションの一部でもこれが必要です）。更新を行わない場合、一部のアニメーションにはコライダーが適用されませんのでご注意ください。このファイルはzipアーカイブのルートディレクトリに同梱していますが、実際には “\BepInEx\plugins” フォルダ内に配置する必要があります。
3. “HS2_BetterHScenes.dll” の更新版についても、引き続きリリースを予定しています。この更新では、XMLの動作仕様を変更し、アニメーションIDに基づいて処理を行う方式へと移行します。更新版をリリースする際には、既存の.xmlファイルを新しいフォーマットに変換・適応させるためのツール（またはそれに準ずる解決策）も併せて提供する予定です。これにより、それまでにご自身で積み重ねてこられた作業内容（設定等）は、**原則として**そのまま引き継ぐことができるようになります。
4. ポジション名（体位名）については手動で設定を行っているため、それらの名称を正しく英語で表示させるには、ご自身の環境において翻訳ファイルが「展開（Unpack）」された状態になっていることを確認してください。 「BepInEx\Translation\en\RedirectedResources」フォルダ内に、「assets.zip」というファイル、あるいは「assets」という名前のフォルダが存在するかどうかを確認してください。もし前者（assets.zip）がある場合は、そのファイルを解凍（展開）してください。ゲームの読み込み時にいずれにせよその.zipファイルは自動的に解凍されるため、翻訳ファイルを個別のファイル（loose files）として配置しておくことが可能です。こうすることで、私の提供する翻訳データが正しく適用されるようになります。

アップグレードについて

バージョン2.0より、本MODの内部構造（アーキテクチャ）が全面的に再構築されました。つきましては、バージョン2.0以前の本MODによって導入されたすべてのファイルを削除し、インストール環境を「初期状態（ファクトリー状態）」に戻す作業をお願いいたします。具体的には、v1.1で導入されたファイル群を確認し、それらをすべて削除してください。お手数をおかけして大変申し訳ございませんが、新しい方式ではすべての変更点がゲームのコアファイルから分離されており、今後の開発に向けたより強固な基盤が構築されています。この手法を提示してくださった Mr. C 氏に感謝いたします。

また、ポジション名（体位名）のローカライズ方法についても変更が必要となりました。以前の手法では、「BetterHScenes」の.xmlオフセットファイル内で指定された英語の翻訳データが正しく適用されないという不具合が発生していたためです。これはリリース後に判明した問題であり、ユーザーの皆様が独自に作成されたオフセット設定の「鍵（キー）」となる重要な値であるため、安易に変更することはできないと判断しました。そこで、本MODの.zipファイル内に同梱されている「Upgrading」フォルダの中に、「hs2ax_positionReplacer.ps1」というPowerShellスクリプトを用意いたしました。このスクリプトファイルを、ご自身の.xmlオフセットファイルと同じフォルダ内に配置し、実行してください（スクリプトの実行方法については、同梱の画像ファイル「hs2ax_positionReplacer_howToRun.png」をご参照ください）。スクリプトを実行すると、ファイル内に残存している日本語のアニメーション名（英語環境でプレイされている場合、これらは旧バージョンのMODによって追加されたアニメーションにのみ残っているはずです）を自動的に検出し、v2.0で採用された現在の英語表記へと一括変換します。この作業はv2.0のインストール完了後に行ってください。そうすることで、すでに作成済みのオフセット設定がすべて正しく引き継がれるようになります。なお、スクリプト実行時には元のファイルのバックアップが自動的に作成されますので、設定データが消失する心配はありません。また、この作業が必要となるのは今回限りとなる見込みです。

機能

• マップ、場所、実績、イベントなどに紐づいていた特定のアニメーションを解除し、すべてのマップで広く利用可能にしました。これには以下の内容が含まれます：
  • 特定のアニメーションをアンロックするためのゲームプレイ上の要件（ただし「状態」に関する要件は除く）を撤廃しました（例：教会でのみアンロック可能だった「クンニ＆手コキ」など）。
  • 特定のマップ上の場所に関する要件を撤廃しました（例：ソファ用のアニメーションを椅子でも利用可能に、プール用のアニメーションをカウンターでも利用可能に、など）。
  • 特定の環境下でのみ存在していたアニメーションの複製を作成しました（例：「風呂場での自慰」アニメーションを通常環境でも利用可能に。元の「風呂場マップ」での挙動に影響を与えず個別に調整できるよう、新しい名称やIDを割り当てています）。
  • 新たに対応した場所において、アニメーションの表示位置を最適化するための微調整を行いました（調整が適用されるのは新しい場所のみで、元々のアニメーションが存在していた場所の表示位置には影響しません）。
• Mr. C氏による最新のファイル群に加え、4P（4人プレイ）以外のすべてのRG（リアルガール）アニメーションを網羅し、さらに新規のバリエーション（Alt）も追加しました。
  • また、Mr. C氏の最近のリリースで発生していた音声バグを修正しました。この音声問題を完全に解消するには、Mr. C氏のModに含まれる以下の2つのファイルを削除する必要があります（すべてのRGアニメーションの音声処理を、本Modの音声ファイル側で一括して担うようになったためです）：
    • “\abdata\list\h\sound\breath\100.unity3d”
    • “\abdata\list\h\sound\voice\100.unity3d”
• 多くの「膣愛撫」系アニメーションに対し、新たに「アナル（肛門）」版のバリエーションを追加しました。これらは指やバイブレーターの当たり判定（コライダー）が正常に機能するよう調整されています。
  • 中には「キス＆アナル自慰」という、アナルでの自慰行為を再現したアニメーションも1種類含まれています。

バグ修正

• クライマックス直前の最終段階において、本来とは異なる音声セリフが誤って再生されてしまうバグを修正しました。影響を受けていたアニメーションは以下の通りです：
  • すべての「アナル」系アニメーション
• 「サイド・アナル（Side Anal）」のシステム挙動を修正しました。以前はこの体位において、アナル（肛門）への刺激ではなく、膣への刺激に基づいた音声が誤って再生されていました。
  • すべての体位について、同様のエラーがないか再確認を行いました。これで問題ないはずです。
• 一連のアニメーション（主に自慰行為、その他数点）において、Ctrl+N（BetterHScenesのクリップナビゲーター）を起動した際に、クリップ操作用のコントロールが表示されない不具合が見つかりました。
  • この不具合は修正されました。ゲーム内のすべてのアニメーションが、ナビゲーターを使用して操作可能になっているはずです。
• 標準搭載されているアニメーションのうち数点が「HS2_BetterPenetration.dll」に含まれておらず、その結果、コリジョン（当たり判定）が設定されていない状態でした。
  • これらもすべて修正されました。
• 水面に浮く体位のアニ​​メーションに、水が揺れる音（水音）の効果音が鳴ってしまう不具合がありました。
  • 標準の効果音を使用するように変更しました。これにより、プールなどの水場以外で使用した際に水音が鳴ることはなくなりますが、逆にプール内で使用した場合も水音は鳴らなくなりますのでご了承ください。
• Studioモード用のアニメーション2点において、参照設定の破損が見つかりました。
  • どちらも修正済みです：『[Mr.C][RG] Table Cowgirl』および『[RG]Counter Miss』。

ロードマップ

• 最優先事項は、上記に挙げた既知の不具合の修正です。
• 「階段」用の体位アニメーションを、椅子でも使用できるように適応させることを検討中です。すべてのマップに階段があるわけではないためです。
• 新しいコリジョン設定を活用した、アナル自慰行為の別パターン（バリエーション）を追加する可能性があります。
• アナル・クンニリングス（アナル舐め）の別パターンを追加する可能性があります。これは主に没入感を高めるためのものです。
• RG（クリエイター）による4P（4人プレイ）用のアニメーションを追加する可能性があります。
• RGによるマップ（背景）を追加する可能性があります（これについてはまだテストすら開始していません）。
• 残りのアニメーション全体を見直し、他に別パターン（バリエーション）として追加する価値のあるものがないか検討します。
• 「睡眠」イベント中にどの体位アニメーションを表示させるべきか、選定の見直しを行います。Mr. C氏のオリジナル版には、睡眠中という状況設定にそぐわないアニメーションが多数含まれていました。これらは一度削除しましたが、その結果として「では、具体的にどの体位アニメーションを残すべきなのか？」という再選定の必要性が生じました。
• 私は普段、ゲーム内の「弱点（Weakness）」機能を無効にしてプレイしています。そのため、この機能が有効な状態でのみアクセス可能な、既存アニメーションの微調整版（バリエーション）をすべて見逃してしまっている状態です。個人的には、そうした特殊なバリエーションのアニメーションも、通常プレイ時（弱点機能が無効な状態）に普通に選択・使用できるようにしてほしいと考えています。
• 主人公（プレイヤーキャラ）が撮影を行っている構図の体位アニメーションを、もっと増やすべきでしょうか？ 犬用首輪と鎖を使用した体位アニメーションを増やすべきでしょうか？ 女の子が目隠しをされている体位アニメーションのサブセット（一連のシリーズ）を追加すべきでしょうか？ RG氏の作品に見られるような、「女の子が会話せず、電話を耳に当てている」というシチュエーションの体位アニメーションを、もっと増やすべきでしょうか？どれも実現可能なことですが、アニメーションリストのデータがさらに肥大化してしまうかもしれません。
• 「HS2_BetterHScenes.dll」を書き直し、オフセットの保存構造を完全に再構築します。具体的には、アニメーションIDを主要なキーとして扱い、ファイル内には人間が読み取れる形式の値も併記しつつ、キャラクターグループはアニメーションに紐づく副次的な要素として位置づけることを目指します。また、同一名のキャラクターが2体存在する場合に、3P（3人プレイ）用のアニメーションで不具合が生じるバグの修正も行います。
• 最近リリースされた「HS2-Progression」Modの基盤技術を活用し、アニメーションリストを完全に再編成します。これにより、少なくとも視覚的にはある程度の秩序をもってグループ化できるようになるはずです。すべてのアニメーション関連作業が完了する頃には、現在のリストはあまりに無秩序になりすぎて、実質的に使い物にならなくなっているだろうと予想しています。「HS2-Progression」は本質的にアニメーションリストに対して後処理（ポストプロセス）を施す仕組みであるため、現在は「アニメーションのエントリが読み込まれた順序」に依存しているリストを、何らかの理にかなった順序で再出力できる可能性があります。理想を言えば、完全に新規のリストを作成したいところですが、そのためにはさらに踏み込んだ深い解析作業が必要となるでしょう。
• 他のIllusion製ゲーム（PH、HS1、KKなど）からアニメーションを移植する方法を模索します。実現の可能性は定かではありませんが、もし可能であれば非常に有用な機能となるはずです。

謝辞

Mr. C — 今どこにいらっしゃるかは存じませんが、進むべき道を示してくださったことに感謝します。
Enimaroah — このModの作業のほぼすべてを「SB3UGS」を通じて行ったため、深く感謝いたします。
2155X — 「BetterHScenese」の提供に感謝します。これなくしては、このModが存在する意義はほとんど失われていたでしょうし、私自身もおそらく、すべての作業を「Studio」上で行うことになっていたはずです。
Animal — 「BetterPenetration」という、極めて整理され、かつ熟考されたModを作成してくださったことに感謝します（また、他者が改変を行えるようソースコードを公開してくださったことにも）。その完成度の高さのおかげで、今回の機能拡張も容易に行うことができました。