Tutoriel ManiaCode
De TM Wiki.
Comment utiliser des ManiaCodes
Pour une définition des ManiaCodes, consultez l'article sur le sujet
Pour une définition des ManiaLinks, consultez l'article sur le sujet
Pour créer votre ManiaCode, il faut :
- Créer le fichier ManiaCode XML en utlisant la syntaxe expliquée plus bas.
- Télécharger ce fichier sur un serveur Web classique (accès direct aux fichiers)
- Télécharger également tous les fichiers indiqués référencés dans le ManiaCode
- Enregistrer le ManiaCode sur votre page personnelle Nadeo. (Page Joueur )
Pour utiliser un ManiaCode : il suffit de taper son nom dans la barre d'adresse du navigateur ManiaLink
Syntaxe ManiaCode
Tag externe
Un fichier ManiaCode est un fichier XML. La balise racine est maniacode. Toutes les commandes doivent ĂŞtre des balises filles de celle-ci.
<?xml version='1.0' encoding='utf-8' ?> <maniacode> </maniacode>
Note: si vous ne voulez pas le message "Maniacode complété", vous pouvez utiliser <maniacode noconfirmation="1">
show_message : afficher un message
Vous pouvez afficher un message dans une boîte de dialogue. Utilisez la commande suivante et inscrivez votre message entre les balises message.
Gardez à l'esprit que votre ManiaCode peut être lu par n'importe qui, donc faites attention à la langue utilisée, et au but.
<show_message>
<message>Votre message ici</message>
</show_message>
install_track : télécharger et installer un circuit
Le paramètre url pointe vers le fichier du circuit en question. Ce fichier peut être stocké n'importe où en ligne, du moment qu'il s'agit d'un lien direct (les peocessus spécifiques de téléchargement avec identification comme Rapidshare ne marcheront pas). TMX utilise des liens directs donc vous pouvez l'utiliser.
Le paramètre name sert à renommer le fichier à la fin du téléchargement. Name.Challenge.Gbx.
<install_track> <name>TrackDavid</name> <url>http://data.trackmaniaunited.com/tracks/TrackDavid.Challenge.Gbx</url> </install_track>
play_track : télécharger, installer et lancer un circuit
L'utilisation est identique à install_track (ci-dessus), à la différence que le circuit téléchargé sera lancé dans le jeu.
<play_track> <name>TrackDavid</name> <url>http://data.trackmaniaunited.com/tracks/TrackDavid.Challenge.Gbx</url> </play_track>
Dans ce cas, le circuit ne sera pas sauvegardé. Il ne pourra être joué qu'une seule fois.
install_replay : télécharger et installer un replay
Le paramètre url désigne le fichier du replay. De même que les circuits, le fichier doit être accessible directement, sans utiliser un processus de téléchargement spécifique type Rapidshare.
Le paramètre name détermine le nom du fichier après téléchargement. Name.Replay.Gbx.
<install_replay> <name>ReplayDavid</name> <url>http://data.trackmaniaunited.com/replays/ReplayDavid.Replay.Gbx</url> </install_replay>
view_replay : Télécharger, installer et voir un replay
Le paramètre url pointe vers le fichier replay. Il peut être n'importe où sur Internet, mais doit néanmoins être sur un serveur web classique, c'est à dire avec un procédé de téléchargement classique, au contraire de sites comme RapidShare. TMX est un serveur classique. Vous pouvez donc l'utiliser.
Le paramètre name est utilisé pour renommer le fichier après le téléchargement en name.Replay.Gbx.
<view_replay> <name>ReplayDavid</name> <url>http://data.trackmaniaunited.com/replays/ReplayDavid.Replay.Gbx</url> </view_replay>
Le replay n'est pas sauvé sur le disque dur. Il ne peut donc être visualiser qu'une seule fois. Dès qu'il sera fermé, il sera effacé.
join_server : Entrer en mode Multijoueur et se connecter au serveur spécifié
Le paramètre ip est l'adresse IP, ":" indique le port de connexion.
<join_server> <ip>213.186.41.190:30000</ip> </join_server>
install_skin : installation générique d'une skin.
Télécharger et installe une skin (Modèles 3D, Peintures véhicules Nadeo, avatars). Il est ensuite demander à l'utilisateur si il veut utiliser la skin dans son porfil.
Le paramètre name est probablement là pour afficher un message. Note: normalement il devrait avoir la même fonction que pour les maps: renommer le fichier final Le paramètre file indique la cible de l'installation. Le chemin d'installation définira le type de fichier. faites très attention à ce paramètre, si le chemin est erroné, la skin ne fonctionnera pas. Le paramètre url indique la localisation du fichier. Il peut être n'importe où sur Internet, mais obligatoirement sur un serveur web classique et non sur un site imposant une méthode de téléchargement spécifique, comme RapidShare par exemple. CarPark, SkinCenter, Blocktuner sont des serveurs web classique, ils sont donc utilisables.
<install_skin> <name>TestDavid</name> <file>Skins/Vehicles/SportCar/TestDavid.zip</file> <url>http://data.trackmaniaunited.com/vehicles/TestDavid.zip</url> </install_skin>
Types de fichiers supportés
Chaque type disponible est listé avec son chemin d'installation.
- Skin pour véhicule : Skins/Vehicles/<enviro du véhicule>/<nom>.zip
Vous pouvez également proposer une installation générique d'un modèle 3D disponible pour tous les environnements dans : Skins/Vehicles/CarCommon/<nom>.zip
- Avatar : Skins/Avatars/<nom>.jpg (supporte les sous-dossiers)
A compléter, TMUP specifications are a good repository of all know available TM skins
les Locators sont créés automatiquement, vous n'avez pas besoin de les gérer dans le ManiaCode !
Exemples
Le maniacode ci-dessous effectue les actions suivantes
- Affiche un message
- Installe une skin, probablement en demandant pour la placer dans le profil
- Installe une track
- Affiche un autre message
<?xml version='1.0' encoding='utf-8' ?>
<maniacode>
<show_message>
<message>Toi aussi utilise l'avatar de toto et son circuit preféré!</message>
</show_message>
<install_skin>
<name>Totoro</name>
<file>Skins/Avatars/Misc/Totoro.jpg</file>
<url>http://data.trackmaniaunited.com/avatars/Totoro.jpg</url>
</install_skin>
<install_track>
<name>TrackDavid</name>
<url>http://data.trackmaniaunited.com/tracks/TrackDavid.Challenge.Gbx</url>
</install_track>
<show_message>
<message>voilĂ c'est fait!</message>
</show_message>
</maniacode>
