Scripts Publics pour développeurs

Les données publiques et les Scripts Publics permettent à tout développeur de pouvoir construire une interface de jeu externe.


Données Publiques



Scripts Publics

  • Les Scripts Publics renvoient les données associées à un Braldûn.
  • Le nombre d'appels autorisés aux Scripts Publics est limité.
  • XXX = le NUMERO d'un Braldûn
  • YYY = le mot de passe restreint correspondant.
  • Le mot de passe restreint peut-être obtenu dans vos paramètres via l'interface de jeu.
  • Info, anomalies, pour en parler... Forum Scripts Publics et Interfaces Externes



Détails des Scripts Publics

Le nombre d'appels autorisés aux Scripts Publics est limité par jour et par catégorie.

Catégorie Scripts Dynamiques : 24 appels par jour
Vue Version : 5
URL : http://sp.braldahim.com/scripts/vue/?idBraldun=XXX&mdpRestreint=YYY&version=5
Détails d'une ligne: TYPE;position_x;position_y;postion_z;autre_element;autre_element...
Historique :
version 5 : ajout des id_butin sur les éléments aliment, equipement, graine, ingredient, materiel, minerai, munition, partieplante, potion, rune, tabac + info de gibier ou non pour monstre / cadavre, suppression du niveau des monstres
version 4 : ajout de l'id_type_*, points gredins / redresseurs / distinctions, date de fin palissade
version 3 : ajout de l'id_type_monstre sur les types CADAVRE et MONSTRE
version 2 : ajout du type PORTAIL


Profil
Version : 2
URL : http://sp.braldahim.com/scripts/profil/?idBraldun=XXX&mdpRestreint=YYY&version=2


Événements
Version : 2
URL : http://sp.braldahim.com/scripts/evenements/?idBraldun=XXX&mdpRestreint=YYY&version=2
Détails d'une ligne: idBraldun;idEvenement;type;date;details;detailsbot

Catégorie Scripts Statiques : 14 appels par jour

Compétences
Version : 1
URL : http://sp.braldahim.com/scripts/competences/?idBraldun=XXX&mdpRestreint=YYY&version=1
Détails d'une ligne: idBraldun;typeCompetence;idCompetence;nom;nom_systeme;maitrise;idMetier


Contenu du Laban
Version : 1
URL : http://sp.braldahim.com/scripts/laban/?idBraldun=XXX&mdpRestreint=YYY&version=1
Détails d'une ligne: TYPE;autre_element;autre_element...


Contenu du coffre
Version : 1
URL : http://sp.braldahim.com/scripts/coffre/?idBraldun=XXX&mdpRestreint=YYY&version=1
Détails des lignes : similaire au script laban.


Contenu de la charrette
Version : 1
URL : http://sp.braldahim.com/scripts/charrette/?idBraldun=XXX&mdpRestreint=YYY&version=1


Liste des équipement équipés par le Braldûn
Version : 1
URL : http://sp.braldahim.com/scripts/equipements/?idBraldun=XXX&mdpRestreint=YYY&version=1
Détails d'une ligne : EQUIPEMENT;id_equipement;nom;qualite;emplacement;niveau;id_type_equipement;id_type_emplacement;
nom_type_emplacement;nom_systeme_type_emplacement;nb_runes;armure;force;agilite;vigueur;sagesse;
vue;attaque;degat;defense;suffixe;poids;etat_courant;etat_initial;ingredient;nom_systeme_type_ingredient;
armure_equipement_bonus;vernis_bm_armure_equipement_bonus;agilite_equipement_bonus;vernis_bm_agilite_equipement_bonus;
force_equipement_bonus;vernis_bm_force_equipement_bonus;sagesse_equipement_bonus;vernis_bm_sagesse_equipement_bonus;
vigueur_equipement_bonus;vernis_bm_vigueur_equipement_bonus;vernis_bm_vue_equipement_bonus;
vernis_bm_attaque_equipement_bonus; vernis_bm_degat_equipement_bonus;vernis_bm_defense_equipement_bonus;
id_rune_equipement_rune1;nom_type_rune1;id_rune_equipement_rune2;
nom_type_rune2;id_rune_equipement_rune3;nom_type_rune3;id_rune_equipement_rune4;nom_type_rune4;
id_rune_equipement_rune5;nom_type_rune5;id_rune_equipement_rune6;nom_type_rune6;
ou :
AUCUN_EQUIPEMENT



Liste des échoppes
Version : 2
URL : http://sp.braldahim.com/scripts/echoppes/?idBraldun=XXX&mdpRestreint=YYY&version=2
Détails d'une ligne si une échoppe est possédée: voir ci-dessous.
ou :
AUCUNE_ECHOPPE


Liste des champs
Version : 1
URL : http://sp.braldahim.com/scripts/champs/?idBraldun=XXX&mdpRestreint=YYY&version=1
Détails d'une ligne : CHAMP;idChamp;x;y;z;idRegion
ou :
AUCUN_CHAMP



Liste des quêtes et étapes
Version : 1
URL : http://sp.braldahim.com/scripts/quetes/?idBraldun=XXX&mdpRestreint=YYY&version=1

Catégorie Scripts Appels : 6 appels par jour

Appels
Version : 1
URL : http://sp.braldahim.com/scripts/appels/?idBraldun=XXX&mdpRestreint=YYY&version=1


Elements Communs
La première ligne renvoyée indique soit une erreur, soit le nombre d'appels en cours.

Exemple nominal :
			TYPE:dynamique;NB_APPELS:15;MAX_AUTORISE:24
			[..] (la suite des résultats sur les lignes suivantes)
			
Exemple avec le code ERREUR-09 :
			ERREUR-09. Depassement Appels;TYPE:dynamique;NB_APPELS:26;MAX_AUTORISE:24 
			
Exemple avec un autre code erreur :
			ERREUR-03. Braldûn inconnu
			


Code d'erreurs
ERREUR-01. Erreur Technique, l'équipe est informée
ERREUR-02. Paramètres incorrects
ERREUR-03. Braldûn inconnu
ERREUR-04. Mot de passe invalide
ERREUR-05. Braldûn désactivé ou pnj
ERREUR-06. Service temporairement désactivé
ERREUR-07. Service inconnu
ERREUR-08. Version incorrecte
ERREUR-09. Dépassement appels


Aide

Débuter


Premier Exemple
			
			/* lecture du fichier et stockage dans la chaîne de caractères "$buffer" */
			$fichier = "http://public.braldahim.com/bralduns.csv";
			$buffer = "";
			$fd = @fopen($fichier,"r");
			if ($fd) {
				while (!@feof($fd)) { $buffer .= @fgets($fd, 4096); }
				@fclose ($fd);
			
				/* premier découpage en tranches : les lignes sont séparées */
				$lignes = explode("\n", $buffer );
					
				/* chaque ligne est à nouveau découpée en tranches, par champs, et affichée */
				$i=0;
				while ($lignes[$i]) {
					$data = explode(";", $lignes[$i]);
					echo $data[0]." - ".$data[1]." - ". $data[2]." - ". $data[3];
					echo " - ". $data[4]." - ". $data[5]." - ". $data[6]."<br>";
					$i++;
				}
			} else { 
				echo "Le fichier "".$fichier."" est inaccessible : "; 
			}
		
Exemple optimisé
Remplacer :
			while (!@feof($fd)){ $buffer .= @fgets($fd, 4096); }
			@fclose ($fd);
			$lignes = explode("\n", $buffer );
			
par :
			while (!@feof($fd)){ $lignes[] = @fgets($fd, 4096); }
			@fclose ($fd);
			

Remplacer :
			echo $data[0]." - ".$data[1]." - ". $data[2]." - ". $data[3]
			echo " - ". $data[4]." - ". $data[5]." - ". $data[6]."<br>";
			
par :
			echo implode(" - ", $data );