Choose your operating system:
Windows
macOS
Linux
Unreal Editor allows you to spawn a player anywhere and instantly preview your game from within the editor without waiting for files to save. There are two preview types available: Play In Editor (PIE) which is directly accessed via the Play button located on the Main Toolbar and Simulate In Editor (SIE) which is accessed via the Play dropdown menu ( Alt+S ). The in-editor preview system supports toggling between Play In Editor and Simulate In Editor sessions, so that you can quickly iterate on gameplay and asset tweaks and see how your game changes as a result.
When you launch a game preview session, the editor quickly creates a duplicate copy of your level. Changes can be saved back to the editor copy of the level using Keep Simulation Changes . This duplication of the level keeps the editor's copy of the world safely immutable.
Game previewing includes level streaming, and the World Outliner will update accordingly so that you can select and edit Actors that are streamed in as a result of gameplay. Any Actors you have selected when you begin testing your game with a Play In Editor or Simulate In Editor session will remain selected. The reverse is also true, so any Actors selected during in-editor testing will remain selected after you end the testing session. This means that the Details panel will show the properties for an Actor you select because you want to change its appearance or behavior, even if you begin gameplay in a distant section of the level.
Toolbar
You can begin a Simulate In Editor or Play In Editor session from either the Level Editor or the Blueprint Editor , using the appropriate Toolbar buttons or dropdown menus.
From the Level Editor , you can click the Play button.
This will start a Play In Editor (PIE) session, so that gameplay can be tested directly from the editor. Different modes and options for Play In Editor sessions can be selected in the dropdown menu, and the Play In button will use the same settings that were selected for the previous session.
Click the Play dropdown button to display the Play Options dropdown menu.
You can change your Play In Editor mode , set basic networked Play In Editor options, or open the full Play In Editor settings window . Clicking on Simulate begins Simulate In Editor mode, which changes the testing section of the Toolbar. While simulating, you can pause or stop gameplay, as well as swap to a Play In Editor session with the Possess button.
Play In Editor
Clicking on the Play button in the toolbar ( Alt + P ) or selecting Play From Here in the Viewport context menu begins a Play In Editor session. Play In Editor allows you to play the current level directly from the editor, so that you can test gameplay functionality, including player controls and level events triggered by players' actions.
Modes
Launching a game preview with a different mode will change the default Play mode that is activated by the Play button.
Display Types
- Viewport
-
Gameplay will be shown in the active Level Editor viewport.
- New Window
-
Gameplay will be shown in a new window. To change the default size of new windows, use the Play In Editor settings window .
- Standalone Game
-
Gameplay will be shown in a new window that runs in its own process. To change the default standalone window size, use the Play In Editor settings window .
Start Locations
- Camera Location
-
Gameplay begins at the current camera location.
- Default Player Start
-
Gameplay begins at the Player Start location.
If your game uses a NavMesh for either player-controlled or AI-controlled movement, using Camera Location for your Play In Editor starting location could cause you to spawn in a location that breaks pathing. In this case, starting a Play In Editor session from the Default Player Start is recommended.
Play From Here
You can access an additional Play In Editor mode by right-clicking in the
Viewport
and selecting
Play From Here
.
Play From Here
begins gameplay at the location that you have clicked, and acts as if your
Display Type
is set to
Level Viewport
.
Switching to Simulate In Editor
While in a Play In Editor session in a viewport, press Shift+F1 to regain your mouse control. Then, click on Eject in the Toolbar to switch to a Simulate In Editor session. You will detach from the player controller, and begin a Simulate In Editor session at your current location.
You can also press the Eject keyboard shortcut ( F10 ) to switch to Simulate In Editor from Play In Editor.
If you have set up more than one client for your Play In Editor testing with Networked Play In Editor , only the first session (the one in the Viewport ) will support switching to Simulate In Editor mode. Even for single-player gameplay testing, Play In Editor sessions where the game is in a new window or in a standalone game process do not support switching to Simulate In Editor.
Simulate In Editor
Using the Simulate button begins a Simulate In Editor session in the currently active viewport. While simulating, gameplay begins, including the execution of Blueprints and C++ code that do not rely on a player's interaction with the game. While simulating, you have full access to the Editor's tools, so you can modify the scene and its contents, or even place new Actors. You can also select and inspect Pawns controlled by AI right as they are performing actions, and quickly debug and tweak gameplay behaviors. However, because you are not using a PlayerController while simulating, you cannot enter game controls. You can save certain changes made in a Simulate In Editor session using Keep Simulation Changes .
Switching to Play In Editor
While in a Simulate In Editor session, you can click on Possess in the Toolbar to switch to a Play In Editor session. You will attach to the player controller, and begin a Play In Editor session in the active level viewport.
You can also press the Possess keyboard shortcut ( F10 ) to switch to Play In Editor from Simulate In Editor.
If you began in-editor testing with a Simulate In Editor session, and then used Possess to attach to the player controller, you will begin your Play In Editor session at the default player start. This is equivalent to selecting Play > Selected Viewport > Default Player Start from the Play dropdown menu. However, if you had previously swapped from a Play In Editor session to a Simulate In Editor session, without leaving in-editor testing mode, when you click Possess , you will re-attach to the player controller and resume gameplay at the location in the level where you previously clicked on Eject .
Testing Gameplay
Blueprints
When you enter Play In Editor or Simulate In Editor mode, all your Blueprint are compiled, although they are not saved. While playing or simulating, all Blueprint graphs are read-only, so you cannot add additional nodes or connect wires differently.
However, you can change Blueprint defaults while a preview session is active, and the changes will be applied to all instances of that Blueprint in the level you are testing.
C++
For projects that contain C++ code, there is a Compile button on the Level Editor Toolbar . This button recompiles and reloads game code on the fly. If you change a property or a function in a C++ file in your project, clicking the Compile button will recompile and reload your game module, so that your code changes are reflected in the editor. In some cases, you can even compile while using Play In Editor or Simulate In Editor, and your code changes will update without you needing to stop gameplay or simulation.