{"id":853,"date":"2020-03-06T07:46:13","date_gmt":"2020-03-06T07:46:13","guid":{"rendered":"http:\/\/www.chozabu.net\/blog\/?page_id=853"},"modified":"2024-02-04T14:20:31","modified_gmt":"2024-02-04T14:20:31","slug":"portalsbp-docs","status":"publish","type":"page","link":"http:\/\/www.chozabu.net\/blog\/?page_id=853","title":{"rendered":"PortalsBP Docs"},"content":{"rendered":"\n
\"\"<\/figure>\n\n\n\n

By Alex “Chozabu” PB – with some fantastic contributions from Spencer Crapo<\/p>\n\n\n\n

See on marketplace here: https:\/\/www.unrealengine.com\/marketplace\/portals-blueprint<\/a>
<\/p>\n\n\n\n

These docs are for 4.23+ – <\/strong>if using an older version, please check the old docs<\/a><\/p>\n\n\n\n

This portal system is designed to allow you to connect two points in space though there are several important limitations<\/em>, see \u201cImportant Notes\u201d at the bottom of the document.
<\/p>\n\n\n\n

If this doc does not answer your question, you can ask a question on the marketplace page, contact me on discord: https:\/\/discord.gg\/xeBWY9N<\/a> or by email ( chozabu+portalsbp@gmail.com).<\/p>\n\n\n\n

Usage:<\/strong><\/h3>\n\n\n\n

Adding to Your own project<\/h4>\n\n\n\n

You must enable \u201cGlobal Clip Plane\u201d in project settings.<\/strong><\/p>\n\n\n\n

Migrate over the PortalBP actor.
<\/p>\n\n\n\n

Creating a portal:<\/h4>\n\n\n\n

Place two \u201cPortalBP\u201d actors in your level, select \u201cPortalBP\u201d and in the details panel

Set the \u201cPortalTarget\u201d to \u201cPortalBP2\u201d
Select \u201cPortalBP2\u201d and set its \u201cPortalTarget\u201d to \u201cPortalBP\u201d
<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

Customising Recursion<\/h4>\n\n\n\n

If you don’t add a PortalRenderManager to a level – one will be created OnBeginPlay.<\/p>\n\n\n\n

To change its settings (recursion limit) you can either edit the BP to change globally, or add an instance to the level to change just for that level.<\/p>\n\n\n\n

Setting up your Player Pawn<\/h4>\n\n\n\n

On your player pawn (if 1st person), you should also implement PortalCameraInterface, and return the players camera location.
For a 3rd person pawn, you may still implement, but return the character, or 1st person camera location.<\/strong><\/p>\n\n\n\n

Usually a portal teleports an object when its center enters a portal. The purpose of PortalCameraInterface <\/strong>is so, with a first person setup, the pawn will teleport when the camera crosses the portal.
<\/p>\n\n\n\n

Additional Setup:<\/strong><\/h3>\n\n\n\n

Ensure your project has “Global Clip Plane” enabled.<\/p>\n\n\n\n

\"\"\/<\/figure>\n\n\n\n

Also make sure the portals \u201cNear Clip Plane\u201d distance matches your projects \u201cNear Clip Plane\u201d if non-standard.
<\/p>\n\n\n\n

Anything that should pass through a portal must generate overlap events.
<\/p>\n\n\n\n

Portal Quality:<\/strong><\/h3>\n\n\n\n

-RenderMipScaledownSpeed – set this value closer to 0 to improve portal quality at a distance, bring it closer to 1 to increase performance at the cost of quality
-UseSimpleRenderMethod – disabled optimisations, should give perfect quality portals
<\/p>\n\n\n\n

Important Notes:<\/strong><\/h3>\n\n\n\n

Though an object appears to be on both sides of a portal when touching one – in terms of physics it is only on one side of the portal. This means you may experience physics weirdness when an object is being pushed through a portal. Again, I have plans to change this in the future, but no promises.
<\/p>\n\n\n\n

Performance – each portal can do a full re-render of the level – I\u2019ve done some work to optimise here, but keep performance in mind, and check you are not going over your frame-budget.
<\/p>\n\n\n\n

SpringArm will not function well – there is an example of custom 3rd person camera on EPlayer blueprint. Fuzzy Tom also mentions he has had some success with inbuilt spring arm when camera position lag is disabled.<\/p>\n\n\n\n

Changelog<\/h2>\n\n\n\n

v24<\/em> (2021\/10\/15)<\/h2>\n\n\n\n