コンテンツにスキップ

ユーザーガイド

ShinkiEMU Releases から、お使いのプラットフォームとアーキテクチャに合った Manager の成果物をダウンロードします。デスクトップ版のパッケージは書き込み可能なディレクトリにすべて展開し、shinki-emu-manager(Windows では .exe)を実行します。同梱の依存ファイル、ライセンス、リソースはそのまま残してください。デスクトップでは shinki-emu-manager --help でヘルプを表示でき、サブコマンドなしで起動すると GUI が開きます。

ダウンロードするのは Release に実際に添付されているファイルだけにしてください。ビルド状況はコア一覧で確認できます。Android の debug 署名付き CI APK はテスト用パッケージです。iOS は実機向けとシミュレーター向けの成果物を区別する必要があり、ライブラリファイルはインストール可能な IPA ではありません。

初回起動時には、中国語と英語の転売防止に関する告知を読み、「我已阅读 / I have read this」にチェックを入れてください。告知が合計 8 秒間表示されると先へ進めるようになります。確認の記録と告知テキストの SHA-256 ダイジェストはローカルに保存され、告知が更新されると再確認が必要です。ShinkiEMU は無料のオープンソースソフトウェアです。公式サイトまたは GitHub Releases からダウンロードしてください。お金を払って入手した場合は、返金を申請し、販売者を通報してください。告知は設定の「About」ページでも確認できます。

二言語の告知は Rust で画像としてラスタライズされ、オンボーディングと「About」の画像スロットに表示されます。読了時間が加算されるのは、画像全体が読めるサイズでスクロール領域内に表示されている間だけです。非表示、サイズ不足、切り抜かれた状態、ウィンドウの最小化中は計測が止まります。ウィンドウが狭い場合は高さを広げるか、告知全体が見える位置までスクロールしてください。UI の画像を削除しても Rust 側の完了チェックは回避できず、オンボーディングは完了しません。

告知画像は現在のライトテーマまたはダークテーマ、その背景色と文字色に追従し、カスタムテーマの色も反映されます。テーマを切り替えると画像は再ラスタライズされますが、加算済みの読了時間は保持されます。

Manager は簡体字中国語、英語、日本語で表示できます。「設定 → 外観 → 言語」で切り替えてください。「システムに従う」を選ぶと OS の言語に合わせ、中国語環境では簡体字中国語、日本語環境では日本語、それ以外では英語で表示します。切り替えはすぐに反映され、ほかの設定と一緒に保存されます。中国語と日本語のフォントを同梱しているため、CJK フォントのないシステムでも正しく表示されます。漢字は日本語表示では日本語の字形、それ以外では簡体字中国語の字形で描画します。

ゲームのタイトル、説明、パッチの説明はメタデータから取得します。現在の言語の内容を優先し、日本語がない場合は英語、英語もない場合は簡体字中国語を表示します。転売防止の告知は常に中国語と英語の二言語です。

ネットワーク接続を許可すると、Manager は起動時に一度、バックグラウンドで自身の更新を確認します。起動を妨げず、失敗してもダイアログは表示しません。「設定 → アップデート → 今すぐ確認」では手動で確認し、失敗の理由を表示します。Project-Shinkirou/ShinkiEMU の GitHub Releases にある manager-v<semver> タグを比較します。コアやストアのゲームの更新とは別の機能です。

プレリリース版を受け取るか選択でき、現在の Manager がプレリリース版なら初期値はオンです。新しい版が見つかると、バージョン、リリースノート、現在のプラットフォーム向けダウンロード先を表示し、システムのブラウザーで開きます。自動ダウンロードや自動インストールは行いません。無視したバージョンは端末に保存され、再通知しません。「後で」は今回のセッションだけ通知を隠します。オフライン時は更新リクエストを送信しません。

ゲームの追加とコアのインストール

Section titled “ゲームの追加とコアのインストール”

設定で、正規に入手したゲームのインストールディレクトリを追加し、ライブラリをスキャンします。ゲームを選んだら、検出されたコアとゲーム固有の設定を確認してからセッションを開始します。プローブの一致はフォーマットが認識されたことを示すだけです。暗号化されたリソースには別途プライベートな設定が必要な場合があり、鍵は常にローカルに保管してください。

コアの更新で廃止された設定は、保存済みの設定から自動的に削除されます。

メタデータの同期やコアのダウンロードの前に、設定でネットワーク接続を許可します。コア管理ページでカタログを更新し、現在のプラットフォーム向けのコアをインストールまたは更新します。カタログにはバージョン、ABI、ダウンロード URL、ハッシュが記録されています。読み込み済みのライブラリを置き換える更新では、先にセッションを終了し、画面の指示に従って Manager を再起動してください。コアディレクトリは core.json、依存ファイル、存在する場合は Resources/、ライセンスを含めて丸ごと保持してください。DLL だけをコピーしてもインストールにはなりません。

設定でネットワーク接続を許可し、「ゲームを追加 → ストアからダウンロード」を開きます。複数のストアを組み込んだ場合は、先にストアを選びます。ログイン方法はストアごとに異なります。Steam は QR、アカウントとパスワードによる Steam Guard 認証、デスクトップクライアントからのインポートに対応します。DLsite と DMM/FANZA は Manager 内でストア自身のサインインページを開きます。Cookie と更新 token はシステムの秘密情報ストアだけに保存され、インストール記録やログには書き込まれません。ログアウトすると、そのストアの保存済みログインが削除されます。

Web サインイン(DLsite、DMM/FANZA):「サインインページを開く」を選ぶと、ストア公式のサインインページをシステムの Web ビューで表示します。Windows は WebView2、macOS と iOS は WKWebView、Linux は WebKitGTK の別ウィンドウ、Android はアプリの上に WebView を表示します。CAPTCHA や二段階認証も含め、そのページでサインインしてください。ストアがアカウントのセッション付きでサインイン後のページに進むと、Manager は Web ビューからそのストアの Cookie(HttpOnly Cookie を含む)を直接読み取り、ページを閉じてログインを完了します。コピーや貼り付けは不要です。Web ビューは毎回空のプライベート Cookie ストアで始まり、閉じた後には何も残しません。保存されるのはストアのログイン情報だけで、保存先はシステムの秘密情報ストアです。「キャンセル」、ウィンドウを閉じる、Android の戻る操作、ストア画面から離れる、のいずれでもサインインは中止されます。Windows では Microsoft Edge WebView2 ランタイム(Windows 11 は標準搭載)、Linux では WebKitGTK 4.1(libwebkit2gtk-4.1)が必要です。

**Steam のログイン:**アカウント名とパスワードでログインし、案内に従ってメールまたはモバイルの Steam Guard コードを入力するか、スマートフォンで承認します。Steam モバイルアプリでローカル生成された QR コードをスキャンする方法もあります。デスクトップ版では Steam クライアントのキャッシュ済みログインも取り込めます。モバイル版はパスワードまたは QR コードでログインします。パスワードは保存されません。リフレッシュトークンはシステムのシークレットストア(Windows 資格情報マネージャー、Linux Secret Service、macOS/iOS のキーチェーン、AndroidKeyStore で暗号化されたアプリ専用ストレージ)にだけ保存されます。ログアウトすると保存済みのログイン情報は消去されます。

「QR コードでログイン」を選ぶと、アカウント名やパスワードを入力せずに、新しいログイン用 QR コードを Steam に要求します。Steam の応答後に QR コードが表示され、モバイルアプリで承認するとログインが完了します。キャンセルすると待機を止め、ログインは完了しません。

所有しているゲームを検索し、デポとブランチを選んでから、書き込み可能なライブラリディレクトリを選択します。Windows 向けデポはモバイル版でも既定で選択されています。言語デポは個別に選択できます。ダウンロードが終わると、Manager はゲームを自動で追加し、対応するコアをプローブします。ゲームをダウンロードできても、そのエンジンに対応するコアがあるとは限りません。

「更新を確認」は、ローカルと Steam のデポマニフェストを比較します。再度ダウンロードすると、変更のないローカルデータを再利用して差分更新を行います。「検証と修復」はインストール済みのファイルを検証し、修復します。キャンセルすると、進行中の書き込みが終わるのを待ち、中断マーカーを残します。再試行時は検証済みのローカルチャンクを再利用して続行します。各ゲームディレクトリの .DepotDownloader は削除しないでください。インストール済みのマニフェストと差分更新に必要な情報が記録されています。

ダウンロードできるのは、ログイン中のアカウントが所有する PC ダウンロード版だけです。Play 専用、ストリーミング、ブラウザ向け作品にはダウンロードできない理由を表示します。DRM、起動 token、ライセンス確認は回避しません。ブランチ、デポ、検証の操作はストアが対応する場合だけ表示します。新規インストールは <ライブラリ>/.shinki/store/<provider>/installs/、一時ファイルとキャッシュは <Manager データディレクトリ>/.shinki/store/<provider>/ に保存します。以前の Steam インストール記録と秘密情報ストアの参照は一度だけ移行し、ゲーム本体は移動しません。

ストアがインストール済みのバージョンを判定できない場合は、エラーではなく Update status unavailable と表示し��更新操作を非表示にします。ライブラリを更新すると再確認します。アーカイブやインストーラーをダウンロードした場合は、完了後に Downloaded archives need manual extraction or installer run と Open folder を表示します。自分で展開するか公式インストーラーを実行し、実際に起動できるゲームディレクトリを Manager に追加してください。インストーラーや DRM の回避は行いません。

DLsite は上記の Web サインインを使い、DLsite Play のログインページから始めます。DLsite が __DLsite_SID のアカウントセッション付きで Play に戻るとサインイン完了です。セッションはプラットフォームの秘密情報ストアだけに保存されます。ライブラリには DLsite Play の購入作品を表示し、DLsite がアカウント向けに提供する PC 版ファイルだけを取得します。Play の閲覧用・メディア用最適化ファイルはゲームとしてインストールしません。ZIP はパス安全性を検査して展開します。RAR と自己解凍インストーラーは変更せず保存し、手動での展開またはインストールが必要です。ダウンロードした実行ファイルを Manager が起動することはありません。調査した API からはインストール済みビルドを特定できないため、更新状態は不明として表示します。

ダウンロード計画を解決できない作品は、サインイン済みブラウザーで操作を再現し、応答本文を含む HAR をエクスポートしてください。https://play.dlsite.com/api/v3/download?workno=<購入済み作品番号> から始め、リダイレクト先と /home/download、/home/serial、分割ファイル一覧の各リクエストを含めます。共有前に Cookie、シリアル番号、署名付き URL の token を削除してください。HAR をコミットしないでください。

既定のメタデータソースは次のとおりです。

https://project-shinkirou.github.io/data/shinkiemu/v1/

設定ページでネットワーク接続の許可と手動同期を行えます。破損した、または検証に通らなかったスナップショットが有効なキャッシュを上書きすることはありません。レポートを見るときは、VNDB のリリース rID、コア、プラットフォーム、アーキテクチャ、desktop/device/simulator のバリアントがすべて一致しているかを確認してください。別のプラットフォームやアーキテクチャの結果は、現在の環境には当てはまりません。再現可能な観察結果は issue フォームから報告できます。

オンラインのパッチでレビュー済みの Luau パッチを選ぶか、**ローカルのパッチを読み込む…**で .luau スクリプトまたは ZIP を開きます。カタログに紐付かないローカルスクリプトは未レビューと表示します。オンラインパッチは具体的なリリースに紐付き、書き込み前にファイル指紋を確認します。スクリプトは明示的に選択した場合だけ実行されます。ダウンロードは HTTPS に限定し、宣言したサイズと SHA256 を確認して <game>/.shinki/patch/ に保存します。オンライン記録では宣言済みのダウンロードだけを許可します。

既定の新しいディレクトリでは元のゲームを変更せず、セーブをコピーしません。その場で上書きは専用の一時領域へ書き込み、変更・削除する元ファイルを <game>/.shinki/backup/<id>/ に退避して、manifest.json にハッシュを記録します。最新のパッチを復元は、ユーザーが後から編集したファイルを上書きしません。レシートは <game>/.shinki/patch-result.json に保存します。リソースパッチは EXE を作成・変更できません。貢献方法は Metadata を参照してください。

Windows、macOS、Linux の新しいディレクトリモードでは、出力先の選択にフォルダーピッカーを使います。変換結果を置く親フォルダーを選んでください。システムのフォルダー操作で新しいフォルダーを作ることもできます。Manager は、その中に作成する localized-output のフルパスを表示します。同名の項目がある場合は localized-output-1、localized-output-2 などを提案します。開始前にこのパスを確認してください。選択だけでは変換用ディレクトリを作成せず、変換成功時に結果を公開します。選択のキャンセルは以前のパスを変更しません。既存のファイルやディレクトリは上書きせず、選択後に他のプログラムが出力パスを使用した場合も拒否します。出力先はゲームやパッチ入力先と重複できません。その場で上書きでは出力先の選択を使用しません。iOS では選択した親フォルダー内に新しい localized-output を作成し、Android ではアプリ専用の新しいエクスポートディレクトリを使います。

新しい Musica パッチには Musica コア beta.5 以降が必要で、Yorino は機能ビット 256 と 512 の両方を必要とします。RFVP のネイティブスクリプトパッチにはセーブ分離と設定フォントの優先が必要です。Manager はインポート時と起動前に実際のコアを確認します。更新を求められたら更新してから再試行してください。バージョン名だけでは機能の対応を判断しません。旧 Manager は維持された v1 カタログと旧スクリプトを読み込みます。

ShinkiEMU は新しいプラットフォーム別のアプリケーションデータディレクトリを使い、その場所は設定から開けます。デスクトップでは SHINKI_EMU_DATA_DIR で絶対パスを指定できます。Android ではアプリ専用ディレクトリを使います。名称変更前のアプリケーションデータベース、キャッシュ、製品独自のセーブは自動では取り込まれません。この切り替えで元のゲームのインストールや市販版のセーブデータが変更されることはありません。

セーブの扱いはコアごとに決まります。Musica は <game>/.shinki/musica/minori/<title>/ の eden/Perseus 形式の .sav と .png を使います。旧 beta の .asav は非対応で、読み込みも変更も変換も行いません。ReMinori の保存先は別です。バックアップや互換性のあるオリジナル形式のファイル交換は、実行中のセッションを終了してから行ってください。