• Windows - Download and install Community Edition of Visual Studio 2017 or 2022.
• • Be sure to also install Desktop development with C++ via the Visual Studio Installer, along with the individual component titled VC++ 2017 version 15.9 v14.16 latest v141 tools (VS2017) or MSVC v143 - VS 2022 C++ x64/x86 build tools (VS2022). CMake is included for command-line builds.
• Linux (Debian-based) - Run sudo apt install build-essential cmake in a Terminal: (or use your Linux distro's package manager)
• FreeBSD - Run pkg install cmake in a Terminal. Alternatively, build cmake via ports if desired.
• macOS - Download Xcode (for building with an IDE) via the App Store, and/or CMake (for command-line builds)
• Docker/Podman - Ensure that it is downloaded and installed (Windows) or installed from your package manager

• Windows/macOS - Grab GitHub Desktop or your preferred git tool
• Linux - Run sudo apt install git in a Terminal.
• FreeBSD - Run pkg install git in a Terminal. Alternatively, build git via ports if desired.

1. Run GitHub Desktop and click File->Clone Repository from the menu.
2. Enter https://github.com/UOX3DevTeam/UOX3.git in the URL tab, and provide a local path for storing the cloned repo on your drive.
3. Hit the Clone button to clone the stable master branch of UOX3 to the specified local path

1. Run git clone https://github.com/UOX3DevTeam/UOX3.git in a Terminal to clone the stable master branch of UOX3 into a subdirectory of the current directory you're in.

If you'd rather grab another branch of the git repository, like the develop branch where most updates get pushed first before being merged into the master branch, you can use the following command after completing the previous step: git checkout develop

GitHub Desktop users can change the active branch via the Current Branch dropdown menu in GitHub Desktop.

• Visual Studio 2022 - (Windows) Open UOX3\make\VS2022\uox3.sln (VS2022), choose Release/Debug from dropdown menu, and hit Build -> Build UOX3
• automake.sh - (Linux/FreeBSD) Run ./automake.sh in a Terminal, from the root of the cloned UOX3 repository. This compiles UOX3 with CMake, but in one command only. Use optional argument -b debug to create debug build, and/or -o clean to do a clean build
• XCode - (macOS) Open UOX3/make/XCode/uox3/uox3.xcworkspace, select Build

If you don't wish to rely on the automake.sh script, but want control over the process yourself, follow these steps (same as what automake.sh does) in a Terminal. This also works on Windows/macOS as an alternative to compiling with IDEs:

• Navigate to root of cloned UOX3 git repository, and execute these commands:
  cmake make/cmake -B ./build -DCMAKE_BUILD_TYPE=Release
cmake --build ./build --config Release

Replace "Release" with "Debug" in the above instructions to create a debug-build; delete build directory to do clean builds.

If you'd rather use GCC (v9.x or higher)/make (GNU Make 4.2.1 or higher) than CMake, you can follow these manual steps. Note that for FreeBSD, this approach requires installing gmake as an alternative to make: pkg install gmake

First, navigate to spidermonkey directory and run these commands:
make -f Makefile.ref DEFINES=-DHAVE_VA_LIST_AS_ARRAY CC=gcc (Linux)
ar -r libjs32.a Linux_All_DBG.OBJ/*.o (Linux)
cp Linux_All_DBG.OBJ/jsautocfg.h ./ (Linux)
gmake -f Makefile.ref DEFINES=-DHAVE_VA_LIST_AS_ARRAY CC=clang (FreeBSD)
ar rcs libjs32.a FreeBSD_DBG.OBJ/*.o (FreeBSD)
cp FreeBSD_DBG.OBJ/jsautocfg.h ./ (FreeBSD)

Next, head to the zlib directory:
cd ../zlib
make distclean
./configure
make

Finally, head to UOX3/source directory:
cd ../source
make (Linux)
gmake (FreeBSD)

When using VS2017, static libraries of the dependency projects (SpiderMonkey and zlib) need to be compiled prior to the UOX3 project. However, after those sub-projects have been compiled once, they never need to be compiled again, and from that point on only the build instructions for UOX3 itself applies:

SpiderMonkey

1. Navigate to the *UOX3\spidermonkey\make\VS2017\jscript* folder and open jscript.sln in VS2017.
2. Make sure you have jscript selected in the Solution Explorer, then select Release and x64 (64-bit) in the Solution Configuration/Platform dropdown menus
3. Click Build > Build jscript from the menu.
4. Visual Studio will compile SpiderMonkey and create a *spidermonkey\make\VS2017\jscript\x64\Release* (64-bit) folder with the compiled jscript.lib library file contained within. No further actions are necessary here, so you can close the SpiderMonkey VS Solution.

zlib

1. Navigate to the UOX3\zlib\make\VS2017 folder and open zlib.sln in VS2017.
2. Select Release and x64 (64-bit) in the Solution Configuration/Platform dropdown menus
3. Click Build > Build zlib-static from the menu.
4. Visual Studio will compile zlib and create a zlib\x64\Release (64-bit) folder with the compiled zlib-static.lib library file contained within. No further actions are necessary here, so you can close the zlib VS Solution.

UOX3

1. Navigate to the *UOX3\make\VS2017* folder and open uox3.sln in VS2017.
2. Make sure you have UOX3 selected in the Solution Explorer, then select Release and x64 (64-bit) in the Solution Configuration/Platform dropdown menus, or via Build -> Configuration Manager.
3. Select Build -> Build UOX3 to start compiling UOX3. When done, you'll find UOX3.exe in UOX3\make\VS2017\Release\x64.

From here on, if you wish to re-compile UOX3, just open the uox3.sln and hit rebuild. Note that if you wish to change from Release to Debug build, the sub-projects (SpiderMonkey and zlib) also need to be compiled for Debug mode prior to compiling UOX3.

Build and tag the image from the root of the repository like: docker buildx build --progress=plain -t uox3 . or podman build -t uox3 .