Adding Titles

Adding in-game titles to Ryzom Core is a pretty simple process. In the course of this article we'll ignore the translation pipeline and modify the language files directly.

Titles are comprised of two primary components:

• An entry in the translation words file: title_words_XX.txt
• An entry in unblock.titles sheet.

Adding Title Translation Entries

The first step is to determine the unique string that will identify your title. For example perhaps you want to be able to grant key members of your community a special title that lets new players know they can ask that person for help. Lets call this new title pc_master_helper. The translation language files for titles are pretty simple. They have three columns:

1. title_id
2. name
3. women_name

The third column, women_name, is optional. This is used for titles in which the gender of the title-bearer affects the title content. These files are tab-delimited files with the column names at the top. They can be edited in a piece of software such as Microsoft Excel or LibreOffice Calc. You can also use the Ryzom Translation Manager plugin. 

To continue with our example we would add a new title to the end of the file like this:

title_id        name    women_name
pc_master_helper    Master Helper

If you are not using the full translation pipeline (Translation Manager, Translation Tool and/or WebTT) then you will want to edit the wk file and the enfile plus any other languages you are presently supporting (e.g. fr, ru, de, etc.)

Updating the Unblock Sheet

In addition to defining the title string(s) you will also need to create an entry in the unblock sheet to define how these titles are unlocked and made available to players. The primary sheet is called unblock.titles and is typically located incode/ryzom/common/data_leveldesign/leveldesign/game_element/xp_table. It is not required that this sheet exists here, just that it is somewhere in thegame_element tree.

There is a huge variety of ways that a title can be unblocked:

Lets say that we'll going to assign a brick to allow a player to use the new title, "Master Helper." Creating the sbrick, which should be located in code/ryzom/common/data_leveldesign/leveldesign/game_element/sbrick/title is a pretty trivial matter. In the EGS console you can use the learnBrickcommand to 'teach' an entity the brick. Assuming we made pc_master_helper.sbrick here's what the entry in unblock.titles would look like:

<STRUCT>
    <!-- This value references the title_id in the translation worksheet. -->
    <ATOM Name="Title" Value="pc_master_helper"/>
    
    <!-- This value references the sbrick sheet. -->
    <ATOM Name="BricksNeeded" Value="pc_master_helper"/>
</STRUCT> 

Update Code

You can use pre-generated title strings like Title00066 but failing that you will have to add an entry into ECharacterTitle in thecode/ryzom/common/src/game_share/character_title.h file. The title must be added to the end of the enum and the enum name must match the title_id.