User:ZXCubed: Difference between revisions

From Pavlov VR Wiki
Jump to navigation Jump to search
mNo edit summary
Tags: Manual revert Visual edit
m (totally a minor edit)
Line 1: Line 1:
Hi!! I'm cubed. I'm currently working on the [[Default Maps]] page. I'll work on other pages ''soon''.
Hi!! I'm cubed. I'm currently working on the [[Getting Started]] page.


You can learn more about me on my [https://zxcubed.carrd.co carrd]!
You can learn more about me on my [https://zxcubed.carrd.co carrd]!
Getting Started
== Setting up the Project ==
NOTE: '''Unreal Engine 4.27 (Legacy PC Engine) will become obsolete in the future. It's best to use Unreal Engine 5.1.1 (Shack & PC Engine) instead.'''
To start making Pavlov Maps, you'll need to register an account for Epic Games and Mod.io (for UE5.1.1). For the Mod.io account, you'll need to verify your email (or else you can't make your maps!).
Epic Games Launcher:
https://store.epicgames.com/en-US/download
Mod.io:
https://mod.io/g/pavlov
You'll also need to install Epic Games Launcher (if you don't have it already). Next, open the Unreal Engine tab in the launcher and install the one you want to mod with (shown below).
{| class="wikitable"
|+
!Shack & PC Engine
!Legacy PC Engine
|-
|Unreal Engine 5.1.1
|Unreal Engine 4.27.x
|}
NOTE: '''When installing UE5.1.1, select the following to install along with UE5.1.1:'''
* Starter Content
* Engine Source
* Android (needed for shack)
* Linux
Lastly, you need to install the Pavlov VR modkit corresponding to your Engine Version (once on github click "code" then "download zip").
UE5.1.1 modkit:
https://github.com/vankruptgames/PavlovVR-ModKit/tree/5.1.1
UE4.27.x modkit:
https://github.com/vankruptgames/PavlovVR-ModKit
Extract the modkit, and open the project. When loading the project, the modkit will stay at 45% while it compiles shaders. Once it finishes compiling, click window, open Pavlov Workshop then log in to your Mod.io Account (UE5.1.1 only).
UE5.1.1 Login Steps:
# Enter Username and Password from Mod.io
# Open your Email and paste the code from the email to the Editor (request another if you need it).
# You're signed in!
To create a mod in UE5.1.1, you need to open the "Create Mod" tab and enter your map name and description. Logo image isn't required when making a map. Once putting in all of the information, press "Create Mod". This will create a UGCxxxxxxx folder, giving your mod a unique code (shown as the x's) that'll be used to figure out what map is currently being played in a server and if it'll need to be downloaded locally.
NOTE: '''ALL assets used in your map MUST be in your UGCxxxxxxx folder.'''
== Creating your Map ==
To create your map, you need to enter your UGCxxxxxxx folder (easier to do this) and press CTRL+S (CMD+S on Mac). This saves your map (currently filled with nothing). You can add objects into your map using the "Place Actors" window. You should also add <code>BP_SkySphere</code> (located in the Engine folder) and <code>Directional Light</code> (search for it in the "Place Actors" window) if you're on UE5.1.1.
In order for your map to function properly in Pavlov, you need to link your map to the "definition" file in your UGCxxxxxxx folder. In the definition file, you're able to see:
{| class="wikitable"
|+
Definition File Contents
!Name
!Description
!Example
|-
|Unique Id (do not change)
|
|UGC1234567
|-
|Label
|
|MyMap
|-
|Version
|
|2.1
|-
|Thumbnail
|
|[[File:ChickenTrans.png|frameless|100x100px]]
|-
|Map
|
|MyMap <small>(level)</small>
|-
|Quest Map
|
|MyMapShack <small>(level)</small>
|-
|Hidden
|
|Unchecked
|-
|Compatibility
|
|<nowiki>Custom | Deathmatch | Team Deathmatch</nowiki>
|-
|Custom Game Mode
|
|Checked
|-
|Custom Game Mode Label
|
|MyGameMode
|}
You should change your "Label" to the name you want your map to have. Version should only be changed if you made changes to an already existing map you've made.
Link your Map or Quest Map to the level you saved earlier which should be called "NewMap" if you haven't changed the name yet. Compatibility should be changed later on (depending on how you make your map) but can be changed now if wanted.
==== Pavlov Game Logic ====
----Before publishing your map, in order for your map to work, you need to add a Pavlov Game Logic. You can find it by searching it up in the "Place Actors" window. Once placed in the map, change its settings under the Pavlov tab inside of the Game Logic. Set "Definition" to the definition file inside of your UGCxxxxxxx folder. You'll also need to set:
{| class="wikitable"
|+
|Global Info Class
|to
|Pavlov_GlobalInfo
|-
|Player Info Class
|to
|Pavlov_PlayerInfo
|-
|Player Proxy Class
|to
|Pavlov_PlayerProxy
|}
You can set these to your own custom info or proxies but these are the ones you should set if you aren't customizing anything.
==== Spawns ====
----In order to properly spawn in your map, you need Pavlov Spawns in your map (search for PavlovSpawn in "Place Actors"). The settings to the Spawns are:
{| class="wikitable"
|+
! colspan="2" |Spawnflags
|-
|TeamID
| -1 = Any Team
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
|}
=== Migrate maps to Modkit ===
----To migrate maps from Unreal Engine projects to the modkit, open the project with the map, select the level file. Right click the file and select migrate. A folder tree with all the referenced files of the map will show up. Press "OK." A file explorer will open after and you'll need to find the UGCxxxxxxx folder directory to import the map to the modkit. After, right click the Content root folder and select '''"Fix up redirectors"'''. This will fix all the asset references.

Revision as of 22:04, 2 September 2023

Hi!! I'm cubed. I'm currently working on the Getting Started page.

You can learn more about me on my carrd!


Getting Started

Setting up the Project

NOTE: Unreal Engine 4.27 (Legacy PC Engine) will become obsolete in the future. It's best to use Unreal Engine 5.1.1 (Shack & PC Engine) instead.

To start making Pavlov Maps, you'll need to register an account for Epic Games and Mod.io (for UE5.1.1). For the Mod.io account, you'll need to verify your email (or else you can't make your maps!).

Epic Games Launcher:

https://store.epicgames.com/en-US/download

Mod.io:

https://mod.io/g/pavlov

You'll also need to install Epic Games Launcher (if you don't have it already). Next, open the Unreal Engine tab in the launcher and install the one you want to mod with (shown below).

Shack & PC Engine Legacy PC Engine
Unreal Engine 5.1.1 Unreal Engine 4.27.x

NOTE: When installing UE5.1.1, select the following to install along with UE5.1.1:

  • Starter Content
  • Engine Source
  • Android (needed for shack)
  • Linux

Lastly, you need to install the Pavlov VR modkit corresponding to your Engine Version (once on github click "code" then "download zip").

UE5.1.1 modkit:

https://github.com/vankruptgames/PavlovVR-ModKit/tree/5.1.1

UE4.27.x modkit:

https://github.com/vankruptgames/PavlovVR-ModKit

Extract the modkit, and open the project. When loading the project, the modkit will stay at 45% while it compiles shaders. Once it finishes compiling, click window, open Pavlov Workshop then log in to your Mod.io Account (UE5.1.1 only).

UE5.1.1 Login Steps:

  1. Enter Username and Password from Mod.io
  2. Open your Email and paste the code from the email to the Editor (request another if you need it).
  3. You're signed in!

To create a mod in UE5.1.1, you need to open the "Create Mod" tab and enter your map name and description. Logo image isn't required when making a map. Once putting in all of the information, press "Create Mod". This will create a UGCxxxxxxx folder, giving your mod a unique code (shown as the x's) that'll be used to figure out what map is currently being played in a server and if it'll need to be downloaded locally.

NOTE: ALL assets used in your map MUST be in your UGCxxxxxxx folder.

Creating your Map

To create your map, you need to enter your UGCxxxxxxx folder (easier to do this) and press CTRL+S (CMD+S on Mac). This saves your map (currently filled with nothing). You can add objects into your map using the "Place Actors" window. You should also add BP_SkySphere (located in the Engine folder) and Directional Light (search for it in the "Place Actors" window) if you're on UE5.1.1.

In order for your map to function properly in Pavlov, you need to link your map to the "definition" file in your UGCxxxxxxx folder. In the definition file, you're able to see:

Definition File Contents
Name Description Example
Unique Id (do not change) UGC1234567
Label MyMap
Version 2.1
Thumbnail ChickenTrans.png
Map MyMap (level)
Quest Map MyMapShack (level)
Hidden Unchecked
Compatibility Custom | Deathmatch | Team Deathmatch
Custom Game Mode Checked
Custom Game Mode Label MyGameMode


You should change your "Label" to the name you want your map to have. Version should only be changed if you made changes to an already existing map you've made.

Link your Map or Quest Map to the level you saved earlier which should be called "NewMap" if you haven't changed the name yet. Compatibility should be changed later on (depending on how you make your map) but can be changed now if wanted.

Pavlov Game Logic


Before publishing your map, in order for your map to work, you need to add a Pavlov Game Logic. You can find it by searching it up in the "Place Actors" window. Once placed in the map, change its settings under the Pavlov tab inside of the Game Logic. Set "Definition" to the definition file inside of your UGCxxxxxxx folder. You'll also need to set:

Global Info Class to Pavlov_GlobalInfo
Player Info Class to Pavlov_PlayerInfo
Player Proxy Class to Pavlov_PlayerProxy


You can set these to your own custom info or proxies but these are the ones you should set if you aren't customizing anything.

Spawns


In order to properly spawn in your map, you need Pavlov Spawns in your map (search for PavlovSpawn in "Place Actors"). The settings to the Spawns are:

Spawnflags
TeamID -1 = Any Team

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

Migrate maps to Modkit


To migrate maps from Unreal Engine projects to the modkit, open the project with the map, select the level file. Right click the file and select migrate. A folder tree with all the referenced files of the map will show up. Press "OK." A file explorer will open after and you'll need to find the UGCxxxxxxx folder directory to import the map to the modkit. After, right click the Content root folder and select "Fix up redirectors". This will fix all the asset references.