Fr/Adding chapters to your mod

Les Chapitres sont dans les jeux Sources des "étapes" d'un jeux ou d'un mod. Le nombres de chapitres peux varier selon les jeux, et ne sont qu'accessibles dans un jeux en mode solo. La liste des chapitres du jeux se trouve dans le menu de départ, sous forme de liste suivit d'une image représentant le chaptire. Les chapitres donnent également une structure propre à votre jeux, et permet au joueur de naviguer dans son déroulement.

L'ajouts de chapitres à votre mod peut être légèrement compliqué, car il faut modifier certains fichiers à manier avec précautions.

Scripts

Engeristrement d'un chapitre

Créez à cet endroit <votre mod>\cfg\chapter1.cfg. Cela créera votre premier chapitre, et contiendra dans la console ce qu'il faut pour son démarrage. Il doit y contenir :

map <la première map de votre chapitre>

Vous ferez la même chose pour chaque chapitre de votre mod.

Localisation du nom

Créez (ou ouvrez, si deja existant) <votre mod>\resource\<mod>_english.txt (ou _french, _japanese, etc). Ceci est le fichier de localisation , là où sont écrits sous format unicode les titres de vos chapitres.

Le fichier doit ressembler à la chose suivant :

lang
{
	Language "English"
	Tokens
	{
		modname_Chapter1_Title	"Nom du Chapitre 1"
	}
}

Si ce fichier existe deja, ne le supprimez pas. Créez-en un nouveau.

Note:Le "modname" doit être le nom de votre mod se trouvant dans votre gameinfo.txt dans la ligne "name"

Note:Le fichier de localisation doit être enregistré au format UCS-2 Little Endian. Dans Notepad, faites "Fichier", "Enregistrer sous" puis selectionnez "Unicode".

Note:Les valeurs se situant dans les guillemets (comme par exemple le nom du chapitre) doivent être entourés d'espaces.

Apparition du nom du chapitre lors du jeu

Le <votre mod>\scripts\titles.txt défini ce qui apparaît lors du commencement de votre chapitre.

Recherchez la section "chapter titles" et modifiez le comme ceci:

//CHAPTER TITLES

$fadein 0.01
$holdtime 3.5
$position -1 0.58

CHAPTER1_TITLE
{
#YourModName_Chapter1_Title
}

Ce fichier doit être enregistré au format normal c'est à dire ANSI.

Images

Thumbnails

Vous devez créer un "Thumbnails" pour chacun de vos chapitres, en guise d’illustration. Ces images doivent se trouver dans <votre mod>\materials\vgui\chapters\ et nommées chapter1, chapter2, chapter3, etc...

• L'image qui apparaît dans le jeu est d'une résolution de 152x86. Depuis les dimensions doivent être des puissances de 2, donc votre VTF doit faire 256x128 avec une bordure en haut et en bas.
• Depuis que ce sont des UI Textures, elles doivent être compilées sans mipmap, et donc sans niveaux de détails. Les commandes VTEX pour cela sont nomip et nolod.

Le VMT de votre image doit être comme ceci :

"UnlitGeneric"
{
  "$baseTexture" "VGUI/chapters/chapter1"
  "$vertexalpha" 1
}

Arrière plan

<votre mod>\scripts\chapterbackgrounds.txt prend en compte l'arrière plan du menu durant un chapitre. Les arrière plans (ou Background en anglais) sont sous formes de maps animées et se débloquent au fur et à mesure en fonction de la progression du joueur à travers le jeu.(En ce qui concerne leur débloquement, voir la section suivante).

Le contenu doit ressembler à ceci:

chapters
{
	1	"mon_background01"
	2	"mon_background02"
	3	"mon_background03"
}

"mon_background" correspond au nom de votre map qui fera office d'arrière plan, et qui doit se trouver dans <votre mod>\maps\ (A moins que mettre une map en guise d'arrière plan ne soit pas votre intention).

Fond lors du chargement de la map

Au lancement, pendant le chargement du jeu, une image est souvent présente dans les jeux Sources, souvent une projection de la map avec en effet floué. Pour créer votre propre image, faite une impression d'écran lorsque votre map est chargée, mettez y les effets voulu grâce à un logiciel de retouche, enregistrez là, créez le VMF grâce à VTFEdit, puis mettez le VMT et le VMF de votre image dans <votre mod>\materials\console\. Votre fond apparaîtra dès le lancement du jeu.

Voir Menu Background Map pour plus de détails.

Maps

Débloquement des Chaptires

Par défaut, tous vos chapitres sont bloqués, hormis le premier.

Pour contourner cela et permettre à tous les chapitres d'êtres débloqués dès le lancement du jeu, vous devez modifiez la ligne sv_unlockedchapters dans le fichier <votre mod>\cfg\config.cfg), or by changing your mod's programming. Hacking it within maps is not recommended.

Equipping players

Players who start a new game at a chapter half-way through your mod will drop into the world without any items. To equip them with the weapons and other goodies they are supposed to have, use a logic_auto's OnNewGame output to spawn a point_template.

The map list

This is not necessary but is used to easily find the names of maps without quitting and relaunching the game.
Create <mod>\maplist.txt and list of maps that your mod will use. For example:

Map1
Map2