Gamedata Build Pipeline

This page is outdated. Please refer to Kaetemi's Manuals

*** IMPORTANT ***

 

Please use the new assets archive, the latest plugins for max, the latest tools, and the latest data repository.

https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows

http://dl.kaetemi.be/ryzom/assets/ryzom_assets_rev3.7z

https://bitbucket.org/ryzom/ryzomcore-data

*** IMPORTANT ***

The information below is outdated and for developer reference only.

*** IMPORTANT ***

The gamedata build pipeline consists of a set of scripts, with the ultimate purpose of automatically bringing together your assets and leveldesign data into packaged client datafiles, as well as building all the data as required by the game services.

Python 2.7 has been confirmed to work ([http://www.python.org/download/releases/2.7/]).

You will need the following:

Projects

The asset pipeline is divided into three major project categories, each containing one or more independent projects that depend on the previous category. The possibility exists to build multiple projects per category in parallel on multiple physical machines. A project has it's own configuration set, allowing multiple independent landscape lighting models or character armor color texture generation.

Processes

Each project may run one or more sequential build processes. A process defines the data which needs to be built, and which tools need to be run for the process to run successfully.
The following processes are currently part of the gamedata build pipeline:

Commands

There are four basic commands which run a specific portion of the entire gamedata build pipeline.

sfb notes

To prep the MAX files for 2010:

12:44 < Kaetemi> nah, that's for opening one single file 12:44 < Kaetemi> you just need to run max 12:44 < Kaetemi> go to the open maxscript 12:44 < Kaetemi> then choose for batched 12:44 < Kaetemi> enter W:\database 12:44 < Kaetemi> check subdirs 12:44 < Kaetemi> uncheck test 12:44 < Kaetemi> uncheck stop on error 12:44 < Kaetemi> and uncheck something else 12:44 < Kaetemi> and run 12:44 < sfb> hahahaha 12:44 < Kaetemi> and wait for a day or so 

Exporting Assets Using The Build Pipeline Step By Step

NOTE: If you have not done so before you will need to follow Convertingryzom_assetsDatabase

(To use the defaults you can use this .bat script, you will need to run this every time you wish to use the drive path's or you can put it in your startup folder as ryzom.bat)

subst @echo off subst R: C:\ryzom subst L: C:\ryzom\code\ryzom\common\data_leveldesign subst W: C:\ryzom\ryzom_assets 

1. Create a folder in drive C:\ named "export" (C:\export)

2. Navigate to C:\ryzom\code\nel\tools\build_gamedata and double click on "0_setup.py".
The console will ask for directory's, Its pretty self explanatory, just fill it out and it will set everything up for you.
Note> Everything in the <> are the suggested defaults.

  • Database Directory (W:/database): is the assets directory
  • Primary Tool Directory: is the location that your compiled binaries from msvc are located at
 Build Quality (1): '1' Primary Tool Directory (c:/RyzomCore/build_gamedata/bin): 'c:/RyzomCore/build_gamedata/bin' Secondary Tool Directory (c:/RyzomCore/common/exedll): 'c:/RyzomCore/common/exedll' Tool Suffix (.exe): '.exe' Script Directory (c:/RyzomCore/build_gamedata): 'c:/RyzomCore/build_gamedata' Workspace Directory (c:/RyzomCore/build_gamedata/workspace): 'c:/RyzomCore/build_gamedata/workspace' Database Directory (W:/database): 'W:/database' Export Build Directory (W:/export): 'W:/export' Install Directory (W:/install): 'W:/install' Data Shard Directory (W:/export_data_shard): 'W:/export_data_shard' Client Dev Directory (W:/client_dev): 'W:/client_dev' Client Patch Directory (W:/client_patch): 'W:/client_patch' Client Install Directory (W:/client_install): 'W:/client_install' Leveldesign Directory (L:/leveldesign): 'L:/leveldesign' Leveldesign DFN Directory (L:/leveldesign/dfn): 'L:/leveldesign/dfn' Leveldesign World Directory (L:/leveldesign/world): 'L:/leveldesign/world' Primitives Directory (L:/primitives): 'L:/primitives' Gamedev Directory (c:/RyzomCore/common/data_client/gamedev): 'c:/RyzomCore/common/data_client/gamedev' Data Common Directory (c:/RyzomCore/common/data_common): 'c:/RyzomCore/common/data_common' Primary Windows exe/dll/cfg Directory (C:/Program Files (x86)/Microsoft Visual Studio 9.0/VC/redist/x86): 'C:/Program Files (x86)/Microsoft Visual Studio 9.0/VC/redist/x86' Secondary Windows exe/dll/cfg Directory (c:/RyzomCore/common/exedll): 'c:/RyzomCore/common/exedll' Tertiary Windows exe/dll/cfg Directory (D:/source/external_shared/bin/x86): 'D:/source/external_shared/bin/x86' Quaternary Windows exe/dll/cfg Directory (R:/code/nel/lib): 'R:/code/nel/lib' Quinary Windows exe/dll/cfg Directory (R:/code/ryzom/bin): 'R:/code/ryzom/bin' Senary Windows exe/dll/cfg Directory (R:/code/ryzom/client): 'R:/code/ryzom/client' Septenary Windows exe/dll/cfg Directory (R:/code/ryzom/tools/client/client_config/bin): 'R:/code/ryzom/tools/client/client_config/bin' 3dsMax Available (1): '1' 3dsMax Directory (C:/Program Files (x86)/Autodesk/3ds Max 2010): 'C:/Program Files (x86)/Autodesk/3ds Max 2010' 3dsMax User Directory (C:/Users/Matt/AppData/Local/Autodesk/3dsMax/2010 - 32bit/enu): 'C:/Users/Matt/AppData/Local/Autodesk/3dsMax/2010 - 32bit/enu' 3dsMax Executable (3dsmax.exe): '3dsmax.exe' 

3. Navigate to C:\ryzom\code\nel\tools\build_gamedata and double click on "1_export.py".
This exports all the data from the .max files in "Database Directory".

4. Navigate to C:\ryzom\code\nel\tools\build_gamedata and double click on "2_build.py".
This runs all the compile operations like converting images to direct draw format, lighting and sound effects.

5. Navigate to C:\ryzom\code\nel\tools\build_gamedata and double click on "3_install.py".
This installs all the generated data and folder structures into "Client Install Directory" for testing in game.