HMUpdater 1.2 (20090221)

HMUpdater est un script écrit en JavaScript/DOM à activer via l’extension GreaseMonkey de Firefox ou via le système de gestion de scripts utilisateur d’Opera.

Ce script permet à un joueur du jeu hordes de disposer sur chaque page de zone d’un bouton « Mettre à jour la M@p » lui permettant d’envoyer d’un seul click les informations suivantes à un outil externe, comme par exemple la PataM@p :

• Liste des objets présents par terre, avec leur statut cassé ou non
• Le nombre de zombies présents dans la zone
• Présence d’un bâtiment ou de ruines à déblayer
• Le statut défini de la case (épuisée, objets divers par terre, …)

Le script permet de mettre à jour aussi bien la PataM@p que le Poste de Contrôle (l’un ou l’autre, ou bien les deux simultanément). Cependant, vous pouvez aussi définir une autre adresse URL où le script devra envoyer les données au format XML (voir la partie Utilisation).

Note : Si vous souhaitez faire une mise à jour, installez simplement la nouvelle version du script. Greasemonkey fera le remplacement automatiquement. Pensez également à consulter le changelog pour connaître les modifications effectuées.

Note : Si vous souhaitez envoyer les données à une adresse URL spécifique, le script vous demandera une première fois les coordonnées de la zone courante, puis actualisera les coordonnées au gré de vos déplacements. Cela est dù à des restrictions techniques du jeu Hordes.

Note (pour Opera) : Pour les utilisateurs d’Opera, vous devez avoir créé un répertoire servant à contenir les fichiers JavaScript utilisateur et spécifié le dit-répertoire dans la configuration d’Opera (dans preferences -> advanced -> content -> javascript options). Vous devez alors simplement sauvegarder le fichier hmupdater.user.js dans ce répertoire.

Utilisation

Avant tout, assurez-vous d’avoir coché la case « Autoriser les applications externes » dans la page Votre âme/Réglages.

Après avoir installé le script, rendez-vous simplement sur une case en dehors de la ville. Vous constaterez alors la présence d’un bouton « Mettre à jour la M@p » juste au dessous du bouton « Actions héroïques ». En cliquant sur ce bouton, les données de la case seront envoyées à l’URL spécifiée dans les réglages du script.

Pour configurer le script, cliquez sur le bouton « HMUpdater » en bas à droite de l’écran. Il ne vous reste plus qu’à cocher les cases souhaitées dans le formulaire qui s’affiche et indiquer votre pseudo s’il n’est pas déjà renseigné.

Si vous choisissez de spécifier une adresse URL spécifique où le script doit envoyer les données, votre identifiant externe (disponible sur la page Votre âme/Réglages) vous sera également demandée. Notez que vous pouvez spécifier plusieurs URLs. Il vous suffit de les séparer par une barre verticale dans le champ texte.

Note : Si vous utilisez la patamap sans clef API, indiquez à HMUpdater l’URL que vous utilisez dans votre navigateur pour visualiser la carte de votre ville. L’inconvénient est que vous devrez changer cette URL à chacune de vos réincarnations puisqu’elle est propre à une ville donnée.

Navigateurs supportés

Le script a été développé et testé sur Firefox 3 et sur Opera 9.5. Il doit en principe fonctionner correctement sur Firefox 2 et Opera 9.0

Il est possible qu'il fonctionne également avec Safari, mais sans aucune garantie, je n'ai pu faire aucun test.

En projet

• Récupérer automatiquement les coordonnées de la case
• Compatibilité assurée avec Safari ?

Historique

• 2009-02-21 : Version 1.2 publiée.
  • Compatibilité avec le Poste de Contrôle
  • Les coordonnées ne sont plus demandées (si mise à jour du PC et/ou de la patamap uniquement)
  • Correction d’un problème qui empêchait le fonctionnement du script avec la dernière mise à jour de GreaseMonkey
• 2008-11-27 : Version 1.1 publiée.
  • Compatibilité avec Hordes V2
• 2008-11-17 : Version 1.0 publiée.
  • Le script a été largement réécrit
  • Compatibilité avec Opera >= 9.0
  • Mises à jour multiples
  • Bouton de mise à jour intégré au panneau d’actions de la page plutôt qu’un simple lien textuel
  • Formulaires de configuration et de demande de coordonnées intégrés au design du site
  • Configuration simplifiée (Pré-selection d’URLs)
  • Le script capte l’information de case épuisée dès l’affichage et non au moment de l’envoi des informations (posait problème si la case n’était pas contrôlée au moment de la mise à jour)
  • Messages d’erreur plus explicites (à la charge de l’application externe)
• 2008-10-31 : Version 0.8 publiée.
  • La présence de la clef API dans les liens de l’annuaire est rendu optionnel (facilite l’utilisation du script sur la bêta de Hordes V2)
• 2008-10-24 : Version 0.7 publiée.
  • Lorsqu'une case contenait un objet présent en plusieurs exemplaires cassés et non cassés, le script ne répertoriait que les exemplaires cassés dans les données envoyées à la m@p
• 2008-10-15 : Version 0.6 publiée.
  • Le script n'était pas actif dans certains cas (Ajustement des règles @include)
  • Non-actualisation des coordonnées dans certains cas
• 2008-10-07 : Version 0.5 publiée suite à une mise à jour du jeu Hordes
• 2008-09-25 : Version 0.4 publiée. Les coordonnées valent NaN.NaN si on fait un premier déplacement sans spécifier de coordonnées
• 2008-09-24 : Version 0.3 publiée.
  • Accepte le format de coordonnées x,y autant que x.y
  • Statut de case épuisée basé sur le contenu html de la page (bloc "La zone est épuisée")
  • Accepte aussi www.patastream.com ainsi que les .fr
  • Stockage d’une URL par login
  • Affiche un message d’erreur si le format des coordonnées est incorrect
  • Ne demande les coordonnées qu'une fois par expédition (sous réserve de ne pas quitter la page ni l’actualiser au moyen du bouton du navigateur)
• 2008-09-07 : Version 0.2 publique. Quelques bugs corrigés, messages d’erreur/résultat user-friendly
• 2008-09-04 : Création de la présente page