Please read the Contributing Guidelines and FAQ before opening an issue.

Better Extended Editor 2 version 4

Portal 2 Mod Tool

The BEE2 allows reconfiguring Portal 2's Puzzlemaker editor to use additional items, reskin maps for different eras, and configure many other aspects. All vanilla items have been upgraded with additional bugfixes and improvements.

The packages (item, style, etc definitions) are in the BEE2-Items repository.

Discord Server

Download and Use

• Download the latest releases of the BEE2.4 and items from the following pages:
  • Application
  • Item Packages
• Extract the contents of the Application release anywhere you like. e.g. C:\BEE2.4
• Place extracted package folder in the root BEE2 folder. e.g. C:\BEE2.4\packages
• To run, locate the BEE2 application in the app folder and execute it. e.g. C:\BEE2.4\BEE2.exe

BEE2.4 on Mac

As of version 4.37 we have stopped supporting BEE2.4 on Mac. See this wiki article for more details and how you can still use the mod.

Used Libraries

• Python 3.8 or later
• TKinter/TTK
• pyglet (for sounds, not required)
• Pillow
• noise (For perlin/simplex noise, as src/perlin.py)
• mistletoe
• cython
• PyInstaller
• babel

Building from Source

Compilation

• You'll need Python 3.8 or later, for 32-bit / Windows 7 you need 3.8 specifically.

• First, grab the 3 git repositories you need:

    git clone https://github.com/TeamSpen210/HammerAddons.git
    git clone https://github.com/BEEmod/BEE2.4.git
  

• Run python -m pip install -r requirements.txt to install the required packages. On Linux, Pillow might need to be installed via the system package manager with the TK component: python-pillow, python-pillow.imagetk.

• To allow sound effects in the app, you need a copy of FFmpeg:

  • In the BEE2.4 folder, add lib-32 and/or lib-64/ folders.
  • Download the 32-bit or 64-bit builds (winXX-lgpl-shared), then copy the contents of the bin folder into the appropriate lib-XX folder mentioned.

• Finally, switch to the BEE2.4 repo and build the compiler, then the application:

    cd BEE2.4/src/
    pyinstaller --distpath ../dist/64bit/ --workpath ../build_tmp compiler.spec
    pyinstaller --distpath ../dist/64bit/ --workpath ../build_tmp BEE2.spec
  

• The built application is found in BEE2.4/dist/64bit/BEE2/. To generate the packages zips, either manually zip the contents of each folder or use the compile_packages script in BEE2-items. This does the same thing, but additionally removes some unnessary content to decrease file sizes - comments, blank lines, hidden visgroups.