BEEmod

faq

This is a list of answers to questions that have been frequently asked by users. 
If you are having problems with BEE2.4 or want to ask about a feature, check here.

If you can't find the answer to your question, ask on Discord or on our discussion page

Where is the executable?

The executable is located in the root of the extracted folder. If it's not there, you probably downloaded the wrong file. Make sure you download the mod from the releases page, and not using the "Clone or download" button on the main page, as this will download the mod's source code rather than a compiled release.

My anti-virus program flagged BEE2.4 as malware?

This is a known issue, and happens for a number of reasons that are mostly out of our control. Antivirus software will often assume that if a file isn't commonly downloaded, it must be malware. Real viruses are also sometimes written in Python, meaning they would share many of the same libraries and files. Additionally, BEE2.4 does several things which could cause it to be seen as a virus - copying a bunch of files into the folder for another program (Portal 2), and replacing executables with its own versions (the compilers). However, we can assure you that BEE2.4 does not contain any malicious code. If you don't believe us, check for yourself; the entire project is open-source.

How do I uninstall BEE2.4 from a game?

To fully uninstall BEE2.4, select the game you want to uninstall it from and choose File  >  Uninstall from Selected Game. This will completely remove BEE2.4 from the game, including editor textures and custom assets. You are then free to delete the folder containing the application and packages yourself.

We would not recommend "verify the game files" as an answer. Although the editor items and style will be restored to default, editor textures will not be reverted and many custom assets added by BEE2.4 will be left in the game files.

Do people playing my maps need BEEmod installed?

No, BEE2.4 packs all custom content into the map automatically. If something doesn't get packed, it's a bug; report it on the issue tracker if it hasn't already been.

What games/mods does BEE2.4 support?

Currently BEE2.4 supports Portal 2 and Aperture Tag.

Thinking With Time Machine and Destroyed Aperture support is planned in the future.

When is the next update for BEE2.4?

There are no set release dates for BEE2 updates. Sometimes they will be released every few weeks, and sometimes there will be months between updates.

Can you add a new item or style?

While we are open to suggestions on what to add to BEEmod, new items and styles are rarely accepted. Items and styles take a lot of work to mantain.

For new items, they must have a clear purpose and a strong concept. They must be both versatile and give the players a reason to use them in puzzles. Some things just aren't possible, especially with Puzzlemaker. Another thing to keep in mind is each item must also work in each style, which is a lot of work especially if ideas aren't well thought out.

For a new style to even be considered, it should make sense overall, work with most/all of Portal 2's test elements, and be possible to reasonably implement in the Puzzlemaker. As an example, Portal 1 is a style that fits this criteria, as most of Portal 2's test elements can reasonably exist there and it has a block-based structure similar to Clean. On the other hand, BTS style typically doesn't use test elements like buttons and cubes, and it's very difficult to make it look good in the Puzzlemaker, hence why it was removed; had this been considered back in 2015, the style never would have been added to begin with.

Custom packages can also add their own items and styles, so feel free to implement your ideas yourself.



Can you add style mixing or changing of items to different styles?

No. We can, but we won't. Puzzlemaker is not a tool for complex story or aesthetic work. You need the flexibility of Hammer to properly implement or explain the mixing of styles, and lots of combinations wouldn't make sense anyway.

Can you expand the Puzzlemaker palette or change Puzzlemaker features?
Can you add Adhesion Gel / <New Gel> or change Gels (or Paint)?

No. Most of the Puzzlemaker and Portal 2 is hard-coded and outside our reach. While we can add new test elements and modify the compiler or in-game appearances, we cannot change how stuff like the editor or game itself behaves. For Puzzlemaker: this includes expanding the palette, adding custom labels to item settings (hence "Button Type", "Start Reversed", etc. on many items), creating new UIs, increasing connection limits, or merging non-compatible items.

Where are or what happened to features from old versions of BEEmod?

Features like bottemless pits and BTS were cut due to problems with quality, mechanics, and/or not working well in Puzzlemaker but may be brough back with a new system.

If you're asking about BEE2 or earlier: since BEE2.4 is a complete rewrite of the app with a different internal item format, all of the old items need to be manually ported. This is in progress, see issue #95 for more details.

Colors / Lights as a testing element?
Toggle or flickering lights?

We won't implement many color or light based ideas due reasons like difficulty to implement, puzzle clairity, color blindness, hard limitations of source, darkness not being a testing element, and many such factors. Puzzlemaker is a tool for puzzles, if you want more complex lighting or colors you'll have to use hammer.

Does BEE2.4 work with pirated/cracked Portal 2?

We do not support cracked versions of Portal 2. While BEE2.4 may still work, we will not help you if you run into any problems. We highly recommend that you buy the game legally on Steam; Portal 2 only costs $10 USD by default, and is usually on sale for an even lower price.

How do I use Catwalks/Vactubes/Unstationary Scaffolds?

These items effectively act as nodes, which need to be connected to each other in order to do anything. The exact way in which this works is different for each item, see their wiki pages for more details: Vactubes, Catwalks, and Unstationary Scaffolds

Will BEE2.4 be compatible with Portal 2: Community Edition?

Since they are making their own Puzzlemaker from scratch, it is not currently known if it will be compatible with BEEmod

Why does it make a high-pitched/corrupted noise when I change the angle of Portal 1 panels?

This is a known issue which seems to be related to audio caching, as the audio files themselves sound correct. One fix that seems to work is running the commands snd_updateaudiocache and sv_soundemitter_flush in the console, in that order. There's no way currently to make the mod apply this automatically, which is why the issue hasn't properly been fixed.

Can you add custom voicelines / Why doesn't Portal 1 GLaDOS have any lines?

It's not possible to properly pack voice lines into maps; while we can pack the actual sounds easily, we can't pack the choreo files that are used for localization, subtitles, and chaining lines. Additionally, the developers of most mods (including Portal Stories: Mel) have said that they do not want people using their custom voice lines in maps.

Why doesn't my exported Puzzlemaker map work properly?

puzzlemaker_export does not work with BEEmod, as the custom compiler isn't able to modify the map and make it actually functional. Before reading on however, keep in mind that exporting Puzzlemaker maps to Hammer is usually not the best idea. If you want to make extensive modifications to a map, or are just starting out learning Hammer, it's generally easier to build a map from scratch, as Puzzlemaker maps are generated in a complex way making them difficult to edit by hand. Only consider exporting if you just want to make small adjustments to a map, and already have experience using Hammer.

If this is still what you want to do, first go into the BEE2 app and set Spawn Point to Elevator and disable Restart When Reaching Exit. Compile your map in Puzzlemaker, then open ../maps/styled/preview.vmf in Hammer and resave it to a different location so it doesn't get overwritten. Additionally, check your Build Programs settings to make sure that you're using the BEE2 version of VRAD (simply called vrad.exe), as this is needed for some features such as music to work.