Скачать плагин LiveAtlas — Интерфейс Dynmap / Pl3xmap для современного Интернета [3.1.0]

Начиная с 1.0.0, LiveAtlas теперь поддерживает несколько бэкэндов карты («серверов») в одном экземпляре. Эта функция предназначена для устранения необходимости поддерживать несколько копий LiveAtlas, если у вас есть несколько серверов с картами. При настройке нескольких серверов в раскрывающемся списке карты добавляется раздел, позволяющий пользователю переключаться между ними.
Пример конфигурации с несколькими серверами можно найти здесь

Это считается продвинутым использованием, и ожидается, что вы получите практические знания по настройке веб-серверов и координатах.

Как это работает

Если в LiveAtlas включена поддержка нескольких серверов, к URL-адресу будет добавлен сервер, который в данный момент просматривается пользователем. Например, если LiveAtlas размещен по адресу https://example.com/map/, а пользователь находится на сервере выживания, URL-адрес будет https://example.com/map/survival.

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

Требования

LiveAtlas на внешнем веб-сервере

Поддержка нескольких серверов требует, чтобы LiveAtlas размещался на внешнем веб-сервере. Внутренние веб-серверы Dynmap/Pl3xmap не будут работать для этого, поскольку они не будут правильно маршрутизировать URL-адреса серверов.

Все настроенные серверы доступны извне через браузер
LiveAtlas должен иметь возможность делать запросы к каждому настроенному серверу из браузера посетителя. Это означает, что все настроенные вами URL-адреса серверов dynmap/Pl3xmap должны быть общедоступными и соответствовать всем ограничениям, налагаемым браузером:

Если доступ к вашим серверам осуществляется через источник, отличный от самого LiveAtlas, тогда вам нужно будет убедиться, что заголовки CORS настроены правильно. Заголовки для внутреннего веб-сервера Dynmap можно настроить с помощью параметра http-response-headers в dynmap.

В качестве альтернативы вы можете настроить свой веб-сервер как обратный прокси-сервер и сделать все отдельные серверы доступными из того же источника, на котором размещен LiveAtlas,
что позволит избежать этой проблемы.

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

Приступаем к настройке:

1) Настройте LiveAtlas на URL-адреса, которые вы хотите использовать

LiveAtlas должен быть доступен через URL-адреса всех серверов, которые вы хотите использовать. Например, если вы хотите, чтобы ваши серверные карты были доступны через https://example.com/map/<servername> с серверами с именами creative и survival, вам необходимо убедиться, что LiveAtlas доступен через https://example.com/map/survivall и https://example.com/map/creative.

Простой способ сделать это - разместить LiveAtlas по адресу https://example.com/map/ (обратите внимание на завершающий /) и настроить свой веб-сервер для маршрутизации запросов на несуществующие файлы в index.html LiveAtlas. В приведенном ниже примере для nginx запросы к несуществующим файлам для /map/ URL направляются в LiveAtlas: 

 location ~ ^/map/ {
     index index.html;
     try_files $uri /map/index.html;

     # If you're hosting dynmap's php files in the same folder
     location ~ \.php$ {
         fastcgi_split_path_info ^(.+\.php)(/.+)$;
         fastcgi_pass unix:/run/php/php7.4-fpm.sock;
         fastcgi_index index.php;
         include /etc/nginx/fastcgi_params;
         fastcgi_param SCRIPT_FILENAME $request_filename;
    }
}

2)  Настроить LiveAtlas для нескольких серверов

Поддержка нескольких серверов настраивается в index.html. Найдите <script>, содержащий объект window.liveAtlasConfig, и отредактируйте свойство servers, включив в него серверы, которые должны быть доступны в LiveAtlas. Ключ каждого серверного объекта будет использоваться в URL-адресе для доступа к нему.
Каждый объект сервера должен содержать свойство dynmap или pl3xmap, которое содержит URL-адреса, необходимые для отображения карты. Для карт Dynmap требуется несколько URL-адресов, которые можно найти в standalone/config.js для сервера. Для карт Pl3xmap требуется только URL-адрес, по которому карта в настоящее время доступна для просмотра. Во избежание двусмысленности рекомендуется сделать все URL-адреса абсолютными.

Пример с двумя dynmap-серверами с именами creative и survival и 3-м сервером Pl3xmap:

 window.liveAtlasConfig = {
     servers: {
         creative: {
             label: 'Creative',
             dynmap: {
                 configuration: 'http://example.com/creative/standalone/MySQL_configuration.php',
                 update: 'http://example.com/creative/standalone/MySQL_update.php?world={world}&ts={timestamp}',
                 sendmessage: 'http://example.com/creative/standalone/MySQL_sendmessage.php',
                 login: 'http://example.com/creative/standalone/MySQL_login.php',
                 register: 'http://example.com/creative/standalone/MySQL_register.php',
                 tiles: 'http://example.com/creative/standalone/MySQL_tiles.php?tile=',
                 markers: 'http://example.com/creative/standalone/MySQL_markers.php?marker='
             }
         },
         survival: {
             label: 'Survival',
             dynmap: {
                 configuration: 'http://example.com/survival/standalone/MySQL_configuration.php',
                 update: 'http://example.com/survival/standalone/MySQL_update.php?world={world}&ts={timestamp}',
                 sendmessage: 'http://example.com/survival/standalone/MySQL_sendmessage.php',
                 login: 'http://example.com/survival/standalone/MySQL_login.php',
                 register: 'http://example.com/survival/standalone/MySQL_register.php',
                 tiles: 'http://example.com/survival/standalone/MySQL_tiles.php?tile=',
                 markers: 'http://example.com/survival/standalone/MySQL_markers.php?marker='
             }
         },
         pl3xmap: {
             label: 'Pl3xmap',
             pl3xmap: 'http://example.com/pl3xmap/'
         }
     }
 }

3)  Удалите тег standalone/config.js <script>.

Этот скрипт больше не требуется, и его следует удалить, чтобы избежать ненужного запроса.

4) Тест

Посетите URL-адрес, по которому вы размещаете LiveAtlas (в нашем примере http://example.com/map/), и убедитесь, что все работает правильно. Обязательно проверьте URL-адреса отдельных серверов (в данном случае http://example.com/map/survival, http://example.com/map/creative и http://example.com/map/pl3xmap). .

Если сервер настроен неправильно,

LiveAtlas отобразит ошибку на экране-заставке, информируя вас о проблеме. Если конфигурация верна, попробуйте переключиться на все настроенные серверы и убедитесь, что они загружаются правильно. Если сервер загружается некорректно, проверьте консоль браузера, чтобы узнать, почему, и при необходимости измените конфигурацию.