Help:Default Settings: Difference between revisions

Help page
(Better use of spacing. More spacing for description.)
(Added missing setting and tweaked others.)
(35 intermediate revisions by 2 users not shown)
Line 2: Line 2:


==CPU configuration==
==CPU configuration==
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
! Description
|-
|-
|'''PPU Decoder'''||Recompiler (LLVM)||'''Recompiler (LLVM)''': Recompiles the game's executable once before running it for the first time. By far the fastest option and should always be used. Should you face compatibility issues, fall back to one of the Interpreters and retry. <br/>'''Interpreter (fast)''': The fastest interpreter. Trades accuracy for speed, and it very rarely breaks games even in comparison to the precise option. Try this if Recompiler (LLVM) fails. <br/>'''Interpreter (precise)''': The most accurate Interpreter, but very slow to play games with. You may try this as a last resort if you encounter odd bugs or crashes.
|'''PPU decoder'''||LLVM Recompiler||'''LLVM Recompiler''': Recompiles the game's executable once before running it for the first time. By far the fastest option and should always be used. Should you face compatibility issues, fall back to one of the Interpreters and retry. <br>'''Interpreter (fast)''': The fastest interpreter. Trades accuracy for speed, and it very rarely breaks games even in comparison to the precise option. Try this if PPU LLVM Recompiler fails. <br>'''Interpreter (precise)''': The most accurate Interpreter, but very slow to play games with. You may try this as a last resort if you encounter odd bugs or crashes.
|-
|-
|'''SPU Decoder'''||Recompiler (ASMJIT)||'''Recompiler (ASMJIT)''': Fastest option with very good compatibility. <br/>'''Interpreter (fast)''': Slower than the Recompiler (ASMJIT) but significantly faster than Interpreter (precise). Games rarely need this option. <br/>'''Interpreter (precise)''': Extremely slow but may fix broken graphics in some games. <br/>'''Recompiler (LLVM)''': Doesn't exist (yet).
|'''SPU decoder'''||LLVM Recompiler||'''LLVM Recompiler''': Fastest option with very good compatibility. Recompiles the game's SPU LLVM cache before running which adds extra start-up time. If you experience issues, use the ASMJIT Recompiler. <br>'''ASMJIT Recompiler''': Fast option with very good compatibility. <br>'''Interpreter (fast)''': Slower than the SPU ASMJIT Recompiler but significantly faster than Interpreter (precise). Games rarely need this option. <br>'''Interpreter (precise)''': Extremely slow but may fix broken graphics in some games.
|-
|-
|'''Preferred SPU Threads'''||Auto||Some SPU stages are sensitive to race conditions and allowing a limited number at a time helps alleviate performance stalls. Setting this to a smaller value might improve performance and reduce stuttering in some games. <br/>Leave this on auto if performance is negatively affected when setting a small value.
|'''Preferred SPU threads'''||Auto||Some SPU stages are sensitive to race conditions and allowing a limited number at a time helps alleviate performance stalls. Setting this to a smaller value might improve performance and reduce stuttering in some games. <br>Please note that the best value depends on the individual game and specific CPU being used, so users need to try different values themselves. <br>Leave this on ''Auto'' if performance is negatively affected when setting a small value.
|-
|-
|'''Firmware Settings'''||Load liblv2.sprx only||'''Load liblv2.sprx only''': Closely emulates how games can load and unload system module files on a real PlayStation 3. Some games require this. <br/>'''Automatically load required libraries''': Automatically selects the LLE libraries to load. While this option works fine in most cases, liblv2 is the preferred option. <br/>'''Manually load selected libraries''': Allows the user to manually choose the LLE libraries to load. If unsure, don't use this option. Nothing will work if you use this. <br/>'''Load automatic and manual selection''': Automatically selects the LLE libraries to load and allows the user to choose additional libraries manually. If unsure, don't use this option.
|'''Enable thread scheduler'''||On||Allows the emulator to manually schedule physical cores to run specific tasks on, instead of letting the OS handle it. Very useful for AMD Ryzen systems on Windows, where it can give huge performance gains. <br>Not recommended for Linux as the OS schedules the physical cores better on its own. <br>No effect on Intel CPUs.
|-
|-
|'''Enable Thread Scheduler'''||On||Allows the emulator to manually schedule physical cores to run specific tasks on, instead of letting the OS handle it. Very useful on windows, especially for AMD Ryzen systems where it can give huge performance gains. <br/>Not recommended for Linux as the OS schedules the physical cores better on its own.
|'''Lower SPU thread priority'''||Off||Runs SPU threads with lower priority than PPU threads. <br>Usually faster on an i3 or i5, possibly slower or no difference on an i7 or Ryzen.
|-
|-
|'''Lower SPU Thread Priority'''||Off||Runs SPU threads with lower priority than PPU threads. <br/>Usually faster on an i3 or i5, possibly slower or no difference on an i7 or Ryzen.
|'''Enable SPU loop detection'''||On||Try to detect loop conditions in SPU kernels and use them as scheduling hints. <br>Improves performance and reduces CPU usage. May cause severe audio stuttering in rare cases.
|-
|-
|'''Enable SPU Loop Detection'''||On||Try to detect loop conditions in SPU kernels and use them as scheduling hints. <br/>Improves performance and reduces CPU usage. May cause severe audio stuttering in rare cases.
|'''SPU cache'''||On||Should normally stay enabled. Disable this if the cache becomes too large. Disabling it does not remove the existing cache.
|-
|-
|'''Hook Static Function'''||Off||Allows to hook some functions like 'memcpy' replacing them with high-level implementations. <br/>May do nothing or break things. Experimental.
|'''Accurate xfloat'''||Off||Fixes bugs in various games at the cost of performance. This setting is only applied when SPU LLVM is active.
|-
|'''SPU block size'''||Safe||This option controls the SPU analyser, particularly the size of compiled units. <br>Mega and Giga modes may improve performance by tying smaller units together, decreasing the number of compiled units but increasing their size. <br>Use the Safe mode for maximum compatibility.
|-
|'''TSX instructions'''||Enabled||Enable usage of TSX instructions. <br>Needs to be forced on some Haswell or Broadwell CPUs. Forcing this on older Hardware can lead to system instability, use it with caution.
|}
|}


==GPU configuration==
==GPU configuration==
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
! Description
|-
|-
|'''Renderer'''||OpenGL||Vulkan is the fastest renderer. OpenGL is the most accurate renderer. If unsure, use Vulkan. Should you have any compatibility issues, fall back to OpenGL. DirectX 12 is deprecated and should never be used.
|'''Renderer'''||OpenGL||Vulkan is the fastest renderer while OpenGL is the most accurate renderer. If unsure, use Vulkan. <br>Should you have any compatibility issues when using Vulkan, fall back to OpenGL.
|-
|'''Graphics device'''||NA||On multi GPU systems select which GPU to use in RPCS3 when using Vulkan. This is not needed when using OpenGL.
|-
|-
|'''Graphics Device'''||NA||On multi GPU systems select which GPU to use in RPCS3 when using Vulkan or DirectX 12. This is not needed when using OpenGL.
|'''Aspect ratio'''||16:9||Leave this on 16:9 unless you have a 4:3 monitor. Auto also works well, especially if you use a resolution that is not 720p.
|-
|-
|'''Aspect Ratio'''||Auto||Leave this on 16:9 unless you have a 4:3 monitor. Auto also works well, especially if you use a resolution that is not 720p.
|'''Framelimit'''||Off||Most games have an inbuilt framelimit and adding RPCS3's limiter on-top of that will only hurt performance even if you're well below reaching the cap. Off is the best option as it performs faster. <br>Only use framelimiter if a game runs too fast without it. Some games will crash if the framerate is too high. If that happens, set value to anything other than ''Off''.
|-
|-
|'''Framelimit'''||Off||Off is the best option as it performs faster. Using the frame limiter will add extra overhead and slow down the game. However, some games will crash if the framerate is too high. If that happens, set value to anything other than Off.
|'''Anisotropic filter'''||Automatic||Higher values increase sharpness of textures on sloped surfaces at the cost of GPU resources. <br>Setting it to '''16x''' provides the best quality and can be done on any modern GPU. However, some games (such as Unreal Engine titles) may have visual artifacts. <br>In such cases, set it to '''Automatic''' to allow games to use their own inbuilt filtering methods. <br>There's not much reason to use a value below 16x as it will only look worse with the same performance and compatibility issues in certain games.
|-
|-
|'''Anisotropic Filter'''||Automatic||Higher values increase sharpness of textures on sloped surfaces at the cost of GPU resources. Modern GPUs can handle this setting just fine even at 16x. Keep this on Automatic if you want to use the original setting used by a real PS3.
|'''Anti-aliasing'''||Auto||Emulates PS3 multisampling layout.<br>Can fix some visual artifacts in some games.<br>Low to moderate performance hit depending on your GPU hardware.
|-
|-
|'''Anti-Aliasing'''||NA||Doesn't exist (yet).
|'''Default resolution'''||1280x720||In most cases, do not change resolution in settings, leave it at ''1280x720''. Any other setting may result in compatibility issues and performance decrease. <br>If you wish to try setting the resolution higher to 1920x1080, you '''MUST''' check the compatible resolutions for the game from the game list to ensure that it can support such a resolution. <br>Forcing such resolution on games that do not support it will result in significant issues. <br>Using resolutions lower than ''1280x720'' will not improve performance in any way.
|-
|-
|'''Default Resolution'''||1280x720||This setting will be ignored if the Resolution Scale is set to anything other than 100%. Leave this on 1280x720, every PS3 game is compatible with this resolution. Only use 1920x1080 if the game supports it.
|'''Resolution scale'''||100%||Scales the game's resolution by the given percentage of the base resolution set in the above option. Set this value to 100% if you want to use the normal resolution. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|-
|'''Resolution Scale'''||100%||Scales the game's resolution by the given percentage. The base resolution is always 1280x720. Set this value to 100% if you want to use the normal resolution options.
|'''Resolution scale threshold'''||16 x 16||Only framebuffers greater than this size will be upscaled. Increasing this value might fix problems with missing graphics when upscaling, especially when Write Color Buffers is enabled. Do not touch this setting if you are unsure. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|-
|'''Resolution Scale Threshold'''||16 x 16||Only framebuffers greater than this size will be upscaled. Increasing this value might fix problems with missing graphics when upscaling, especially when Write Color Buffers is enabled. Do not touch this setting if you are unsure.
|'''Write color buffers'''||Off||Enable this option if you get missing graphics or broken lighting ingame. <br>Might degrade performance and introduce stuttering in some cases.
|-
|-
|'''Write Color Buffer'''||Off||Enable this option if you get missing graphics or broken lighting ingame. <br/>Might degrade performance and introduce stuttering in some cases.
|'''Strict rendering mode'''||Off||Enforces strict compliance to the API specification. Might result in degraded performance in some games. Can resolve rare cases of missing graphics and flickering. <br>Overrides settings for ''Resolution Scale'' and ''Resolution Scale Threshold'' and enforces default values. <br>It is meant to disable all the shortcuts in the rendering path, and as such it trades speed and resolution options for the enhanced compatibility.
|-
|-
|'''Use GPU Texture Scaling'''||On||Small to significant performance boost in most games and rarely with side effects. <br/>May cause texture corruption in rare cases.
|'''VSync'''||Off||By having this off you might obtain a higher frame rate at the cost of tearing artifacts in the game.
|-
|-
|'''Strict Rendering Mode'''||Off||Enforces strict compliance to the API specification. Might result in degraded performance in some games. Can resolve rare cases of missing graphics and flickering. Enforces default settings for Resolution Scale and Resolution Scale Threshold. If unsure, don't use this option.
|'''Stretch to display area'''||Off||Overrides the aspect ratio and stretches the image to the full display area.
|-
|-
|'''VSync'''||Off||By having this off you might obtain a higher frame rate at the cost of tearing artifacts in the game.
|'''Disable vertex cache'''||Off||Disables the vertex cache. Might resolve missing or flickering graphics output. May degrade performance.
|-
|-
|'''Stretch To Display Area'''||Off||Overrides the aspect ratio and stretches the image to the full display area.
|'''Multithreaded RSX'''||Off||Offloads some RSX operations to a secondary thread. <br>May improve performance for some high-core processors. May cause slowdown in some situations due to the extra worker thread load.
|-
|-
|'''Disable Vertex Cache'''||Off||Disables the vertex cache. Might resolve missing or flickering graphics output. May degrade performance.
|'''Disable Async shader compiler'''||Off||Disables asynchronous shader compilation. Fixes missing graphics while shaders are compiling, but introduces stuttering. <br>Disable if you do not want to deal with graphics pop-in, or for testing before filing any bug reports.
|}
|}


==Audio configuration==
==Audio configuration==
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
! Description
|-
|-
|'''Audio Out'''||'''Windows''': XAudio2 <br/>'''Linux''': PulseAudio||'''Windows''': Always use XAudio, no exceptions. <br/>'''Linux''': PulseAudio uses the recommended native Linux sound system and has good compatibility and sound quality. If it is unavailable on your system, ALSA is the next best alternative. <br/>OpenAL uses a cross-platform approach but will have poor audio quality and stuttering sound in most games.
|'''Audio output (Windows)'''||XAudio2||XAudio2 is the recommended option and should be used whenever possible. <br>OpenAL uses a cross-platform approach and is the next best alternative.
|-
|-
|'''Dump to File'''||Off||Saves all audio as a raw wave file. If unsure, leave this unchecked.
|'''Audio output (Linux)'''||OpenAL||OpenAL uses a cross-platform approach and supports audio buffering, so it is the recommended option. <br>PulseAudio uses the native Linux sound system, and is the next best alternative. If neither are available, ALSA can be used instead.
|-
|'''Dump to file'''||Off||Saves all audio as a raw wave file. If unsure, leave this unchecked.
|-
|-
|'''Convert to 16-bit'''||Off||Uses 16-bit audio samples instead of default 32-bit floating point. Use with buggy audio drivers if you have no sound or completely broken sound.
|'''Convert to 16-bit'''||Off||Uses 16-bit audio samples instead of default 32-bit floating point. Use with buggy audio drivers if you have no sound or completely broken sound.
|-
|-
|'''Downmix to Stereo'''||On||Uses stereo audio output instead of default 7.1 surround sound. Use with stereo audio devices. Disable it only if you are using a surround sound audio system.
|'''Downmix to stereo'''||On||Uses stereo audio output instead of default 7.1 surround sound. Use with stereo audio devices. <br>Disable it only if you are using a surround sound audio system.
|-
|'''Volume'''||100%||Controls the overall volume of the emulation. Values above 100% might reduce the audio quality. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|'''Enable buffering'''||On||Enables audio buffering, which reduces crackle and stutter but increases audio latency (requires XAudio2 or OpenAL).
|-
|'''Audio buffer duration'''||100ms||Target buffer duration in milliseconds. Higher values make the buffering algorithm's job easier, but may introduce noticeable audio latency. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|'''Enable time stretching'''||Off||Reduces crackle and stutter further, but may cause a very noticeable reduction in audio quality on slower CPUs. <br>Requires audio buffering to be enabled.
|-
|'''Time stretching threshold'''||75%||Buffer fill level (in percentage) below which time stretching will start. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|'''Microphone type'''||Null||Standard should be used for most games. <br>Singstar emulates a singstar device and should be used with Singstar games. <br>Real Singstar should only be used with a REAL Singstar device with Singstar games. <br>Rocksmith should be used with a Rocksmith dongle.
|}
|}


==I/O configuration==
==I/O configuration==
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
! Description
|-
|-
|'''Keyboard Handler'''||Null||Some games support native keyboard input. Basic will work in these cases.
|'''Keyboard handler'''||Null||Some games support native keyboard input. Basic will work in these cases.
|-
|'''Mouse handler'''||Basic||Some games support native mouse input. Basic will work in these cases.
|-
|-
|'''Mouse Handler'''||Basic||Some games support native mouse input. Basic will work in these cases.
|'''Camera input'''||Unknown||Camera support is not implemented, leave this on unknown.
|-
|-
|'''Camera Input'''||Unknown||Camera support is not implemented, leave this on unknown.
|'''Camera settings'''||Null||Camera support is not implemented, leave this on null.
|-
|-
|'''Camera Settings'''||Null||Camera support is not implemented, leave this on null.
|'''Move handler'''||Null||PlayStation Move support is not implemented, leave this on null. <br>'''Fake''': Experimental! This maps Move controls to DS4 controller mappings.
|}
|}


==System configuration==
==System configuration==
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
! Description
|-
|-
|'''Console Language'''||Japanese||Some games may fail to boot if the system language is not available in the game itself. Other games will switch language automatically to what is selected here. It is recommended leaving this on a language supported by the game.
|'''Console language'''||English (US)||Some games may fail to boot if the system language is not available in the game itself. Other games will switch language automatically to what is selected here. <br>It is recommended leaving this on a language supported by the game.
|-
|'''Console region'''||NA||Doesn't exist (yet).
|-
|'''Enter button assignment'''||Enter with cross||The button used for enter/accept/confirm in system dialogs. You can change this to use the circle button instead, which is the default configuration on Japanese systems and in many Japanese games. <br>In these cases, having the cross button assigned can often lead to confusion.
|-
|'''Clear disk cache automatically'''||Off||Automatically removes older files from disk cache on boot if it grows larger than the specified value. Games can use the cache folder to temporarily store data outside of system memory. It is not used for long-term storage. <br>Default wipe size is set to 5120MB. <br>Note that you can use keyboard arrow keys for precise changes on the slide bars.
|-
|'''Keyboard type'''||English keyboard (US Standard)||Sets the used keyboard layout. Currently only US, Japanese and German layouts are fully supported.
|-
|-
|'''Homebrew: Enable /host_root/'''||Off||Required for some Homebrew. If unsure, don't use this option.
|'''Homebrew: Enable /host_root/'''||Off||Required for some Homebrew. If unsure, don't use this option.
|}
==Network configuration==
{| class="wikitable"
! Setting
! Default Option
! Description
|-
|-
|'''Console Region'''||NA||Doesn't exist (yet).
|'''Network status'''||Disconnected||Leave as disconnected unless you're debugging. RPCS3 has no online support.
|}
|}


==Network configuration==
==Advanced configuration==
{| class="wikitable" style="font-size:90%;"
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! Description
|-
|'''Debug console mode'''||Off||Increases the amount of usable system memory to match a DECR console and more. <br>Causes some software to behave differently than on retail hardware.
|-
|'''Sleep Timers Accuracy'''||Usleep only||Changes the sleep period accuracy.<br>'''As Host''' uses default accuracy of the underlying operating system, while '''All Timers''' attempts to improve it.<br>'''Usleep Only''' limits the adjustments to usleep syscall only.<br>Can affect perfomance in unexpected ways.
|-
|'''Maximum number of SPURS threads'''||Unlimited||Limits the maximum number of SPURS threads in each thread group. May improve performance in some cases, especially on systems with limited number of hardware threads. <br>Limiting the number of threads is also likely to cause crashes. It's recommended to keep this at default value.
|-
|'''Firmware settings'''||Load liblv2.sprx only||'''Load liblv2.sprx only''': Closely emulates how games can load and unload system module files on a real PlayStation 3. <br>'''Automatically load required libraries''': Automatically selects the LLE libraries to load. While this option works fine in most cases, liblv2 is the preferred option. <br>'''Manually load selected libraries''': Allows the user to manually choose the LLE libraries to load. If unsure, don't use this option. Nothing will work if you use this incorrectly. <br>'''Load automatic and manual selection''': Automatically selects the LLE libraries to load and allows the user to choose additional libraries manually. If unsure, don't use this option.
|-
|'''Read depth buffers'''||Off||Initializes render target memory using vm memory.
|-
|'''Write depth buffers'''||Off||Writes depth buffer values to vm memory.
|-
|'''Read color buffers'''||Off||Initializes render target memory using vm memory.
|-
|'''Disable on-disk shader cache'''||Off||Disables the loading and saving of shaders from and to the shader cache in the data directory.
|-
|'''VBlank frequency'''||60 Hz||Adjusts the frequency of vertical blanking signals that the emulator sends.<br>Affects timing of events which rely on these signals.<br>Only available on per-game configurations.
|-
|'''Clocks scale'''||100%||Changes the scale of emulated system time.<br>Affects software which uses system time to calculate things such as dynamic timesteps.<br>Only available on per-game configurations.
|}
 
==Debug configuration==
Below configurations are primarily used by developers. If unsure, don't use these options.
{| class="wikitable"
! Setting
! Default Option
! Description
! Description
|-
|-
|'''Network Status'''||Disconnected||Leave as disconnected unless you're debugging. RPCS3 has no online support.
|'''Use legacy OpenGL buffers'''||Off||Enables use of classic OpenGL buffers which allows capturing tools to work with RPCS3 e.g RenderDoc.
|-
|'''Debug output'''||Off||Enables the selected API's inbuilt debugging functionality. Will cause severe performance degradation especially with Vulkan.
|-
|'''Debug overlay'''||Off||Provides a graphical overlay of various debugging information.
|-
|'''Log shader programs'''||Off||Dump game shaders to file.
|-
|'''Use high precision Z-buffer'''||Off||Only useful when debugging differences in GPU hardware.
|-
|'''Disable ZCull occlusion queries'''||Off||Disables running occlusion queries. Minor to moderate performance boost. <br>Might introduce issues with broken occlusion e.g missing geometry and extreme pop-in.
|-
|'''Force CPU blit emulation'''||Off||Forces emulation of all blit and image manipulation operations on the CPU. <br>Requires 'Write Color Buffers' option to also be enabled in most cases to avoid missing graphics. <br>Significantly degrades performance but is more accurate in some cases. This setting overrides the 'GPU texture scaling' option.
|-
|'''Disable Vulkan memory allocator'''||Off||Disables the custom Vulkan memory allocator and reverts to direct calls to VkAllocateMemory/VkFreeMemory.
|-
|'''Disable FIFO reordering'''||Off||Disables RSX FIFO optimizations completely. Draws are processed as they are received by the DMA puller.
|-
|'''Strict texture flushing'''||Off||Forces texture flushing even in situations where it is not necessary/correct. <br>Known to cause visual artifacts, but useful for debugging certain texture cache issues.
|-
|'''Use GPU texture scaling'''||Off||Force all texture transfer, scaling and conversion operations on the GPU. <br>May cause texture corruption in some cases.
|-
|'''PPU debug'''||Off||Never use this.
|-
|'''SPU debug'''||Off||Never use this.
|-
|'''Set DAZ and FTZ'''||Off||Never use this.
|-
|'''Accurate GETLLAR'''||Off||Never use this.
|-
|'''Accurate PUTLLUC'''||Off||Never use this.
|-
|'''Hook static functions'''||Off||Allows to hook some functions like 'memcpy' replacing them with high-level implementations. <br>May do nothing or break things. Experimental.
|}
|}


==Legacy configuration==
==Legacy configuration==
Below are the configurations used for previous versions of the emulator. Refer to the linked pull request for a detailed description on why this setting was removed.
Below are the configurations used for previous versions of the emulator. Refer to the linked pull request for a detailed description on why this setting was removed.
{| class="wikitable" style="font-size:90%;"  
{| class="wikitable"
! style="width: 200px;"| Setting
! Setting
! style="width: 125px;"| Default Option
! Default Option
! style="width: 90px;"| Category
! Category
! style="width: 90px;"| Removed By
! Removed By
! Description
! Description
|-
|-
|'''Bind SPU Threads To Secondary Cores'''||Off||CPU||{{pr|4079}}||If your CPU has SMT (Hyper-Threading) SPU threads will run on these logical cores instead. Usually faster on an i3, possibly slower or no difference on an i7 or Ryzen.
|'''Bind SPU threads to secondary cores'''||Off||CPU||{{pr|4079}}||If your CPU has SMT (Hyper-Threading) SPU threads will run on these logical cores instead. <br>Usually faster on an i3, possibly slower or no difference on an i7 or Ryzen.
|-
|-
|'''Invalidate Cache Every Frame'''||Off||GPU||{{pr|3618}}||Enable this option if the game has broken shadows. May slightly degrade performance.
|'''Invalidate cache every frame'''||Off||GPU||{{pr|3618}}||Enable this option if the game has broken shadows. May slightly degrade performance.
|}
|}

Revision as of 07:39, 3 January 2020

Below is the default configuration for the emulator. Not all options mentioned below are mandatory. For example, options such as Resolution Scale and Anisotropic Filter can be increased if your graphics card can handle the additional load whereas Lower SPU Thread Priority should be used with weaker CPUs. For best performance, read the description for each option carefully and also refer to the specific configurations mentioned for each game page.

CPU configuration

Setting Default Option Description
PPU decoder LLVM Recompiler LLVM Recompiler: Recompiles the game's executable once before running it for the first time. By far the fastest option and should always be used. Should you face compatibility issues, fall back to one of the Interpreters and retry.
Interpreter (fast): The fastest interpreter. Trades accuracy for speed, and it very rarely breaks games even in comparison to the precise option. Try this if PPU LLVM Recompiler fails.
Interpreter (precise): The most accurate Interpreter, but very slow to play games with. You may try this as a last resort if you encounter odd bugs or crashes.
SPU decoder LLVM Recompiler LLVM Recompiler: Fastest option with very good compatibility. Recompiles the game's SPU LLVM cache before running which adds extra start-up time. If you experience issues, use the ASMJIT Recompiler.
ASMJIT Recompiler: Fast option with very good compatibility.
Interpreter (fast): Slower than the SPU ASMJIT Recompiler but significantly faster than Interpreter (precise). Games rarely need this option.
Interpreter (precise): Extremely slow but may fix broken graphics in some games.
Preferred SPU threads Auto Some SPU stages are sensitive to race conditions and allowing a limited number at a time helps alleviate performance stalls. Setting this to a smaller value might improve performance and reduce stuttering in some games.
Please note that the best value depends on the individual game and specific CPU being used, so users need to try different values themselves.
Leave this on Auto if performance is negatively affected when setting a small value.
Enable thread scheduler On Allows the emulator to manually schedule physical cores to run specific tasks on, instead of letting the OS handle it. Very useful for AMD Ryzen systems on Windows, where it can give huge performance gains.
Not recommended for Linux as the OS schedules the physical cores better on its own.
No effect on Intel CPUs.
Lower SPU thread priority Off Runs SPU threads with lower priority than PPU threads.
Usually faster on an i3 or i5, possibly slower or no difference on an i7 or Ryzen.
Enable SPU loop detection On Try to detect loop conditions in SPU kernels and use them as scheduling hints.
Improves performance and reduces CPU usage. May cause severe audio stuttering in rare cases.
SPU cache On Should normally stay enabled. Disable this if the cache becomes too large. Disabling it does not remove the existing cache.
Accurate xfloat Off Fixes bugs in various games at the cost of performance. This setting is only applied when SPU LLVM is active.
SPU block size Safe This option controls the SPU analyser, particularly the size of compiled units.
Mega and Giga modes may improve performance by tying smaller units together, decreasing the number of compiled units but increasing their size.
Use the Safe mode for maximum compatibility.
TSX instructions Enabled Enable usage of TSX instructions.
Needs to be forced on some Haswell or Broadwell CPUs. Forcing this on older Hardware can lead to system instability, use it with caution.

GPU configuration

Setting Default Option Description
Renderer OpenGL Vulkan is the fastest renderer while OpenGL is the most accurate renderer. If unsure, use Vulkan.
Should you have any compatibility issues when using Vulkan, fall back to OpenGL.
Graphics device NA On multi GPU systems select which GPU to use in RPCS3 when using Vulkan. This is not needed when using OpenGL.
Aspect ratio 16:9 Leave this on 16:9 unless you have a 4:3 monitor. Auto also works well, especially if you use a resolution that is not 720p.
Framelimit Off Most games have an inbuilt framelimit and adding RPCS3's limiter on-top of that will only hurt performance even if you're well below reaching the cap. Off is the best option as it performs faster.
Only use framelimiter if a game runs too fast without it. Some games will crash if the framerate is too high. If that happens, set value to anything other than Off.
Anisotropic filter Automatic Higher values increase sharpness of textures on sloped surfaces at the cost of GPU resources.
Setting it to 16x provides the best quality and can be done on any modern GPU. However, some games (such as Unreal Engine titles) may have visual artifacts.
In such cases, set it to Automatic to allow games to use their own inbuilt filtering methods.
There's not much reason to use a value below 16x as it will only look worse with the same performance and compatibility issues in certain games.
Anti-aliasing Auto Emulates PS3 multisampling layout.
Can fix some visual artifacts in some games.
Low to moderate performance hit depending on your GPU hardware.
Default resolution 1280x720 In most cases, do not change resolution in settings, leave it at 1280x720. Any other setting may result in compatibility issues and performance decrease.
If you wish to try setting the resolution higher to 1920x1080, you MUST check the compatible resolutions for the game from the game list to ensure that it can support such a resolution.
Forcing such resolution on games that do not support it will result in significant issues.
Using resolutions lower than 1280x720 will not improve performance in any way.
Resolution scale 100% Scales the game's resolution by the given percentage of the base resolution set in the above option. Set this value to 100% if you want to use the normal resolution.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Resolution scale threshold 16 x 16 Only framebuffers greater than this size will be upscaled. Increasing this value might fix problems with missing graphics when upscaling, especially when Write Color Buffers is enabled. Do not touch this setting if you are unsure.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Write color buffers Off Enable this option if you get missing graphics or broken lighting ingame.
Might degrade performance and introduce stuttering in some cases.
Strict rendering mode Off Enforces strict compliance to the API specification. Might result in degraded performance in some games. Can resolve rare cases of missing graphics and flickering.
Overrides settings for Resolution Scale and Resolution Scale Threshold and enforces default values.
It is meant to disable all the shortcuts in the rendering path, and as such it trades speed and resolution options for the enhanced compatibility.
VSync Off By having this off you might obtain a higher frame rate at the cost of tearing artifacts in the game.
Stretch to display area Off Overrides the aspect ratio and stretches the image to the full display area.
Disable vertex cache Off Disables the vertex cache. Might resolve missing or flickering graphics output. May degrade performance.
Multithreaded RSX Off Offloads some RSX operations to a secondary thread.
May improve performance for some high-core processors. May cause slowdown in some situations due to the extra worker thread load.
Disable Async shader compiler Off Disables asynchronous shader compilation. Fixes missing graphics while shaders are compiling, but introduces stuttering.
Disable if you do not want to deal with graphics pop-in, or for testing before filing any bug reports.

Audio configuration

Setting Default Option Description
Audio output (Windows) XAudio2 XAudio2 is the recommended option and should be used whenever possible.
OpenAL uses a cross-platform approach and is the next best alternative.
Audio output (Linux) OpenAL OpenAL uses a cross-platform approach and supports audio buffering, so it is the recommended option.
PulseAudio uses the native Linux sound system, and is the next best alternative. If neither are available, ALSA can be used instead.
Dump to file Off Saves all audio as a raw wave file. If unsure, leave this unchecked.
Convert to 16-bit Off Uses 16-bit audio samples instead of default 32-bit floating point. Use with buggy audio drivers if you have no sound or completely broken sound.
Downmix to stereo On Uses stereo audio output instead of default 7.1 surround sound. Use with stereo audio devices.
Disable it only if you are using a surround sound audio system.
Volume 100% Controls the overall volume of the emulation. Values above 100% might reduce the audio quality.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Enable buffering On Enables audio buffering, which reduces crackle and stutter but increases audio latency (requires XAudio2 or OpenAL).
Audio buffer duration 100ms Target buffer duration in milliseconds. Higher values make the buffering algorithm's job easier, but may introduce noticeable audio latency.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Enable time stretching Off Reduces crackle and stutter further, but may cause a very noticeable reduction in audio quality on slower CPUs.
Requires audio buffering to be enabled.
Time stretching threshold 75% Buffer fill level (in percentage) below which time stretching will start.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Microphone type Null Standard should be used for most games.
Singstar emulates a singstar device and should be used with Singstar games.
Real Singstar should only be used with a REAL Singstar device with Singstar games.
Rocksmith should be used with a Rocksmith dongle.

I/O configuration

Setting Default Option Description
Keyboard handler Null Some games support native keyboard input. Basic will work in these cases.
Mouse handler Basic Some games support native mouse input. Basic will work in these cases.
Camera input Unknown Camera support is not implemented, leave this on unknown.
Camera settings Null Camera support is not implemented, leave this on null.
Move handler Null PlayStation Move support is not implemented, leave this on null.
Fake: Experimental! This maps Move controls to DS4 controller mappings.

System configuration

Setting Default Option Description
Console language English (US) Some games may fail to boot if the system language is not available in the game itself. Other games will switch language automatically to what is selected here.
It is recommended leaving this on a language supported by the game.
Console region NA Doesn't exist (yet).
Enter button assignment Enter with cross The button used for enter/accept/confirm in system dialogs. You can change this to use the circle button instead, which is the default configuration on Japanese systems and in many Japanese games.
In these cases, having the cross button assigned can often lead to confusion.
Clear disk cache automatically Off Automatically removes older files from disk cache on boot if it grows larger than the specified value. Games can use the cache folder to temporarily store data outside of system memory. It is not used for long-term storage.
Default wipe size is set to 5120MB.
Note that you can use keyboard arrow keys for precise changes on the slide bars.
Keyboard type English keyboard (US Standard) Sets the used keyboard layout. Currently only US, Japanese and German layouts are fully supported.
Homebrew: Enable /host_root/ Off Required for some Homebrew. If unsure, don't use this option.

Network configuration

Setting Default Option Description
Network status Disconnected Leave as disconnected unless you're debugging. RPCS3 has no online support.

Advanced configuration

Setting Default Option Description
Debug console mode Off Increases the amount of usable system memory to match a DECR console and more.
Causes some software to behave differently than on retail hardware.
Sleep Timers Accuracy Usleep only Changes the sleep period accuracy.
As Host uses default accuracy of the underlying operating system, while All Timers attempts to improve it.
Usleep Only limits the adjustments to usleep syscall only.
Can affect perfomance in unexpected ways.
Maximum number of SPURS threads Unlimited Limits the maximum number of SPURS threads in each thread group. May improve performance in some cases, especially on systems with limited number of hardware threads.
Limiting the number of threads is also likely to cause crashes. It's recommended to keep this at default value.
Firmware settings Load liblv2.sprx only Load liblv2.sprx only: Closely emulates how games can load and unload system module files on a real PlayStation 3.
Automatically load required libraries: Automatically selects the LLE libraries to load. While this option works fine in most cases, liblv2 is the preferred option.
Manually load selected libraries: Allows the user to manually choose the LLE libraries to load. If unsure, don't use this option. Nothing will work if you use this incorrectly.
Load automatic and manual selection: Automatically selects the LLE libraries to load and allows the user to choose additional libraries manually. If unsure, don't use this option.
Read depth buffers Off Initializes render target memory using vm memory.
Write depth buffers Off Writes depth buffer values to vm memory.
Read color buffers Off Initializes render target memory using vm memory.
Disable on-disk shader cache Off Disables the loading and saving of shaders from and to the shader cache in the data directory.
VBlank frequency 60 Hz Adjusts the frequency of vertical blanking signals that the emulator sends.
Affects timing of events which rely on these signals.
Only available on per-game configurations.
Clocks scale 100% Changes the scale of emulated system time.
Affects software which uses system time to calculate things such as dynamic timesteps.
Only available on per-game configurations.

Debug configuration

Below configurations are primarily used by developers. If unsure, don't use these options.

Setting Default Option Description
Use legacy OpenGL buffers Off Enables use of classic OpenGL buffers which allows capturing tools to work with RPCS3 e.g RenderDoc.
Debug output Off Enables the selected API's inbuilt debugging functionality. Will cause severe performance degradation especially with Vulkan.
Debug overlay Off Provides a graphical overlay of various debugging information.
Log shader programs Off Dump game shaders to file.
Use high precision Z-buffer Off Only useful when debugging differences in GPU hardware.
Disable ZCull occlusion queries Off Disables running occlusion queries. Minor to moderate performance boost.
Might introduce issues with broken occlusion e.g missing geometry and extreme pop-in.
Force CPU blit emulation Off Forces emulation of all blit and image manipulation operations on the CPU.
Requires 'Write Color Buffers' option to also be enabled in most cases to avoid missing graphics.
Significantly degrades performance but is more accurate in some cases. This setting overrides the 'GPU texture scaling' option.
Disable Vulkan memory allocator Off Disables the custom Vulkan memory allocator and reverts to direct calls to VkAllocateMemory/VkFreeMemory.
Disable FIFO reordering Off Disables RSX FIFO optimizations completely. Draws are processed as they are received by the DMA puller.
Strict texture flushing Off Forces texture flushing even in situations where it is not necessary/correct.
Known to cause visual artifacts, but useful for debugging certain texture cache issues.
Use GPU texture scaling Off Force all texture transfer, scaling and conversion operations on the GPU.
May cause texture corruption in some cases.
PPU debug Off Never use this.
SPU debug Off Never use this.
Set DAZ and FTZ Off Never use this.
Accurate GETLLAR Off Never use this.
Accurate PUTLLUC Off Never use this.
Hook static functions Off Allows to hook some functions like 'memcpy' replacing them with high-level implementations.
May do nothing or break things. Experimental.

Legacy configuration

Below are the configurations used for previous versions of the emulator. Refer to the linked pull request for a detailed description on why this setting was removed.

Setting Default Option Category Removed By Description
Bind SPU threads to secondary cores Off CPU PR 4079 If your CPU has SMT (Hyper-Threading) SPU threads will run on these logical cores instead.
Usually faster on an i3, possibly slower or no difference on an i7 or Ryzen.
Invalidate cache every frame Off GPU PR 3618 Enable this option if the game has broken shadows. May slightly degrade performance.