-
Notifications
You must be signed in to change notification settings - Fork 31
/
faq.html
194 lines (192 loc) · 12.4 KB
/
faq.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
---
layout: default
texts: compatibility
---
<head>
{% include head.html %}
</head>
<section class="text-center text-white d-flex">
<div class="container my-auto">
<div class="row">
<div class="col-lg-10 mx-auto">
<h1>
<strong>FAQs</strong>
</h1>
<hr />
<br>
</div>
<div class="col-lg-8 mx-auto">
<p class="text-faded mb-1">Frequently asked questions.</p>
</div>
</div>
</div>
</section>
<section class="bg-dark text-white pb-5">
<div class="container">
<h3>What are the system requirements I need to run it?</h3>
<div class="my-5">
<h6>
The requirements for running Vita3K are still not fully known and may change a lot during its current development stage.
The absolute minimum requirements for running the program are:<br /><br />
</h6>
<div class="row justify-content-center">
<div class="col-lg-6 d-flex flex-column">
<strong>PC</strong>
<li>CPU: CPU with the AVX instruction set</li>
<li>GPU: An OpenGL 4.4 capable graphics</li>
<li>RAM: Minimum of 4GB RAM</li>
<li>OS: Windows 8/10/11, macOS and Linux (Must be a 64-bits OS)</li><br />
</div>
<div class="col-lg-6 d-flex flex-column">
<strong>Android</strong>
<li>CPU: An AArch64 CPU</li>
<li>GPU: Vulkan 1.0 support</li>
<li>OS: Android 7+</li><br />
</div>
</div>
<h6>
See the <a href="/quickstart.html">Quickstart</a> for more information.
</h6>
</div>
<h3>What is Vita3K and where can I get it?</h3>
<div class="my-5">
<h6>
Vita3K is an open-source experimental Sony PlayStation Vita emulator for Windows, macOS, Linux and Android written in C++.
It is currently capable of booting and playing commercial games. Please check the <a href="/compatibility.html">Compatibility List</a>.
The source code for Vita3K is hosted here on <a href="https://github.com/Vita3K/Vita3K/">GitHub</a>.
You may grab the latest compiled revisions in <a href="/index.html">Home Page</a>.
</h6>
</div>
<h3>Does Vita3K support commercial games?</h3>
<div class="my-5">
<h6>
<strong>Some</strong>. Please see <a href="/compatibility.html">Compatibility List</a>.
The emulator is in an early stage of development and a lot of features required to run many commercial games haven't been implemented yet.
Currently, many games made with GameMaker Engine work flawlessly.
More games will be supported when the hardware/firmware emulation is accurate enough to run them.
It all depends on the amount of developers working on this project, their skills, and free time, etc. Ignore any estimates and guesses you find out there.
</h6>
</div>
<h3>How to get games?</h3>
<div class="my-5">
<h6>
For homebrew, get them via <a href="https://vitadb.rinnegatamante.it/">VitaDB</a>.
For commercial games, dump them with <a href="https://github.com/TheOfficialFloW/NoNpDrm/releases">NoNpDrm</a>.
If the game is known to not work with NoNpDrm, you can optionally replace the executable with a <a href="https://github.com/CelesteBlue-dev/PSVita-RE-tools/tree/master/FAGDec/build">FAGDec</a> dump.
Vitamin dumps are <strong>not</strong> supported.
</h6>
</div>
<h3>How to run games?</h3>
<div class="my-5">
<h6>First you have to install them. When you do, you only need to run the emulator and it will display a <em>Game Select</em> Screen.</h6>
</div>
<h3>How to install games?</h3>
<div class="my-5">
<h6>
Windows:<br />
Right click on a <code>.vpk</code>, go to Properties and click "Change..." to associate <code>Vita3K.exe</code> with <code>.vpk</code> files. Double-clicking them should work after that.
Alternatively, drag and drop games to <code>Vita3K.exe</code>.<br /><br />
Windows/Linux/macOS/Android:<br />
Games can be installed via the emulator directly through the <code>File > Install .pkg</code> or <code>File > Install .zip .vpk</code>.<br />
Alternatively, supply them as a command-line argument to the executable or install them manually by unzipping the <code>.vpk</code> to Vita3K's home directory (see below).
</h6>
</div>
<h3>Where are games installed?</h3>
<div class="my-5">
<h6>
They are installed in the Vita3K home directory, in <code><Vita3K_home_dir>/ux0/app/<Title_ID></code>.
Defaults are:<br />
Windows: <code>C:/Users/"username"/AppData/Roaming/Vita3K/Vita3k</code><br />
Linux: <code>~/.local/share/Vita3K/Vita3K</code><br />
Android: <code>Android/data/org.vita3k.emulator/files</code><br /><br />
You can change it by editing <code>config.yml</code>'s "<code>pref-path</code>" entry.
</h6>
</div>
<h3>What is vitamin dump and how does it differ from a regular dump?</h3>
<div class="my-5">
<h6>
Vitamin is (or rather was) a software for dumping PS Vita games from the cartridge or from the internal storage.
They generally have the <code>.vpk</code> extension. Vitamin dumps aren't allowed/don't work, because the data inside isn't properly ripped.
According to the developers of Vitamin, the software shouldn't be used because it contains bugs that can sometimes corrupt game data or corrupt your save file.
The Recommended dumping way is to use <a href="https://github.com/TheOfficialFloW/NoNpDrm/releases">NoNpDrm</a> or <a href="https://github.com/CelesteBlue-dev/PSVita-RE-tools/tree/master/FAGDec/build">FAGDec</a> with <a href="https://github.com/TheOfficialFloW/VitaShell/releases/tag/v2.02">VitaShell</a>. See the <a href="https://vita3k.org/quickstart.html">QuickStart guide</a>.
</h6>
</div>
<h3>Why can't I play Vita3K?</h3>
<div class="my-5">
<h6>
See the <a href="/quickstart.html">Quickstart</a> for more information.
If you are using Dynarmic for CPU Backend, changing to Unicorn may work (in exchange for extremely slow speeds).
If the Quick Start Guide and here do not solve your problem, please ask in the <strong>#help</strong> channel on the <a href="https://discord.gg/n8HV3dN">Discord</a> Server.
Be sure to report your OS, Vita3K version, and PC configuration when you do so.
</h6>
</div>
<h3>What input devices can I use with Vita3K?</h3>
<div class="my-5">
<h6>
We currently support keyboard / mouse inputs and <strong>SDL2</strong>-compliant devices can be used.
DualShock4 and DualSense are usually recommended. The rear touchpad is realized with right click.
</h6>
</div>
<h3>Can I play multiplayer games online with real consoles or other Vita3K users?</h3>
<div class="my-5">
<h6>
Playing commercial games online with real PlayStation Vita systems would require the user to connect to PlayStation Network which isn't very feasible due to obvious technical and legal limitations.
That said, networking is partly implemented and you can play some <strong>homebrew</strong> multiplayer games like <a href="https://github.com/Rinnegatamante/vitaQuake">vitaQuake</a> just fine.
</h6>
</div>
<h3>Where to download firmwares?</h3>
<div class="my-5">
<h6>
Go to <code>Help</code> -> <code>Welcome</code> -><code>Download Firmware</code>. This will decrypt the modules only.
If you also need all firmware files, like fonts, go to <code>Help</code> -> <code>Welcome</code> -><code>Download Firmware Font Package</code>.
</h6>
</div>
<h3>How to play Vita3K on Steam Deck?</h3>
<div class="my-5">
<h6>
Using Vita3K on Steam Deck:<br /><br />
0. Switch to desktop mode (hold power button until you get options menu, select Switch to Desktop)<br />
1. Open Konsole<br />
2. run <code>mkdir Vita3K && cd Vita3K && wget https://github.com/Vita3K/Vita3K/releases/download/continuous/ubuntu-latest.zip</code> (<a href="//github.com/Vita3K/Vita3K/releases/download/continuous/ubuntu-latest.zip">Link</a>)<br />
3. run <code>unzip ubuntu-latest.zip</code><br />
4. run <code>chmod +x Vita3K && ./Vita3K</code><br /><br />
This should run Vita3K in desktop mode. (Suggested since running it in "game mode" often times compresses the aspect ratio to a tiny square in the middle of your screen)
</h6>
</div>
<h3>How is progress?</h3>
<div class="my-5">
<h6>
See <a href="/blog.html">Blog</a> or our social media accounts.
For more cutting-edge progress, see our <a href="https://github.com/Vita3K/Vita3K/pulls">GitHub page (Pull Requests)</a> and <a href="https://discord.gg/n8HV3dN">Discord Server</a> in the <strong>#development</strong> channel.
</h6>
</div>
<h3>Why do you work on game X instead of game Y?</h3>
<div class="my-5">
<h6>Vita3K is a completely hobby-driven project. Developers do what they want to do, when they want to do it. Reports of problems are welcome.</h6>
</div>
<h3>I'd like to create a patch, contribute, or possibly become a developer. Where do I start?</h3>
<div class="my-5">
<h6>
That's awesome, contributions are welcome! Check the <a href="https://github.com/Vita3K/Vita3K/wiki/Coding-Style">Coding Style Guidelines</a>, and <a href="https://github.com/Vita3K/Vita3K/wiki/Developer-Information">Developer Information</a>.
Most dev discussion happens on Discord, so be sure to hit us up on our <a href="https://discord.gg/n8HV3dN">Discord Server</a> in the <strong>#development</strong> channel.
Find something you want to implement or improve (such as broken games, bugs, missing features, <a href="https://github.com/Vita3K/Vita3K/wiki/Roadmap">Roadmap</a> goals, etc.), work on it, test your changes and send a <a href="https://help.github.com/articles/using-pull-requests">Pull Requests</a>.
Also you can contribute by participating in testing.
Please visit the <a href="https://github.com/Vita3K/compatibility/issues">compatibility repository</a> and submit your test results.
</h6>
</div>
<h3>There is some issue/feedback/comment that I want to report.</h3>
<div class="my-5">
<h6>
Good, you can do it through the <a href="https://github.com/Vita3K/Vita3K/issues">GitHub Issue Tracker</a>
Please follow this guidelines before sending anything:<br /><br />
<li>Check if your system matches all the system minimum requirements.</li>
<li>Check if the issue is meaningful for the team (e.g. "Uncharted: Golden Abyss doesn't work" is obvious and therefore useless).</li>
<li>Search older issues/forum threads to see if your issue was already submitted.</li>
<li>Use understandable English. It doesn't need to be perfect, but clear enough to understand your message.</li>
<li>While reporting issues, don't forget to include details about your system (OS, CPU, GPU, etc.), as well as the Vita3K.log file.</li>
<li>Please do not post individual game issues. Please post them in the <a href="https://github.com/Vita3K/compatibility/issues">compatibility repository</a>.
There are currently so many games with problems that it is difficult to accept them all.</li>
</h6>
</div>
</div>
</section>