ShuriZma
/
pcsx2
mirror of https://github.com/PCSX2/pcsx2.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Docs: Update FAQ

This commit is contained in:
TheTechnician27 2024-07-31 11:07:52 -05:00 committed by Ty
parent 2fea312187
commit ed9b82097d
5 changed files with 61 additions and 60 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
.github/workflows/scripts/linux/pcsx2-qt.metainfo.xml.in vendored
View File

@ -1,23 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0" encoding="UTF-8"?>
<!-- Uses the AppStream standard https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html -->
<component type="desktop"> <component type="desktop">
<id>net.pcsx2.PCSX2</id> <id>net.pcsx2.PCSX2</id>
<launchable type="desktop-id">net.pcsx2.PCSX2.desktop</launchable> <launchable type="desktop-id">net.pcsx2.PCSX2.desktop</launchable>
<metadata_license>CC0-1.0</metadata_license> <metadata_license>CC0-1.0</metadata_license>
<project_license>GPL-3.0</project_license> <project_license>GPL-3.0+</project_license>
<name>PCSX2</name> <name>PCSX2</name>
<developer_name>PCSX2</developer_name> <developer_name>PCSX2</developer_name>
<summary>PlayStation 2 Emulator</summary> <summary>PlayStation 2 Emulator</summary>
<description> <description>
<p>PCSX2 is a free and open-source PlayStation 2 (PS2) emulator. Its purpose is to emulate the PS2's hardware, using a combination of MIPS CPU Interpreters, Recompilers and a Virtual Machine which manages hardware states and PS2 system memory. This allows you to play PS2 games on your PC, with many additional features and benefits.</p> <p>PCSX2 is a free and open-source PlayStation 2 (PS2) emulator. Its purpose is to emulate the PS2's hardware, using a combination of MIPS CPU Interpreters, Recompilers, and a Virtual Machine which manages hardware states and PS2 system memory. This allows you to play PS2 games on your PC, with many additional features and benefits.</p>
<p>PlayStation 2 and PS2 are registered trademarks of Sony Interactive Entertainment. This application is not affiliated in any way with Sony Interactive Entertainment.</p> <p>PlayStation 2 and PS2 are registered trademarks of Sony Interactive Entertainment. This application is not affiliated in any way with Sony Interactive Entertainment.</p>
</description> </description>
<url type="homepage">https://pcsx2.net/</url> <url type="homepage">https://pcsx2.net/</url>
<url type="bugtracker">https://github.com/PCSX2/pcsx2/issues</url> <url type="bugtracker">https://github.com/PCSX2/pcsx2/issues</url>
<url type="donation">https://github.com/sponsors/PCSX2</url> <url type="donation">https://github.com/sponsors/PCSX2</url>
<url type="faq">https://pcsx2.net/docs/</url> <url type="faq">https://pcsx2.net/docs/</url>
<url type="help">https://discord.com/invite/TCz3t9k</url> <url type="help">https://pcsx2.net/discord</url>
<url type="translate">https://crowdin.com/project/pcsx2-emulator</url> <url type="translate">https://crowdin.com/project/pcsx2-emulator</url>
<url type="vcs-browser">https://github.com/PCSX2/pcsx2</url> <url type="vcs-browser">https://github.com/PCSX2/pcsx2</url>
<url type="contact">https://mastodon.social/@PCSX2</url>
<screenshots> <screenshots>
<screenshot type="default"> <screenshot type="default">
<image>https://raw.githubusercontent.com/PCSX2/pcsx2/master/.github/workflows/scripts/linux/flatpak/screenshots/screenshot1.png</image> <image>https://raw.githubusercontent.com/PCSX2/pcsx2/master/.github/workflows/scripts/linux/flatpak/screenshots/screenshot1.png</image>
@ -27,7 +29,7 @@
</screenshot> </screenshot>
</screenshots> </screenshots>
<content_rating type="oars-1.1"/> <content_rating type="oars-1.1"/>
<update_contact>stenzek_AT_gmail.com</update_contact> <update_contact>pcsx2_AT_pcsx2.net</update_contact>
<releases> <releases>
<release version="@GIT_VERSION@" date="@GIT_DATE@" /> <release version="@GIT_VERSION@" date="@GIT_DATE@" />
</releases> </releases>

97
pcsx2/Docs/PCSX2_FAQ.md
View File

@ -12,22 +12,22 @@ urlcolor: "cyan"
### Question 1: What is the purpose of the PCSX2 project? ### Question 1: What is the purpose of the PCSX2 project?
PCSX2 intends to emulate the PlayStation 2 console, allowing PS2 games to be played on a computer. This requires having an original PlayStation 2 console to supply a BIOS dump and the original games, either to be played directly off the disc or to be dumped and played as ISO/CSO images. PCSX2 intends to emulate the PlayStation 2 console, allowing PS2 games to be played on a computer. This requires having an original PlayStation 2 console to supply a BIOS dump and the original games, either to be played directly off the disc or to be dumped and played as ISO/CSO images.
### Question 2: Is PCSX2 open source? ### Question 2: Is PCSX2 open-source?
PCSX2 is open source, licensed under the GNU Lesser General Public License v3.0. [Source code is kept on GitHub](https://github.com/pcsx2/pcsx2). PCSX2 is free and open-source, licensed under the GNU General Public License v3.0+. [Source code is kept on GitHub](https://github.com/pcsx2/pcsx2).
### Question 3: How can I help the project? ### Question 3: How can I help the project?
There are a number of ways to help the project, whether it be bug reporting, game patching, or even writing code for the emulator itself. Some examples: There are a number of ways to help the project, whether it be bug reporting, game patching, or even writing code for the emulator itself. Some examples:
* Want to make changes to emulator code? [Check out the issue tracker](https://github.com/PCSX2/pcsx2/issues), or [fork the PCSX2 repository and work on your own ideas](https://github.com/PCSX2/pcsx2). * Want to make changes to emulator code? [Check out the issue tracker](https://github.com/PCSX2/pcsx2/issues), or [fork the PCSX2 repository and work on your own ideas](https://github.com/PCSX2/pcsx2).
* Want to patch games? [Check out the cheats and patches forum thread for inspiration](https://forums.pcsx2.net/Thread-Post-your-PCSX2-cheats-patches-here). There are other threads to find as well, [such as those dedicated to 60 FPS patches](https://forums.pcsx2.net/Thread-60-fps-codes) or [widescreen patches](https://forums.pcsx2.net/Thread-PCSX2-Widescreen-Game-Patches). * Want to patch games? [Check out the cheats and patches forum thread for inspiration](https://forums.pcsx2.net/Thread-Post-your-PCSX2-cheats-patches-here). There are other threads to find as well, [such as those dedicated to 60 FPS patches](https://forums.pcsx2.net/Thread-60-fps-codes) or [widescreen patches](https://forums.pcsx2.net/Thread-PCSX2-Widescreen-Game-Patches).
* Want to report bugs you have discovered in your games? [Head over to the Bug Reporting section of the PCSX2 forums](https://forums.pcsx2.net/Forum-Bug-reporting). Also check out our [GitHub issue guidelines](https://github.com/PCSX2/pcsx2/wiki/How-to-create-useful-and-valid-issues) for info on how we handle GitHub issues. * Want to report bugs you have discovered in your games? Head over to [the Bug Reporting section of the PCSX2 forums](https://forums.pcsx2.net/Forum-Bug-reporting), to [the PCSX2 Discord](https://pcsx2.net/discord), or to [the GitHub issues section](https://github.com/PCSX2/pcsx2/issues).
* Want to update us on the compatibility of your games? [Take a look at the Public Compatibility List on the PCSX2 forums](https://forums.pcsx2.net/Forum-Public-compatibility-list) * Want to update us on the compatibility of your games? [Take a look at the Public Compatibility List on the PCSX2 forums](https://forums.pcsx2.net/Forum-Public-compatibility-list)
* Want to improve the PCSX2 wiki? [Here is how to contribute](https://wiki.pcsx2.net/Help!_How_to_contribute_guide) * Want to improve the PCSX2 wiki? [Here is how to contribute](https://wiki.pcsx2.net/How_to_contribute)
### Question 4: Is PCSX2 ready to run out-of-the-box? ### Question 4: Is PCSX2 ready to run out-of-the-box?
No, first, you must dump your PlayStation 2 console's BIOS using the BIOS dumper. The BIOS dumper is [available on the PCSX2 website](https://pcsx2.net/docs/usage/setup/gather/). No. First, you must dump your PlayStation 2 console's BIOS using the BIOS dumper. Instructions for the BIOS dumper are [available on the PCSX2 website](https://pcsx2.net/docs/setup/bios).
After dumping your PlayStation 2 console's BIOS and copying it to your computer, launch PCSX2, step through the first time setup wizard, and then you may begin playing. After dumping your PlayStation 2 console's BIOS and copying it to your computer, launch PCSX2, step through the first-time setup wizard, and then you may begin playing.
<div class="page"/> <!-- Because PDFs are terrible --> <div class="page"/> <!-- Because PDFs are terrible -->
@ -40,7 +40,7 @@ After dumping your PlayStation 2 console's BIOS and copying it to your computer,
| Operating System | CPU | GPU | RAM | | Operating System | CPU | GPU | RAM |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| - Windows 7 or newer (32 or 64 bit) <br/> - Ubuntu 18.04/Debian or newer, Arch Linux, or other distro (32 or 64 bit) | - Supports SSE2 <br/> - [PassMark Single Thread Performance](https://www.cpubenchmark.net/singleThread.html) rating near or greater than 1600 <br/> - Two physical cores, with hyperthreading | - Direct3D10 support <br/> - OpenGL 3.x support <br/> - [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 3000 (GeForce GTX 750) <br/> - 2 GB Video Memory | 4 GB | | - Windows 10 Version 1809 or newer (64-bit) <br/> - Ubuntu 22.04/Debian or newer, Arch Linux, Fedora, or other distro (64-bit) <br/> - macOS 11.0 (Big Sur) or newer | - SSE4.1 support <br/> - [PassMark Single Thread Performance](https://www.cpubenchmark.net/singleThread.html) rating near or greater than 1500 <br/> - Two physical cores, with simultaneous multithreading (SMT) | - Direct3D11 (Feature Level 10.0) support <br/> - OpenGL 3.3 support <br/> - Vulkan 1.1 support <br/> - [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 3000 (GeForce GTX 750, Radeon RX 560, Intel Arc A380) <br/> - 2 GB Video Memory | 8 GB |
*Note: Recommended Single Thread Performance is based on moderately complex games. Games that pushed the PS2 hardware to its limits will struggle on CPUs at this level. Some release titles and 2D games which underutilized the PS2 hardware may run on CPUs rated as low as 1200. A quick reference for CPU **intensive games**: [Wiki](https://wiki.pcsx2.net/Category:CPU_intensive_games), [Forum](https://forums.pcsx2.net/Thread-LIST-The-Most-CPU-Intensive-Games) and CPU **light** games: [Forum](https://forums.pcsx2.net/Thread-LIST-Games-that-don-t-need-a-strong-CPU-to-emulate)* *Note: Recommended Single Thread Performance is based on moderately complex games. Games that pushed the PS2 hardware to its limits will struggle on CPUs at this level. Some release titles and 2D games which underutilized the PS2 hardware may run on CPUs rated as low as 1200. A quick reference for CPU **intensive games**: [Wiki](https://wiki.pcsx2.net/Category:CPU_intensive_games), [Forum](https://forums.pcsx2.net/Thread-LIST-The-Most-CPU-Intensive-Games) and CPU **light** games: [Forum](https://forums.pcsx2.net/Thread-LIST-Games-that-don-t-need-a-strong-CPU-to-emulate)*
@ -48,22 +48,28 @@ After dumping your PlayStation 2 console's BIOS and copying it to your computer,
| Operating System | CPU | GPU | RAM | | Operating System | CPU | GPU | RAM |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| - Windows 10 (64 bit) <br/> - Ubuntu 19.04/Debian or newer, Arch Linux, or other distro (64 bit) | - Supports AVX2 <br/> - [PassMark Single Thread Performance](https://www.cpubenchmark.net/singleThread.html) rating near or greater than 2100 <br/> - Four physical cores, with or without hyperthreading | - Direct3D11 support <br/> - OpenGL 4.5 support <br/> - [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 6000 (GeForce GTX 1050 Ti) <br/> - 4 GB Video Memory | 8 GB | | - Windows 10 Version 22H2 (64-bit) or newer <br/> - Ubuntu 24.04/Debian or newer, Arch Linux, Fedora, or other distro (64-bit) <br/> - macOS 11.0 (Big Sur) or newer | - AVX2 support <br/> - [PassMark Single Thread Performance](https://www.cpubenchmark.net/singleThread.html) rating near or greater than 2000 <br/> - Four or more physical cores, with or without simultaneous multithreading (SMT) | - Direct3D12 support <br/> - OpenGL 4.6 support <br/> - Vulkan 1.3 support <br/> - Metal Support (macOS only) <br/> - [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 6000 (GeForce GTX 1650, Radeon RX 570) <br/> - 4 GB Video Memory | 16 GB |
*Note: Recommended GPU is based on 3x Internal, ~1080p resolution requirements. Higher resolutions will require stronger cards; 6x Internal, ~4K resolution will require a [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 12000 (GeForce GTX 1070 Ti). Just like CPU requirements, this is also highly game dependent. A quick reference for GPU **intensive games**: [Wiki](https://wiki.pcsx2.net/Category:GPU_intensive_games)* *Note: Recommended GPU is based on 3x Internal, ~1080p resolution requirements. Higher resolutions will require stronger cards; 6x Internal, ~4K resolution will require a [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 12000 (GeForce GTX 1070 Ti). Just like CPU requirements, this is also highly game dependent. A quick reference for GPU **intensive games**: [Wiki](https://wiki.pcsx2.net/Category:GPU_intensive_games)*
### Question 6: How many CPU cores can PCSX2 use? #### Heavy
By default, PCSX2 uses two cores for emulation. Enabling the MTVU speedhack allows the PS2's VU1 coprocessor to run on a third core, which is safe for most games.
Software rendering can be set to use as many or as few rendering threads as desired. We recommend using no more than 8, or the number of cores (including hyperthreads) that your CPU has, whichever is the lower number. | Operating System | CPU | GPU | RAM |
| --- | --- | --- | --- |
| - Windows 10 Version 22H2 (64-bit) or newer <br/> - Ubuntu 24.04/Debian or newer, Arch Linux, Fedora, or other distro (64-bit) <br/> - macOS 11.0 (Big Sur) or newer | - AVX2 support <br/> - [PassMark Single Thread Performance](https://www.cpubenchmark.net/singleThread.html) rating near or greater than 2600 <br/> - Six or more physical cores with simultaneous multithreading (SMT) | - Direct3D12 support <br/> - OpenGL 4.6 support <br/> - Vulkan 1.3 support <br/> - Metal support (macOS only) <br/> - [PassMark G3D Mark](https://www.videocardbenchmark.net/high_end_gpus.html) rating around 6000 (GeForce RTX 3050, Radeon RX 5600XT) <br/> - 4 GB Video Memory | 16 GB |
### Question 6: How many CPU cores can PCSX2 use?
By default, PCSX2 uses two cores for emulation. Enabling the MTVU speedhack allows the PS2's VU1 coprocessor to run on a third core, which is safe for most games and is generally enabled by default if possible on your CPU.
Software rendering can be set to use as many or as few rendering threads as desired. We recommend using no more than 8, or the number of cores (or SMT threads) that your CPU has, whichever is the lower number.
<div class="page"/> <!-- Because PDFs are terrible --> <div class="page"/> <!-- Because PDFs are terrible -->
### Question 7: Why isn't my CPU not using 100% of its power? ### Question 7: Why is my CPU not using 100% of its power?
The CPU load as reported in software such as Windows' Task Manager is usually a *summation* of CPU usage, across *all* cores. Software can only use the resources of the individual CPU cores it is actually running on, and cannot "borrow" CPU time from other cores. The CPU load as reported in software such as Windows' Task Manager is usually a *summation* of CPU usage, across *all* cores. Software can only use the resources of the individual CPU cores it is actually running on, and cannot "borrow" CPU time from other cores.
### Question 8: Will SLI or Crossfire help with performance? ### Question 8: Will multi-GPU (Nvidia SLI or AMD CrossFire) help with performance?
No. PCSX2 does not use or require SLI or Crossfire. No. PCSX2 does not use or require multi-GPU.
### Question 9: How do I check if a game is playable? ### Question 9: How do I check if a game is playable?
The PCSX2 website has a [compatibility list](https://pcsx2.net/compat/) with every game that has been tested. The PCSX2 website has a [compatibility list](https://pcsx2.net/compat/) with every game that has been tested.
@ -71,7 +77,7 @@ The PCSX2 website has a [compatibility list](https://pcsx2.net/compat/) with eve
### Question 10: Do PS1 (PSX) games work on PCSX2? ### Question 10: Do PS1 (PSX) games work on PCSX2?
#### If you want to enjoy your PS1 games without issues: #### If you want to enjoy your PS1 games without issues:
No, they will not work without issues. Please use a proper PS1 emulator, such as Duckstation or Mednafen. No, they will not work without issues. Please use a proper PS1 emulator, such as DuckStation or Mednafen.
#### If you are a tinkerer and like to break things: #### If you are a tinkerer and like to break things:
PS1 games may work on PCSX2, but compatibility is very limited. Specific settings are often required to get a game to boot, and there are other universal problems including missing/pitch-shifted audio and severe FMV corruption. A [forum thread for PS1 compatibility](https://forums.pcsx2.net/Thread-PSX-Mode-Unofficial-Compatibility-List) is tracking some fixes and compatibility reports. PS1 games may work on PCSX2, but compatibility is very limited. Specific settings are often required to get a game to boot, and there are other universal problems including missing/pitch-shifted audio and severe FMV corruption. A [forum thread for PS1 compatibility](https://forums.pcsx2.net/Thread-PSX-Mode-Unofficial-Compatibility-List) is tracking some fixes and compatibility reports.
@ -79,13 +85,13 @@ PS1 games may work on PCSX2, but compatibility is very limited. Specific setting
*While we encourage discussion about PS1 games and improving compatibility, bug reports are NOT being accepted for PS1 games. Any reports for PS1 games will be closed immediately as invalid.* *While we encourage discussion about PS1 games and improving compatibility, bug reports are NOT being accepted for PS1 games. Any reports for PS1 games will be closed immediately as invalid.*
### Question 11: Why does my game not work like it did in an earlier PCSX2 version? ### Question 11: Why does my game not work like it did in an earlier PCSX2 version?
Any change to the emulator may fix one game, but cause problems for another. If the issue is severe and not fixable with different settings, you can always revert back to the last known PCSX2 version to work, and report the build number that broke the game. [Development builds](https://pcsx2.net/download/development.html) are very helpful for finding the exact change that caused a regression. Any change to the emulator may fix one game, but cause problems for another. If the issue is severe and not fixable with different settings, you can always revert back to the last known PCSX2 version to work, and report the build number that broke the game. [Development builds](https://pcsx2.net/downloads/) are very helpful for finding the exact change that caused a regression.
### Question 12: Why is PCSX2 slow? ### Question 12: Why is PCSX2 slow?
The PlayStation 2 is a complex console, and this substantially raises the PC requirements to emulate it at full speed accurately. [This forum thread](https://forums.pcsx2.net/Thread-Why-is-PCSX2-slow) helps explain some of the technical reasons behind it, and our current guidelines for PC requirements are listed above. The PlayStation 2 is a complex console, and this substantially raises the PC requirements to emulate it at full speed accurately. [This forum thread](https://forums.pcsx2.net/Thread-Why-is-PCSX2-slow) helps explain some of the technical reasons behind it, and our current guidelines for PC requirements are listed above.
### Question 13: Where do I get a PS2 BIOS? ### Question 13: Where do I get a PS2 BIOS?
You have to dump the BIOS files from your PlayStation 2 console. There is a BIOS dumper tool [available on the PCSX2 website](https://pcsx2.net/docs/usage/setup/gather/) to do this. If you need a guide, check the bottom of this FAQ for links to BIOS guides. You have to dump the BIOS files from your PlayStation 2 console. There is a BIOS dumper tool [available on the PCSX2 website](https://pcsx2.net/docs/setup/bios) to do this. If you need a guide, check the bottom of this FAQ for links to BIOS guides.
<div class="page"/> <!-- Because PDFs are terrible --> <div class="page"/> <!-- Because PDFs are terrible -->
@ -93,33 +99,30 @@ You have to dump the BIOS files from your PlayStation 2 console. There is a BIOS
You can use games from your personal collection of discs, purchase them from local stores that resell old games, or look online at sites like eBay or Amazon. You can use games from your personal collection of discs, purchase them from local stores that resell old games, or look online at sites like eBay or Amazon.
### Question 15: Can I use PS2 discs directly with PCSX2? ### Question 15: Can I use PS2 discs directly with PCSX2?
Yes. However, some games have speed problems, because unlike the PS2 which would constantly keep the disc spinning, PCSX2 will not do the same to your PC's disc drive. It is recommended to instead dump your games to ISO images. ImgBurn is a popular software to do this with, and we recommend [installing ImgBurn by using Ninite](https://ninite.com) to avoid any issues with the ImgBurn installer. Yes. However, some games have speed problems, because unlike the PS2 which would constantly keep the disc spinning, PCSX2 will not do the same to your PC's disc drive. It is recommended to instead dump your games to ISO images. You can find a guide for this [on the PCSX2 website](https://pcsx2.net/docs/setup/dumping).
### Question 16: How do I play a game? ### Question 16: How do I play a game?
If you are using an ISO image: If you are using an ISO image:
1) Click the CDVD menu 1) Click System > Start File.
2) Check that "ISO" mode is selected. 2) Locate and click on the ISO image.
3) Go to "ISO Selector", then Browse.
4) Locate your ISO image. If you wish to have your ISO image(s) populate in the game list:
5) Click the System menu, then Boot ISO. 1) Click Settings > Game List.
2) Add the directory where you keep your games if not added already.
3) It is recommended but not required that you scan this directory recursively.
If you are using a disc: If you are using a disc:
1) Click the CDVD menu 1) Click System > Start Disc.
2) Check that "Disc" mode is selected.
3) Go to "Drive Selector", then select your drive.
4) Click the System menu, then Boot CDVD.
### Question 17: What is Fast Boot? ### Question 17: What is Fast Boot?
Normally, PCSX2 will launch the PS2 BIOS, which will then launch the game. Some games need this for multi-language settings or times to work. Fast Boot, enabled by default, will directly mount and launch the game without first launching the PS2 BIOS. You may disable this in Settings > BIOS > Fast Boot if you wish to see the BIOS startup animation or if Fast Boot is causing an issue.
Fast Boot will directly mount and launch the game without first launching the PS2 BIOS. On versions 1.6 and below, this may cause some multi-language games to boot into the wrong language.
### Question 18: How do I build the PCSX2 source code? ### Question 18: How do I build the PCSX2 source code?
* [Windows build guide](https://github.com/PCSX2/pcsx2/wiki/Setting-up-the-PCSX2-repository-on-Windows) * [Windows build guide](https://github.com/PCSX2/pcsx2/wiki/12-Building-on-Windows)
* [MacOS build guide](https://github.com/PCSX2/pcsx2/wiki/Building-on-MacOS) * [Linux build guide](https://github.com/PCSX2/pcsx2/wiki/10-Building-on-Linux)
* [Linux build guide](https://github.com/PCSX2/pcsx2/wiki/Installing-on-Linux) * [macOS build guide](https://github.com/PCSX2/pcsx2/wiki/11-Building-on-MacOS)
### Question 19: When will the next version be released? ### Question 19: When will the next version be released?
It will be released when it is ready. Please don't waste your time and ours asking when. It will be released when it is ready. Please don't waste your time and ours asking when.
@ -138,8 +141,6 @@ The framelimiter has a few options that allow you to alter the pacing of your ga
* Slowmo (Shift + Tab): Drops the framelimiter to 50%, restricting a game to 0.5x its normal speed. * Slowmo (Shift + Tab): Drops the framelimiter to 50%, restricting a game to 0.5x its normal speed.
* Framelimiter Disabled (F4): Completely disables the framelimiter. The game will run as fast as your PC can push it. * Framelimiter Disabled (F4): Completely disables the framelimiter. The game will run as fast as your PC can push it.
Some settings are greyed out. These are advanced counters that should only be modified by those who understand the effects they have on a game's playback speed and frame pacing.
### Question 22: What is the normal speed for a PlayStation 2 game? ### Question 22: What is the normal speed for a PlayStation 2 game?
* NTSC games will play at 59.94 FPS * NTSC games will play at 59.94 FPS
* PAL games will play at 50 FPS * PAL games will play at 50 FPS
@ -148,37 +149,35 @@ Some settings are greyed out. These are advanced counters that should only be mo
These framerates are what the PlayStation 2 console would push to a real TV through its video cable. A game itself, typically, internally generates only half of those frames, and repeats frames to fill the gaps. This is why a "full speed" game may not "feel like 60 FPS". The console's "speed" (meaning AI, sound, physics, *everything*) is tied to the playback framerate, which is what PCSX2 reports as its "FPS". These framerates are what the PlayStation 2 console would push to a real TV through its video cable. A game itself, typically, internally generates only half of those frames, and repeats frames to fill the gaps. This is why a "full speed" game may not "feel like 60 FPS". The console's "speed" (meaning AI, sound, physics, *everything*) is tied to the playback framerate, which is what PCSX2 reports as its "FPS".
### Question 23: What are Gamefixes? ### Question 23: What are Gamefixes?
Gamefixes are specialized fixes built into PCSX2 for specific games. Gamefixes mostly fix core emulation problems that would crash or soft lock a game, rather than graphical or performance issues. By default, the "System > Automatic Gamefixes" option is enabled, meaning any games that need gamefixes will have them automatically applied, regardless of what gamefix settings you have enabled. Gamefixes are specialized fixes built into PCSX2 for specific games. Gamefixes mostly fix core emulation problems that would crash or soft lock a game, rather than graphical or performance issues. By default, these are automatically enabled, meaning any games that need gamefixes will have them automatically applied, regardless of what gamefix settings you have enabled.
Most games will not need gamefixes, however if your game is having issues, you can try manually enabling them in Emulation Settings. Most games will not need gamefixes, however if your game is having issues, you can try manually enabling them in Settings > Game Properties > Game Fixes.
Gamefixes are not FPS boosters; more often than not, they will degrade performance slightly. Gamefixes are not FPS boosters; more often than not, they will degrade performance slightly.
<div class="page"/> <!-- Because PDFs are terrible --> <div class="page"/> <!-- Because PDFs are terrible -->
### Question 24: Are Speedhacks safe? ### Question 24: What are all these EE/IOP and VU options?
As the name says, speedhacks are hacks to make things faster. They will speed up games, but risk causing stability problems or crashing some games. PCSX2 ships with some speedhacks enabled in the default "Safe" preset. This selection of speedhacks has been reviewed thoroughly and determined to be safe for nearly all games.
*Bug reports of issues caused by speedhacks will NOT be accepted, and will be immediately closed as invalid.*
### Question 25: What are all these EE/IOP and VU options?
The PS2 EE, IOP and VU processors are substantially different from a PC CPU and require different rounding and clamping modes to do math accurately. Most games work fine on the default options, but some games might need a different setting. You can check the [PCSX2 Wiki](https://wiki.pcsx2.net/Category:Games) to see if your game needs an alternate setting, or check the [PCSX2 Forums](https://forums.pcsx2.net/) to see if anyone else has posted about it there. The PS2 EE, IOP and VU processors are substantially different from a PC CPU and require different rounding and clamping modes to do math accurately. Most games work fine on the default options, but some games might need a different setting. You can check the [PCSX2 Wiki](https://wiki.pcsx2.net/Category:Games) to see if your game needs an alternate setting, or check the [PCSX2 Forums](https://forums.pcsx2.net/) to see if anyone else has posted about it there.
### Question 26: What are PCSX2 plugins? ### Question 25: What are PCSX2 plugins?
Older versions of PCSX2 used a plugin framework for various sections of the emulator. A plugin is a small, incomplete piece of software that, when plugged in to another piece of software, provides some sort of additional function. PCSX2 used to use plugins for: Older versions of PCSX2 used a plugin framework for various sections of the emulator. A plugin is a small, incomplete piece of software that, when plugged in to another piece of software, provides some sort of additional function. PCSX2 used to use plugins for:
* Video (GSdx) * Video (GSdx)
* Controls (Lilypad for Windows, OnePad for Linux) * Sound (SPU2-X)
* Controls (LilyPad for Windows, OnePad for Linux)
* CDVDGigzherz (CDVD)
* Dev9Gigaherz (DEV9)
* USB (No plugin included) * USB (No plugin included)
In newer versions, these have been merged into the main emulator, and there is no longer a way to load external plugins. In newer versions, these have been merged into the main emulator, and there is no longer a way to load external plugins.
### Question 27: Why is my sound garbled up? ### Question 26: Why is my sound garbled up?
PCSX2's default audio playback mode is Timestretch, which will attempt to stretch sounds out when the emulator is unable to play at full speed, to fill the gaps in the sound playback and prevent even harsher stutters. If you are unable to get the game running at full speed or an acceptable speed where timestretching does not ruin the sound, you can try changing from Timestretch to Async, but this may break games. Your device may simply be too slow to play the game. If you have changed settings, attempt to revert them to the default, as these are usually the fastest.
### Question 28: Is my controller supported? ### Question 27: Is my controller supported?
For Windows users, PCSX2 will ship with XInput bindings already created. This will automatically work with an Xbox One controller or any other XInput controller. Bindings can easily be made for DirectInput and XInput controllers, such as Xbox 360 controllers. PS3, PS4, or Switch Pro controllers should be set up using third party compatibility software, such as Steam's Big Picture mode. For Windows users, PCSX2 will ship with XInput bindings already created. This will automatically work with an Xbox One controller or any other XInput controller. Bindings can easily be made for DirectInput and XInput controllers, such as Xbox 360 controllers. PS3, PS4, or Switch Pro controllers should be set up using third party compatibility software, such as Steam's Big Picture mode.
For Linux users, PCSX2 will automatically detect and bind controls to any recognizable controller. For Linux and macOS users, PCSX2 will automatically detect and bind controls to any recognizable controller via SDL.
<div class="page"/> <!-- Because PDFs are terrible --> <div class="page"/> <!-- Because PDFs are terrible -->

6
tools/generate_update_fa_glyph_ranges.py
View File

@ -7,10 +7,10 @@ import re
import functools import functools
# PCSX2 - PS2 Emulator for PCs # PCSX2 - PS2 Emulator for PCs
# Copyright (C) 2002-2022 PCSX2 Dev Team # Copyright (C) 2002-2024 PCSX2 Dev Team
# #
# PCSX2 is free software: you can redistribute it and/or modify it under the terms # PCSX2 is free software: you can redistribute it and/or modify it under the terms
# of the GNU Lesser General Public License as published by the Free Software Found- # of the GNU General Public License as published by the Free Software Found-
# ation, either version 3 of the License, or (at your option) any later version. # ation, either version 3 of the License, or (at your option) any later version.
# #
# PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; # PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
@ -105,4 +105,4 @@ with open(dst_file, "r") as f:
f.write(updated) f.write(updated)
print("Updated {}".format(dst_file)) print("Updated {}".format(dst_file))
else: else:
print("Skipping updating {}".format(dst_file)) print("Skipping updating {}".format(dst_file))

4
tools/merge_ws_ni_patches.py
View File

@ -1,10 +1,10 @@
#!/usr/bin/env python3 #!/usr/bin/env python3
# PCSX2 - PS2 Emulator for PCs # PCSX2 - PS2 Emulator for PCs
# Copyright (C) 2024 PCSX2 Dev Team # Copyright (C) 2002-2024 PCSX2 Dev Team
# #
# PCSX2 is free software: you can redistribute it and/or modify it under the terms # PCSX2 is free software: you can redistribute it and/or modify it under the terms
# of the GNU Lesser General Public License as published by the Free Software Found- # of the GNU General Public License as published by the Free Software Found-
# ation, either version 3 of the License, or (at your option) any later version. # ation, either version 3 of the License, or (at your option) any later version.
# #
# PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; # PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

4
tools/texture_dump_alpha_scaler.py
View File

@ -7,10 +7,10 @@ import argparse
from PIL import Image from PIL import Image
# PCSX2 - PS2 Emulator for PCs # PCSX2 - PS2 Emulator for PCs
# Copyright (C) 2002-2022 PCSX2 Dev Team # Copyright (C) 2002-2024 PCSX2 Dev Team
# #
# PCSX2 is free software: you can redistribute it and/or modify it under the terms # PCSX2 is free software: you can redistribute it and/or modify it under the terms
# of the GNU Lesser General Public License as published by the Free Software Found- # of the GNU General Public License as published by the Free Software Found-
# ation, either version 3 of the License, or (at your option) any later version. # ation, either version 3 of the License, or (at your option) any later version.
# #
# PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; # PCSX2 is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;