• happens only in coop mode
• can only be caused by the client (p-body)
• can happen by accident or willingly

1) the client steps on a floor_button for a very short time or jumps repeatedly
2) the outputs of the button will (at some point) get reversed

• Whatever is connected with that button will then be permanently toggled.
• Which leads to broken puzzles and/or confused players.

• player stands on button > button > OnPressed > [enable connection]
• player leaves the button > button > OnUnPressed > [disable connection]


If you press and release the button fast enough, the enable part is sometimes send
just after the disable part, which leads to permanently toggled connections.

• it is a bug
• breaks puzzles
• leads to confusion
• might lead to negative feedback
• can happen on all cooperative maps





Buttons are connected to other objects to enable or disable them.
You build your puzzle around that mechanic and trust that it is working.

Now imagine some players on your cooperative map are able to bypass
a big part of the map, because the connection of the button was enabled
all the time, altough no player was standing on the button.

The bug can happen by accident and I have seen many people report it.
Some of them did not even notice that it was a bug.
Which leads to confusion or broken puzzles.

In order to fix the bug we have to make sure, that the output states
'pressed' and 'unpressed' are always send correctly.

Now we can't edit how the button itself works very easily,
so we use another entity to handle the outputs instead.

The 'logic_branch' entity stores a boolean value (true or false)
in the form of '1' for true and '0' for false.

Now everytime the button is pressed or unpressed we toggle the stored
value of the branch in order to always have a correct connection state.

• button > OnPressed > branch > ToggleTest
• button > OnUnPressed > branch > ToggleTest


• branch > OnTrue > [enable connection]
• branch > OnFalse > [disable connection]


<<< normal | bug >>>

As you can see here, the button outputs are switched (after jumping on it)
and the branch still sends "FALSE" as the last connection state.

The PuzzleMaker loads all information about the used instances
from the 'editoritems.txt' file, which includes the connection input/outputs.

In order to integrate the 'logic_branch' into the buttons logic,
we have to change the 'ConnectionStandard':





1) goto and open:
"Steam\steamapps\common\Portal 2\portal2_dlc2\scripts\editoritems.txt"

2) search for text:
"instances/p2editor/floor_ball_button_black.vmf"

3) a few lines beneath that text, look for:
"Outputs" and "CONNECTION_STANDARD"

4) change the "Activate" and "Deactivate" part to:
"Activate" "instance:branch;OnTrue"
"Deactivate" "instance:branch;OnFalse"

5) save the file and also make an extra copy of the modded file
If the game gets updated you might have to change the editoritems.txt again.
So make sure to make a copy of the modded file to make it easier next time.

If you know how to work with the Portal 2 Authoring Tools Beta (Hammer Editor),
then you might aswell go ahead and try to fix the bug yourself with the information provided.

• floor_button_white_intact.vmf
• floor_button_black_intact.vmf
• floor_cube_button_white.vmf
• floor_cube_button_black.vmf
• floor_ball_button_white.vmf
• floor_ball_button_black.vmf

For all the other people, that don't know how to use the Hammer Editor,
I have provided the fixed instances via download here:

1) click on this link[forums.thinking.withportals.com]
• find and click the "Download" button on that Page

2) go to your Steam folder an navigate to:
"Steam\steamapps\common\Portal 2\sdk_content\maps\instances\p2editor\"

3) extract the downloaded instances into that folder
• overwrite existing files

Whenever there is an Portal 2 update, or when you manually check the integrity
of your game files, the 'editoritems.txt' and the fixed instances will be overwritten
and therefore you have to replace these files again with the modded version.
Just keep a copy of each file in a subfolder for easy access.

• noticed it myself while playing coop maps
• heard about it several times from other people
• have been informed about it being present on ALL of my workshop maps
• the bug is present on all cooperative maps - so you gotta find it sooner or later

• try and error (including several solutions that did NOT work)
• luck and a bit of logic

• Cube and ball button are not actually broken/bugged, but the PuzzleMaker
has the same "ConnectionStandard" for all of them (defined in editoritems.txt).
• This leads to the need of changing all 3 kind of buttons in order to make them work normal.

• I would love to hear the official answer from Valve myself...

• only if you plan on using the ingame PuzzleMaker / Editor
• and only if you then decide to create a coop map
• ... and then finally decide to upload it into the workshop
• otherwise: no, you don't need this

The 'func_instance_io_proxy' or just 'proxy' is used within instances
to deliver input and output message from and to an instance.

ProxyRelay just takes the output of the calling entity and relays it to the next higher instance:
• proxy OnProxyRelay > button;OnPressed
• proxy OnProxyRelay > button;OnUnPressed

• thumbnail from http://www.thinkwithportals.com

• leave a comment

16. July 2017 - by DrFauli