Данные миров (API игры): различия между версиями

Материал из Tribalwars Wiki RU
Перейти к навигации
Строка 74: Строка 74:
== Данные мира 1 ==
== Данные мира 1 ==
[http://ru1.voyna-plemyon.ru/map/village.txt /map/village.txt] - [http://ru1.voyna-plemyon.ru/map/village.txt.gz /map/village.txt.gz]
[http://ru1.voyna-plemyon.ru/map/village.txt /map/village.txt] - [http://ru1.voyna-plemyon.ru/map/village.txt.gz /map/village.txt.gz]
[http://ru1.voyna-plemyon.ru/map/player.txt /map/player.txt] - [http://ru1.voyna-plemyon.ru/map/player.txt.gz /map/player.txt.gz]
[http://ru1.voyna-plemyon.ru/map/ally.txt /map/ally.txt] - [http://ru1.voyna-plemyon.ru/map/ally.txt.gz /map/ally.txt.gz]
[http://ru1.voyna-plemyon.ru/map/conquer.txt /map/conquer.txt] - [http://ru1.voyna-plemyon.ru/map/conquer.txt.gz /map/conquer.txt.gz]
[http://ru1.voyna-plemyon.ru/map/profile.txt /map/profile.txt] - [http://ru1.voyna-plemyon.ru/map/profile.txt.gz /map/profile.txt.gz]
[http://ru1.voyna-plemyon.ru/interface.php?func=get_conquer&since=unix_timestamp /interface.php?func=get_conquer&since=unix_timestamp]
[http://ru1.voyna-plemyon.ru/interface.php?func=get_config /interface.php?func=get_config]

Версия от 12:36, 24 ноября 2010

Общая информация

Для того, чтобы игроки могли создавать свои инструменты для игры мы предоставляем регулярно обновляемые данные миров.

Чтобы уменьшить трафик, старайтесь скачивать данные о мире не слишком часто. Программы, скачивающие данные более раза в час в нормальном режиме запрещены. В этом случае попробуйте сохранять данные на внешнем сервере. Данные обновляются через равные промежутки времени, зависящие от сервера.

Файлы также доступны в сжатом виде (с суффиксом .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

/interface.php?func=get_conquer&since=unix_timestamp

/interface.php?func=get_config