|
|
| Zeile 15: |
Zeile 15: |
| <code><a href="<nowiki>http://www.die-staemme.de/?ref=banner_button</nowiki>"><img style="border:none" src="<nowiki>http://www.die-staemme.de/banner.php?id=banner_button</nowiki>" alt="Die Stämme" /></a></code> | | <code><a href="<nowiki>http://www.die-staemme.de/?ref=banner_button</nowiki>"><img style="border:none" src="<nowiki>http://www.die-staemme.de/banner.php?id=banner_button</nowiki>" alt="Die Stämme" /></a></code> |
|
| |
|
| == Weltdaten ==
| |
|
| |
|
| Um externe Statistiken oder ähnliches zu erstellen, werden die wichtigsten Weltdaten zum Download angeboten. Die Eigenschaften der Dörfer, der Stämme und der Spieler stehen regelmäßig zum Download bereit. Mittlerweile gibt es auch noch weitere Daten, wie alle Adelungen seit Anfang der Welt mit Unix Timestamp oder Inhalte von Profilen.
| |
|
| |
| Versuche die Weltdaten möglichst selten zu laden, um Traffic zu reduzieren. Skripte, die im Normalbetrieb mehr als 1 mal pro Stunde die Daten laden, sind nicht erlaubt. Versucht in diesem Fall, die Daten auf einem externen Webserver zu cachen. Die Weltdaten werden zu regelmäßigen Zeitabständen aktualisiert. Diese Abstände sind serverspezifisch.
| |
|
| |
| Die Dateien sind auch komprimiert verfügbar (Dateiendung .txt.gz). Als Kompressionsverfahren wurde gzip genutzt. Nutzt diese Dateien, wenn möglich.
| |
|
| |
| Es existieren insgesamt 5 Dateien zum Download. Jede Datei besteht aus beliebig vielen Zeilen, die kommagetrennt die Daten enthalten. Die einzelnen Daten sind mit Hilfe der PHP-Funktion urlencode() codiert, d.h. dass z.B. ein Komma durch %2C ersetzt ist.
| |
|
| |
| {|
| |
| |- bgcolor="#8D7654"
| |
| ! Pfad
| |
| ! Beschreibung
| |
| ! Sortierung
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/village.txt<br /> <br />/map/village.txt.gz
| |
| | In dieser Datei befinden sich Informationen über die Dörfer. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $id, $name, $x, $y, $player, $points, $bonus_id
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/player.txt<br /> <br />/map/player.txt.gz
| |
| | In dieser Datei sind Informationen über die Spieler. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $id, $name, $ally, $villages, $points, $rank
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/ally.txt<br /> <br />/map/ally.txt.gz
| |
| | In dieser Datei sind Informationen über die Stämme. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $id, $name, $tag, $members, $villages, $points, $all_points, $rank
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/conquer.txt<br /> <br />/map/conquer.txt.gz
| |
| | In dieser Datei sind alle Adelungen seit Beginn der Welt enthalten. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $village_id, $unix_timestamp, $new_owner, $old_owner
| |
| |- bgcolor="#F4E4BC"
| |
| | /interface.php?func=get_conquer&since=unix_timestamp
| |
| | Über diese Funktion kann man sich alle Adelungen seit dem letzten Unix-Timestamp ausgeben lassen. Der Timestamp darf maximal 24 Stunden zurück liegen. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $village_id, $unix_timestamp, $new_owner, $old_owner
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/profile.txt<br /> <br />/map/profile.txt.gz
| |
| | In dieser Datei sind die Profildaten der Spieler. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $player_id, Geburtstag, Geschlecht, Wohnort, Profiltext (als XHTML), Profilbild-Dateiname
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/kill_att.txt<br /> <br />/map/kill_def.txt<br /> <br />/map/kill_all.txt
| |
| | In diesen Dateien befinden sich Informationen über die Besiegte-Gegner-Punkte (Alle, Als Verteidiger, Als Angreifer) für Spieler. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $rank, $id, $kills
| |
| |- bgcolor="#F4E4BC"
| |
| | /map/kill_att_tribe.txt<br /> <br />/map/kill_def_tribe.txt<br /> <br /> /map/kill_all_tribe.txt
| |
| | In diesen Dateien befinden sich Informationen über die Besiegte-Gegner-Punkte (Alle,Als Verteidiger,Als Angreifer) für die gesamten Stämme. Die Daten stehen in folgender Reihenfolge zur Verfügung:
| |
| | $rank, $id, $kills
| |
| |- bgcolor="#F4E4BC"
| |
| | /interface.php?func=get_config
| |
| | Über diese Funktion kann man die Konfiguration der Welt auslesen (Format: XML) [[XML|mehr]]
| |
| |
| |
| |- bgcolor="#F4E4BC"
| |
| | /interface.php?func=get_unit_info
| |
| | Informationen zu den Einheiten als XML [[XML|mehr]]
| |
| |
| |
| |- bgcolor="#F4E4BC"
| |
| | /interface.php?func=get_building_info
| |
| | Informationen zu den Gebäuden als XML [[XML|mehr]]
| |
| |
| |
| |}
| |
|
| |
| Um die komplette URL für eine bestimmte Welt zu erhalten, muss vor dem Pfad die entsprechende URL der Welt ausgewählt werden:
| |
|
| |
| <code><nowiki>http://deXX.die-staemme.de</nowiki></code>
| |
|
| |
| Anstelle des XX muss die entsprechende Welt ausgewählt werden. Eine korrekte URL könnte daher lauten:
| |
|
| |
| <code><nowiki>http://de68.die-staemme.de/interface.php?func=get_config</nowiki></code>
| |
|
| |
| === Beispiel ===
| |
|
| |
| Ein einfaches Beispiel in PHP, um die Dörfer + Namen von Welt1 in eine MySQL-Datenbank zu schreiben:
| |
|
| |
| <code>$lines = gzfile('<nowiki>http://dexx.die-staemme.de/map/village.txt.gz</nowiki>');<br />
| |
| if(!is_array($lines)) die("Datei konnte nicht geöffnet werden");<br/>
| |
| foreach($lines as $line) {
| |
| list($id, $name,$x, $y, $player, $points, $rank) = explode(',', $line);<br />
| |
| $name = urldecode($name);<br />
| |
| <br />
| |
| $name = addslashes($name);<br />
| |
| mysql_query("INSERT INTO village SET id='$id', name='$name', x='$x', y='$y',
| |
| player='$player', points='$points', rank='$rank'");<br />
| |
| }
| |
| </code>
| |
|
| |
| === Server-Urls ermitteln ===
| |
|
| |
| Da teilweise die URLs der Spielwelten sich durch Wartungsarbeiten und ähnliches zeitweise ändern, gibt es jetzt eine Möglichkeit, die offizielle URL jeder Spielwelt zu ermitteln.
| |
|
| |
| Zurückgegeben wird ein serialisiertes PHP-Array.
| |
|
| |
| http://www.die-staemme.de/backend/get_servers.php
| |
|
| |
| Beispiel im PHP-Code:
| |
|
| |
| <code>$file = file_get_contents('<nowiki>http://www.die-staemme.de/backend/get_servers.php</nowiki>');<br />
| |
| $servers = unserialize($file);</code>
| |
|
| |
| Für andere Sprachen müsste man den Rückgabestring parsen.
| |
|
| |
|
| [[Kategorie:Offizieller Hilfeartikel]] | | [[Kategorie:Offizieller Hilfeartikel]] |
