EasyWebMap

Создан для европейского сервера выживания Hytale play.hyfyve.net

Живая веб-карта для вашего сервера Hytale. Просмотр вашего мира в браузере, отслеживание игроков в режиме реального времени и легкая интеграция с вашим сайтом сообщества.

Быстрый старт

1. Скачать последнюю EasyWebMap.jar из выпуски
2. Поместите его на свой сервер мод папка
3. Перезагрузите свой сервер
4. Открыть http://localhost:8080 В вашем браузере

Что вы можете сделать

Живая карта мира

• Посмотреть весь ваш мир в веб-браузере
• Terrain обновляется автоматически, когда игроки создают или уничтожают блоки
• Zoom in/out и свободно передвигаться
• Использование рендеринга родной карты Hytale (так же, как и внутриигровая карта)

Отслеживание игроков в реальном времени

• Все онлайн-игроки на карте с маркерами стрел
• Стрелы вращаются, чтобы показать, в каком направлении сталкиваются игроки.
• Нажмите на любого игрока на боковой панели, чтобы перейти к его местоположению
• Обновление позиций игрока каждую секунду через WebSocket

Интеграция сайта

Вставьте карту непосредственно на веб-сайте вашего сообщества с помощью iframe:

<iframe src="http://your-server-ip:8080" width="100%" height="600"></iframe>

Или ссылайтесь на него с веб-сайта вашего сервера, Discord или форумов.

REST API

Создание пользовательских инструментов с использованием встроенного API:

Пример: Позиции игроков

const response = wait fetch ('http://your-server:8080/api/players/world');
Const Players = Wait Response.json();
// [{название: "Стив", x: 100, y: 64, z: -200, yaw: 1.57 }, ...]

Пример: WebSocket для живых обновлений

const ws = новый WebSocket ('ws://your-server:8080/ws');
ws.onmessage = (e) => {
const data = JSON.parse (e.data);
console.log (data.worlds); // Все позиции игроков по миру
}

Многомировая поддержка

• Переключение между мирами с помощью выпадающего
• Конфигурируйте, какие миры видны
• Каждый мир имеет свой собственный кэш

командование

Все команды требуют easybmap.admin Разрешение.

HTTPS с Let's Encrypt (бесплатный SSL)

EasyWebMap может автоматически получать и обновлять SSL-сертификаты от Let's Encrypt. Не требуется ручное управление сертификатами!

Быстрая настройка

1. Направьте свой домен на ваш сервер - Убедись. map.yourserver.com (или любой домен, который вы выберете) указывает на IP-адрес вашего сервера.

2. Открытый порт 80 Let's Encrypt должен проверить, что вы владеете доменом, подключившись к порту 80. Убедитесь, что ваш брандмауэр позволяет это.

3. Добавьте в конфигурацию. Джексон:

{
"Включить Https": правда,
httpsPort: 8443,
"домен": "map.yourserver.com",
"acmeEmail": "admin@yourserver.com"
?

1. Перезагрузите свой сервер - Плагин будет автоматически:
   • Скачать Let's Encrypt
   • Запрос сертификата для вашего домена
   • Начать обслуживание HTTPS на порту 8443

Вот так! Ваша карта теперь доступна на https://map.yourserver.com: 8443

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

Когда вы включаете HTTPS, плагин:

1. Создает учетную запись с помощью Let's Encrypt (хранится в ssl/account.key)
2. Запрос сертификата для вашего домена
3. Let's Encrypt вызов HTTP-01 на порту 80
4. Хранит сертификат в ssl/domain.crt и ключ к ssl/domain.key
5. Запуск сервера HTTPS
6. Ежедневно проверяет, нуждается ли сертификат в обновлении (обновляется за 30 дней до истечения срока действия)
7. Автоматически перезагружать сертификат без перезапуска

Опции конфигурации HTTPS

SSL команды

Требования

• Доменное имя - Вам нужен домен, указывающий на ваш сервер (IP-адреса не будут работать с Let's Encrypt)
• Порт 80 доступен Let's Encrypt проверяет право собственности на домен через HTTP на порту 80
• Порт 8443 (или 443) - для обслуживания HTTPS трафика

Первый тест

Прежде чем идти в прямом эфире, проверьте с помощью Let's Encrypt сервер, чтобы избежать ограничений скорости:

{
"Включить Https": правда,
"домен": "map.yourserver.com",
«UseProductionAcme»: ложный
?

Постановочный сервер выдает тестовые сертификаты, которым браузеры не будут доверять, но это доказывает, что все работает. После проверки устанавливается Производитель: Acme назад к истинный и перезапустить.

Порт 443 (стандартный HTTPS)

По умолчанию HTTPS работает на порту 8443. Если вы хотите использовать стандартный порт HTTPS (443):

{
"httpsPort": 443
?

Привязка к порту 443 может потребовать запуска сервера в качестве корня/администратора или использования обратного прокси.

За обратным прокси

Если вы используете nginx или Apache в качестве обратного прокси-сервера, вы можете разрешить прокси-серверу обрабатывать SSL и сохранять EasyWebMap только на HTTP. Пример конфигурации nginx:

Сервер {
слушать 443 ssl;
server_name map.yourserver.com

ssl_certificate /etc/letsencrypt/live/map.yourserver.com/fullchain.pem;
ssl_certificate_key/etc/letsencrypt/live/map.yourserver.com/privkey.pem;

местоположение / {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
прокси_set_header Обновление $http_upgrade
proxy_set_header Подключение «обновление»;
прокси_set_header хостинг $host;
?
?

конфигурация

Файл Config: mods/cryptobench_EasyWebMap/config.json

{
"httpPort": 8080,
"обновление IntervalMs": 1000,
"TileCacheSize": 20000,
«Возможные миры»: [],
"размер плитки": 256,
"МаксЗум": 4,
"RenderExploredChunksOnly": правда,
"chunkIndexCacheMs": 30000,
"useDiskCache": правда,
"TileRefreshRadius": 5,
"TileRefreshIntervalMs": 60000,
"Включить Https": ложный,
httpsPort: 8443,
"домен": "",
"acmeEmail": ",
Оригинальное название: UseProductionAcme: True
?

Chunk Index Cache (недоступная ссылка)Обсуждение IndexCacheMs)

Когда Скачать ExploredChunksOnly включен, плагин должен проверить, какие фрагменты были исследованы. Для этого требуется считывать индекс с диска. Чтобы избежать чтения диска по каждому запросу плитки, индекс кэшируется.

Компромисс:

• более низкое значение (например, 5000 мс): Новое исследование показывает на карте быстрее, но больше диска считывает
• Более высокая ценность (например, 60000 мс): Меньше считывает диск, но недавно исследованные области занимают больше времени, чтобы появиться.

Что это означает на практике:

Примерный сценарий: Игрок исследует новую область. с Обсуждение:IndexCacheMs: 30000Новые фрагменты не появятся на веб-карте до истечения срока действия кэша (до 30 секунд). До тех пор плитка будет казаться пустой.

Примечание: Это только влияет новый Исследовал куски. Уже исследованные куски всегда видны. The /easywebmap clearcache Команда очищает этот кэш немедленно, если это необходимо.

Дисковый кэш и Smart Refresh

Плагин использует интеллектуальную систему кэширования, чтобы минимизировать нагрузку на сервер:

1. Дисковый кэшTiles сохраняются как PNG файлы mods/cryptobench_EasyWebMap/tilecache/. Они сохраняются при перезагрузке сервера, поэтому первый посетитель после перезагрузки не запускает генерацию массовой плитки.

2. Smart RefreshПлитка восстанавливается только тогда, когда:

   • Плитка старше, чем Обновление IntervalMs (по умолчанию: 60 секунд), и
   • Игрок находится внутри Плитка RefreshRadius По умолчанию: 5 кусков

Почему это важно:

• Если поблизости нет игроков, местность не может измениться, поэтому кэшированная плитка всегда действительна.
• Это означает, что 99% запросов на плитку обслуживаются мгновенно из кэша с нулевой загрузкой сервера.
• Регенерируют только активные игровые зоны и максимум раз в минуту.

Поток:

Запрос на плитку → Кэш памяти? Служить мгновенно
↓ нет
Дисковый кэш? Достаточно свежий? Обслуживание с диска
↓ Нет ↓ Старый
Создавать новых игроков поблизости? Нет: сервировать несвежий (поезд без изменений)
↓ да
Регенерировать плитку

Предпоколение

Использовать /easywebmap pregenerate <radius> Чтобы согреть кэш:

• Генерирует плитки в квадрате вокруг вашего положения
• Пропускает уже кэшированные плитки и неисследованные куски
• Запускается в фоновом режиме с задержкой 50 мс между плитками, чтобы избежать задержки
• Пример: /easywebmap прегенерирует 50 генерирует до 10 201 плитки
• Нет максимального предела - используйте то, что вам нужно (большие значения потребуют времени)

Случаи общего использования

Публичная серверная карта - Пусть игроки видят, где все исследуют.

Виджет сайта Вставить на домашнюю страницу вашего сервера, чтобы показать живую активность

наложение потока Отображение карты в потоке Twitch/YouTube

Боты Discord - Используйте API для публикации локаций игроков или скриншотов

Инструмент администратора Мониторинг активности игрока на вашем сервере

FAQ

В: Как получить доступ к карте с другого компьютера? Используйте IP-адрес вашего сервера вместо местный житель: http://192.168.1.100:8080

Q: Как я встраиваю его на свой сайт? Используйте iframe: <iframe src="http://your-server:8080" width="800" height="600"></iframe>

Q: может Я скрываю определенные миры? Добавить конкретные имена в включенный Миры в конфигурации. Пустой массив показывает все.

В: Как мне поставить его за обратный прокси? Точка nginx/Apache в порт 8080. Путь WebSocket /ws.

В: Почему некоторые области на карте выглядят пустыми? По умолчанию отображаются только исследованные фрагменты ()делать Исследованные фрагменты: правда). Это предотвращает задержку сервера и злоупотребление пользователями, прокручивающимися в неисследованные области. Установить его ложный Если вы хотите отобразить все фрагменты (не рекомендуется для общедоступных серверов).

В: Могут ли пользователи злоупотреблять картой, чтобы отстать от моего сервера? Не с настройками по умолчанию. The Скачать ExploredChunksOnly Опция (включается по умолчанию) предотвращает визуализацию неисследованных кусков, поэтому прокрутка вокруг не вызовет генерацию кусков.

Q: Как включить HTTPS? Добавить «EnableHttps»: правда и «домен»: «your-domain.com» к вашей конфигурации. Плагин автоматически получает бесплатный сертификат SSL от Let's Encrypt. Смотрите раздел HTTPS выше для получения подробной информации.

В: Почему мой SSL-сертификат не работает? Общие вопросы:

1. Домен не указывает на IP вашего сервера
2. Порт 80 блокируется брандмауэром (для проверки требуется шифрование)
3. Другой сервис использует порт 80 Проверьте журналы сервера на наличие определенных сообщений об ошибках.

В: Нужно ли обновлять сертификат вручную? Нет! Плагин автоматически проверяет каждый день и обновляет сертификаты за 30 дней до истечения срока действия. Вам никогда не нужно прикасаться к нему.

Вопрос: Могу ли я использовать свой собственный SSL-сертификат вместо Let's Encrypt? В настоящее время только автоматические Поддерживаются сертификаты Encrypt. Если вам нужно использовать свой собственный сертификат, поместите EasyWebMap за обратный прокси (nginx / Apache), который обрабатывает SSL.

Q: Что делать, если Let’s Encrypt не работает или ограничен? Плагин будет нормально работать с HTTP. Он повторяет запросы сертификатов и регистрирует любые ошибки. Как только Let's Encrypt снова станет доступен, сертификаты будут получены автоматически.

Строительство из источника

Чистый пакет mvn
cp target/EasyWebMap-1.0.0.jar/path/to/Server/mods/

Требуется Java 25+ и Maven 3.8+.

Лицензия

MIT - делайте с ним все, что хотите!