FAQ : Les Thèmes d'Interface

Qu'est-ce-que c'est ?

(cliquez sur une image pour la voir en plus grand) 

 

 

 

Comment trouver de nouveaux thèmes ?

Comment installer et mettre à jour un thème ?

Comment créer un thème ?

Mise en place du "Mode Dev"

Contenu du fichier config-custom.xml

<?xml version="1.0" encoding="UTF-8"?> 
<LangFile> 
    <!-- Activation du mode developpement, doit forcément être activé pour utiliser les lignes suivantes 
        Value: true, false --> 
    <entry key="dev.mode">true</entry> 
     
    <!-- Affiche en jeu la mini interface affichant le fps et les accès rapides 
        Value: true, false --> 
    <entry key="dev.auto.display.controler">true</entry> 
</LangFile>

 

(elle vous permet également de visualiser le nombre de FPS du client DOFUS ainsi que la mémoire utilisée par celui-ci)

 

• /uiinspector : Permet de visualiser le style CSS utilisé sur l'élément ciblé par votre souris, ainsi que le chemin du fichier lié à ce style. Permet également de voir le chemin de la ressource graphique utilisée par un conteneur, un bouton, etc..
• /clearcsscache : Permet de recharger les fichiers CSS utilisés par le thème. Utile pour visualiser vos changements sans avoir à relancer votre client. Il est cependant nécessaire de fermer puis réouvrir l'interface en cours de modification pour en voir les résultats.

Réaliser une base pour son thème

1. Copiez le dossier « darkStone » et collez-le au même endroit que celui-ci.
2. Renommez le dossier fraîchement collé en ce que vous souhaitez. par exemple : monMagnifikTheme
3. Rendez-vous dans le dossier de votre thème et renommez le fichier darkStone.dt en monMagnifikTheme.dt (le nom du fichier doit être identique à celui du dossier de votre thème, c'est important)
4. Modifiez le contenu de votre fichier monMagnifikTheme.dt avec un éditeur de texte (le bloc note windows suffit) et inscrivez-y ceci :

Contenu du fichier .dt

<theme>
    <name>monMagnifikTheme</name>
    <skinType>1</skinType>
    <description>Description du thème</description>
    <previewUri>monMagnifikTheme.png</previewUri>
    <author>PseudoDeAuteur</author>
    <version>1.0.0</version>
    <dofusVersion>2.42</dofusVersion> 
    <creationDate>JJ/MM/AAAA</creationDate> 
    <modificationDate>JJ/MM//AAAA</modificationDate> 
</theme>
 

• Supprimez le fichier signature.xmls.

De quoi est constitué un thème ?

Fichier DT

• Localisation : à la racine du dossier du thème.
• Utilité : Permet de définir les informations sur le thème : son nom, sa date de création, sa date de dernière modification, pour quelle version du jeu est-il compatible, son image de prévisualisation, sa description ainsi que son auteur. Ces informations sont utilisées par l'interface de gestion des thèmes.

Fichiers JPG/PNG

• Localisation : dans les dossiers "bitmap", "common", "illus" et "texture" (ainsi que les sous-dossiers éventuels) contenus à la racine du thème.

• Utilité : Ce sont toutes les images utilisées par le client de jeu pour constituer les interfaces. Elles seront à modifier selon votre convenance afin de personnaliser votre thème.

Fichiers CSS

• Localisation : dans le dossier nommé "css".

• Utilité : Ces fichiers définissent le style des textes des interfaces. (police utilisée, couleur, taille, ombres etc...)

• Polices Utilisables : Eras, Tahoma, Verdana, Gadugi, Roboto, RobotoCondensed, BebasNeue, GoodyBookletter.

• Il n'est pour le moment pas possible d'utiliser d'autres polices d'écriture.

Fichier colors.XML

• Localisation : à la racine du dossier du thème.

• Utilité : Ce fichier sert à déclarer à l'aide de "clés" différentes couleurs utilisées dynamiquement par le client de jeu. (couleur de fond des menus contextuels, couleurs du survol des zones sur la carte, couleurs des barres de progression, couleurs du mode tactique etc...)

• Informations : L'encodage de ces couleurs utilise la base 16. Ainsi, les formats acceptés sont : 0xRRGGBB et 0xAARRGGBB (A = Alpha, R = Rouge, G = Vert, B = Bleu). Vous pouvez vous aider de ce site pour obtenir la version en base 16 de la couleur désirée. La couche dite « Alpha » permet de définir le niveau de transparence de la couleur, elle peut varier de 00 à 99. En l'absence de couche Alpha définie, l'opacité sera considérée comme égale à 100%.

Fichiers themeData.JSON

• Localisation : à la racine du dossier du thème.

• Utilité : Ces fichiers servent à définir de quelle manière sont utilisées certaines textures dans les interfaces. Si vous ne savez pas comment modifier ces fichiers, n'y touchez pas ! Des dysfonctionnements pourraient survenir.

• Pour vous aider dans vos modifications, voici à quoi correspondent certains termes :
  • uri : chemin vers la texture.
  • scale9Grid : un rectangle qui indique comment la texture doit être redimensionnée (chercher scale 9 grid sur google). Exemple : scale9Grid:{x:[marge gauche], y:[marge haut], width:[taille - marge gauche - marge droite], height:[hauteur - marge haut - marge bas]} .
  • colorTransform : Applique une transformation de couleur (voir ce site pour le détail des propriétés utilisables).
  • align : Alignement de la texture (TOPLEFT, TOP, TOPRIGHT, LEFT, CENTER, RIGHT, BOTTOMLEFT, BOTTOM, BOTTOMRIGHT).
  • alpha : Valeur de 0 à 1 indiquant la transparence (0 pour invisible, 1 pour sans transparence).
  • bgColor : Valeur de type 0xRRGGBB ou 0xAARRGGBB permettant de définir la couleur de fond du composant.
  • bgAlpha : Valeur de 0 à 1 indiquant la transparence du fond du composant (0 pour invisible, 1 pour sans transparence).

Quels outils pour modifier son contenu ?

• Un éditeur de texte vous sera utile pour modifier les fichiers CSS, JSON, XML ainsi que DT. Un simple bloc-note peut suffire, mais il vous sera conseillé d'utiliser un éditeur plus évolué pour plus de clarté. Des éditeurs gratuits sont disponibles sur la toile, comme Notepad ++ ou Sublime Text dans les plus connus.

• Un logiciel d'édition/retouche d'images vous permettra de modifier l'ensemble des images qui constituent un thème d'interface. De nombreuses solutions gratuites sont accessibles comme les logiciels Photofiltre ou Gimp, il ne vous reste alors plus qu'à laisser votre imagination faire le reste !

Comment partager mon thème ?

Héberger son thème en ligne

• Dofus Tools : La solution la plus simple pour vous. Après avoir créé un compte sur cette plateforme, rendez-vous dans la section Thèmes d'Interface. Vous y retrouverez de nombreux thèmes créés par la communauté, et la possibilité d'ajouter le votre à cette bibliothèque.  Pour cela rien de plus simple, une fois votre thème terminé, créez une archive au format ZIP regroupant la totalité des fichiers de votre thème et téléchargez-la sur le site. Après quelques instants, une page dédiée à votre thème sera accessible et un lien vers un fichier JSON vous sera présenté : il servira à la communauté pour installer votre thème depuis l'interface de jeu.
• Git Hub : La plateforme très connue de partage et de développement de projets vous permet d'héberger votre thème et de le proposer à la communauté. Un tutoriel est disponible sur le Forum Officiel DOFUS, il vous permettra d'héberger votre thème et de le maintenir à jour étape par étape. Merci à Angom8 pour sa contribution.

Contenu du fichier JSON

 
 {
    "author" : "PseudoDeAuteur", 
    "name" : "Nom du Thème", 
    "keyWords" : "keyword1,keyword2",
    "version" : "1.0.0",
    "dofusVersion" : "2.42", 
    "description" : "Description de mon thème", 
    "url" : "http://mywebsite.com/mytheme.zip",
    "previewUrl" : "http://mywebsite.com/preview.jpg", 
    "creationDate" : "JJ/MM/AAAA", 
    "modificationDate" : "JJ/MM/AAAA"
    } 
  

• author : Pseudo de l'auteur du thème.
• name : Nom du thème.
• keyWords : Mots-clés qui permettront à l'interface d'installation de trier les thèmes par catégorie, si plusieurs thèmes sont mentionnés dans un même fichier JSON.
• version : Version du thème.
• dofusVersion : Version du jeu compatible avec le thème.
• description : Brève description du thème.
• url : URL du fichier ZIP de votre thème, permettant à l'interface d'installation de le récupérer et d'installer le thème.
• previewUrl : URL de l'image de prévisualisation de votre thème, permettant à l'utilisateur de l'identifier facilement.
• creationDate : Date de création du thème.
• modificationDate : Date de dernière modification du thème.

Présenter son thème sur le Forum Officiel

Contenu de votre présentation

• Titre du sujet : Nous vous invitons à mentionner la version de jeu compatible avec votre thème ainsi que le nom de celui-ci. exemple : [2.42] monMagnifikTheme
•  Contenu du message :
  • Présentez votre thème en quelques lignes, ses spécificités s'il y en a.
  • Ajoutez une capture d'écran de votre thème, permettant à l'utilisateur de se donner un premier avis sur celui-ci.
  •  N'oubliez pas également de mentionner le lien de téléchargement du thème.
  • Attention : Un fichier ZIP ou un fichier JSON est attendu. Aucun fichier exécutable ne doit être téléchargé.

Ce que vous pouvez faire

• Créer un sujet pour chaque thème présenté.
• Créer un sujet pour demander de l'aide sur la création d'un thème.
• Poster dans un sujet pour commenter la création d'un joueur.
• Poster dans un sujet pour y contribuer.

Ce que vous ne pouvez pas faire

• Poster ou créer un nouveau sujet pour rapporter un souci d'interface qui ne dépend pas de sa personnalisation. Préférez utiliser cette section.
• Poster ou créer un nouveau sujet pour rapporter un souci lié à la personnalisation d'interface. (Fichiers inaccessibles à la personnalisation, ajout de paramètres dans colors.xml etc.) Préférez utiliser cette section et plus précisément ce sujet-ci.

Mise à jour de mon thème

• Triez les fichiers du dossier « darkStone » par date de modification. Cela vous permettra de voir rapidement quels fichiers ont été ajoutés et/ou modifiés pour cette mise à jour. Dans le cas des fichiers CSS, JSON ou colors.xml, il vous sera nécessaire de vérifier directement le contenu de ceux-ci si vous ne voulez pas recommencer toutes vos précédentes modifications.

Questions fréquentes

Que se passe-t-il si l’interface que j’ai installée m’empêche de lancer le jeu correctement ?

Un site me propose de télécharger directement les thèmes sur mon ordinateur, est-ce normal ?

Suite à une Mise à Jour du jeu, l’interface que j’utilisais n’est plus compatible, que dois-je faire ?

Où puis-je trouver un catalogue de thèmes à utiliser ?

Que puis-je modifier pour créer mon thème d'interface ?

Depuis la version 2.42, le Mode Tactique est personnalisable, comment faire pour le modifier ?

Clés utilisées pour personnaliser le Mode Tactique

<!--entry key="tacticmode.floor01">0xbdbfbf</entry>
    <entry key="tacticmode.floor02">0xb7b9b9</entry>
    <entry key="tacticmode.block01">0xf6f6f6</entry>
    <entry key="tacticmode.block02">0x7c7c7c</entry>    
    <entry key="tacticmode.block03">0x9c9c9c</entry-->

• Supprimez les caractères : !-- et -- présents.
• Modifiez les couleurs du Mode Tactique selon votre convenance.

Pourquoi la console ne s'affiche pas ?