Данные миров (API игры)
Общая информация
Для того, чтобы игроки могли создавать свои инструменты для игры мы предоставляем регулярно обновляемые данные миров.
Чтобы уменьшить трафик, старайтесь скачивать данные о мире не слишком часто. Программы, скачивающие данные более раза в час в нормальном режиме запрещены. В этом случае попробуйте сохранять данные на внешнем сервере. Данные обновляются через равные промежутки времени, зависящие от сервера.
Файлы также доступны в сжатом виде (с суффиксом .txt.gz). По возможности, используйте эти файлы.
Всего для скачивание предоставлено 5 файлов. Каждый состоит из произвольного числа строк, содержащих данные через запятую. Каждый элемент данных закодирован с помощью функции PHP urlencode(), что в частности, означает, что запятая представлена как %2C.
/map/village.txt - /map/village.txt.gz
В этом файле находится информация о деревнях. Данные представлены в следующем порядке:
$id, $name, $x, $y, $player, $points, $rank
/map/player.txt - /map/player.txt.gz
В этом файле находится информация об игроках. Данные представлены в следующем порядке:
$id, $name, $ally, $villages, $points, $rank
/map/ally.txt - /map/ally.txt.gz
В этом файле находится информация о племенах. Данные представлены в следующем порядке:
$id, $name, $tag, $members, $villages, $points, $all_points, $rank
/map/conquer.txt - /map/conquer.txt.gz
В этом файле хранится информация о всех захватах со старта мира. Данные представлены в следующем порядке:
$village_id, $unix_timestamp, $new_owner, $old_owner
/interface.php?func=get_conquer&since=unix_timestamp
С помощью этой функции можно получить информацию о всех захватах с указанного момента, указанного в виде unix timestamp. Дата не может быть более, чем 24 часа назад. Данные представлены в следующем порядке:
$village_id, $unix_timestamp, $new_owner, $old_owner
/map/profile.txt - /map/profile.txt.gz
В этом файле представлены данные профилей игроков в следующем порядке:
$player_id, Geburtstag, Geschlecht, Wohnort, Profiltext (als XHTML), Profilbild-Dateiname
/interface.php?func=get_config
С помощью этой функции можно получить конфигурацию мира в формате XML.
Простейший пример на PHP, сохраняющий деревни и имена первого мира в базу данных MySQL:
$lines = gzfile(http://ds1.die-staemme.de/map/village.txt.gz); if(!is_array($lines)) die("Невозможно открыть файл"); 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'"); }
Данные мира 1
Информация о деревнях: /map/village.txt - /map/village.txt.gz
Информация об игроках: /map/player.txt - /map/player.txt.gz
Информация о племенах: /map/ally.txt - /map/ally.txt.gz
Информация о захватах деревень: /map/conquer.txt - /map/conquer.txt.gz
Данные профилей игроков: /map/profile.txt - /map/profile.txt.gz
Все захваты за последние 24 часа: /interface.php?func=get_conquer&since=unix_timestamp
Настройки мира в формате XML: /interface.php?func=get_config