Main Menu

Portal 2 Perpetual Testing Initiative

 Are you having issues with your Portal 2 Puzzle? Read on for some steps to fix it!

Do you have the Portal 2 Authoring Tools installed?

If so, verify your game cache files for Portal 2 by doing the following here.

Do you have too many items?

If you receive the error below, you created a puzzle with too many items. Please delete a few items and check that your puzzle rebuilds properly.

Build Error: There was an error building the puzzle

If you are having the following error message, you may have one of several issues listed below.

Incorrect Error Message on Mac

The game may incorrectly show Mac users the generic "Build Error" message, instead of the more specific "too many items" error message. To determine if this is happening, first enable the Developer Console (this is in the main menu, under Options and Keyboard/Mouse) and open it using the ~ (tilde) key at the top-left of your keyboard (this key will toggle the Developer Console open/closed). Once your puzzle has failed to build, look at the red text which appears in the Developer Console. If you have too many items in your puzzle, you will see some text like this:

        VBSP: ERROR!  '-entity_limit' exceeded (1924 out of 1750)

Huge Maps Error

We currently have a problem where very large puzzles may fail to rebuild. If you can shrink your chamber slightly or split it into multiple parts and work on them as multiple separate puzzles (the Save As menu option will help with this) that should allow you to continue with your work until we fix the bug. Here is an example of a puzzle that had this issue:

Programs that interfere with building

If you are getting a build error message make sure that you aren't running any programs that interfere with Steam as listed here. Specifically, we have reports that running Comodo Anti-virus or Threatfire anti-virus will cause this to occur. Switching Comodo to "Game Mode" should correct the issue, as will temporarily disabling Threatfire.

If all else fails...

  1. Verify your local Portal 2 game cache by following these instructions.
  2. If the files were fixed on your machine, test your compile again.
  3. Find the error.p2c file in: (/SteamApps/common/Portal 2/portal2/puzzles/"big number"/error.p2c)
  4. E-mail the file to


Problem with Steam?

Help Me With My Issue