Sonstige Informationen
Banner
Wenn du auf deiner Homepage einen Stämme-Banner einbauen willst, findest du hier den dafür passenden Code. Kopiere diesen Bannercode aus der Textbox und füge ihn in den HTML-Code deiner Homepage ein. Vielen Dank, dass du hilfst, Stämme bekannter zu machen!
Banner
<a href="http://www.die-staemme.de/?ref=banner_468"><img style="border:none" src="http://www.die-staemme.de/banner.php?id=banner_468" alt="Die Stämme, das kostenlose Browsergame" /></a>
Button
<a href="http://www.die-staemme.de/?ref=banner_button"><img style="border:none" src="http://www.die-staemme.de/banner.php?id=banner_button" alt="Die Stämme" /></a>
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.
| Pfad | Beschreibung | Sortierung |
|---|---|---|
| /map/village.txt /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 |
| /map/player.txt /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 |
| /map/ally.txt /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 |
| /map/conquer.txt /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 |
| /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 |
| /map/profile.txt /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 |
| /map/kill_att.txt /map/kill_def.txt /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 |
| /map/kill_att_tribe.txt /map/kill_def_tribe.txt /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 |
| /interface.php?func=get_config | Über diese Funktion kann man die Konfiguration der Welt auslesen (Format: XML) mehr | |
| /interface.php?func=get_unit_info | Informationen zu den Einheiten als XMLmehr | |
| /interface.php?func=get_building_info | Informationen zu den Gebäuden als 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:
http://deXX.die-staemme.de
Anstelle des XX muss die entsprechende Welt ausgewählt werden. Eine korrekte URL könnte daher lauten:
http://de68.die-staemme.de/interface.php?func=get_config
Beispiel
Ein einfaches Beispiel in PHP, um die Dörfer + Namen von Welt1 in eine MySQL-Datenbank zu schreiben:
$lines = gzfile('http://dexx.die-staemme.de/map/village.txt.gz');
if(!is_array($lines)) die("Datei konnte nicht geöffnet werden");
foreach($lines as $line) {
list($id, $name,$x, $y, $player, $points, $rank) = explode(',', $line);
$name = urldecode($name);
$name = addslashes($name);
mysql_query("INSERT INTO village SET id='$id', name='$name', x='$x', y='$y',
player='$player', points='$points', rank='$rank'");
}
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:
$file = file_get_contents('http://www.die-staemme.de/backend/get_servers.php');
$servers = unserialize($file);
Für andere Sprachen müsste man den Rückgabestring parsen.