## Messages Nécrologiques Personnalisés : Vue d'ensemble

Le but de cette amélioration est de permettre aux administrateurs de serveurs de changer "les messages nécrologiques" sur leur serveur. Les messages nécrologiques sont affichés lorsqu'un joueur est tué durant le jeu. Un administrateur peut changer autant de messages nécrologique qu'il le souhaite. Si aucune modification n'est apporté, les messages standard sont utilisés par le jeu.

La personnalisation est faite en utilisant les variables de configuration (cvars) qui seront placées dans les fichiers de configuration spécifiques des maps (par exemple : railgun.cfg) ou dans default.cfg (qui est utilisé si aucun fichier de configuration spécifique n'est disponible disponible pour une map). Cela permet aux administrateurs de personnalisé les messages par map s'ils le désirent.

## Messages Nécrologiques Personnalisés : Types de messages

Enemy Territory affiche différents types de messages quand un joueur est tué. Le type de message affiché dépend des événements liés à la mort du joueur. Avec cette amélioration, les différents types de messages sont configurables.

Lorsqu'un joueur meurt du fait de dommages occasionés par "le monde" (chute, noyade...) ou qu'il meurt par une de ses actions (une de ses grenade...), un premier type de messages est affiché.

Exemple: JoueurX fell to his death

Lorsqu'un joueur meurt du fait de dommages occasionés par un joueur de l'équipe adverse, un second type de messages est affiché.

Exemple: JoueurX was killed by JoueurY's thompson.

Enfin, lorsqu'un joueur meurt du fait de dommages occasionés par un de ses équipiers, un troisième type de messages est affiché.

Exemple: JoueurX WAS KILLED BY TEAMMATE JoueurY

NOTE: les messages nécrologiques DOIVENT être gérés par le serveur afin que la customisation fonctionne. Ce comportement n'est pas celui par défaut l'etpub. Pour activer la gestion des messages nécrologiques côté serveur :

    set g_obituary 3

## Analyse syntaxique des CVAR

Les CVARs utilisés les messages nécrologiques sont analysés syntaxiquement avant dêtre affichés. Cela permet de personnaliser autant que vous le souhaitez les messages affichés. L'analyseur syntaxique reconnait deux clés lors de la construction du message :

    [v] - Affiche le nom de la victime(nom du joueur tué)
    [a] - Affiche le nom de l'attaquant

L'analyseur cherche les occurences de ces clés et les remplace par leurs valeurs respectives. Les caractères accentués, i.e. é è à... n'étant pas bien supporté dans le jeu, il n'est pas recommandé de les inclure dans les messages afin d'avoir un affichage correct.

## Configuration des messages nécrologiques provoqués par le "Monde" ou du joueur sur lui même

Ce style de messages nécrologiques est le plus facile pour configurer. Un seul CVAR doit être modifié et doit décrire la façon dont le joueur est mort. L'analyseur syntaxique ne cherche que la victime (clé [v]) puisqu'il n'y a pas d'attaquant dans ce genre d'action.

Ci-dessous, vous trouverez une liste des CVARs configurable qui permet la customisation de ce type de messages nécrologiques. Dans la liste qui suit, les CVARs contiennent le texte des messages par défaut. Pour éviter des traitements inutiles par l'analyseur, il est recommandé de ne modifier que les messages que vous voulez changer et de ne pas fixer les valeurs des messages que vous ne voulez pas changer. En effet si la valeur d'un CVAR n'est pas explicitement fixée, les valeurs par défaut du jeu sont utilisées.

    set g_obit36 "[v]^7 fell to his death."
    set g_obit34 "[v]^7 was crushed."
    set g_obit31 "[v]^7 drowned."
    set g_obit32 "[v]^7 died by toxic materials."
    set g_obit54 "[v]^7 got buried under a pile of rubble."
    set g_obit33 "[v]^7 was incinerated."

    set g_obit26 "[v]^7 dynamited himself to pieces."
    set g_obit18 "[v]^7 dove on his own grenade." 	// Axis
    set g_obit20 "[v]^7 dove on his own grenade." 	// Allies
    set g_obit17 "[v]^7 vaporized himself." 		// Panzerfaust
    set g_obit19 "[v]^7 played with fire." 		// Flamethrower
    set g_obit27 "[v]^7 obliterated himself." 		// Airstrike
    set g_obit30 "[v]^7 fired for effect on himself."	// Artillery
    set g_obit43 "[v]^7 ate his own rifle grenade."	// Axis
    set g_obit44 "[v]^7 ate his own rifle grenade."	// Allies
    set g_obit45 "[v]^7 failed to spot his own landmine."
    set g_obit46 "[v]^7 embraced his own satchel explosion."
    set g_obit52 "[v]^7 engineered himself into oblivion."
    set g_obit53 "[v]^7 buried himself alive."
    set g_obit57 "[v]^7 never saw his own mortar round coming."
    set g_obit62 "[v]^7 danced on his own airstrike marker."
    set g_obit37 "[v]^7 killed himself." 			// /kill command

Note: Les flags des couleurs peuvent être utilisés dans les messages.

Par exemple:

    set g_obit26 "[v]^7 had an ^1EXPLOSIVE^7 relationship with his dynamite"

Remarquez que dans tous les cas la couleur ^7 est ajoutée après la clé [v] afin que les couleurs définies dans le nom du joueurs n'affectent pas l'affichage du message.

## Configuration des messages nécrologiques liés aux combat (hors team-kill)

Ce type de messages nécrologiques contient 3 informations :

         - Le nom de la victime
         - Le nom de l'attaquant
         - Méthode/arme utilisée pour le kill.

Le paramétrage de ces messages est fait simplement en utilisant les clés [a], [v] et une description. Vous devez tenir compte de la ponctuation et des couleurs, comme dans les messages précédents. Vous pouvez modifier autant de messages que vous le souhaitez. Comme précédement, un message non customisé provoquera l'affiche du message par défaut contenu dans le jeu.

La liste des CVARs gérant les messages nécrologiques liés au combat est (les valeurs affichées sont celles contenues par défaut dans le jeu) :

    set g_obit206 "[v]^7 was killed by [a]^7's knife."  			// knife (not thrown)
    set g_obit258 "[v]^7 was killed by [a]^7's Akimbo .45ACP 1911's." 	// akimbo Colt (allies)
    set g_obit260 "[v]^7 was killed by [a]^7's Akimbo .45ACP 1911's." 	// akimbo Colt w/silencer
    set g_obit259 "[v]^7 was killed by [a]^7's Akimbo Luger 9mm's." 		// Akimbo Luger (axis)
    set g_obit261 "[v]^7 was killed by [a]^7's Akimbo Luger 9mm's" 		// Akimbo Luger  w/silencer
    set g_obit207 "[v]^7 was killed by [a]^7's Luger 9mm."			// Luger (axis)
    set g_obit214 "[v]^7 was killed by [a]^7's Luger 9mm."			// Luger (axis) w/silencer
    set g_obit208 "[v]^7 was killed by [a]^7's .45ACP 1911."			// Colt (allies)
    set g_obit250 "[v]^7 was killed by [a]^7's .45ACP 1911."			// Colt (allies) w/silencer
    set g_obit209 "[v]^7 was killed by [a]^7's MP40."			// MP40 (axis)
    set g_obit210 "[v]^7 was killed by [a]^7's Thompson."			// Thompson (allies)
    set g_obit211 "[v]^7 was killed by [a]^7's Sten."			// Sten
    set g_obit226 "[v]^7 was blasted by [a]^7's dynamite."			// dynamite
    set g_obit217 "[v]^7 was blasted by [a]^7's Panzerfaust."		// Panzerfaust
    set g_obit218 "[v]^7 was exploded by [a]^7's grenade."			// Axis grenade
    set g_obit220 "[v]^7 was exploded by [a]^7's grenade."			// Allied grenade
    set g_obit219 "[v]^7 was cooked by [a]^7's flamethrower."		// Flamethrower
    set g_obit257 "[v]^7 never saw [a]^7's mortar round coming."		// Mortar
    set g_obit201 "[v]^7 was perforated by [a]^7's crew-served MG."		// Crew-served MG action
    set g_obit202 "[v]^7 was perforated by [a]^7's tank-mounted browning 30cal."	// Tank gun (allied)
    set g_obit203 "[v]^7 was perforated by [a]^7's tank-mounted MG42."		// Tank gun (axis)
    set g_obit227 "[v]^7 was blasted by [a]^7's support fire."		// Airstrike
    set g_obit230 "[v]^7 was shelled by [a]^7's artillery support."		// Artillery
    set g_obit242 "[v]^7 was killed by [a]^7's K43."			// Axis Base rifle
    set g_obit255 "[v]^7 was killed by [a]^7's K43."			// Axis sniper rifle w/o scope
    set g_obit241 "[v]^7 was killed by [a]^7's Garand."			// Allied Base rifle
    set g_obit212 "[v]^7 was killed by [a]^7's Garand."			// Allied sniper rifle w/o scope
    set g_obit243 "[v]^7 was killed by [a]^7's rifle grenade."		// Axis grenade launcher
    set g_obit244 "[v]^7 was killed by [a]^7's rifle grenade."		// Allied grenade launcher
    set g_obit245 "[v]^7 failed to spot [a]^7's Landmine."			// Landmine
    set g_obit252 "[v]^7 got caught in [a]^7's construction madness."	// Construction
    set g_obit253 "[v]^7 got buried under [a]^7's rubble."			//
    set g_obit249 "[v]^7 was mown down by [a]^7's Mobile MG42."		// Mobile MG42
    set g_obit251 "[v]^7 was silenced by [a]^7's Garand."			// Allied sniper using scoped weapon
    set g_obit256 "[v]^7 was silenced by [a]^7's K43."			// Axis sniper using scoped weapon
    set g_obit215 "[v]^7 was killed by [a]^7's FG42."			// FG-42 non-scoped
    set g_obit216 "[v]^7 was sniped by [a]^7's FG42."			// FG-42 scoped.
    set g_obit246 "[v]^7 was blasted by [a]^7's Satchel Charge."		// Satchel charge
    set g_obit262 "[v]^7 stood on [a]^7's airstrike marker."		// Airstrike marker explosion
    set g_obit266 "[v]^7 was poisoned by [a]^7's needle."			// Medic poison needle
    set g_obit265 "[v]^7 experienced death from above from [a]^7."		// goomba!
    set g_obit267 "[v]^7 was scared to death by [a]^7."			// fear
    set g_obit268 "[v]^7 was killed by [a]^7's throwing knife." 		// throwing knife

Remarquez que dans tous les cas la couleur ^7 est ajoutée après la clé [v] afin que les couleurs définies dans le nom du joueurs n'affectent pas l'affichage du message..

EXEMPLES:

    set g_obit206 "[v]^7 was sliced by [a]^7's knife."

Générera : JoueurX was sliced by JoueurY's knife.

    set g_obit206 "[v]^7 was carved to shreds by [a]^7's ginsu knife."

Générera : JoueurX was carved to shreds by JoueurY's ginsu knife

## Méssages nécrologiques du Team-Kill :

Dans ce type de messages l'arme utilisée n'est pas affichée dans le message. Ce type d'événement entraine l'affichage d'un message en rouge "WAS KILLED BY TEAMMATE".

La même méthode que pour les messages liés au combat peut être appliquée pour créer des messages de team-kill personnalisés. Il est donc possible d'ajouter plus d'information que dans le message par défaut.

Note: Quand vous créez un message pour le teamkill, vous DEVEZ mettre cette information dans le message car le jeu ne la mettra pas pour vous.

Pour customiser ces message, il vous faut ajouter "tk" au nom du CVAR utilisé pour les messages liés au combat. Le nombre de messages à personnaliser est laissé à votre libre choix.

Exemple :

Configuration d'un message teamkill avec une grenade, le message sur cet événement dans les combat est le g_obit218, il vous faut donc ajouter "tk" au CVAR, ce qui donne :

    set g_obit218tk "[v]^7 was exploded by ^1TEAMMATE^7 [a]^7's grenade"

Génerera : "JoueurX was exploded by TEAMMATE JoueurY's grenade"

## PENSÉES FINALES et FAQ :

Q: Pourquoi permettent cette configuration?
R: Donner une touche personelle à votre serveur, vous amuser...

Q: Si je veux garder les messages originaux, dois-je copier tous les cvar listés ci-dessus ?

R: NON !!! En fait il vaut même mieux ne pas le faire. Si vous ne changer rien, les messages par défaut sont utilisés.

Q: Puis-je modifier tous les cvar ?

A: Oui... mais souvenez vous que plus vous modifiez de cvars, plus la puissance sur serveur va être utilisée. Faites des test pour mesurer l'impact de vos modifications.

Q: Pourquoi les numéro des CVARs ne sont ils pas ordonnés ?

A: La numérotation des cvar est basée sur une variable interne d'Enemy Territory. Cela pertmet la création de CVAR personnalisés en utilisant des CVARs dynamiques permettant de limiter les ressources utilisées sur le serveur. De plus si le dans le mod d'autre événement sont créés pouvant générer des messages nécrologiques, aucun développement supplémentaire ne sera requit, il suffira de renseigner les CVARs correspondant pour les customiser.

Q: J'aimerais que mes messages soit très court et contiennent peu d'information comme "JoueurX a ete tue" ou "JoueurX a ete tue JoueurY". Puis je le faire ?

A: Bien sur, remplissez les CVARs comme suit :

    set g_obit206 "[v]^7 a ete tue..."

Génerera : JoueurX a ete tue...
Q: Les messages sont ils obligatoirement dans l'ordre victime puir attaquant ?

A: Non. Vous pouvez mettre les clés [v] et [a] dans l'ordre que vous souhaitez, par exemple :

set g_obit206 "[a]^7 a decoupe [v]^7 avec un couteau bien aiguise !"
Génerera : JoueurX a decoupe JoueurY avec un couteau bien aiguise !
Q: Est il possible d'utiliser une clé plus d'une fois par message ?

A: Bien sur, par exemple :

    set g_obit206 "[v] a ete tue par le couteau de [a]... Pauvre [v], bien vu [a]!"

Generera: JoueurX a ete tue par le couteau de JoueurY... Pauvre JoueurX, bien vu JoueurY!