Goodies
Fichier Prop
Le client permet de faire un autologin, de personnaliser sa barre de menu, d'associer des commandes aux touches de fonctions et encore d'autres choses. Pour adapter le client, il faut éditer le fichier brettspielwelt.prop (prop: est une abréviation de property = propriétés) avec un éditeur de texte (pas Word, mais plutôt Notepad ou le bloc note). Le fichier Prop se trouve dans le répertoire BrettspielWelt. Pour une installation standard sous Windows, le répertoire se trouve normalement sous C:\Utilisateurs\%nom%\AppData\Roaming\BSW\ ou sous c:\Program Files\BSW\ pour les Windows jusqu'à XP. Le répertoire AppData est masqué par défaut, il faut donc commencer par l'afficher avec les options des dossiers.
Alternativ kann man die prop auch im Client selbst mit dem Befehl /showprop öffnen lassen.
Attention pour les utilisateurs de Vista/Windows 7 : Si le BSW a été installé avec l'ancien client dans le répertoire par défaut c:\programmes, il peut arriver que la modification du fichier .prop reste sans effet, car Vista peut empêcher la sauvegarde des modifications. Dans ce cas, il faut désinstaller le BSW et le réinstaller avec la dernière version téléchargeable.
Ce à quoi on doit faire attention lorsque l'on édite le fichier
- Une copie de sauvegarde du fichier Prop peut éviter beaucoup de soucis.
- Les modifications ne sont prises en compte qu'au prochain démarrage du client.
- Chaque ligne ne doit comporter qu'une seule instruction.
- L'ordre des paramètres n'est pas important. Il n'est pris en compte que pour l'ordre des menus personnalisés.
- La présence de caractère espace ou tabulation en fin de ligne, peut rendre impossible la connexion. Dans les menus personnalisés, les espaces peuvent être utiles et avoir une signification particulière.
- Tout ce qui se trouve après un # est considéré comme un commentaire et n'est pas interprété. Les caractères # sont particulièrement utiles pour ne pas définir certains paramètres sans avoir à les effacer complètement.
- les caractères espace sont ignorés et peuvent donc être utilisés pour organiser les commentaires.
- Les lignes sont de la forme
Configuration de la connexion
En général, la configuration de la connexion peut être ignorée ou laissée aux valeurs par défaut. C'est pour cette raison que les exemples suivants sont commentés.
#Host = game.brettspielwelt.de
#Port = 7670
Cette adresse IP et ce port sont utilisés pour tenter une connexion vers le serveur BrettspielWelt.
#HttpProxyHost = 192.168.1.4
#HttpProxyPort = 8080
Ces paramètres permettent d'établir une connexion à travers un serveur proxy avec les données indiquées. On peut par exemple utiliser les paramètres de configuration d'un navigateur Web.
#reconnect = 10
En cas de rupture de connexion avec le serveur BrettspielWelt le client tente de se reconnecter après le temps indiqué en seconde.
Login automatique
Name = pseudo
Password = mot de passe
Ces paramètres permettent de définir son pseudo et son mot de passe. Ils sont utilisés pour la demande de renseignements à la connexion. En cas d'erreur dans ces paramètres (dont la présence d'un caractère espace en fin de ligne) on entre dans le BSW en tant que "Geist". En cas d'erreur de Majuscule/minuscule on entre dans le BSW en tant que joueur non enregistré.
Room = C1-117
On entre directement en salle C1-117. Pour arriver directement sur la place de C1 LosVelozes, il faut juste indiquer C1 comme numéro de salle.
Game = VabanqueBoard
Dans la salle C1-117 se trouve par exemple le jeu Vabanque. Si l'on a indiqué cette salle comme salle de démarrage, grâce à cette ligne on arrive directement à la table de jeu. Si l'on ne définit pas une salle de jeu comme salle de démarrage, ce paramètre doit être commenté par un # en début de ligne.
Room = CX-Y
Game = Manager2Board
Avec ces deux commandes il est possible de commencer directement dans le manager de jeu de sa ville. Pour cela CX-Y doit être remplacé par le numéro de salle du manager de la ville.
Configuration de la langue
Nation = fr
Le paramètre Nation permet de définir la langue dans laquelle les informations du serveur seront affichées. Pour le détail des sigles, voir la page des langues.
Configuration de l'affichage du client
WinWidth = 1220
WinHeight = 990
Permet de configurer la taille de la fenêtre du client. Pour fixer ces paramètres il est possible de fixer à la main la taille et la position de la fenêtre et d'utiliser la commande /getsize pour obtenir les valeurs. Pour avoir un affichage optimal il est recommandé d'utiliser une largeur standard de 610, 915 ou 1220, car les images des (plus anciens) jeux ne sont déformées dans ces dimensions.
WinPosX = -3
WinPosY = -3
Fixe la position du coin supérieur gauche de la fenêtre.
foType = Helvetica
foSize = 12
foCol = 000000
bgCol = DDDDDD
inpfoCol = 000000
inpbgCol = FFFFFF
Les paramètres suivants de la fenêtre de chat principal peuvent être configurés : police (foType), taille (foSize), couleur (foCol), couleur de fond (bgCol), couleur de commandes (inpfoCol), couleur de fond de la ligne de commande (inpbgCol). Les couleurs sont données par des valeurs hexadécimales.
tell_foType = Helvetica
tell_foSize = 12
tell_foCol = 000000
tell_bgCol = A4A4F0
tell_inpfoCol = 000000
tell_inpbgCol = FFFFFF
Les paramètres correspondants pour les fenêtres Tell.
chan_foType = Helvetica
chan_foSize = 12
chan_foCol = 000000
chan_bgCol = FFFFDE
chan_inpfoCol = 000000
chan_inpbgCol = FFFFFF
Les paramètres correspondants pour les fenêtres de canal.
MenuBar = on
Active la barre de menus au dessus de la barre d'outils. Le contenu de la barre de menu peut être défini dans le fichier Prop. Voir les paramètres plus loin.
MenuBarFontName = Helvetica
MenuBarFontSize = 10
Configuration de police pour la barre de menu.
MenuFontName = Helvetica
MenuFontSize = 10
Configuration de police pour les textes des menus.
IconFontName = Helvetica
IconFontSize = 10
IconFontColor = ffffff
Configuration de police pour la barre d'outils
IconOnly = on
Avec ce paramètre, seules les icônes sont affichées dans la barre d'outils.
IconHelp = on
Permet d'afficher un texte d'aide lorsqu'on laisse la souris sur un élément de la barre d'outils.
UserListTool-Display = NameOnly
Dans l'outil joueurs présents n'est affiché par défaut que le nom des joueurs présents. Avec ce paramètre il est possible d'ajouter le rang (NameTech), le titre (NameTitle) ou les deux (NameTechTitle).
UserListTool-DisplayStr=%N (%L) %T %R
Donne l'affichage standard pour l'outil joueurs présents. %N(Nom), %L(Langue), %T(Titre) et %R(Rang) peuvent être utilisés dans l'ordre souhaité. De plus il est également possible de mettre certains paramètres entre parenthèses. Avec cette configuration l'affichage ressemblera à ceci :
ARMistice (de) Patrizier W10
UserListTool-DisplayBubbleStr=%N %L %T %R
Configure l'affichage pour la bulle d'aide de l'outil joueurs présents. Les paramètres sont les mêmes que pour la configuration précédente.
toolStyle = red
Configure la couleur du cadre de fenêtre des outils. Les autres configurations sont actuellement black, blackShiny, austria, spring, woodShiny, plainGray, white et frame1.
OpenTools = off
Lorsque l'on active cette propriété (avec la valeur off), les fenêtres d'outils ne s'ouvrent plus automatiquement sur mise à jour (par exemple la fenêtre d'information lors d'une demande d'information sur un joueur). Cela permet de n'avoir aucune fenêtre éventuellement gênante lors de l'arrivée dans le monde.
CityBanner = West
Permet d'afficher sur la gauche de l'écran la bannière de la ville dans laquelle on se trouve. Avec la valeur East la bannière est affichée du côté droit. Comme les bannières ont une largeur de 48 pixels, il faut augmenter le paramètre WinWidth (voir ci-dessus) de 48.
CollectChat = on
Active le Chat collectif, la fenêtre qui rassemble tous les Chat.
CollectChatBlinkCount = 3
Spécifie le nombre de fois que le symbole respectif clignote dans le Chat collectif, lorsque qu'un nouveau message a été écrit dans un Chat.
CollectChatLocation = West
Par défaut le Chat collectif apparaît sur le côté droit du Chat principal. Avec la valeur West, il est possible de le positionner du côté gauche.
CollectChatFix = on
Les fenêtres de chat dans le chat collectif sont fixées ; c-à-d que lorsque quelque chose est écrit dans un Chat, celui-ci ne passe plus automatiquement vers le haut.
Time = on
Active l'affichage de l'heure au début de chaque ligne de Chat.
Manager de jeu
managerTheme=newstone
Dans le manager de jeu il est possible de choisir entre différents designs. En plus du standard "newblack" il est actuellement possible de choisir "newstone", "newwood", "light", "tradlight" und "newwin"
geselligkeitMode = X
Définit la configuration du niveau d'expérience dans le manager de jeu. X est la somme des codes numériques des filtres souhaités.
- 1 = partie d'apprentissage
- 2 = débutants bienvenus
- 4 = jeu informel
- 8 = partie rapide
- 16 = Experts
Par exemple avec X= 31 on active tous les niveaux. avec X=24 on active les filtres pour n'avoir que les parties rapides ou pour experts.
managerHelp=off
Désactive les bulles d'aide (cube) dans le manager
Raccourcis clavier
Il est possible d'assigner des commandes ou du texte aux touches de fonctions F1 à F9. Il est également possible d'assigner les combinaisons de ces touches.
FKey1 = */manager
FKey2 = +/ghook
FKey3 = +/room
ShiftFKey3 = -C105
Les raccourcis peuvent déclencher des actions de trois façons différentes :
En commençant par * : la commande suivante est exécutée directement dans la fenêtre de Chat active. Attention, la plupart des commandes ne fonctionnent que dans le Chat principal et ne sont pas reconnues lorsqu'elles sont exécutées dans une fenêtre de Chat ou de canal. En commençant par + : le contenu de la ligne de saisie de la fenêtre active est remplacé par le texte indiqué, mais n'est pas envoyé. Il est donc possible de compléter une commande par un paramètre par exemple le nom du joueur après /ghook ou le numéro de salle après /room. Il est possible d'ajouter l'espace après la commande directement dans la ligne de configuration.
En commençant par - : le texte est écrit à la position actuelle du curseur. Dans l'exemple, la succession des raccourcis F3 et Shift+F3 donne la commande /room C105.
C-FKey1 = */chwho
C-FKey2 = +Salut
ShiftC-FKey8 = */exit
Dans les fenêtres de Canal, il est possible d'affecter de la même manière des raccourcis différents. Voir aussi les commandes de canaux.
Menus personnalisés
Il est possible de se faire ses propres menus et sous-menus pour la barre de menus, pour par exemple passer directement des commandes, ouvrir une page web ou définir d'autres raccourcis clavier. Les espaces dans les noms de menu doivent être remplacés par le caractère '_'.
MenuSpiel-Reset-R = */reset
MenuSpiel-Join-J = +/join
MenuSpiel-Start-S = */start
MenuSpiel-Accept = */accept
MenuSpiel-Refuse = */refuse
MenuSpiel-MasterReset-M = */masterreset
Dans cet exemple un menu Jeu avec 6 éléments est créé. Chaque élément de menu a la syntaxe suivante :
Menu[nom du menu]-[élément du menu]-[raccourci] = [Commande / Texte]
Le raccourci (accessible par Ctrl + touche) est optionnel. La commande ou le texte doivent être donnés comme pour un raccourci clavier.
MenuJeu-*Separator* = dummy
Permet de placer un séparateur dans le menu Jeu.
MenuWebseiten-BrettspielWelt = http://www.brettspielwelt.de
MenuWebseiten-Staedte-ARMfeld = http://www.armfeld.de
Ces exemples montrent 2 autres possibilités : tout d'abord il est possible de mettre comme texte une adresse Web. Lorsque l'on utilise une adresse Web celle ci est transmise directement dans le navigateur. Ensuite il est également possible de faire des sous-menus. Pour cela, il faut suffit d'ajouter -[nom du sous-élément] à la suite du nom de l'élément du menu.
Menus contextuels
Les menus contextuels du Chat collectif peuvent aussi être personnalisés. La syntaxe est la même que pour les raccourcis clavier avec 2 extensions : dans les menus contextuels de la fenêtre de Chat, le caractère dollars "$" est remplacé par le nom du joueur. Si la commande commence par un point d'exclamation "!", elle est envoyée ou exécutée directement dans le canal ou le Chat correspondant.
ContextMenuTell-ghook = */ghook $
Exécute la commande /ghook sur le joueur sélectionné.
ContextMenuTell-Salut = !*Salut $
Envoie une salutation dans la fenêtre de Chat du joueur.
ContextMenuChan-ChWho = !*/chwho
Exécute la commande /chwho dans le Canal sélectionné.
Eléments de menu pour l'outil joueurs présent de la barre d'outils
On peut de la même manière ajouter ses propres éléments au menu contextuel du bouton joueurs présents de la barre d'outils.
ContextMenuUser-AddWatchKommentar = +/add watch $
ContextMenuUser-AddFriends = */add friends $
Aides pour les personnes avec des difficultés visuelles
EinfachGenialMode=old
utilise les anciennes couleurs pour "Einfach Genial".
CarcassonneColor1 = ff00ff
ManitouColor1 = ffff00
Permet de modifier les couleurs dans les jeux indiqués. Les valeurs sont des couleurs en valeur hexadécimale. Le chiffre indique la place du joueur. Dans l'exemple la couleur du joueur en place 1 est fixée à lilas pour Carcassonne et Jaune pour Manitou.
CarcassonneColorBig1 = ff00ff
Pour l'extension de Carcassonne il est possible de modifier la couleur du gros pion.
Altcolors = on
Permet d'utiliser des couleurs de joueurs plus différentiables. Actuellement cela concerne les jeux : Attribut, Carcassone et CantStop.
Dans la plupart des jeux il est possible de modifier les polices de caractères utilisés :
NOMDUJEU.defaultFont=Helvetica,0,24
La première valeur après le "=" est le nom de la police, ensuite 0 pour une écriture normale ou 1 pour une écriture en gras, et ensuite la taille de la police.
Si l'on souhaite ne modifier ces valeurs que pour certaines langues, il est possible de les préciser entre parenthèses :
SantaCruz(de,en).defaultFont=Arial,0,24
Pour savoir quels types de police sont utilisés pour les différentes parties d'une jeu, il faut regarder dans le fichier .string correspondant au jeu. On les trouve dans le répertoire BSW sous localized/LANGUE/strings/NOMDUJEU.string (evt. localized/LANGUE/strings/NOMDUJEU.string_UTF-8). Par exemple D:/BSW/localized/de/strings/SantaCruz.string
StoreFontCol = ff0000
Permet de changer la couleur de l'écriture dans l'entrepôt.
Paramètres pour le son
TellMsgSound = on
ChanMsgSound = on
MainMsgSound = on
Chaque message arrivant dans une fenêtre de Tell/canal ou la fenêtre principale émet un bip, comme pour un client de messagerie instantanée.
Autres paramètres
AutoSave = on
Exécute automatiquement à la déconnexion la commande /save pour sauvegarder les listes.
Configurations spécifiques à certains jeux
WizardWings = on
Aide à l'utilisation pour Wizard. Plus d'infos à ce sujet dans les règles de Wizard.
Grimoria.PlayerColor1 = 0000FF
Modifie les couleurs des joueurs à Grimoria. Dans l'exemple le joueur 1 serait bleu.
Grimoria.CardPopup = off
Si les cartes qui apparaissent à Grimoria gênent, cette commande permet de les désactiver. On peut les réactiver avec "on".