4Coder Community

Welcome to the 4coder community repository.

Building

Windows

1. Setup the MSVC toolchain in your environment, this can be done with the code/custom/bin/setup_cl_x64.bat script
2. call the package.bat script from the code directory (this builds a distribution in the distributions directory with all the non-binary dependencies)
   1. $ cd 4cc\code
   2. .\bin\package.bat
3. You can also use the build.bat script if you want just build the binaries (this produces the build artifacts in the build directory, this doesn't produce a functional distribution)
   1. $ cd 4cc\code
   2. $ .\bin\build.bat

In addition to the parameter listed below, you can specify which backend to use by passing one of those parameters to the build scripts:

• /DWIN32_OPENGL (default) to use the OpenGL backend.
• /DWIN32_DX11 to use the Direct3D 11 backend.

Linux

tested on Ubuntu 22.04:

1. Get required libraries (apt names):

   • $ sudo apt install build-essential libx11-dev libxfixes-dev libglx-dev mesa-common-dev libasound2-dev libfreetype-dev libfontconfig-dev

2. Use the package-linux.sh script from the code directory (this builds a distribution in the distributions directory with all the non-binary dependencies)

   1. $ cd 4cc/code
   2. $ ./bin/package-linux.sh

3. You can also use the build-linux.sh script if you want just build the binaries, (this produces the build artifacts in the build directory, this doesn't produce a functional distribution)

   1. $ cd 4cc/code
   2. $ ./bin/build-linux.sh

Mac

4coder targets x86_64. If you are using a M1+ ARM CPU you need to prefix the build scripts commands with: arch -arch x86_64

1. Use the package-mac.sh script from the code directory (this builds a distribution in the distributions directory with all the non-binary dependencies)

   1. $ cd 4cc/code
   2. $ ./bin/package-mac.sh

2. You can also use the build-mac.sh script if you want just build the binaries, (this produces the build artifacts in the build directory, this doesn't produce a functional distribution)

   1. $ cd 4cc/code
   2. $ ./bin/build-mac.sh

Older Macs, 10.15.7 Catalina

If you are using an older version of mac, such as 10.15.7 Catalina you need to install the realpath command:

1. $ sudo port install coreutils
2. macports names the realpath command grealpath, so make a symbolic link in order to use build-mac.sh:
   $ sudo ln -s /opt/local/bin/grealpath /opt/local/bin/realpath

Build script parameter

The build script accepts a parameter (mutually exclusive):

• /DDEV_BUILD or /DDEV_BUILD_X86 (default value) : build without optimizations. Produces debug symbols. Defines: FRED_INTERNAL, FRED_SUPER, DO_CRAZY_EXPENSIVE_ASSERTS (on Windows) macros.
• /DOPT_BUILD or /DOPT_BUILD_X86 (similar to build_optimized script): build with optimizations. Doesn't produce debug symbols. Defines FRED_SUPER macro.
• /DPACKAGE_SUPER_X64 or /DPACKAGE_SUPER_X86 (similar to package script): package 4coder for distribution. Turns on optimizations. Produces debug symbols. Defines SHIP_MODE, FRED_SUPER, DO_CRAZY_EXPENSIVE_ASSERTS (on Windows) macros.
• /DPACKAGE_DEMO_X64 or /DPACKAGE_DEMO_X86: packages 4coder demo for distribution. Turns on optimizations. Produces debug symbols. Defines SHIP_MODE, DO_CRAZY_EXPENSIVE_ASSERTS (on Windows) macros.