Getting started with modding ADVR

This Tutorial will show you how to install mods to your game and enable them. If you use the Oculus Quest, you need to do a few extra steps to get everything set up. If you are on PCVR, you can skip these steps.

## Oculus Quest

If you are modding the game on Quest, there are a few easy steps you need to do first. If you are on PCVR you can skip this step. First, start the game in your Quest, go to the settings menu and on your right, press the button to enable modding (see image).

Now your Quest will display a prompt asking you to give the *Read External Storage* permission. Ancient Dungeon needs this permission in order to read the mod folder. After you have granted the permission, the game will reload. You can close the game after that.

Now connect your Quest to your PC and make sure you allow your PC to read the files of it (You may need to give permission inside the headset). Now you can open the storage of your Quest (either via SideQuest or the windows explorer). Once you have done that, navigate to `Android/data/de.erthu.ancientdungeonfull/files` and inside it **create a folder called `ADVR_Mods`.** Do this by right clicking inside the folder and press "Create new Folder". This folder is now your mod folder. In this folder you can put mods in to play (check image for more information).

Now that you have the ADVR\_Mods folder, you can read further down below where the installation process of mods is explained.

### Alternative Quest Installation

Another method is now available to install mods with just the just Quest headset alone. You still need to follow the general instructions in the above section, but return here before needing to attach the Quest to a PC. The general approach is to use the built-in web browser to download mod files, but they have to be in "Zip" format, because it won't work with RAR files. Then utilize the APPLAB app Mobile VR Station (MVRS) to create the **`ADVR_Mods`** folder and then deploy the zips directly into the **`ADVR_Mods`** folder. A video on the process from the app developer of MVRS has been posted here (be aware that this video is outdated. You need to create the mod folder inside the new path "Android/data/de.erthu.ancientdungeonfull/files" that goes over folder creation and then installing mods.

## PCVR

If you are modding the game on PCVR, locate the folder where you have ADVR installed (where you have the .exe file that you run) and look for the mod folder.

It is located under:

*Ancient\_Dungeon\_VR\_Beta\_Data/StreamingAssets/mods/*

In this folder, you can put the mod files. Read the next section to get to know how to install mods.

## Installing a mod

The first thing you need when installing a mod, is the mod itself. You can download mods from the **#modding-creations** channel in the Discord. Just download a mod that you like, and we can continue.

Mod files are usually supplied in .zip or .rar files. Zip files can be easily opened with the normal file manager (or another archive manager like WinRar or 7Zip) you have on your PC. Once you have opened the file, you should see a folder, normally named the same as the .zip file is called.

This folder needs to be put in your mods folder. You can just drag and drop it in there.

This image shows the process on PC:

This image shows the process on Quest (drag the mod folder into your newly created ADVR\_Mods folder)

After that, you're good to go! Start up the game, go into settings and on your right, you should see the mod you have just installed.

Be sure to enable it by pressing the button with your controller and press the reload button. The mod should now be loaded!