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'appel [; 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 ?