【Vita3K】PSVitaエミュ総合スレ その2

Vita3K公式サイト
https://github.com/Vita3K/Vita3K

Vita3K+
https://github.com/nckstwrt/Vita3K-Plus

動作確認リスト（参考程度）
https://vita3k.org/compatibility.html

※前スレ
【Vita3K】PSVitaエミュ総合スレ
https://egg.5ch.io/test/read.cgi/software/1712666219/

動作確認リスト
主にVersion 0.01が公開された2019～2020年頃のWindows版を基準に作られています。
十分な確認作業が行われないまま「Playable」と判定されているケースも多いため、
特にAndroid版で動かす場合は、正常に動作する保証はありません。
あくまで参考程度にしてください。

チート機能追加について（機械翻訳）11/4版

### チート機能：FinalCheat / VitaCheat データベースに対応

PS Vita向けプラグイン [FinalCheat / VitaCheat](https://github.com/r0ah/vitacheat) と互換性のあるチート機能を追加します。
これらのプラグインが読み込む `*.psv` ファイルは、そのまま使用できます。GitHubリポジトリで公開されているコミュニティ製データベースにも対応しています。
ファイルを指定のフォルダに配置するだけで、チートが表示されます。

### チートの使用方法

### 1\. チートファイルを cheats フォルダに配置する
ゲームのタイトルIDをファイル名にします。
例：`PCSA00147.psv`
`.txt` 形式にも対応しています。

Vita3Kは起動時にこのフォルダを作成します。また、アプリ一覧でゲームを右クリックし、Open Folder ▸ Cheats を選択するとフォルダを開けます。

| プラットフォーム | 保存先 |
| -------- | ------------------------------------------------------------------------------------- |
| Windows | Vita3K.exe と同じ場所にある cheats（ポータブルモードでは portable/cheats） |
| Linux | ~/.local/share/Vita3K/cheats（$XDG_DATA_HOME が設定されている場合は $XDG_DATA_HOME/Vita3K/cheats） |
| macOS | ~/Library/Application Support/Vita3K/Vita3K/cheats |
| Android | アプリのストレージ内にある cheats（patch フォルダと同じ場所） |

すべてのゲームのチートを1つにまとめたデータベースにも対応しています。
この場合、`cheat.db` というファイル名を使用し、各ゲームのタイトルIDを `_S <title id>` というセクションで区切ります。
なお、タイトルIDをファイル名にした個別のチートファイルが存在する場合は、そちらが優先されます。

### 2\. チートを有効にする

ゲームの実行中に Manage ▸ Cheats を開くか、アプリ一覧でゲームを右クリックして Manage Cheats を選択します。

- チートにチェックを入れると有効になります。実行中のゲームでは、次の VBlank（垂直帰線期間）から適用されます。ゲームが起動していない場合は、Save を押すことで次回起動時に有効になります。
- チートを選択すると、コードの内容が表示されます。有効化する前に、どのような処理が実行されるか確認できます。Vita3Kが解釈できないコードは、その旨が表示され、適用されません。
- Save を押すと、有効・無効の状態がチートファイルに `_V1` / `_V0` というマーカーとして保存されます。コメントやファイルの書式は変更されず、この数字だけが書き換えられます。`_V1` が付いたチートはゲーム起動時に自動的に有効になります。
- Open Cheat File でチートファイルを既定のテキストエディタで開き、Reload で再読み込みできます。ゲームを起動したままチートを修正することも可能です。
- Enable cheats はチート機能全体のマスタースイッチです（`config.yml` 内の `enable-cheats` で設定）。デフォルトでは有効です。これを無効にすると、すべてのチートが停止し、`$A` コードによって置き換えられたゲームコードも元に戻ります。

Android版について：

現時点ではチート管理画面は実装されていません。ただし、チートファイル内で `_V1` が設定されているチートは、ゲーム起動時に適用されます。

### 未対応の機能

- `$C2` のパッドタイプ指定フィールドには対応していません。Vita3Kが公開するパッドは1つだけだからです。
- `$B2` のモジュール番号については、`00` 以外に対応していません。
VitaCheatがメイン実行ファイル以外のモジュールにどのような番号を割り当てているのか、仕様が文書化されていないためです。誤ったモジュールにパッチを適用する可能性があるため、該当するチートには警告が表示されます。

### 内部的な仕組み

- 新しい `cheat` ライブラリにパーサーとインタープリターを実装しました。GUIへの依存はありません。
- チートコードは、実機のプラグインと同様に、ディスプレイの VBlank スレッド上で毎回実行されます。GUIスレッドからチートの有効・無効を切り替える際の競合を防ぐため、Mutex（排他制御）を使用しています。


補足：Android版 Vita3K+ で使用する場合

今回の変更で特に重要なのは、Android版ではチート管理画面がまだ実装されていないという点です。

そのため、現状では以下の手順になります。

- Androidの `cheats` フォルダにチートファイルを配置する。
- ファイル名をゲームのタイトルIDに合わせる（例：`PCSG01128.psv`）。
- 有効にしたいチートに `_V1` を設定する。
- ゲームを起動する。

つまり、Android版ではチートファイルを直接編集して利用する方式になります。