La page d'aide des "Scripts Publics" de Mountyhall

1. Accès direct aux infos du jeu.

   2 sortes d'infos, 2 façons de les récupérer :
   • les listes des trolls, des guildes, etc. disponibles sur le ftp de Mountyhall : - ftp
   • les "Scripts Publics" pour les données de chaque trõll, ici-même

2. Les "Scripts Publics" renvoient les données de chaque trõll

   Ce qu'il faut savoir :
   • XXX = le NUMERO d'un trõll et YYY = un code d'accès correspondant
   • Si vous avez un code d'accès et un numéro de trõll, vous pouvez tout savoir sur lui sans vous connecter au jeu grâce aux "Scripts Publics"
   • L'intérêt du code d'accès est qu'il ne permet pas de jouer votre trõll.

3. Le nombre d'appels autorisés aux Scripts Publics est limité

   Au-delà, vous risquez un avertissement, et cela peut aller jusqu'à la désactivation de votre trõll.

   maximum d'appels par catégorie et par jour	catégorie	font partie de cette catégorie
   24	Dynamiques	SP_Profil2, SP_Profil3, SP_Profil4, SP_Vue2, SP_Evenement, SP_EvenementPage, SP_ProfilPublic2, SP_Aptitude2, SP_ActionsProg, SP_BonusMalus, SP_Caract
   10	Statiques	SP_Equipement, SP_Mouche, SP_Gigots, SP_Tanieres, SP_Gowaps, SP_Listesdevente, SP_Tanieres, SP_GrandesTanieres, SP_Consignes, SP_Distinctions
   4	compteurs d'appels	SP_Appels

   Exemples pour 1 trõll sur une journée
   • autorisé : 10 appels à SP_Profil2, 5 à SP_Vue2, 2 à SP_Gowaps, 5 à SP_Equipement
   • interdit : 7 appels à SP_Gowaps, 7 à SP_Tanieres
     (pourquoi est-ce interdit ? parce que le total d'appels pour la catégorie "statiques" = 14 > 8)
   [haut]

4. Normalisation

   • tout message d'erreur commence par les 6 caractères suivants : Erreur (voir la suite).
   • chaque paramètre est formé d' "un seul mot ou mot composé, français, explicite, non abbrégé, les accents ayant été retirés".
   • chaque fois que c'est possible, lorsqu'un script contient plusieurs lignes, elles ne sont pas triées
   [haut]

5. Liste des Scripts

   Leur modification est annoncée sur les Forums https://www.mountyhall.com.

   - infos publiques -

   • SP_Evenement.php?Numero=XXX&Motdepasse=YYY
     Les 20 derniers événements du trõll n°Numero.
   • SP_EvenementPage.php?Numero=XXX&Motdepasse=YYY [&Page=1] [&Type=]
     Ce script affiche les événements du trõll n°Numero par Pages (tranches de 20), la plus récente étant notée 1.
     Le paramètre Type prend l'une des valeurs suivantes ou bien, il est ignoré : ACHAT, ACTION, AMÉLIORATION, ANNEAU, APPARITION, COMBAT, COMPETENCE, DEPLACEMENT, DIVERS, DON de GG, DON de PX, DON de Suivant, ENTRAINEMENT, GUILDE, LAMPE, LIEUX, MONSTRE, MORT, PARCHEMIN, POTION, PRIERE, RITUEL, SORTILEGE, TRESOR, TROC, TROLLIGION.
     
   • SP_ProfilPublic2.php?Numero=XXX&Motdepasse=YYY [&Cible=ZZZ]
     Ordre des champs --> numéro; Nom; Race; Niveau; Date d'inscription ; E-mail ; Blason ; Intangible ; Nb mouches ; Nb kills ; Nb morts ; Numéro de Guilde ; Niveau de Rang ; Intangible ? ; PNJ ?
     Argument facultatif [&Cible=ZZZ] : permet d'avoir le profil du Trõll "Cible".
     
   • SP_Distinctions.php?Numero=XXX&Motdepasse=YYY [&Cible=ZZZ]
     Ordre des champs --> numéro; Description
     Argument facultatif [&Cible=ZZZ] : permet d'avoir la liste des distinctions du Trõll "cible".

   - infos privées -

   • SP_Appels.php?Numero=XXX&Motdepasse=YYY&categorie=NNN
     Renvoie le nombre d'appels aux scripts publics faits pour ce troll.
     Ce script prend le paramétre categorie, qui accepte les valeurs 1, 2, A.
     • 1 correspond à la catégorie "Dynamique"
     • 2 correspond à la catégorie "Statique"
     • A correspond à la liste de tous les SP appelés
     Ordre des champs --> Nombre d'appels [; Code du script]
     
   • SP_Vue2.php?Numero=XXX&Motdepasse=YYY [&Tresors=1] [&Lieux=1] [&Champignons=1]
     Eléments --> TROLLS # MONSTRES [# TRESORS] [# LIEUX] [# CHAMPIGNONS] # ORIGINE
     "# ORIGINE", ordre des champs : vue totale horizontale ; Position X ; Position Y ; Position N
     Ordre des champs : --> ID ; [Nom ;] Position X ; Position Y ; Position N
     
   • SP_Profil2.php?Numero=XXX&Motdepasse=YYY
     Ordre des champs --> ID, Position X ; Position Y ; Position N ; PV Actuels ; PV Max ; PA Restant ; DLA ; Nb Dés d'Attaque ; Nb Dés d'Esquive ; Nb Dés de Dégat ; Nb Dés de Régénération ; Vue ; Armure ; MM ; RM ; attaques subies ; fatigue ; camouflage ? ; invisible ? ; intangible ? ; Nb parades programmées ; Nb contre-attaques programmées ; durée du tour ; bonus de durée (hors équipement) ; Armure naturelle ; Nombre de dés d'armure en moins ; Immobile ? ; A terre ? ; en course ? ; Levite ? ; PV Totaux ; Niveau ; PIs Totaux ; Numéro de guilde ; Portée de vue ; Nb Retraites ; Direction des retraites (ordre chronologique) ; Durée du tour
   • SP_Profil3.php?Numero=XXX&Motdepasse=YYY
     Ordre des champs --> ID, Nom ; Position X ; Position Y ; Position N ; PA Restant ; DLA ; Fatigue ; Camouflage ; Invisible ; Intangible ; PX ; PX perso ; PI ; GG' ; Immobile ? ; A terre ? ; en course ? ; Levite ?
   • SP_Profil4.php?Numero=XXX&Motdepasse=YYY
     à documenter : version JSON
   • SP_Aptitudes2.php?Numero=XXX&Motdepasse=YYY
     Liste des Compétences et Sortilèges du Trõll
     Ordre des champs --> Type, Id ; Pourcentage ; Bonus Pourcentage ; Niveau ; Particularités (séparées par des virgules)
     
   • SP_Caract.php?Numero=XXX&Motdepasse=YYY
     Détail des caractéritiques du Trõll
     Ordre des champs --> Type ; Attaque ; Esquive ; Dégats; Régénération ; PVMax ; PVActuels ; Portée deVue ; RM ; MM ; Armure ; Duree du Tour ; Poids ; Concentration
     Le type donne trois valeurs : CAR(actéristiques), BMM et BMP
     
   • SP_Gigots.php?Numero=XXX&Motdepasse=YYY
     Nombre de GG possédés.
   • SP_Equipement.php?Numero=XXX&Motdepasse=YYY [&Cible=ZZZ] [&Split=0] [&withSolidite=0]
     Détaille l'équipement porté (équipé et non équipé) :
     Ordre des champs --> ID, équipé ? ; type ; identifié ? ; nom ; magie ; description ; poids ; Solidité
     Argument facultatif [&Cible=ZZZ] : permet d'avoir la liste des equipements portés par le Trõll "cible".
     Argument facultatif [&Split=1] : permet d'avoir un affichage des bonus découpés en BMP\BMM.
     Argument facultatif [&withSolidite=0] : permet d'avoir la solidité de l'item.
     
   • SP_Consignes.php?Numero=XXX&Motdepasse=YYY
     voir SP_Equipement + réservé au trõll + prix
   • SP_GrandesTanieres.php?Numero=XXX&Motdepasse=YYY
     voir SP_Equipement + réservé au trõll + prix
   • SP_Tanieres.php?Numero=XXX&Motdepasse=YYY
     voir SP_Equipement + réservé au trõll + prix
   • SP_Gowaps.php?Numero=XXX&Motdepasse=YYY
     voir SP_Equipement
   • SP_Listesdevente2.php?Numero=XXX&Motdepasse=YYY
     Renvoie l'ensemble des objets présents dans les listes de vente des trolls situés dans la zone :
     - limite de vue horizontale = vue + bonus de vue limité à 5 cases ;
     - limite de vue verticale = limite de vue horizontale / 2 arrondi au supérieur ;
     - Le trõll cible doit être visible ou camouflé, mais dans ce cas doit être sur la même case que le troll du joueur.
     voir SP_Equipement + trõll vendeur + prix
   • SP_Mouche.php?Numero=XXX&Motdepasse=YYY
     Liste des Mouches.
     Ordre des champs --> ID ; nom ; type ; âge ; présence
     
   • SP_Bonusmalus.php?Numero=XXX&Motdepasse=YYY
     Liste des Bonus et Malus (BM).
     Ordre des champs --> Nom ; Type ; Effet ; Durée (en tours)
     
   • SP_ActionsProg.php?Numero=XXX&Motdepasse=YYY
     Liste des actions programmées.
     Ordre des champs --> Numéro de l'Action ; Type ; Date ; Durée (en tours)
     
   [haut]

Messages d'erreurs

1. Erreur 1 : paramètres incorrects (aide)
2. Erreur 2 : trõll inexistant
3. Erreur 2 : guilde inexistante
4. Erreur 3 : mot de passe incorrect
5. Erreur 4 : Entretien
6. Erreur 5 : Scripts Publics Temporairement désactivés.
7. Erreur 6 : Troll désactivé ou PNJ

qu'est-ce qu'un jour ?