Build Source on Mac

For some information about the quite new native Mac OS X Support, see Mac Client State. Link to blank page.

Pre Requirement

Don't forget to add MacPorts in your PATH (only needed for older macports installers):

echo 'export PATH=${PATH}:/opt/local/bin' >> ~/.profile 

Since Xcode 5, to be able to compile Ryzom Core, you'll need to type :

xcode-select --install 

If you plan to deploy Ryzom on different Mac OS X versions, I suggest you to set MACOSX_DEPLOYMENT_TARGET environment variable before compiling any dependencies :


Installing Dependencies

  • Run XCode once to accept the license agreement
  • Launch the Terminal application and execute the following command in it.
sudo port install mercurial p7zip boost cmake curl freetype jpeg libwww libxml2 lua zlib libpng python_select libogg libvorbis python26
sudo port select --set python python26
  • Install luabind, see Installing Luabind.
  • note: if you get string.h not found error in macOS 10.14 run this command:

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

Get the sources

See Getting Source.


This section shows how to create a static Ryzom Core client built on Mac OS X. The resulting binary only depends on system libs, therefore can be moved easily to another Mac OS X machine. The given list of CMake options is just an example. For a complete list see: CMake Options. Building a Ryzom Core client that depends on NeL and Ryzom shared libraries is strongly discouraged.

cd code
mkdir build
cd build
sudo make install

The install process created /Applications/ for you.

To check which libraries are needed by your binary run:

otool -L bin/

You should only see libraries which reside in /usr/lib or /System/Library/Frameworks.

Universal binary

To create an universal binary for 32 and 64 bits Mac OS X versions, just append -DCMAKE_OSX_ARCHITECTURES="i386;x86_64" to CMake command line.


You can append -DRYZOM_DATA_DIR=<Ryzom data path> to CMake command-line to copy your data into bundle.

Create Distribution Package

Use the application "packages.dmg" to create a pkg from the .app file you can download it at the bottom of the page. ( Note i could only get it working correctly in build and debug mode...)

Use the following command to create a compressed dmg for the pkg

hdiutil create ryzom_client.dmg -srcdir