PatchGen¶

First generate new product by running

patch_gen createNewProduct patch_game/game.xml

that creates default directory layout and xml files

Directory layout¶

* patch_game/
* patch_game/bnp     - put your .bnp files here
* patch_game/patch   - this will have generated patch files. copy these to web server
* patch_game/ref     - patch_gen work files
* patch_game/game.hist
* patch_game/game.xml

Generate patch¶

Copy updated .bnp files to patch_game/bnp and run

patch_gen updateProduct patch_game/game.xml

xml file¶

<xml>
        <_Categories>
                <_Category>
                        <_Name type="STRING" value="main"/>
                        <_IsOptional type="SINT32" value="0"/>
                        <_IsIncremental type="SINT32" value="0"/>
                        <_Files type="STRING" value="main.bnp"/>
                        <_Files type="STRING" value="sound.bnp"/>
                        <_Files type="STRING" value="textures.bnp"/>
                </_Category>
                <_Category>
                        <_Name type="STRING" value="unpacked"/>
                        <_IsOptional type="SINT32" value="0"/>
                        <_UnpackTo type="STRING" value="./"/>
                        <_IsIncremental type="SINT32" value="1"/>
                        <_Files type="STRING" value="exedll.bnp"/>
                </_Category>
                <_Category>
                        <_Name type="STRING" value="optional"/>
                </_Category>
        </_Categories>
        <_IndexFileName type="STRING" value="game.hist"/>
        <_PatchDirectory type="STRING" value="patch_game/patch/"/>
        <_BnpDirectory type="STRING" value="patch_game/bnp/"/>
        <_RefDirectory type="STRING" value="patch_game/ref/"/>
        <_NextVersionFile type="STRING" value=""/>
</xml>

<_Files> node in each category will tell which .bnp files are being tracked.

Directory entries or IndexFileName can also be absolute like bnp's in 'r:/game/ryzom/data', patch will be put to 'w:/webroot/patch_game' and history is kept in 'c:/game.hist'

External tools¶

lzma.exe can be found from http://www.7-zip.org/sdk.html

xdelta.exe from http://evanjones.ca/software/xdelta-win32.html

Warning!

On Windows 7 environments you may need to enable compatibility. To do this:

1. Right click on xdelta.exe and choose Properties
2. Navigate to the Compatibility tab.
3. Check "Run this program in compatility mode for" in the "Compatibility Mode" section.
4. Choose "Windows XP (Service Pack 3)"
5. Click OK.
6. Run xdelta.exe and confirm that you wish to allow the program to make changes to your system.

Patch Generated¶

1. Create a folder inside the client directory and name it "unpack".
2. Place the ryzom_00000.idx inside the "unpack" folder created in step number one.
The 5 digits is the server version, if your server version is 1 you will have to replace 000000 to 00001
3. Open your favorite database editor and click on "nel" then click the table "domain".
4. There's a domain with the id of 12, click to edit the fields patch_version.
5. replace "patch_version" with the version of your server version, in this case it would be 0, click save.

6. Make sure to change your client cfg file to "PatchWanted = 1;"
7. Open the client and watch it patch your client files!

There's no written information on how the client downloads the patch files from external sites yet.