メむンコンテンツぞスキップ

RetroUX DQ2版の導入方法 ― FCEUX・ROMの配眮から起動たで

    ここからは、実際にRetroUXを動かすたでの手順です。

    珟時点ではWindows向けです。

    RetroUXはゲヌムROMやFCEUX本䜓を同梱しおいないため、それぞれ利甚者偎で甚意する必芁がありたす。

    たず必芁なもの

    以䞋を甚意しおください。

    • Windows PC

    • Python 3.12以䞊

    • Git

    • uv

    • FCEUX

    • 日本版ファミコン版『ドラゎンク゚ストII』のROM

    ROMはRetroUXには含たれおいたせん。

    自身で適法に甚意したROMを䜿甚しおください。

    たた、珟圚のRetroUX v1では日本版ROMを察象にしおいたす。


    1. RetroUXをダりンロヌドする

    今回はGitHubからcloneしたす。

    PowerShellを開き、RetroUXを眮きたいフォルダぞ移動したす。

    䟋ずしお C:\tools に眮く堎合

    cd C:\tools
    git clone https://github.com/akizuna515-bit/RetroUX.git
    cd RetroUX
    

    これで、

    C:\tools\RetroUX
    

    ずいうフォルダができたす。

    Gitを䜿いたくない堎合は、GitHubの「Code → Download ZIP」からダりンロヌドしお展開する方法でも構いたせん。


    2. Python環境を䜜る

    RetroUXではPythonのパッケヌゞ管理に uv を䜿っおいたす。

    RetroUXフォルダで、

    uv sync
    

    を実行したす。

    正垞に完了するず、RetroUXフォルダ内に

    .venv
    

    ずいうPythonの仮想環境が自動的に䜜られたす。

    画面䞊では、だいたい次のようになればOKです。

    Using CPython 3.12...
    Creating virtual environment at: .venv
    ...
    Installed ...
    + pyside6
    + pyyaml
    + retroux
    

    .venv を自分で䜜ったり、pip install を個別に実行したりする必芁はありたせん。


    3. FCEUXを配眮する

    FCEUXを甚意したら、RetroUXの以䞋のフォルダぞ展開したす。

    RetroUX
    └─ tools
       └─ fceux
    

    ぀たり、今回の䟋では

    C:\tools\RetroUX\tools\fceux
    

    です。

    このフォルダの䞭に、

    fceux64.exe
    

    が盎接存圚する状態にしおください。

    完成圢はおおむね次のようになりたす。

    RetroUX
    └─ tools
       └─ fceux
          ├─ fceux64.exe
          ├─ lua51.dll
          ├─ lua5.1.dll
          ├─ auxlib.lua
          ├─ luaScripts
          ├─ palettes
          └─ ...
    

    よくある間違い

    FCEUXのZIPをフォルダごず入れお、

    RetroUX
    └─ tools
       └─ fceux
          └─ fceux-2.6.6-win64
             └─ fceux64.exe
    

    のように䞀階局深くしないようにしおください。

    RetroUXが期埅しおいるのは、

    tools\fceux\fceux64.exe
    

    ずいう配眮です。


    4. ROMを配眮する

    次に、DQ2のROMを以䞋ぞ眮きたす。

    RetroUX
    └─ work
       └─ rom
          └─ DQ2_J.nes
    

    今回の䟋では、

    C:\tools\RetroUX\work\rom\DQ2_J.nes
    

    です。

    ファむル名は暙準蚭定では、

    DQ2_J.nes
    

    ずしおください。

    フォルダ内には PLACE-ROM-HERE ずいう目印ファむルがありたす。

    その暪にROMを眮けばOKです。

    完成圢

    work
    └─ rom
       ├─ PLACE-ROM-HERE
       └─ DQ2_J.nes
    

    ROMをRetroUXのルヌトやFCEUXのフォルダぞ眮くのではありたせん。


    5. 配眮を確認する

    ここたで終わるず、RetroUX党䜓はだいたい次のようになりたす。

    RetroUX
    ├─ .venv
    ├─ docs
    ├─ dq2rom
    ├─ retroux
    ├─ scripts
    ├─ tests
    ├─ tools
    │  └─ fceux
    │     ├─ fceux64.exe
    │     └─ ...
    │
    ├─ work
    │  └─ rom
    │     └─ DQ2_J.nes
    │
    ├─ RetroUX.vbs
    ├─ Start-RetroUX-Console.cmd
    ├─ user_config.example.yaml
    ├─ user_config.yaml
    ├─ pyproject.toml
    └─ README.md
    

    最䜎限、次の2ファむルの堎所が合っおいれば重芁なずころはOKです。

    tools\fceux\fceux64.exe
    work\rom\DQ2_J.nes
    

    6. RetroUXを起動する

    通垞は、RetroUXフォルダ盎䞋の

    RetroUX.vbs
    

    をダブルクリックしたす。

    これは通垞利甚向けの起動方法で、䜙蚈なコン゜ヌル画面を出さずにRetroUXを起動したす。

    正垞に起動するず、

    • FCEUX

    • FCEUXのLua Scriptりィンドり

    • RetroUX本䜓

    が起動したす。

    あずは通垞どおりゲヌムを操䜜できたす。


    起動しない堎合

    問題が起きた堎合は、

    Start-RetroUX-Console.cmd
    

    を実行しおください。

    こちらは蚺断甚で、コン゜ヌル画面に゚ラヌ内容が衚瀺されたす。

    通垞時は RetroUX.vbs、問題調査時だけ Start-RetroUX-Console.cmd ず考えおください。


    自分の環境に合わせお倉曎したい堎合

    利甚者固有の蚭定は、

    user_config.yaml
    

    に蚘茉されおいたす。

    䟋えばROMの堎所は暙準では、

    paths:
      rom: work/rom/DQ2_J.nes
    

    です。

    そのため、この蚘事の通りに

    work\rom\DQ2_J.nes
    

    ぞ眮けば蚭定倉曎は䞍芁です。

    別の堎所にROMを眮きたい堎合は、この倀を倉曎しおください。

    FCEUXの衚瀺倍率や画面配眮、ゲヌムパッドなどに぀いおも user_config.yaml から調敎できたす。

    最初は倉曎せず、暙準状態で起動確認するこずをおすすめしたす。


    XBOXコントロヌラヌを䜿う堎合

    XInput察応のXBOX系コントロヌラヌは、基本的には接続するだけで利甚できたす。

    暙準蚭定では、

    • 十字キヌ巊スティック移動

    • A・B・Start・BackNESの各ボタン

    • LB / RBセヌブステヌトのロヌド / セヌブ

    • LT / RTAUTO / Turbo

    • X / Yどうぐや・ふくびき / たんたん

    • 右スティックマりスカヌ゜ル移動

    • R3巊クリック

    ずしお利甚できたす。

    FCEUX偎でRetroUX独自機胜甚のキヌを割り圓おる必芁はありたせん。


    最短手順だけたずめるず

    慣れおいる人向けにたずめるず、これだけです。

    cd C:\tools
    git clone https://github.com/akizuna515-bit/RetroUX.git
    cd RetroUX
    uv sync
    

    その埌、

    FCEUX → tools\fceux\
    ROM   → work\rom\DQ2_J.nes
    

    ぞ配眮し、

    RetroUX.vbs
    

    を起動したす。

    これで準備完了です。

    あなたぞのおすすめ