Getting Started

From Pavlov VR Wiki
Jump to navigation Jump to search

Template:Capsule-editor


Download Unreal Engine

The default layout of the UE4 Editor

1. Register an Unreal Engine Account and download the Unreal Engine Launcher at UnrealEngine.com
2. Once you have downloaded and installed the launcher you need to login with the Account you just created.
3. Go to the "Unreal Engine" Tab and select "Library" on the left. (DO NOT press "Install Engine" as this will install the latest Engine build.)
4. In the Libraries window press the "+ Add Engine Version", select your Engine Version and press on the yellow "Install" Button. Specify the installation path and continue.
5. The engine will now download and install. Wait for it to finish and proceed with the next step.

Engine Version Branch
UE4.21.x PC/Shack Main Branch
UE4.27.x Shack RC
UE5.1.x PC Beta
If you need further instructions on how to create an Unreal Engine Account and installing the engine please visit the official Unreal Engine Documentation "Installing UE4" website

Download the PavlovVR ModKit (Workshop Tools)

1. You can download ModKit fromt the the PavlovVR ModKit Github Page.
2. Select the green "Code" drop down button and then select "Download ZIP".

Setting up a new project

Setup Example

1. Extract the "Pavlov.uproject" file, "Config" folder, and "Plugins" folder from the downloaded "PavlovVR-ModKit-master.zip" to your Unreal Project folder (Example: C:\My Documents\Unreal Projects\*ProjectNameHere*\*ExtractedFiles*)

NOTE: Do not rename the Pavlov.uproject.

2. Are you creating a Pavlov PC map or Pavlov Shack (quest) map?

[Pavlov PC] Steam should be open and logged into an Account that owns Pavlov. Completely close and reopen your Epic Games Launcher and open the Pavlov project from the Libraries tab.

[Pavlov Shack] Do not open steam, or logout / put it in offline mode. When you launch into UE4 editor, it should ask you if you are making a Shack Mod, answer yes. Highly recommend following Junt's tutorial - as he goes into a variety of useful areas: https://www.youtube.com/watch?v=dWMxWHxCa4U

3. Wait for the Editor to load (The first time you open UE4, expect it to hang at 45% for about an hour.)
4. In the UE4 Editor, the first thing you have to do is to go to "Window" and select "Pavlov Workshop".
5. In the Pavlov Workshop window - there are differences based on Pavlov PC and Pavlov Shack maps.

[Pavlov PC]Press the "Create New" button once and wait for it to finish. This will create a new and unique UGCXXXXX folder inside the *ProjectNameHere*\Content\CustomMaps folder. Close the window.

[Pavlov Shack] On the setup tab, the map file name follows convention <creator>_<mapname>. Eg. John_PoolDay for example. This will also create a new and unique SVR_<map name> folder inside the *ProjectNameHere*\Content\CustomMaps folder. Close the window.

NOTE: [Both PC and Shack] ALL Assets need to be inside the map folder (UGCXXXXX or SVR_YYYY_ZZZZ) otherwise those assets will not be included in the map and won't work ingame later on. DO NOT rename or delete this folder.

6. Create a new Map asset by saving the Untitled template map anywhere inside the map folder.
7. Open the "Definition" file inside the map folder and enter a Label (Map Name) and reference the Map file you just saved. You can set a Thumbnail for the map by importing a 512x512 PNG Image file. Do not change the UGC ID. Under Compatibility you can set the gamemodes your map will support. For shack, make sure CUSTOM is selected so it is created as a custom map.

NOTE: Do not rename or delete the Definition file.

8. Press the Save button and close the window.
9. In the Modes window on the left of the screen, type "Pavlov" into the Search Classes field.
10. Drag and drop a Pavlov Game Logic object anywhere on the map. Place any additional gamemode assets you want as well. (There should already be 1 player spawn placed; you need at least 1 to play the map)

NOTE: If the player spawn says "BAD SIZE", it's too far into the floor and you will fall through the floor when you spawn.

11. Doubleclick the Pavlov Game Logic object you just placed and in the Details tab select the Definition file.
12. Delete Player Start and Atmospheric Fog assets from map. These assets do not work with Pavlov maps. The player start will be replaced later with player spawns.
13. Go to File and press Save All. The map should now be ready to Stage or Deploy.

TIP: Every time you open the project you will see a new unsaved, untitled template map. To make UE4 load straight into your actual map, go to Edit, select Project Settings, and in the Default Maps area reference your Map asset in the Editor Startup Map dropdown.
TIP2: Each new project will have a setting enabled by default that will launch Steam VR upon opening the project. Disable this in Unreal via Edit > Plugins, left panel: Virtual Reality > Steam VR. Uncheck the box and restart Unreal.


For more information on how to develop a map and how Unreal Engine works, please visit the official Unreal Engine 4 Documentation "Getting Started" website

Migrating an existing map from another UE4 Project

Make sure you followed all the previous steps before doing this.
1. Open the origin project with the Map you want to migrate.
2. Find your Map file in the Content Browser, right click on it, and select "Migrate...".
3. You will see a folder tree with all the referenced files of the map. Press "OK".
4. A Windows Explorer prompt will appear. Select the "Content" folder of your destination Project (Default path is \Users\*winuser*\My Documents\Unreal Projects\) and press "OK".
5. Close the origin project and open the Pavlov project you just migrated to.
6. Move the migrated Map file and all the extra folders that came with it somewhere inside the UGCXXXXX folder. (Click the icon next to the "Seach Folders" field that toggles "Show the Sources Panel". Drag and drop the folders/files inside this panel to move them around.)
7. Right click the Content root folder and select "Fix up redirectors" This will fix all the asset references so they are correctly pointing to each other within the UGCXXXXX folder.


For more information on how to migrate Assets to other Projects, visit the official Unreal Engine 4 Documentation "Migrating Assets" website

Mandatory Entities and their Configuration

Light

Pavlov VR only works with static baked lightning so you have to use a "Directional Light" entity with the "Mobility" set to "Static"
Use a "Skylight" Entity for a realistic outdoor lightning. It also needs to be set to "Static".
For a more realistic look and better clarity in VR set the "Indirect Lightning Intensity" to a value between 2-6.
You can use as many "Point Lights" and "Spot Lights" as you like, as long as they're set to "static"


Spawns

To be able to play your map, you need to have valid Spawnpoints.
Use the "Pavlov Spawn" Entities from the "All Classes" category on the left in the "Modes" window, or use the searchbar at the top of the "Modes" window.
You need to configure them according to the gamemodes you want to support with your map.

Spawnflags
TeamID 0 = Blue Team (Defenders) , 1 = Red Team (Attackers)
Dynamic Tick this for Deathmatch, This prevents spawning inside another person who occupies the spawn area
Only Team Use this Together with the TeamID parameter to only allow for a certain team to spawn. Search & Destroy (S&D) spawns needs this. Uncheck for random Deathmatch spawns
Special Tick this for marking the Spawn to be used for Search & Destroy gamemodes. Use only ONE spawn per Team.. Teams will spawn together at one spawn. Use together with TeamID

When using S&D "Special" spawns, make sure to leave some space to the right of it, as the other 4 Players will spawn in a line next to it.
To set a spawn as DM only, use 2 in TeamID.


Protip: Select a spawn and move it above the position where you like it. Then press "END" to drop it to the floor. This will make sure that you'll spawn correctly ingame without falling trough the floor.


Bot Navigation

The Navigation Mesh Visualisation in action

To make the Bots move on your map, you need to add a "Nav Mesh Bounds Volume", which you can find under the "Volumes" Category in the "Modes" Window.
The Volume needs to cover ALL of the walkable space of your map.
Press "P" on your keyboard to get a visual representation of the Navigation Mesh. The green area represents the walkable space for the Bots.
DO NOT make ANY changes to the settings of the volume in the "Details" window, since this will cause the Bots to not move at all.
The Bots will only move between areas that are clearly connected with the Navigation Mesh. (check the "P" Navigation visualisation)
To connect areas that don't connect to eachother but are wide enough to fit a player, you can use a "Nav Link Proxy"
Drag a "Nav Link Proxy" from the "All Classes" category in your map. The Proxy has two beacons that need to touch the green area of the Nav Mesh.
Press "P" to see the bounds and the connection indicator. Align the two beacons so they connect the two Nav Mesh areas. This way you can link a narrow doorway that won't connect to the Nav Mesh.
You can change the Nav Link to be one way by changing the "Link Direction" setting in the "Details" window.


Reflection Captures

A Sphere- and Box Reflection Capture

Reflection Captures are needed to have realistic reflections on all surfaces that are inside the reflection volume.
There are 2 Types of Reflection Captures avaiable. "Box-" and "Sphere Reflection Captures".
The only difference is the shape, so you can adjust the volumes to your level geometry.
Having Reflection Captures in your map prevents shiny and reflective surfaces from looking pitch black ingame. (e.g. Weapons)
Drag and Drop them into your Level from the "Visual Effects" Category of the "Modes" window.
Adjust the size to the aproximate size of your room on eye level.


Bomb Spots

Search & Destroy maps need at least one bombspot. You can have up to 2 seperate bombspots ( A and B ) But you can have as many Bomb Placement Spots for the two Spots.
Drag the "Pavlov Bomb Spot" from the "All Classes" category on the left in the "Modes" window into you map.
By default the Bombspots will be treated as bombspot "A". To change it, simply tick the checkbox "Is B".
The bomb will be placed at the root of the red arrow facing the direction of the arrow. Leave some space between the wall and the arrow, otherwise the Bomb will clip into the wall. (About 5 Units)

King of the Hill

File:KOTHsettings.PNG
How to adjust King of the Hill for your map

The blueprint actors can be found in the CustomMapTools Content folder -> Blueprints (please make sure "show plugin content" is enabled in your view options for your content browser

To place a KOTH point, drag BP_KOTHObjectiveProxy onto your map where you want hill points to show up, similar to placing CTF flag points.


If you want to edit the score to win or limited ammo, then you place a BP_KOTHSettingsProxy into the level and adjust the settings accordingly.


Blocking Volumes

Apart from regular walls, sometimes you want to use an "Invisible Wall" for blocking access to a certain area of the map.
To create an "Invisible Wall", drag a "Blocking Volume" from the "Volumes" category into your level and scale it to your liking.
The Geometry Editing Tool can also be used on this volume to easily adjust it to your Level Geometry.
Use Blocking Volumes as a ramp over stairs to prevent the VR camera from aggressively hopping when walking up stairs.
You can also use them for smoothing out narrow and busy areas to prevent getting stuck and assure smooth gameplay.

Killing Volumes

Put a "Pavlov Kill Volume" about 1000 - 2000 units under your map, that is a bit bigger than your playspace. This will kill players that somehow fell out of the map or gliched out of it.
You can also use the Kill Volumes for harzardous enviroments in that the Player should die when touching the Volume. (e.g. the front of a moving train or a pool of lava/deep water)


Pavlov Game Logic

You must add this to your level or the Map will not show up ingame.
This object can be placed anywhere in your Map.
Once you place the object in your level, you have to assign the definition file in the object's Details by doubleclicking it.

Ladders

Overcoming walk-able angle restrictions is possible by using Pavlov Ladder Volumes.
The player will only stick to player-collidable surfaces contained inside the Pavlov Ladder Volume. Avoid overlapping Pavlov Ladder Volumes as this can cause the player to glitch between them.
The Volumes only come as rectangular prisms. To match the shape of a surface that isn't rectangular/square, use many smaller Volumes without overlapping or have a large one that overextends as long as the overextended region isn't encompassing player-collidable surfaces you don't intend to be climbable.

TIP: Work in Player Collision View Mode to better see where the extents of the Volume need to be.

Bullet Penetration - Physical Materials

Show Plugin Content

To enable bullet penetration, you first have to show the Plugin Content. Do this by selecting the View Options in the Content Browser and enabled Show Plugin Content. Next open your material, go into the General tab and select the Phys Material based on the object you're using.
There are two options, normal and thin. Thin will be penetrable.
Physical materials will also change the physics of the objects so metal sounds like metal, wood sounds like wood.


Shack Tips

- Don't use textures bigger than 512p since everything will be downsized to max 512.
- Keep your UV's inside 0 to 1 coordinates. Every UV bigger as 1 or smaller than 0 will result in pixelated textures on the quest
- Build your map from segments and merge Actors then as chuncks to improve performance

Testing your Map

There are different methods to test Pavlov PC and Pavlov Shack maps. To test either type of map, start by openning the "Pavlov Workshop" window by clicking on "Window" > "Pavlov Workshop", then follow platform specific steps below.

[Pavlov PC Map]

Click on the "Testing" tab and then press the "Stage" button and wait for it to finish. It is finished when the 3 dots stop flashing and the "Stage" button returns.
This will create a local .pak file in your game's "\Pavlov\Content\Paks" folder, so you can load up the map offline for testing.
You can only Stage one map at a time. If you have already Deployed the map to The Workshop, you must be unsubscribed to it before playing a locally staged version of it.
NOTE: Your project won't Stage or Deploy if any asset filepaths exceed 260 characters.
TIP: View your Output Log when you Stage or Deploy to see if any errors or warnings occur. Do this by going to Window > Developer Tools > Output Log.


[Pavlov Shack Map]

Click on Server Map tab, make sure Android is checked for target, then press build selected platforms button.
The map will be created in folder xxxx, which you then deploy to a dedicated server or your oculus quest for testing.
NOTE: For Shack build 24 and onwards, maps go in /sdcard/Android/data/com.vankrupt.pavlovbeta/files/maps. Before build 24, they were in /sdcard/pavlov/maps.

Testing tip:
Download the copy2quest tool
This application creates an entry in the explorer menu called "Copy to Quest" To use it just right click on a folder or file and select "Copy to Quest".

In the path_config.txt you have to specify the Quest folder where the file or folder should be copied to. The default is the Pavlov Shack maps folder. If you want to have another path, please change it. The new path must start with the first folder on the Quest. For example: "Android\data\com.vankrupt.pavlovbeta"

Install: Click on the "copy2quest_Install-Uninstall.exe"

        To make sure that the installation works properly, this should be done with administrator rights (Runs as Administrator)
        Make sure that the folder with the "copy2quest_Install-Uninstall.exe" is stored in a safe and
        permanent place, because the exporter entry needs to access the .exe. There is no real installation

Uninstall: Click also on the "copy2quest_Install-Uninstall.exe". You can delete the folder now

Small tip: You can also create a shortcut of the copy2quest_Install-Uninstall.exe and insert as destination the path of the folder behind the target location of the shortcut. Example: From target path: "D:\\QuestTools\copy2quest_Install-Uninstall.exe" To target path "D:\\QuestTools\copy2quest_Install-Uninstall.exe D:\\UnrealBuilds\Glory_Stacks\SVR_Quacklin_GoldenEye_Stack"

Or create a batch and use copy2quest_Install-Uninstall.exe as command-line with the path as command

Submitting and Updating your Map (Pavlov PC Maps only)

To make your Map available on Steam, open the "Pavlov Workshop" window by clicking on "Window" > "Pavlov Workshop".
Click on the "Deployment" tab and press the "Submit" button after you typed in some optional but recommended changenotes.
To update the Thumbnail or the Map name, edit the Definition file and press the "Sync Metadata" button on the Setup tab of the "Pavlov Workshop" Window (Where the "Create New" button was before).
By default, the Steam Workshop page is set to "Hidden" and can only be interacted with by it's creators. (You can add people on your Friend's List as creators.) An orange prompt on the page will notify you if it's private still. If you're ready for the map to be available to everybody, set the visibility to "Public".

NOTE: Before testing online, you must set the visibility to Public or Unlisted, or the server will kick to Datacenter.

Just like any other map, you will need to Subscribe to download it. Make sure you delete the local staging .PAK of the map before doing this, if you made one. You may need to restart Steam as well.


TIP: Add some screenshots to your Steam Workshop Page to promote the Map, and be sure the Thumbnail thoroughly represents the Map as it is used in the map selection screen ingame. To add screenshots, visit your Workshop Page on Steam and click on the "Add/edit images & videos" button on the right.

Creating an overhead map image

Add a Camera Actor to your map, preferable high (1000 units roughly) above your map
Rotate the camera -90° on the Y (green) axis so the camera is looking down
Change the Projection Mode to Orthographic
Press G (Game View) which will hide editor stuff
Right click the CameraActor and select Pilot 'CameraActor'
Change the View Mode from Wireframe to Lit
Change the Ortho Width so your whole map is in screen
If you want to remove some ceilings from of the camera, increase the Ortho Near Clip Plane until the ceiling you want to be removed is hidden

For taking a screenshot: Press F11 (Immersion Mode), press the arrow in the top left and choose "High Resolution Screenshot"
Press the camera at the bottom right to create your screenshot. The screenshot will be saved in ../YourProjectName/Saved/Screenshots/Windows/ folder

Stop piloting the CameraActor and delete the CameraActor. If you don't do this, your map will not load.

TIP: Pavlov VR does not use post processing effects, but many of them are on by default in the UE Viewports. You should disable them when Immersion Mode is active.

Troubleshooting

FAQ
The "Create New" Button is missing. Steam needs to be open and the used Account needs to have Pavlov purchased. Also check your firewall settings if it blocks any UE4 application.
The map does not update ingame or on the Workshop page. Restart Steam, close the Editor and go to your Project folder, delete the "Intermidiate", "Saved" and "Build" folder. Restart the Editor and try updating again.
The map was updated on the Workshop page but Steam won't download it. If Pavlov is open, close it. Be sure you are subscribed to it. Try restarting Steam. If it still won't download, unsubscribe from it and then resubscribe to it.
Loading the map ingame leads back to the Lobby. Check the Definition file if the map is linked properly.
Error "Definition not found". Check if your UGC ID matches the UGC ID in the Definitions file. The definitions file needs to be directly inside of the "UGCXXXXX" folder. This error also tends to appear in some cases where the project has multiple "UGC" folders, so make sure only the primary UGC folder is present when staging.
Map not loading ingame. Check if you have added a Pavlov Game Logic and assigned the definition file to it.
Textures or Models are not showing in-game and/or in the editor. Use "Fix up redirectors" and delete the "Build", "Saved" and "Intermediate" folder inside the Project folder. Also make sure ALL Assets are inside the UGCXXXXX Folder. Additionally, if having moved files between folders in the project, make sure to move the files in smaller groups and use "Fix up redirectors" after each move of a batch of files. (Right-click the "Content" folder, and choose "Fix up redirectors").
I lost my definition file. First make sure it's really gone, if it is, add a new Data Asset in the UGCXXXXX folder. Right click in the UGC folder, Miscellaneous > Data Asset > Choose Pavlov_Map > Name it definition (all lowercase). Fill in your Unique Id which is your UGC foldername ie. UGC123456789.
Nothing happens after I Stage or Deploy. Look at the Output Logs window for errors. Window > Developer Tools > Output Logs
I get an error saying "Pavlov installation not found", even though I'm building a Shack map. You can work around this by creating a dummy Pavlov executable in your Steam. Open up any Steam library in Windows Explorer, create a "steamapps\common\PavlovVR" folder, and put a blank file in this folder named "Pavlov.exe". Restart Unreal Engine and the Pavlov Workshop should tell you it's found a Pavlov installation.
I've done everything correctly but my Shack map isn't showing up in-game. Try deleting the map completely from your Quest, open and close Shack, then re-upload the map. Simply overwriting the map with a new copy is not always enough!

If you need further support, check the pinned messages in the workshop channels at Discord.gg/Pavlov-VR[1].

There's also an Unofficial Pavlov Map Making Guide[2] which may be more wordy and up-to-date.



Thanks for Reading!