Help:Frequently Asked Questions: Difference between revisions

Help page
(Updated VSH settings)
(Merge edit by Darkhost)
Tag: merged edit of another user
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
This is a page meant to address common questions and issues faced by users.
This is a page meant to address common questions and issues faced by users.


==Running VSH in RPCS3==
==Running VSH/XMB in RPCS3==
To run VSH (otherwise known as XMB, the PS3's graphical user interface) currently you need this [https://ci.appveyor.com/api/buildjobs/8xi7o1l3skx4poxr/artifacts/rpcs3-v0.0.7-8912-d4f412bd_win64.7z special build]. You also need to make the following changes in the ''Settings menu'':
Since July 2021, it has been possible to run VSH/[https://en.wikipedia.org/wiki/XrossMediaBar XMB] on the official master builds of the emulator, bearing in mind some quirks and limitations. The initial set-up is as follows:


===Configuration===
Make the following modifications to the ''Global'' configuration.
{{config
{{config
<!-- CPU configuration -->
<!-- CPU configuration -->
|firmware settings                  = Load liblv2.sprx and manual selection <!-- Manually load selected libraries, Load automatic and manual selection, Load liblv2.sprx only, Load liblv2.sprx and manual selection, Load liblv2.sprx and strict selection -->
|ppu decoder                          = Interpreter (fast) <!-- Interpreter (precise), Interpreter (fast), Recompiler (LLVM) -->
|firmware settings notes             = '''Deselect''' every module in the ''Firmware Libraries'' menu <!-- Where libraries are manually selected, mention the list of libraries to be selected here -->
|ppu decoder notes                     = Can be used for a smoother experience during initial setup.
<!-- GPU configuration -->
<!-- GPU configuration -->
|write color buffers                = On <!-- On, Off -->
|default resolution                    = 1920x1080 <!-- 1920x1080, 1280x720, 720x480, 720x576, 1600x1080, 1440x1080, 1280x1080, 960x1080 -->
|write color buffers notes           =  
|default resolution notes             = Can be used if you prefer a Full HD presentation.
<!-- Advanced configuration -->
|write color buffers                  = On <!-- On, Off -->
|debug console mode                  = On <!-- On, Off -->
|write color buffers notes             = Fixes background wave effect
|debug console mode notes           =  
<!-- Debug configuration -->
<!-- Debug configuration -->
|force cpu blit emulation           = On <!-- On, Off -->
|force cpu blit emulation             = On <!-- On, Off -->
|force cpu blit emulation notes     =  
|force cpu blit emulation notes       = Fixes background wave effect
}}
}}


After this, select <code>File > Boot elf/self...</code> and select <code>/dev_flash/vsh/module/vsh.self</code>
===Initial Setup===
[[File:VSH database.png|300px|thumb|right|Time to rebuild the XRegistry database]]
 
The initial setup consists of two phases. The first phase is as follows:
# Select <code>File > Boot VSH/XMB</code> to get started. VSH will have to rebuild its [https://www.psdevwiki.com/ps3/XRegistry.sys XRegistry] database. You may notice that the image output is low resolution, and has a 4:3 aspect ratio. This is completely normal and the expected behavior.
# As soon as the progress bar hastily completes, you'll be met with an empty black screen. This is also the expected behavior for now. Simply quit VSH manually (like you'd quit any game).
 
Now you can proceed to the second phase:
# Select <code>File > Boot VSH/XMB</code>. You will be greeted by the intro logo.
# You'll be presented with the language selection menu. Select your desired language and '''Press X'''.
# Next, you will be met with a message, saying that an HDMI display was detected. Choose '''Yes'''.
# Following this, you'll be asked to select your Timezone and the current time. You can just spam X to get through these, especially the current time selection part (it will autofill, if you hit X a couple times).
# Once done, '''Press Right'''. If you've done everything correctly (the summary page looks correct), '''Press X''' to finish the setup.
 
<gallery widths=300px heights=200px mode="packed">
File:VSH language.png|Select your desired language
File:VSH HDMI.png|HDMI detection prompt
File:VSH time.png|Select your Timezone and current time
File:VSH Network.png|Cancel setting up networking
</gallery>
 
# Before letting you in to the main menu, VSH will ask you if you want to set up a network connection. It is recommended that you do not.
# Confirm the new user profile creation and... Welcome to the PS3!
# This concludes the initial setup of the VSH / XMB.
 
<gallery widths=300px heights=200px mode="packed">
File:VSH Intro.png|Welcome to the PS3!
</gallery>
 
To correctly turn off VSH,
# Navigate to <code>Users > Turn Off System</code> option (VSH ''will'' throw a database corruption prompt on the next boot if you do not shut it down this way).
# After selecting the option, the screen will turn black. You can then proceed to manually exit VSH at this point.
 
<u>Notes</u>:
# It is recommended to boot VSH up back again after this, to ensure everything worked correctly, and to collect some extra PPU module cache. To build all ppu caches click File -> All Titles -> Create PPU Cache. This can help VSH run smoother.
# Make sure to revert the <code>PPU Decoder</code> option to '''Recompiler (LLVM)''' after you're done, in case you've set it to '''Interpreter (fast)''' for the duration of the setup process.
 
===Limitations===
At its current stage, VSH has several quirks and limitations:
* there's no multi-process support yet, meaning you can not use XMB as a frontend to boot into games or other applications
* due to encryption related reasons, it will display several instances of ''Corrupted Data'' erroneously in place of Game Data
* restarting and shutting down doesn't work automatically yet (hence why you have to do that manually as explained above or delete the rpcs3/dev_hdd0/tmp/turnoff file between boots)
* there's no audio support yet (missing rsxaudio)
 
===Troubleshooting===
In case you somehow manage to brick it, you can try removing the <code>dev_flash2</code> and <code>dev_flash3</code> folders from the RPCS3 directory. This will put you back at square one (you'll need to do the initial setup all over again).


==Enabling Debug tab==
==Enabling Debug tab==
Line 34: Line 80:
: First, a custom configurations for the particular game must be created. This is done to ensure that changes made only affect one game and not every game present in the emulator:
: First, a custom configurations for the particular game must be created. This is done to ensure that changes made only affect one game and not every game present in the emulator:
:# Launch RPCS3
:# Launch RPCS3
:# Right-click on the game and press '''Configure'''
:# Right-click on the game and press '''Create Custom Configuration'''
:# When the Settings Menu opens, hit '''Save''' and close the emulator
:# When the Settings Menu opens, hit '''Save''' and close the emulator
::: This will create a custom configuration for this game  
::: This will create a custom configuration for this game  
Line 42: Line 88:
:# Open the file using any text editor
:# Open the file using any text editor
:# Scroll through the list of settings available to find the one you wish to modify (don't forget to hit save after you've changed the necessary option)
:# Scroll through the list of settings available to find the one you wish to modify (don't forget to hit save after you've changed the necessary option)
==List of CLI commands==
If you want to use RPCS3 through CLI, you can type <code>--help</code> to view the full list of commands available.

Revision as of 13:53, 10 January 2022

This is a page meant to address common questions and issues faced by users.

Running VSH/XMB in RPCS3

Since July 2021, it has been possible to run VSH/XMB on the official master builds of the emulator, bearing in mind some quirks and limitations. The initial set-up is as follows:

Configuration

Make the following modifications to the Global configuration. Options that deviate from RPCS3's default settings and provide the best experience with this title are listed below.

CPU configuration

Setting Option Notes
PPU decoder Can be used for a smoother experience during initial setup.

GPU configuration

Setting Option Notes
Default resolution 1920x1080 Can be used if you prefer a Full HD presentation.
Write color buffers On Fixes background wave effect

Debug configuration

This tab is hidden by default. For instructions on how to enable the Debug tab in the settings window, click here.

Setting Option Notes
Force CPU blit emulation On Fixes background wave effect

Initial Setup

Time to rebuild the XRegistry database

The initial setup consists of two phases. The first phase is as follows:

  1. Select File > Boot VSH/XMB to get started. VSH will have to rebuild its XRegistry database. You may notice that the image output is low resolution, and has a 4:3 aspect ratio. This is completely normal and the expected behavior.
  2. As soon as the progress bar hastily completes, you'll be met with an empty black screen. This is also the expected behavior for now. Simply quit VSH manually (like you'd quit any game).

Now you can proceed to the second phase:

  1. Select File > Boot VSH/XMB. You will be greeted by the intro logo.
  2. You'll be presented with the language selection menu. Select your desired language and Press X.
  3. Next, you will be met with a message, saying that an HDMI display was detected. Choose Yes.
  4. Following this, you'll be asked to select your Timezone and the current time. You can just spam X to get through these, especially the current time selection part (it will autofill, if you hit X a couple times).
  5. Once done, Press Right. If you've done everything correctly (the summary page looks correct), Press X to finish the setup.
  1. Before letting you in to the main menu, VSH will ask you if you want to set up a network connection. It is recommended that you do not.
  2. Confirm the new user profile creation and... Welcome to the PS3!
  3. This concludes the initial setup of the VSH / XMB.

To correctly turn off VSH,

  1. Navigate to Users > Turn Off System option (VSH will throw a database corruption prompt on the next boot if you do not shut it down this way).
  2. After selecting the option, the screen will turn black. You can then proceed to manually exit VSH at this point.

Notes:

  1. It is recommended to boot VSH up back again after this, to ensure everything worked correctly, and to collect some extra PPU module cache. To build all ppu caches click File -> All Titles -> Create PPU Cache. This can help VSH run smoother.
  2. Make sure to revert the PPU Decoder option to Recompiler (LLVM) after you're done, in case you've set it to Interpreter (fast) for the duration of the setup process.

Limitations

At its current stage, VSH has several quirks and limitations:

  • there's no multi-process support yet, meaning you can not use XMB as a frontend to boot into games or other applications
  • due to encryption related reasons, it will display several instances of Corrupted Data erroneously in place of Game Data
  • restarting and shutting down doesn't work automatically yet (hence why you have to do that manually as explained above or delete the rpcs3/dev_hdd0/tmp/turnoff file between boots)
  • there's no audio support yet (missing rsxaudio)

Troubleshooting

In case you somehow manage to brick it, you can try removing the dev_flash2 and dev_flash3 folders from the RPCS3 directory. This will put you back at square one (you'll need to do the initial setup all over again).

Enabling Debug tab

To enable RPCS3's debug tab in the settings window,

  1. Navigate to:
    RPCS3\GuiConfigs on Windows
    ~/.config/rpcs3/GuiConfigs on Linux
  2. Open CurrentSettings.ini with a text editor
  3. Change showDebugTab=false to showDebugTab=true

Modifying settings through config.yml

In most cases, users should use the Settings tab available in the GUI to modify configurations present in RPCS3. However, the GUI interface does not expose all settings available. This is done to prevent users from accidentally modifying sensitive settings. In the event users need to modify one of these settings, the following guide will demonstrate how:

First, a custom configurations for the particular game must be created. This is done to ensure that changes made only affect one game and not every game present in the emulator:
  1. Launch RPCS3
  2. Right-click on the game and press Create Custom Configuration
  3. When the Settings Menu opens, hit Save and close the emulator
This will create a custom configuration for this game
The next step is navigate to the location where the custom (per-game) configuration is saved:
  1. Right click on the game in the gamelist and click on Open custom config folder (or)
    Navigate to RPCS3\config\custom_configs\ on Windows or ~/.config/rpcs3/custom_configs/ on Linux
  2. Locate the file config_GAMEID.yml where GAMEID is the Title ID of your particular game
  3. Open the file using any text editor
  4. Scroll through the list of settings available to find the one you wish to modify (don't forget to hit save after you've changed the necessary option)

List of CLI commands

If you want to use RPCS3 through CLI, you can type --help to view the full list of commands available.