Fix wiki

Margen67 2023-06-07 18:23:47 -07:00
parent 24f6aa1f6c
commit 148004f9ed
4 changed files with 113 additions and 53 deletions

@ -1,114 +1,123 @@
__TOC__ __TOC__
= How do I use Xenia? = = Master =
Refer to the [https://github.com/xenia-project/xenia/wiki/Quickstart Quickstart page].
= What are Xenia's system requirements? = == How do I use Xenia? ==
Refer to the [https://github.com/xenia-project/xenia/wiki/Quickstart#system-requirements Quickstart page]. Refer to the [https://github.com/xenia-canary/xenia-canary/wiki/Quickstart Quickstart page].
== How do I improve performance? == == What are Xenia's system requirements? ==
Refer to the [https://github.com/xenia-canary/xenia-canary/wiki/Quickstart#system-requirements Quickstart page].
=== How do I improve performance? ===
Upgrade your PC or wait for optimizations. Upgrade your PC or wait for optimizations.
== Why do I get an error saying "Your CPU does not support AVX"? == === Why do I get an error saying "Your CPU does not support AVX"? ===
Your CPU doesn't meet the minimum requirements. (see above) Your CPU doesn't meet the minimum requirements. (see above)
== Does Xenia support OpenGL/Direct3D11? == === Does Xenia support OpenGL/Direct3D11? ===
No. (see system requirements above) No. (see system requirements above)
= How do I fix the VCRUNTIME error? = == How do I fix the VCRUNTIME error? ==
Refer to the [https://github.com/xenia-project/xenia/wiki/Quickstart Quickstart page]. Refer to the [https://github.com/xenia-canary/xenia-canary/wiki/Quickstart Quickstart page].
= Why is the audio delayed? = == Why is the audio delayed? ==
Audio is one of the least worked on things in Xenia. There is no fix. Audio is one of the least worked on things in Xenia. There is no fix.
= How do I fix "Graphics device lost (probably due to an internal error"? = == How do I fix "Graphics device lost (probably due to an internal error"? ==
You can't. You can't.
= Can you add support for Windows Me? How about my Pentium II? = == Can you add support for Windows Me? How about my Pentium II? ==
Support for older operating systems and processors will not be added unless a Support for older operating systems and processors will not be added unless a
contributor steps up to build and maintain them. All active contributors are on contributor steps up to build and maintain them. All active contributors are on
modern systems and busy with higher priority tasks. Whether the emulator runs on modern systems and busy with higher priority tasks. Whether the emulator runs on
Windows Vista or not doesn't matter if it can't run games. Windows Vista or not doesn't matter if it can't run games.
= Does Xenia run on Linux or macOS? = == Does Xenia run on Linux or macOS? ==
Not natively, but Xenia may run with Wine on Linux ''using Vulkan''.* Not natively, but Xenia may run with Wine on Linux ''using Vulkan''.*
* [https://github.com/xenia-project/xenia/wiki/Quickstart#minimum D3D12 will only work on Windows 10+ due to vkd3d not being supported.] * [https://github.com/xenia-canary/xenia-canary/wiki/Quickstart#minimum D3D12 will only work on Windows 10+ due to vkd3d not being supported.]
macOS is not compatible due to requiring MoltenVK/Metal support which isn't implemented in Xenia. macOS is not compatible due to requiring MoltenVK/Metal support which isn't implemented in Xenia.
= How do I dump games? = == How do I dump games? ==
See the guide in [https://github.com/xenia-project/xenia/wiki/Quickstart#How-to-rip-games Quickstart]. See the guide in [https://github.com/xenia-canary/xenia-canary/wiki/Quickstart#How-to-rip-games Quickstart].
== Can I dump games using an Xbox One/Series or run them directly from the disc? == === Can I dump games using an Xbox One/Series or run them directly from the disc using any PC DVD drive? ===
No, and no. No, and no.
== Why is my game in trial/demo mode? == === Do I need a modded console to dump games? ===
See [https://github.com/xenia-project/xenia/wiki/Options#Run_games_as_fullactivated this option]. No. You can use a stock/unmodded console to dump games.
= How do I use xenia-vfs-dump? = === Why is my game in trial/demo mode? ===
See [https://github.com/xenia-canary/xenia-canary/wiki/Options#user-content-Run_games_as_fullactivated this option].
== How do I use xenia-vfs-dump? ==
xenia-vfs-dump is a command-line tool use for dumping content from STFS and SVOD containers. xenia-vfs-dump is a command-line tool use for dumping content from STFS and SVOD containers.
You can download it from [https://ci.appveyor.com/api/projects/benvanik/xenia/artifacts/xenia-vfs-dump_master.zip?branch=master&job=Configuration:%20Release&pr=false here]. You can download it from [https://ci.appveyor.com/api/projects/benvanik/xenia/artifacts/xenia-vfs-dump_master.zip?branch=master&job=Configuration:%20Release&pr=false here].
Usage: <code>xenia-vfs-dump [ContainerPath] [DestinationOutput]</code> Usage: <code>xenia-vfs-dump [ContainerPath] [DestinationOutput]</code>
= Does game ''X'' run? = == Does game ''X'' run? ==
Check the [https://github.com/xenia-project/game-compatibility#game-compatibility compatibility list]. If it's not there, ask in the [https://discord.gg/Q9mxZf9 Discord #help channel] or test it yourself. Check the [https://github.com/xenia-project/game-compatibility#game-compatibility compatibility list]. If it's not there, ask in the [https://discord.gg/Q9mxZf9 Discord #help channel] or test it yourself.
= Saves = == Saves ==
== Why aren't saves working? (Storage device not found/full/not detected, etc) == === Why aren't saves working? (Storage device not found/full/not detected, etc) ===
Saves are broken in some games in Xenia, especially ones with user profile saves. Saves are broken in some games in Xenia, especially ones with user profile saves.
As for saves, etc that worked previously in older builds of Xenia, create a text file in the same directory as xenia.exe named <code>portable.txt</code>. As for saves, etc that worked previously in older builds of Xenia, create a text file in the same directory as xenia.exe named <code>portable.txt</code>.
== Where are saves stored? == === Where are saves stored? ===
Saves are in <code>Documents\xenia\content</code> by default. Saves are in <code>Documents\xenia\content</code> by default.
If a <code>portable.txt</code> file is in the same directory as xenia.exe the <code>content</code> folder will be in the same directory as xenia.exe. If a <code>portable.txt</code> file is in the same directory as xenia.exe the <code>content</code> folder will be in the same directory as xenia.exe.
<!--== How do I transfer saves to/from Xenia? == <!--=== How do I transfer saves to/from Xenia? ===
[[How-to-transfer-saves-to-or-from-Xenia]]--> [[How-to-transfer-saves-to-or-from-Xenia]]-->
= Input = == Input ==
Xenia only supports XInput controllers by default, which includes but is not limited to Xbox 360, and Xbox One controllers. Xenia only supports XInput controllers by default, which includes but is not limited to Xbox 360, and Xbox One controllers.
For non-XInput controllers, [https://github.com/xenia-project/xenia/wiki/Options#HID_Input SDL] must be used. For non-XInput controllers, [https://github.com/xenia-canary/xenia-canary/wiki/Options#HID_Input SDL] must be used.
<!--You can use the mouse to control the analog/joysticks, and rebind the keyboard controls '''with [x360ce](https://www.x360ce.com/)'''.--> <!--You can use the mouse to control the analog/joysticks, and rebind the keyboard controls '''with [x360ce](https://www.x360ce.com/)'''.-->
[https://cdn.discordapp.com/attachments/308207592482668545/437198231613734912/xenia_keyboard-layout.png Default keyboard layout (click to preview)] [https://cdn.discordapp.com/attachments/308207592482668545/437198231613734912/xenia_keyboard-layout.png Default keyboard layout (click to preview)]
Xenia does not support mice, accessories like the Kinect, uDraw GameTablet, or microphones. Xenia does not support mice, accessories like the Kinect, uDraw GameTablet, or microphones.
= Can Xenia play games online with Xbox Live? = == Can Xenia play games online with Xbox Live? ==
Xenia may connect to ''custom'' servers in the far future, but it will '''never''' connect to official Xbox Live servers. Xenia may connect to ''custom'' servers in the far future, but it will '''never''' connect to official Xbox Live servers.
Xenia does not support System Link either. Xenia does not support System Link either.
= How do I check my FPS? = == How do I check my FPS? ==
With an FPS indicator like [https://www.guru3d.com/files-details/rtss-rivatuner-statistics-server-download.html Rivatuner]. With an FPS indicator like [https://www.guru3d.com/files-details/rtss-rivatuner-statistics-server-download.html Rivatuner].
= What is ROV? = == What is ROV? ==
See [[ROV]]. See [[ROV]].
= What are Xenia's options? = == What are Xenia's options? ==
See the [https://github.com/xenia-project/xenia/Options Options page]. See the [https://github.com/xenia-canary/xenia-canary/wiki/Options Options page].
= What's the difference between Gameplay and Playable? = == What's the difference between Gameplay and Playable? ==
Gameplay means the game reaches gameplay, even if the game is unplayable. Gameplay means the game reaches gameplay, even if the game is unplayable.
= Can Xenia run original Xbox games? = == Can Xenia run original Xbox games? ==
Xenia does not support backwards compatibility, and therefore, cannot run original Xbox games. Xenia does not support backwards compatibility, and therefore, cannot run original Xbox games.
For that there's [https://github.com/Cxbx-Reloaded/Cxbx-Reloaded Cxbx-Reloaded] and [https://github.com/xqemu/xqemu xqemu]. For that there's [https://github.com/Cxbx-Reloaded/Cxbx-Reloaded Cxbx-Reloaded] and [https://github.com/xqemu/xqemu xqemu].
= I have a copy of the XDK. Do you want it? = == I have a copy of the XDK. Do you want it? ==
'''No.''' Do not post links or downloads to such resources or you will be banned. '''No.''' Do not post links or downloads to such resources or you will be banned.
= Build tweaks = = Canary =
== 4:3 ==
To play games in 4:3 you need to build Xenia with <code>video_mode->is_widescreen = 0</code> instead of 1 [https://github.com/xenia-project/xenia/blob/master/src/xenia/kernel/xboxkrnl/xboxkrnl_video.cc#L138 here].
''[https://github.com/xenia-project/xenia/blob/master/docs/building.md Refer to building.md on GitHub]'' == What is the difference between Xenia Canary and Xenia master? ==
Xenia Canary is a fork of Xenia with changes not present in master that may or may not fix games.
= Hacks/mods = == How do I install Title Updates? ==
Refer to the [https://github.com/xenia-project/xenia/wiki/Game-hacks,-mods,-etc Game hacks, mods, etc. page]. # Identify Game Title ID. This can be identified by running the game in Xenia. [https://i.imgur.com/Vhz9sCC.png (click for image)]
# Locate your TU folder from your removable storage. [https://i.imgur.com/M4R1SyZ.png (click for image)]
# Copy your TU file from <code>$TitleUpdate\[TitleID]\000B0000</code> to <code>Documents\Xenia\[TitleID]\000B0000</code>
== Game patches ==
See [https://github.com/xenia-canary/game-patches Game patches repository].

@ -1,3 +1 @@
![](https://github.com/xenia-project/xenia/raw/master/assets/icon/128.png)
# Welcome to the Xenia wiki! # Welcome to the Xenia wiki!

@ -1,7 +1,5 @@
__TOC__ __TOC__
''[https://github.com/xenia-canary/xenia-canary/wiki/Options Xenia Canary Options]''
= How to use = = How to use =
# Run xenia if you haven't before. # Run xenia if you haven't before.
# [https://social.technet.microsoft.com/wiki/contents/articles/1784.windows-how-to-view-file-name-extensions.aspx Show file name extensions in Explorer]. # [https://social.technet.microsoft.com/wiki/contents/articles/1784.windows-how-to-view-file-name-extensions.aspx Show file name extensions in Explorer].
@ -11,7 +9,7 @@ __TOC__
# For launchers/frontends like [https://github.com/quinton-ashley/bottlenose Bottlenose] you can use the <code>--config</code> launch parameter to specify what config to use. # For launchers/frontends like [https://github.com/quinton-ashley/bottlenose Bottlenose] you can use the <code>--config</code> launch parameter to specify what config to use.
#* To launch specific games, add the path to the game before the launch options. For example: <code>xenia.exe path/to/game/default.xex --vsync=false</code> #* To launch specific games, add the path to the game before the launch options. For example: <code>xenia.exe path/to/game/default.xex --vsync=false</code>
= Options = = Master =
== Run games as full/activated == == Run games as full/activated ==
{| {|
! <code>license_mask</code> = ! <code>license_mask</code> =
@ -211,10 +209,7 @@ Allow texture and vertex fetch constants with invalid type - generally unsafe be
|} |}
* ''This wont improve the framerate if your PC cant handle running the game at its native FPS.'' * ''This wont improve the framerate if your PC cant handle running the game at its native FPS.''
* This doesnt work with all games, including but not limited to: * Games that speed up have the [https://github.com/xenia-project/game-compatibility/issues?q=is%3Aopen+is%3Aissue+label%3Avsync-off-speedup vsync-off-speedup] label.
** Banjo Kazooie/Tooie
** Halo 3/ODST/Reach/4
** Sonic The Hedgehog (2006)
==== Renderer/Backend ==== ==== Renderer/Backend ====
{| {|
@ -288,3 +283,61 @@ Allow texture and vertex fetch constants with invalid type - generally unsafe be
**** These games additionally require the following: **** These games additionally require the following:
***** <code>cl</code> set to <code>-dvd -retail -nosound</code> ***** <code>cl</code> set to <code>-dvd -retail -nosound</code>
--> -->
= Canary =
== Video ==
=== Vsync interval ===
{|
! <code>vsync_interval</code> =
! <code>#</code> (frametime in milliseconds)
|-
| x1 ''(60 FPS, default)''
| <code>16</code>
|-
| x2 ''(120 FPS; 60 FPS for 30 FPS games)''
| <code>8</code>
|}
=== avpack (video mode) ===
{|
! <code>avpack</code> =
! <code>#</code>
|-
| HDMI ''(default)''
| <code>8</code>
|-
| TV PAL-60
| <code>7</code>
|-
| VGA
| <code>6</code>
|-
| PAL-60 Composite/S-Video
| <code>5</code>
|-
| HDMI+A
| <code>4</code>
|-
| 480p Component(HD)
| <code>3</code>
|-
| PAL-60 SCART
| <code>2</code>
|-
| Unused
| <s><code>1</code></s>
|-
| PAL-60 Component(SD)
| <code>0</code>
|}
== Audio ==
=== Max queued frames ===
Allows changing max buffered audio frames to reduce audio delay.
{|
! <code>max_queued_frames</code> =
! <code>#</code>
|-
| Default
| <code>64</code>
|}

@ -44,7 +44,7 @@ Windows Update tends to lag behind, so download GPU drivers from your manufactur
## Where do I download Xenia? ## Where do I download Xenia?
* **[Master](https://github.com/xenia-project/release-builds-windows/releases/latest/download/xenia_master.zip)** * **[Master](https://github.com/xenia-project/release-builds-windows/releases/latest/download/xenia_master.zip)**
* *[Canary](https://github.com/xenia-canary/xenia-canary/releases/latest/download/xenia_canary.zip)* * *[Canary](https://github.com/xenia-canary/xenia-canary/releases/download/experimental/xenia_canary.zip)*
Xenia is sometimes detected as a virus. Ignore this, as it is a false positive. Xenia is sometimes detected as a virus. Ignore this, as it is a false positive.