Difference between revisions of "Installation Guide"

Revision as of 00:38, 22 November 2018

This guide will teach you how to download, install, and add your own games to EmuVR.

Quick Steps

This may look complicated, but in the end you'll just be doing these basic steps below:

1. Download and extract
2. Copy your games
3. Scan games and download cores
4. Play

Please do read everything below. Every single information here is important to make EmuVR work correctly.

Downloads

In order to setup and start using EmuVR, you will need to download two files:

• EmuVR itself (The latest version is always available on EmuVR's official Discord server, in the #download channel)
• RetroArch v1.7.5 (This is the official download url from Retroarch)

Hint: If you get errors, don't use Winrar to extract Retroarch. Use 7-Zip.

Extracting

• Extract the contents of EmuVR <version>.7z somewhere convenient. For this example, we'll use "C:\EmuVR".
• Extract RetroArch.7z into "C:\EmuVR\Retroarch".

Important: If this is your first EmuVR installation, do not copy from any previous Retroarch installation in your disk. Extract RetroArch.7z to a clean "C:\EmuVR\Retroarch" folder.

EmuVR's Retroarch installation will not mess your any other Retroarch installation in your disk. They're all portable and unaware of each other.

Copying Your Games

!!! ATTENTION: DO NOT ADD MORE THAN 300 GAMES, OR EMUVR WILL FREEZE OR CRASH ON STARTUP !!!

First, go to your "C:\EmuVR\Games" folder and create a new folder there for each console you want. You can name them as you like. Examples:

• C:\EmuVR\Games\SNES
• C:\EmuVR\Games\PS1
• C:\EmuVR\Games\Sega Genesis
• C:\EmuVR\Games\Videos

Now, copy your games (or videos, music) into your respective new folders.

You can delete the default "SystemX/Y/Z" folders, they're just examples.

If they're in ZIP or 7Z files, you do not need to extract them. They'll work compressed or extracted the same way.

The exception is disc games. If they're ISO, CUE + BIN files or other ripped disc formats, you always need to extract them.

If they're in RAR files, you also must extract them.

Recap: ZIP and 7Z work, unless it's a disc file. RAR never works.

Note: PlayStation games won't work in ISO format. They need to be in other formats, such as CUE + BIN or PBP.

Games Scanner

For EmuVR to recognize your games, you need to scan them.

First, run the Game Scanner, located at "C:\EmuVR\Game Scanner\Game Scanner.exe". This will also automatically patch Retroarch to work with EmuVR.

Autofill

Click the Attempt Autofill button. Autofill will search for known names in your folders, and will try to assign the most probable console and emulator core for each one.

If you named you folders with common names like "PS1", "PSX", "PlayStation", "Sony PlayStation", "PlayStation 1", or "SNES", "Super Nintendo", "Super Famicom", they should be automatically detected.

Sometimes a folder name will not be recognized. If you notice a folder was not added from Autofill, read below to know how to manually add folders.

Adding Folders Manually

After trying the Autofill, if you still need to add some folders manually, click the Add folder... button, and choose your folder.

You'll need to select a Media type and an emulator Core for that system.

Media and Core

Each system folder need to be assigned a Media type and an emulator Core. Most systems have multiple cores to choose from.

When you use the Autofill or manually select a Media type, the (arguably) most popular/faster core for that system will be automatically selected for you. You can change it to any other core you like. If you have any problems with it, please also try other cores.

After you choose your options, click Save Changes.

Next, click Download Missing Cores, and it will download and extract each chosen emulator. If your selected core has a little down arrow icon before the name, it means it still need to be downloaded like that.

Note: For now, you'll see placeholder 3D models for consoles that aren't modeled yet, represented by the fantastic Knock-Off Generic EVR-9000 video game console. This allows you to play your games for every supported system, before we get to model them all. Currently, there are models for PS1, N64 and SNES systems. More to come later.

BIOS Files

Some emulator cores will need BIOS files to work.

For example: PS1, Dreamcast, Sega Saturn, Sega CD, Sega 32X.

You'll need to find those files by yourself, just like your games. Just try Googling something like "ps1 bios" to learn more. Do not ask for BIOS files in the Discord server.

After you get your BIOS files, you just need to extract them into "C:\EmuVR\Retroarch\system".

They need to be named correctly. Check this example for PS1 BIOS correct file names.

Scanning Your Games

This is the last step.

Click Scan Games for EmuVR. A small window will show the scanning progress, and then the detected games count when it's finished.

!!! ATTENTION: DO NOT ADD MORE THAN 300 GAMES, OR EMUVR WILL FREEZE OR CRASH ON STARTUP !!!

When To Scan Again

• You do NOT need to click "Scan Games" again when:
  • Changing Media type
  • Changing Core
  • Removing a system folder
  • Deleting games
  • Adding, removing or changing custom labels

• You do NEED to click "Scan Games" again when:
  • Adding a new system folder
  • Renaming a system folder
  • Adding new games to a system folder
  • Renaming game files

If you're adding or renaming a system folder, you'll need to add them before scanning. Try the Autofill before adding them manually.

Updating EmuVR

When a new EmuVR update is released on the Discord server, you can just extract it over your previous installation, and everything should work with no need to do all that setup again, unless otherwise stated on the update notes.

Always read the notes on the new updates for further instructions.

ALWAYS MAKE BACKUPS!

If something doesn't work after an update, try a clean installation with the latest version on another clean folder.

Customizing EmuVR

If you want to customize your bedroom with your own custom wallpapers, wall posters, bed sheets and game labels, check out the Customization Guide.

Playing EmuVR

You're now ready to learn How To Play and finally enjoy EmuVR!

Troubleshooting

If you're having any issues, crashes, or games aren't working, please check out the Troubleshooting page for known solutions.