RetroArch

ノート: RetroArch は Arch Linux とは関係ありません。

RetroArch は libretro API のリファレンス実装です。これは、ビデオゲームシステムエミュレーター、ゲームエンジン、ビデオゲーム、メディアプレイヤーおよびその他のアプリケーション用のモジュール式フロントエンドであり、マルチパスシェーダーのサポート、リアルタイムの巻き戻し、ビデオの記録 (FFmpeg を使用) などのいくつかの一般的でない技術的な機能を提供します。また、フル機能のコマンドラインインターフェイスに加えて、ゲームパッド操作のUIも備えています。

インストール

retroarch パッケージをインストールするか、開発版のために retroarch-git^AUR をインストールしてください。

ヒント:

• RetroArch の GUI 用のフォントとアイコンを取得するために、retroarch-assets-xmb をインストールしてください。デスクトップにより適した GUI のために、retroarch-assets-ozone をインストールすることも検討してください。
• スタンドアロンのゲームボックス用に、システムユーザー、システムサービス、および RetroArch の設定を取得するために、retroarch-standalone-service^AUR をインストールしてください。その後、retroarch-standalone.service を開始および/または有効にします。
• PATH にある retroarch を Steam にインストールされた retroarch にマップするために、retroarch-steam-launcher^AUR をインストールしてください。これは、PATH から retroarch を使用する emulationstation-de^AUR のようなアプリケーションで、クラウドセーブなどの Steam 機能を使用するのに便利です。

使用方法

RetroArch は、その機能のほとんどを「コア」と呼ばれる個別のライブラリに依存しています。これらは、RetroArch 内で (libretro Buildbot を介して) ユーザーごとにダウンロードするか、Community または AUR からシステム全体に インストール することもできます。

デフォルトでは、RetroArchはダウンロードするユーザーごとのコアをロードするように構成されています。他の場所にインストールする場合は、#設定 を変更します。

特定のコアを実行するコマンドは次の通りです

$ retroarch --libretro /path/to/some_core_libretro.so /path/to/rom

設定

RetroArch を初めて実行すると、ユーザー設定ファイルが作成されます~/.config/retroarch/retroarch.cfg。

RetroArch コンポーネントをホームディレクトリにインストールする場合は、コアをダウンロードするためのグローバル構成ファイルでローカルパスを指定する必要があります。例えば、

~/.config/retroarch/retroarch.cfg

libretro_directory = "~/.config/retroarch/cores"
libretro_info_path = "~/.config/retroarch/cores/info"

RetroArch コンポーネントを pacman を使ってシステム全体にインストールする場合は、グローバル設定ファイルにユーザーファイルを設定してしてください。例えば、

/etc/retroarch.cfg

# for retroarch-assets-xmb
assets_directory = "/usr/share/retroarch/assets"
# for libretro-core-info
libretro_info_path = "/usr/share/libretro/info"
# for libretro cores
libretro_directory = "/usr/lib/libretro"

~/.config/retroarch/retroarch.cfg

#include "/etc/retroarch.cfg"

ノート: RetroArch はこれらのコンポーネントの複数の検索パスをサポートしていません。例えば、pacman でコアをインストールして、RetroArch の GUI を使ってコアをダウンロードした場合、それらは別のディレクトリにインストールされているので、RetroArch が一度にすべてのコアを表示するように設定することはできません。

設定を上書きしたい場合は (特定のコアを実行しているときなど) --appendconfig /path/to/config コマンドラインオプションを使うことができます。

ヒントとテクニック

オンラインアップデーター を有効にする

pacman の代わりに組み込みのアップデータを使用して、すべての RetroArch コンポーネントをインストールする場合は、設定ファイルを使用して有効にすることができます:

~/.config/retroarch/retroarch.cfg

menu_show_core_updater = "true"

ノート: Install libretro-core-info to ensure the core downloader works correctly. Without this package it will not fetch the core list to choose from.

SaveRAM Autosave Interval の有効化

デフォルトでは、RetroArch はエラーなしで終了した場合のみ SRAM をディスクに書き込みます。つまり、クラッシュが発生しやすいコアを使用すると、セーブデータが失われるリスクがあります。この動作を変更するには、~/.config/retroarch/retroarch.cfg を開いて、autosave_interval に n を設定します。

~/.config/retroarch/retroarch.cfg

autosave_interval = "600"

上記の例では、RetroArch は SRAM の変更を600秒毎にディスクに書き込みます。

警告: この値を低くしすぎると、あらゆる種類の問題、特にハードウェアの劣化が発生します。[1] を参照してください

フィルターとシェーダー

RetroArch は BSNES XML filters と CG shaders をロードできます。これらはそれぞれ、retroarch.cfg に video_bsnes_shader と video_cg_shader でそれぞれ設定されています。シェーダーは、オンラインアップデータを使用して、RetroArch 内で直接取得および更新することもできます。

ノート: retroarch-git^AUR では、cg shaders を使用するために、nvidia-cg-toolkit が必要です。

設定をデフォルト値にリセットする

GUIを使用して、設定またはキーバインドをデフォルト値にリセットするには、ハイライト表示して、Start を押します。キーバインドからボタンを削除するには、キーバインドをハイライト表示にして、Y を押します。

トラブルシューティング

コアが見つかりません

デフォルトでは、RetroArch は ~/.config/retroarch/cores 内でコアを検索します。これは、Online Updater がコアをインストールする場所です。pacman でインストールされたコアは /usr/lib/libretro に配置されるため、RetroArch の GUI には表示されません。コアのインストール方法（pacman または Online Updater）のいずれかを選択し、それに合わせて設定を変更する必要があります。

入力デバイスが使えない

RetroArch を CLI で実行したり Xorg 以外のディスプレイサーバーで実行すると問題が発生します。/dev/input ノードは root だけがアクセスできるように制限されているためです。この問題は手動で KERNEL=="event*", NAME="input/%k", MODE="666" という中身のルールを /etc/udev/rules.d/99-evdev.rules に追加することで解決します。次を実行して udev ルールをリロードしてください:

# udevadm control --reload-rules

システムを再起動したりデバイスの再接続ができない場合、次のコマンドでパーミッションを強制的に設定することもできます:

# chmod 666 /dev/input/event*

ビデオパフォーマンスが悪い

ビデオパフォーマンスが低いのを補うために、~/.config/retroarch/retroarch.cfg に video_threaded = true と設定することで RetroArch を別のスレッドで実行することができます。

ただし、垂直同期が完全に使えなくなり、遅延が多少増えるため、RetroArch のビデオ解像度やリフレッシュレートを調整することで問題が解決する場合はこの手段は使わないほうが良いでしょう。

ALSA でのオーディオの問題

ALSA を使用する場合の audio_out_rate は、システムのデフォルトの出力レートと一致させる必要があります。通常は、48000 です。

RetroArch がクラッシュするとセーブデータが失なわれる

#SaveRAM Autosave Interval の有効化 を参照してください。

プレイリストからゲームを開始したが、'No Items' と報告される

RetroArch が libretro core requires contents, but nothing provided と報告する場合、Main Menu > Load Content から ROM のパスを手動で選択してゲームをロードしてみてください。playlist からゲームを開始するのは信頼性が低いようです。

RetroArch を Xwayland で強制的に起動する必要があります。

$ WAYLAND_DISPLAY="" retroarch

--verbose オプションを使用してログを確認できますが、その際に "vk_wayland" の代わりに Found vulkan context: "vk_x" が表示されるはずです。

BIOS ファイルが見つからない、または認識されない

Retroarch のコアは、retroarch.cfg 内の system_directory オプションで設定された場所に BIOS ファイルを探します。

GUI メニューの Settings > Directory > System/BIOS でもディレクトリが表示されます。

いくつかのコアは、ファイルをこのディレクトリに直接配置する必要があります。その他のコアは、特定の BIOS ファイルのために、このディレクトリ内に特定の名前のサブディレクトリが必要です。さらに、一部のコアは、実行しようとする ROM ファイルと同じディレクトリにファイルを探します。

インストールされている各コアは、必要なファイル、MD5 ハッシュ、および配置する必要があるディレクトリに関する情報を提供します。この情報は、GUI メニューの Settings > Core > Manage Core で確認できます。ここでコアを選択すると、この特定のコアに必要な BIOS ファイルに関する情報が表示されます。RetroArch は、コア情報ページでそれらを「ファームウェア」ファイルとして説明しています。

サポートされている多くのコアの BIOS ファイルに関する詳細な情報は、公式ドキュメントで確認できます。 [2]

参照

• 公式ウェブサイト
• RetroArch wiki on Github
• 開発者向けドキュメント