|
|
| (22 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| == Banner == | | === Premium-Welten === |
|
| |
|
| 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!
| | Premium-Welten sind Welten auf denen erweiterte Premium-Features, wie zum Beispiel Bauzeitreduzierung, Baukostenreduzierung oder das Premium-Depot aktiv sind. |
|
| |
|
| === Banner === | | === Non-Premium-Welten === |
|
| |
|
| <center>[[Bild:DSbanner1.gif|DS-Banner]]</center>
| | Non-Premium-Welten sind Welten auf denen die oben genanten Features nicht aktiv sind. |
|
| |
|
| | === Bot-Schutz === |
| | Unter Bearbeitung! |
|
| |
|
| <code><a href="<nowiki>http://www.die-staemme.de/?ref=banner_468</nowiki>"><img style="border:none" src="<nowiki>http://www.die-staemme.de/banner.php?id=banner_468</nowiki>" alt="Die Stämme, das kostenlose Browsergame" /></a></code>
| | Mit dem Botschutz wird überprüft, ob ein menschlicher Spieler oder ein Bot die Aktionen im Account ausführt. Die Anzeige des Botschutzes richtet sich nach verschiedenen internen Kriterien und kann mehrmals am Tag erscheinen. Sie besagt jedoch nicht zwangsläufig, dass tatsächlich ein Bot verwendet wird. |
|
| |
|
| === Button ===
| | Der Botschutz hat unter Umständen mehrere Stufen (Schwierigkeitsgrade): |
|
| |
|
| <center>[[Bild:DSbanner2.png|DS-Button]]</center>
| | # Es muss nur ein Klick in ein Feld gemacht werden. |
| | # Es müssen Bilder ausgewählt werden. Dabei kann es passieren, dass mehrmals hintereinander neue Bilder kommen. Dies unter anderem davon abhängig, wie die Maus bewegt wird etc. |
| | # Es muss ein bestimmter Text markiert, kopiert und in ein Textfeld eingefügt werden. |
|
| |
|
| | In einigen Fällen kann es zu Problemen mit dem Lösen des Botschutzes kommen, die folgende Ursachen haben können: |
|
| |
|
| <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>
| | * Es sind Tools oder AddOns, wie z.B. AdBlocker, NoScript, Ghostery, aktiv. |
| | | * Es wird kein aktueller Standard-Browser benutzt. |
| == Externe IGMs ==
| | * JavaScript wurde deaktiviert. |
| | | * Anfragen an die Google Services müssen erlaubt sein. |
| === Versenden von IGMs über externes Interface ===
| |
| | |
| Manchmal ist es wünschenswert, dass externe Programme Nachrichten an Spieler verschicken können, um diese über wichtige Ereignisse zu informieren oder ihre Identität zu überprüfen. Da das Programmieren von Bots laut Regeln untersagt ist, stellen wir ein Interface für diesen Zweck zur Verfügung.
| |
| | |
| IGM-Messages werden per GET-Aufruf erzeugt:
| |
| | |
| <code><nowiki>http://de69.die-staemme.de/send_mail.php?from_id=FROM_ID&api_key=API_KEY&to=TO&subject=SUBJECT&message=MESSAGE</nowiki></code>
| |
| | |
| Bedeutung der Parameter:
| |
| | |
| * FROM_ID: deine Spieler-ID (kann zB. über die Rangliste ermittelt werden) | |
| * API_KEY: dein Stämme API-Key (unter Einstellungen->Einstellungen zu finden)
| |
| * TO: Name (nicht die ID) des Spielers, der die Nachricht erhalten soll
| |
| * SUBJECT: Betreff der Nachricht
| |
| * MESSAGE: Die eigentliche Nachricht
| |
| | |
| Die Option ist nur für die Besitzer eines Premium-Accounts freigeschaltet. Sollte diese Funktion für Spam oder Belästigungen anderer Spieler missbraucht werden, kann der Account gesperrt werden.
| |
| | |
| === Beispiel in PHP: ===
| |
| | |
| <code>// Die Parameter müssen URL-encodiert werden
| |
| $to = urlencode('exception');
| |
| $subject = urlencode('test & test');
| |
| $message = urlencode('Dies ist ein Test');
| |
| <br />
| |
| <br />
| |
| $base_url = "<nowiki>http://deXX.die-staemme.de/send_mail.php?from_id=FROM_ID&api_key=API_KEY</nowiki>";<br /><br />
| |
| // URL aufrufen
| |
| $handle = fopen($base_url . "&to=$to&subject=$subject&message=$message", 'r');
| |
| echo fgets($handle); // Meldung ausgeben
| |
| fclose($handle);</code>
| |
| | |
| In der Variabel base_url muss anstatt XX die entsprechende Welt angegeben werden.
| |
| | |
| == 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<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, $rank
| |
| |-
| |
| | /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
| |
| |-
| |
| | /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
| |
| |-
| |
| | /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
| |
| |-
| |
| | /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<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
| |
| |-
| |
| | /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
| |
| |-
| |
| | /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
| |
| |-
| |
| | /interface.php?func=get_config
| |
| | Über diese Funktion kann man die Konfiguration der Welt auslesen (Format: XML).
| |
| |
| |
| |-
| |
| | /interface.php?func=get_unit_info
| |
| | Informationen zu den Einheiten als XML
| |
| |
| |
| |-
| |
| | /interface.php?func=get_building_info
| |
| | Informationen zu den Gebäuden als XML
| |
| |
| |
| |}
| |
| | |
| 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 Bespiel 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]] |
| Zeile 162: |
Zeile 35: |
| [[ru:Другая информация]] | | [[ru:Другая информация]] |
| [[sl:Ostalo]] | | [[sl:Ostalo]] |
| [[th:การส่งข้อความในเกมจากภายนอก]] | | [[th:ข้อมูลเวิลด์]] |
