How to set up the Build Pipeline¶

for dummies (and for Windows)

Prerequisites¶

Get the data¶

Download ryzom_assets.7z and ryzom_assets_newbieland.7z. These currently contain the majority of the data. Don’t extract them just yet, instructions on where the files must be placed will be given later. Continue with the next steps while it's downloading.

Compile Ryzom Core¶

Get the source code from the Hg repository, and compile the whole thing. We’ll need the tools from both NeL and Ryzom Core. See some other wiki page for more information on this part. While compiling, you may want to move on with the next two steps already.

Download and install the 3ds Max tools¶

We’re assuming you own a copy of 3ds Max for this walktrough. You’ll need one anyway when you start working on your game. If you don’t feel like getting 3ds Max, feel free to write an exporter for your favourite modeling package of choice.
Since it’s pretty much a pain in the ass to compile the plugins for 3ds Max (especially if you’re using the stlport externals, then you’re simply screwed), just download the precompiled binaries for your version of 3ds Max, and plug them into your 3ds Max directory. Please keep in mind that we currently only support 32 bit versions of 3ds Max for the plugins, and that these will only work on a 32 bit installation of 3ds Max.

Install Python¶

Download and install Python. Version 2.7 has been confirmed to work http://www.python.org/download/releases/2.7/.

Set up some folders¶

You’ll need a folder for all the asset building. This will take roughly 40 GB with the complete asset data set, so make sure to use a fast and empty enough hard drive. I’m going to call this directory C:\ryzom_core_build.
We will use some drive substitutions to link to our directories.
Make a bat file that contains the following lines, replace D:\source\nevrax with whatever directory (containing “code”) you’ve grabbed the source code repository to:

subst R: /D
subst R: D:\source\nevrax
subst L: /D
subst L: D:\source\nevrax\code\ryzom\common\data_leveldesign
subst W: /D
subst W: C:\ryzom_core_build

And run the bat file too.

Put the assets in the right place¶

Create a “database” folder under W:\. Extract from ryzom_assets.7z all the directories (named Interfaces, Landscape, SFX, and all the others) into this “W:\database” folder.
From the ryzom_assets_newbieland.7z extract the “landscape” directory into the “W:\database” folder as well. It will merge with the existing “Landscape” folder (Linux users, beware your case sensitivity!).

Move some more files around (ASSET DATABASE FIXES)¶

Due to various reasons, some files are incorrectly placed. You’ll have to move them to the right place.

-- HERE COMES PORTION OF "THE LIST" --

-- move some files around -- etc --
-- WIP -- DO NOT TOUCH --