The aim of this tutorial is to show how to create cuddly toys based on the models of atysian animals.

Prerequisite for modelising only the cuddly toy:

• Having installed Ryzom assets and properly set-up the repositories (NEL tools expect to find the assets in the W:database folder).
• Having installed 3DSMax and set-up the NEL plugin (Beware the plugin works only with versions 32bits of 3DSMax, and from version 9 till version 2012).
• Advised but not mandatory: having installed the NEL tool “tga2dds.exe”.

Prerequisite for deploying the cuddly toy on a game server:

• Having compiled and installed a game server, and having set-up a client to use it.

Note: it is possible to test this cuddly toy IG without having a game server through a trick which will be explained a bit further in this tutorial.

Some useful links for these prerequisites:

• Downloading the assets and tools: https://ryzomcore.atlassian.net/wiki/display/RC/Downloads+for+Windows
• Set-up the drive letter for the assets : https://ryzomcore.atlassian.net/wiki/display/RC/How+to+set+up+the+Build+Pipeline
• Insalling the NEL plugin of 3DSMax: https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins

All 3d models for Ryzom fauna are gathered in the “W:databasestufftrykeragentsmonsters” folder, by creature family. In this tutorial, we'll use the “Gubani” model, which is located in the “horse” (“cheval” in French) folder, to create our cuddly toy:

W:databasestufftrykeragentsmonsterschevalh12tr_mo_h12.max

In 3DSMax, open the “W:databasestufftrykeragentsmonsterschevalh12tr_mo_h12.max” file.

Use the menu ⇒ “File” ⇒ “Manage” ⇒ “Asset Tracking” to check the list of the files used in this model, especially the textures. Notice this two files:

• The 3d model: “tr_mo_h12.max”
• The texture for the gubani: “ju_mo_h12.png”

The aim here is to deploy cuddly mobs for the month object. Hence, we'll create a dedicated folder for our to-be toys and respect the naming convention used by Ryzom.

So we'll create a “soft-toy” folder, in the “W:databasestuffgeneriqueagentsaccessories” folder. We'll save our model by renaming it under: ge_acc_teddy-gubani_01.max

• the first “ge_” prefix in the file name specifies the ecosystem, here _ge_neric (tr: tryker, fy: fyros, etc…).
• the second prefix in the file name specifies the type of model (hom: male homin, mo: monster, wea: weapon, etc…). Here “acc” for _acc_essory.
• and last, the name of our model “teddy-gubani”, which will be suffixed with a number, in order to be able to create several variants of the teddy-gubani.

For the texture, we should also copy it under “W:databasestuffgeneriqueagents_texturesaccessories”, but we'll do it more simply. We'll place it in the same folder as the 3d model and rename it according to the same convention: “ge_acc_teddy-gubani_01.png”.

Ryzom core knows only how to show textures with a “.tga” or “.dds” format. TGA is a raw format without compression which makes it useful for edition, but less efficient in term of memory space. DDS format is a compressed image format which, as jpeg, is destructive. It is the format used internally by Ryzom to minimize the textures' memory space. With your favorite editor, convert the “.png” image into a “.tga” one. That's the one we'll keep for edition. We'll use the NEL tool “'tga2dds'” to generate a texture image under “.dds” format for the 3d model. That's the one which well be used in 3DSMax.

tga2dds ge_acc_teddy-gubani_01.tga

If you don't have this tool, you gan keep the “.tga” version. It will work for the IG tests. In the “soft-toy” folder, you should now have as a result:

The monster 3D model contains a skeleton and animation track. This is not necessary for a toy accessory and unnecessarily overburden the final ryzom model. We will delete it.

Select with the mouse the “Gubani” model. In the right panel, select the “modify” tab. You should see the mesh called “TR_MO_H12” and in the stack one modifier called “physical”. We will delete it also.

Then we will open the scene explorer screen via the “Tools” menu ⇒ “New Scene Explorer” and delete all the elements constituting the skeleton of the model and keep only the animal mesh.

Now we have only one element in our “scene”: the Gubani mesh “TR_MO_H12”

In the right panel, we will rename the mesh “ge_acc_tedy-gubani_01”. This name will be used by the export “NEL” to name the generated file when exporting to “shape” NEL format.

In this section, we will adapt the texturing of 3d model. In principle, we would just change the base texture “ju_mo_h12.png” to point to our “ge_acc_teddy-gubani_01.dds” texture (or the “. tga” one). However, this will be a bit more complicated:

First we open the “Material Editor” (1) screen, then we select the unique material of the scene (2) by double clicking on it. In the central viewport select the node named “Map # 1 Nel Multi Bitmap” by double clicking on it (3). In the right sidebar, a description of its properties (4) appears. The “Nel Multi Bitmap” allows to specify up to 8 different images. It is not multi-texturing, but the ability to configure multiple texture images. Only one is applied at a given moment on the model. This is used for the mobs to specify one texture for each ecosystem. This is also used by environmental objects to specify a different texture for each season.

The ID 1 slot is used for textures of Tryker ecosystem, the second slot (ID 2) for the Fyros ecosystem. The third slot (ID 3) for Zoraï ecosystem and the fourth one (ID 4) for the Primes Root ecosystem. Do not look for Matis slot. As good aesthetes, they understood that beauty lay in the Zorai nature and therefore use Zoraï textures for all their animals. Note that here the Gubani is being only present in jungle and primes root. Only slots 3 and 4 are used

The same system is also used for other IG objects, such as buildings. In this case, the 4 slots correspond to the four seasons. Thus we can note the presence of snow on some Zoraï buildings in winter.

We will not use this mechanism. We will therefore delete the “NEL Multi Bitmap” and replace it with a simple “Bitmap” by dragging the mouse from the output of “tTexture 1” as shown in the above image. When releasing the mouse, a menu appears (2), select “Bitmap” entry:

Then select our texture “W:databasestuffgenericagents _texturesaccessories oft-toyge_acc_teddy gubani_01.dds” (or “.tga”).

Repeat the operation on the other “Nel Multi Bitmap” that reference the same image.

Our 3d model is almost ready. However, its size does not match what is expected. If you use the 3dsmax measuring tool you will see that the Gubani is 2m high. The simplest way to put it in the right size is to load a Homin model to have visual comparison and ensure that the teddybear can be taken in hand.

So we will temporarily put in our scene a reference to another 3d model via the File menu (1) ⇒ References (2) ⇒ Xref Scene (3) and then clicking on the Add button (4) :

Select the Homin model “W:\database\stuff\generic\agents\actors\male\ge_hom_armor02.max” which should appear in your 3d scene.

Scale the Gubani model and move it via tools “Scale” and “Move” from the popup menu that appears when you click the model with the right mouse button.

Once at the right scale, remove the reference to the homin model through the File menu ⇒ References ⇒ Xref Scene.

Reposition the Gubani model at the scene origin (x = 0, y = 0, z = 0), because when the object is carried the position (0,0,0) is located in the hand.

In terms of texture, to give a “plushy effect”, give free rein to your imagination

I edited the “ge_acc_teddy-gubani_01.tga” image with the Gimp application. I used the filter “Artistic> GIMPressionist” using the “canvas” model for a weft fabric effect.

Once the image saved, I re-generated the dds texture with the command:

tga2dds ge_acc_teddy-gubani_01.tga

Here is the result on the 3d model in 3dsmax:

It's time to test the teddybear IG. For this you have to export the model to the “shape” file used by the Ryzom engine

If this is not already done, add the NEL export button on your right side panel by clicking on the “utilities” tab then “More” button and selecting the “NEL Export” option:

Then select the Gubani mesh with the mouse and click on the “Export Model” button. You must specify the folder in which the file “ge_acc_teddy-Gubani-01.shape” will be created.