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.12 or later.

First, grab the repo and then clone the HammerAddons submodule:

  git clone --recurse-submodules https://github.com/BEEmod/BEE2.4.git
  cd BEE2.4
  git submodule update --init

Run python -m pip install -r requirements.txt to install the required packages. On Linux, Pillow, TK and IDLE might need to be installed via the system package manager: python-pillow, python-pillow.imagetk, python-tkinter, python-idle, etc.
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 (You should be in the BEE2.4 folder already):

  cd 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.
For Linux Compilation check out this wiki entry Building from Source

marvin1099/BEE2.4