Puzzle Creator

Template:Featured article tag

The **Puzzle Creator** (also known as **Puzzle Maker** or **Editor**) is a part of the Perpetual Testing Initiative in *Portal 2*, a DLC released on May 8th, 2012 allowing the creation of single-player and Co-op test chambers within a simple in-game editor.

In order to create a Co-operative puzzle, the chamber must be marked as a "Co-operative puzzle" in the "File" menu of the Puzzle Creator.

## Overview

The editor was first mentioned within *The Final Hours of Portal 2*, "[An in-game level browser won't be of much use unless] Valve figures out how to make designing Portal 2 maps an easier process. It has a plan there too, it comes in the form of a simplified level editor [...] a Photoshop for test chambers".

The "Puzzle Creator" does not appear to have a single official name; Valve published a blog post on the October 27, 2011 referring to the editor as the "Puzzle Creator", later referred to it on the blog post of April 27, 2012 as "Puzzle Maker" and simply calling it "Editor" in-game.

## Interface

The Puzzle Creator features a stylised representation of the test chamber being worked on; featuring a simplified, bright, and flat color palette, and models and textures lack the level of detail that they would have in-game.

 File:Puzzle Creator initial view.png
### Basic controls

* Hovering the mouse over the left screen edge displays the item list.
* The top edge of the screen features four buttons: "Build and play puzzle", "Undo", "Redo", and "Switch to game view".
* Selecting and dragging the upper-right corner pans the camera view.
* Selecting and dragging the right edge controls the camera zoom.
* Selecting and dragging the lower-right corner controls the camera rotation.
* Template:Key - Select a block or item.
* Template:Key - On background: Pans camera view; On chamber: Context menu.
* Template:Key - Click: Controls camera rotation; Scroll: Controls camera zoom (follows cursor).
* Template:Key - Zoom in/out.
* Template:Key - Rotate left/right.
* Template:Key - Pan left/right.
* Template:Key - Rotate up/down.
* Template:Key - Toggle surface portalability.
* Template:Key - Invert surface portalability.
* Template:Key - Push/pull (extrude) surface.
* Template:Key/Template:Key - Delete selection.

### Advanced controls

* Template:Key - Allows for batch selection of surfaces.
* Template:Key - Duplicates an item (does not duplicate any connections).
* Template:Key - Places an item on the surface opposite to the one facing the camera.
* Template:Key - Pushes/pulls surface if selected.

### Shortcuts

* Template:Key - New chamber
* Template:Key - Open...
* Template:Key - Save
* Template:Key - Save as...
* Template:Key - Switch to game view.
* Template:Key - Rebuild
* Template:Key - Exit editor
* Template:Key - Undo
* Template:Key - Redo
* Template:Key - Select all

## Items list

* File:Puzzle Creator pedestal button.png Pedestal Button (includes timer)
* File:Puzzle Creator portal button.png Button
* File:Puzzle Creator box socket.png Cube Button
* File:Puzzle Creator ball socket.png Sphere Button
* File:Puzzle Creator cube.png Weighted Cube (with dropper)
* File:Puzzle Creator companion cube.png Companion Cube (with dropper)
* File:Puzzle Creator edgeless safety cube.png Edgeless Safety Cube (with dropper)
* File:Puzzle Creator frankenturret.png Franken Cube (with dropper)
* File:Puzzle Creator tbeam.png Tractor Beam (reversible)
* File:Puzzle Creator faithplate.png Faith Plate
* File:Puzzle Creator hard light emitter.png Light Bridge
* File:Puzzle Creator stairs.png Stairs
* File:Puzzle Creator fizzler.png Fizzler
* File:Puzzle Creator glass.png Glass (can be turned into grating)
* File:Puzzle Creator arm paneltop.png Piston Platform
* File:Puzzle Creator arm motionplatform.png Track Platform
* File:Puzzle Creator laser emitter.png Laser Emitter
* File:Puzzle Creator laser catcher.png Laser Catcher
* File:Puzzle Creator laser receptacle.png Laser Relay
* File:Puzzle Creator reflection cube.png Reflection Cube (with dropper)
* File:Puzzle Creator airlock.png Glass Panel
* File:Puzzle Creator panel flap.png Angled Panel
* File:Puzzle Creator panel flip.png Flip Panel
* File:Puzzle Creator observation room.png Observation Room
* File:Puzzle Creator deathfield.png Laser Field
* File:Puzzle Creator turret.png Turret
* File:Puzzle Creator goo.png Deadly Goo
* File:Puzzle Creator light panel.png Light Strip
* File:Puzzle Creator paintsplat bounce.png Bounce Gel (with dropper)
* File:Puzzle Creator paintsplat speed.png Speed Gel (with dropper)
* File:Puzzle Creator paintsplat portal.png Conversion Gel (with dropper)
* File:Puzzle Creator paintsplat water.png Cleansing Gel (with dropper)

### Default items

These are the mandatory items are placed in the chamber, and can only be moved.

* File:Puzzle Creator portal door.png Entry Door (with Co-op variant)
* File:Puzzle Creator portal door.png Exit Door (with Co-op variant)
* File:Puzzle Creator observation room.png Large Observation Room

### Educational Version items

These items are exclusively featured in the Portal 2 - Educational Version.

* Contraption Cube Receptacle
* File:Puzzle Creator contraption cube.png Contraption Cube (with dropper)
* Text bubbles

## Hints

### Initial non-repeating hints

* Click a chamber surface tile to select it.
* Click and drag across several surfaces to block-select.
* Right click selections to change surface portalability.
* Drag the boundary edge of a selection to move the highlighted surfaces.
* Press and drag the background to rotate your camera view.
* Move the mouse to the far left edge of the screen to open the puzzle item palette.

### Beginner

* Right click an item to change its properties or connect items together.
* The entry door, exit door, and large observation room are mandatory items. They can be moved, but they cannot be deleted or duplicated.
* Use the Template:Key and Template:Key keys to quickly modify selected chamber surfaces.
* Press Template:Key to change portalability of selected surfaces.
* Use the controls along the far right edge of the editor window to pan, zoom, and rotate your camera view.
* Rotate the camera view up to work on the ceiling.
* Rapidly duplicate puzzle items by holding down Template:Key while moving them.
* Use the mouse scroll wheel to zoom in and out.
* Some items need to occupy space behind the surface they are mounted to. Look for a dashed outline of the required volume while you move them.
* Some item placements are incompatible and will show an error indication until they are fixed.

### Early intermediate

* Use the adjustment gizmo that appears when you click an item to reposition it on its surface.
* Double click a surface to automatically expand the selection around all adjacent coplanar surfaces.
* Block-select surfaces on different planes to select a volume.
* Look for hotkey shortcuts along the right side of menus.
* The large mandatory observation room emits a bright light that casts shadows. Position it to enhance the visual effect of your chamber.
* Are your puzzles too dark? Use small observation room and light strip items to control the illumination level throughout your chamber.
* Press and drag the middle mouse wheel/button to rotate the camera view.
* The icons along the left side of a context menu are buttons that can be used repeatedly while the menu is open.
* Press and drag the middle mouse wheel/button while holding down Template:Key to pan the camera view.
* With a volume selected, the Template:Key and Template:Key keys will fill or carve.
* Press and drag the right mouse button to rotate the camera view.
* Drag the boundary of a volume selection set to move a portion of your chamber along any 3D axis.

### Intermediate

* Connect multiple buttons to a receiving item: This requires all to be pressed simultaneously for activation.
* Hold down the spacebar and drag anywhere to quickly move selected surfaces and volumes.
* Use Template:Key key to reset the camera view.
* Press Template:Key to rebuild and run your puzzle.
* Use Template:Key, Template:Key, Template:Key, Template:Key keys to move the camera view.
* Use the Template:Key Template:Key and Template:Key Template:Key keys to rotate the camera view.
* Press the Template:Key key to invert the portalability of selected surfaces
* Connect items together quickly by selecting one and using the Template:Key key.
* Hold down Template:Key while moving items to keep them on surfaces facing away from the camera view.
* Hold down Template:Key while rotating turrets and dropper-less cubes to snap their orientation to 45 degree increments.

### Advanced

* When previewing your puzzle in first-person mode, use the 'noclip' console command to quickly navigate the chamber.
* Place up to 4 light strips on a surface by using their adjustment gizmo.
* Change glass to grating by right clicking and changing the barrier type.
* Drag a trajectory target back onto its faith plate to create a vertical launch.
* Create a pre-placed gel splat by deleting or disabling the associated dropper.

### "WIP Editing" (unused)

*Some of the controls referenced here no longer work, and appear to be from an early version of the editor.*

* Hold down SHIFT while clicking surfaces to expand the selection.
* Use Arrow keys to nudge the selection.
* Shift+arrow keys moves the carat in floor space.
* Use the PageUp/PageDown keys to nudge the selection in and out.
* Use Shift + arrow keys to expand the carat (Alt+Shift to move the opposite end)
* Holding down Spacebar while using the arrow keys to move the volume selection.
* Hold down CTRL while moving volume selections to duplicate the selection.
* Use number keys 1-0 to place an item type. Repeatedly tap to cycle through options.
* Use CTRL+number keys to set the camera to a preset view.
* Use CTRL+F5-F8 to save a custom view setting. F5-F8 to restore the view.

### Puzzlecraft tips (unused)

* Keep goals clear: The puzzle exit should always be visible upon entry.
* Keep puzzles simple. Players should be able to keep the solution in their head.
* Keep puzzles transparent. Players should always see the effect of pressing buttons. Avoid putting things in separate rooms.
* Keep puzzles about the cerebral challenge, not the execution: Puzzles should be easy to solve once players know the solution.
* If you want your puzzle to be broadly played and enjoyed, don't make players rely on precise timing or 'ninja' FPS skills.
* Twitchy puzzles that require precise timing are less fun for most players. Expect a smaller audience.
* Maintain a sense of progression: Split up large puzzles into a series of smaller experiences.
* Maintain a sense of progression: Avoid puzzles that force the player to revisit the same area again and again.
* Puzzles are a contest between author and player where the player is ALWAYS expected to win in the end.
* Good puzzles are not so tricky to be frustrating, but just tricky enough to make players feel smart when they solve it.
* Keep it simple: Fewer puzzle elements arranged in a clear, strong way are better than many elements organized in a tangled knot.
* Playtest early and often to know what parts your audience finds too easy or too hard.
* Keep t-beams away from buttons where they can accidentally lift placed buttons or players.
* Avoid lasers that are always in the players movement path: they can get annoying really fast.
* It's okay to have more than one way to solve a puzzle, just be aware that the alternatives exist and that they don't ruin the puzzle.
* When you add another mechanic to your puzzle, you're increasing complexity -- make sure each added mechanic justifies its existence by contributing something interesting to the puzzle.
* Find a fun central concept for the puzzle and design back from there.
* Be careful not to put critical elements on the ceiling. Players rarely look up (or down) unless guided to.
* There should be a twist in every map. Players get more enjoyment when they figure the twist than when they actually solve the puzzle. The ideal case builds a lot of suspense. 'Whoa! I think this might work' ... [tries crazy idea] ... 'That's awesome! I can't believe I did that!'
* Avoid straightforward puzzles. They are boring.
* Players can't judge how far they will fling - try to avoid making a puzzle with multiple options for a fling where players need to choose the same one.
* Don't make a space that allows for an infini-fling unless it is part of the puzzle. When players are stumped they will frequently try this mechanic. It's also a complicated maneuver so it's possible to fail for a long time before you realize that it's not how to solve the puzzle.
* Avoid creating linear puzzles in linear spaces.
* Stick to using puzzle mechanics already defined in Portal 2. Most players don't appreciate idiosyncratic behavior.
* Play along with users' expectations of how puzzle items function. Defying their expectations loses their trust in how anything will function.
* Buttons should only have a single output. Multiple outputs can be confusing.
* Never, ever let the player get into an un-winnable state.
* Don't allow cubes to get into places where the player cannot retrieve them.
* Avoid using floor-portal orientations as a puzzle mechanic, as most players are unaware portals even have an orientation.
* People's eyes are drawn towards brighter areas. Use lighting to direct player attention.
* Use strip light array, lasers, and other linear features to direct player view along a line.
* Avoid "chambers within chambers" where players can't see the consequences of their actions on the puzzle state.
* Testers want to help you improve your map. Listen to their feedback carefullly and always remember to thank them for their time.

## Limitations

As the puzzle creator is designed for ease of use, certain limitations apply. These limitations can be overcome by exporting the map to Hammer (see Related Commands).

* There is a limit of 1750 entities in a single chamber, as opposed to 2048 in Hammer maps. Items consist of multiple entities, meaning the actual number of placeable items is much lower than this.
* The editor is block based, meaning that angles and smaller geometry cannot be achieved without the use of custom items such as the BEE2's partial blocks.
* Chambers are isolated, so sequences of chambers cannot be published as one map using the Puzzle Creator alone.
* Some item placements are disallowed, such as items placed in midair or inside of other items. While somewhat standard for in-game level editors, no such placement rules exist in Hammer.

## Related commands

* `puzzlemaker_autosave_dev` - Forces an autosave, saving the current puzzle as 'autosave.p2c'.
* `puzzlemaker_compile_and_preview` - Compiles the map and loads it in preview mode.
* `puzzlemaker_compile_and_publish` - Compiles the map and opens the publish dialog.
* `puzzlemaker_current_hint` - The hint number to display in the compile progress window. This is incremented by 1 every time a compile is started.
* `puzzlemaker_drawselectionmeshes 0/1` - When enabled, editor model selection meshes are drawn as red wireframes.
* `puzzlemaker_enable_budget_bar 0/1` - When enabled, a "budget bar" is shown in the bottom-left corner.
* `puzzlemaker_export <name>` - Exports the current puzzle as 'name.vmf', to open it in Hammer. Maps are saved to 'common\portal 2\sdk\_content\maps\'.
* `puzzlemaker_load_dev` - Loads the puzzle with the filename 'name.p2c'.
* `puzzlemaker_new_chamber` - Opens a new chamber
* `puzzlemaker_open_chamber` - Displays the open dialog
* `puzzlemaker_play_sounds 0/1` - Sets if the puzzlemaker can play sounds or not.
* `puzzlemaker_publish_dev` - compile the current puzzle and publish it to the Steam workshop
* `puzzlemaker_quit`
* `puzzlemaker_request_publish`
* `puzzlemaker_save_chamber`
* `puzzlemaker_save_dev <name>` save the current puzzle as 'name.p2c'
* `puzzlemaker_shadows 0/1` - Enables unfinished shadows in the puzzlemaker.
* `puzzlemaker_show_overlay_web_page`
* `puzzlemaker_show 0/1` - 1 shows the puzzle maker, 0 hides it
* `puzzlemaker_zoom_to_mouse 0/1/2` - 0-zoom to center of screen, 1-zoom to mouse cursor (smart), 2-zoom to mouse cursor

## Unused content

The following have been found in the game files:

* File:Puzzle Creator faithplate 128.png Large Aerial Faith Plate
* 'Push out' panel
* A radial menu with voting criteria for a map, including "confused" and "stuck".
* Various "upgrade" badge textures.
* File:Puzzle Creator crusher.png Crusher
* File:Fixed portal door.png Autoportal
* File:Puzzle Creator panel door.png A Glass panel
* 4x1 observation room
* Shadows, enabled with the `puzzlemaker_shadows` command. They are somewhat buggy, and don't accurately represent the actual lighting in the chamber.
* A "budget bar", enabled with the `puzzlemaker_enable_budget_bar` command. This bar will fill up as objects are added to the chamber. When exceeded, the editor will not allow the chamber to be built, using the "build failed" message normally only seen when there are placement errors in the map. The final editor simply relies on the compiler to throw an error when over engine limits, instead of implementing an arbitrary system.

## Modifications

Modifications are addons that add custom content to the Puzzle Maker.

### BEEmod

**BEEmod** is a well-known Puzzlemaker mod which adds additional content to the editor. The latest version of the mod is version 2.4, which uses a standalone app to configure the item palette and other options not available within the Puzzle Creator itself. Some of BEE2.4's features include additional items such as High Energy Pellets and Autoportals, styles such as Portal 1 and Overgrown, and a large selection of music from various Portal games and mods. BEE2.4 can be downloaded from its GitHub page.

## References

1. ↑ 1.0 1.1 ShackNews article *Portal 2 in-game map editor confirmed* accessed 22 October 2011
2. ↑ Portal 2 - The Final Hours, page 10 of chapter "Unlikely Architects".
3. ↑ Portal 2 Puzzle Creator Sneak Peek
4. ↑ The Perpetual Testing Initiative

## External links

* Official "Tips" page
* Official "Controls" page