- Документация
- https://modrinth.com/plugin/server_waypoint
Назначение проекта
Server Waypoint — проект для управления путевыми точками и их автоматической синхронизации с клиентами игроков. Официально заявлена совместимость с Xaero's Minimap. Выбранные серверные файлы предназначены для Paper и Purpur, а категории проекта — management и utility.
Команды доступны при серверной установке, а графический менеджер требует клиентской части. В перечне есть только серверные JAR; проверенный клиентский файл не приведён.
Скриншоты и внешний вид
Основные возможности
Сервер может автоматически синхронизировать путевые точки. Для них заявлена настраиваемая отрисовка. Игрокам доступны управление через GUI при наличии клиента и команды при одной серверной установке. Также указаны автодополнение, собственные разрешения для /wp и совместимость с LuckPerms.
Подтверждённые сценарии:
• создание, просмотр, редактирование и удаление точек;
• телепортация к точке при наличии разрешения;
• синхронизация с поддерживаемым клиентом;
• графический менеджер на клиентской стороне;
• добавление точки из сообщения Xaero's Minimap в чате;
• разделение доступа средствами разрешений.
Сообщение Xaero можно обработать без клиента Server Waypoint, но это не открывает весь клиентский функционал.
Стороны установки и совместимость
Метаданные указывают client=optional и server=optional, а описание различает серверные команды и клиентский GUI. Клиент нужен для экрана управления и /wp download; серверный JAR не заменяет его.
Подтверждены Minecraft 1.21, 1.21.1–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Платформы — Paper и Purpur. JAR помещается в папку plugins совместимого сервера.
Даны два JAR версии 3.0.3 с обозначениями mc1.21-26.2 и mc1.21-26.1.2. Таблицы соответствия всем промежуточным версиям нет, поэтому файлы нельзя считать взаимозаменяемыми. Другие платформы не подтверждены.
Зависимости и расхождение данных
Выбранные метаданные не содержат обязательных project dependencies и называют LuckPerms опциональной зависимостью. Однако официальный раздел Dependencies отдельно указывает Fabric API как required, а LuckPerms и Xaero's Minimap — как optional.
Это не согласуется с перечнем Paper/Purpur JAR. Возможно, Fabric API относится к иной части проекта, но источник этого не уточняет; объявлять его обязательным Paper-плагином нельзя.
Минимальные версии дополнений не приведены. LuckPerms указан как совместимый инструмент разрешений, а не обязательное условие команд.
Безопасная установка на сервер
Перед установкой остановите сервер и сохраните рабочую копию его файлов. Выберите JAR по версии, сверив имя, размер и хеш.
Порядок действий:
• проверить, что сервер работает на Paper или Purpur;
• сопоставить версию Minecraft с маркировкой JAR;
• поместить один выбранный файл в plugins;
• запустить сервер обычным способом;
• проверить журнал загрузки;
• убедиться, что команды /wp распознаются;
• создать и удалить временную точку.
Не оставляйте одновременно оба JAR. Горячая замена не подтверждена, а клиентский GUI этой процедурой не устанавливается.
Команды и клиентский интерфейс
Официально перечислены /wp add, /wp download, /wp edit, /wp list, /wp reload, /wp remove и /wp tp. Добавление не допускает повторяющееся имя и предлагает редактирование для замены. Список выводит точки и связанные действия. Удалённую точку можно восстановить через показанный элемент, а /wp tp телепортирует выполняющего команду игрока.
/wp download не работает без клиентской установки. /wp reload перечитывает config.json и переводы в /config/server_waypoint/lang, но изменение sendXaerosWorldId требует полного перезапуска.
Клиентский менеджер открывается Right Shift по умолчанию или /wp_gui. В его экране T при наведении на точку запускает телепортацию и требует разрешения /wp tp, а C открывает клиентскую конфигурацию.
Полный список permission nodes не дан, поэтому узлы нельзя выводить только из названий команд.
Проверка результата
Сначала проверяют загрузку и распознавание /wp, затем создают временную точку, редактируют, тестируют телепортацию и удаляют.
Контрольный список:
• загружен один подходящий JAR;
• команды доступны назначенным ролям;
• точка появляется в иерархическом списке;
• редактирование и удаление работают;
• телепортация подчиняется разрешению;
• GUI открывается только при наличии клиента;
• /wp download проверяется с клиентской частью;
• сообщение Xaero тестируется отдельно;
• sendXaerosWorldId проверяется после перезапуска.
Заявлен автоматический перевод сообщений по языку клиента получателя, но охват языков в обрезанном источнике не раскрыт.
Файлы и контроль целостности
Для обозначения mc1.21-26.2 дан server_waypoint-3.0.3-paper-mc1.21-26.2.jar размером 175630 байт. SHA-512: abeebd804283aab074dae2ac8ec0eea8ce3d5ef96cb4db61131d00c5c6bf7e81651f514e52c2e229f0e42476aa2cac50c7013e141f796d776a1a73c23281f789. SHA-1: 9c5321b2d2414d56ab495e3352f5887f309b2dad.
Для mc1.21-26.1.2 дан server_waypoint-3.0.3-paper-mc1.21-26.1.2.jar размером 175228 байт. SHA-512: c12e82fba7a2ac2519a7df80bfab39d5741a30017e422f7f2da324e73a661f9cafe7334a672c45c6bf5b08d9b022095eaa74f2f4bd55ba37427ffdef0e30cb35. SHA-1: 07b7a76b7b7ad973dd878f7309f1f329ee2457d8.
Файлы получены по официальному HTTPS, сверены по хешам и статически проверены. Динамический запуск не выполнялся, поэтому нужен тест на сервере.
Ограничения
Не раскрыты формат хранения, предел числа точек, перенос между мирами, полный список разрешений и миграция данных. Клиентский файл не приведён.
Не подтверждены:
• работа на платформах вне Paper и Purpur;
• совместимость с любой версией Xaero's Minimap;
• перенос данных из сторонних плагинов;
• GUI без клиентской части;
• применение sendXaerosWorldId одним reload;
• отсутствие конфликтов с другими системами телепортации;
• обратная совместимость данных после обновления.
Упоминание Fabric API остаётся неразрешённым расхождением. Его нельзя превращать в серверное требование для предоставленных Paper JAR.
Обновление, откат и диагностика
Перед обновлением остановите сервер, сохраните JAR и созданные проектом файлы. Новый JAR сверьте по версии, размеру и хешу, затем повторите тест функций. Старую копию пока не удаляйте.
Для отката остановите сервер, верните прежний JAR и соответствующую резервную копию. Источник не описывает миграцию формата данных, поэтому обратную совместимость гарантировать нельзя.
Если плагин не загружается, проверьте платформу, версию, выбранный JAR и журнал. Если команды работают, но GUI отсутствует, нужна проверка клиентской части. Неработающий /wp download также следует сопоставить с её наличием. Для T требуется право /wp tp, а изменения sendXaerosWorldId применяются после перезапуска.
Авторство, лицензия и FAQ
Публичный участник проекта указан как 2676959. Лицензия — MIT, идентификатор SPDX — MIT. При распространении и локализации сохраняют имя проекта, авторство и условия лицензии; редакционные выводы не являются заявлениями автора.
Можно ли управлять точками без клиента?
Да. Официальный текст предусматривает команды при серверной установке. GUI и /wp download требуют клиентской части.
Какие серверы подтверждены?
Paper и Purpur на перечисленных версиях Minecraft.
Обязателен ли LuckPerms?
Нет. В выбранных метаданных он указан как optional.
Нужно ли ставить Fabric API на Paper?
Источник противоречив: Fabric API назван required в общем описании, но серверные метаданные не показывают обязательных зависимостей. Обязательным Paper-компонентом статья его не объявляет.
Работает ли интеграция с Xaero без клиента Server Waypoint?
Подтверждено добавление точки из сообщения Xaero о совместном доступе. Остальные клиентские функции этим не подтверждаются.
Как применить sendXaerosWorldId?
После изменения требуется полный перезапуск; одного /wp reload недостаточно.
Как откатить обновление?
Остановить сервер, вернуть сохранённый JAR и совместимую резервную копию, затем проверить загрузку и базовые операции.
