TPort

TPort — визуальный плагин телепортации для сервера

TPort — это серверный плагин для платформ Bukkit, Paper и Spigot, предоставляющий расширенные возможности телепортации с акцентом на визуальную составляющую. Основная функция — менеджер локаций, позволяющий игрокам сохранять до 24 точек (TPort) с уникальными иконками и описаниями. Плагин включает систему приватных точек с шестью режимами доступа, от полностью открытых до требующих согласия владельца при его онлайне. Для управления используются как команды, так и инвентарные окна с кастомизируемыми темами и иконками.

Менеджер локаций и настройка точек

Основой плагина является менеджер локаций, где сохранённая точка называется TPort (от t*ele*port). Каждая точка имеет отображаемую иконку (предмет), которую владелец может установить для визуального обозначения типа локации. Кроме иконки, точка может иметь описание или тег для пояснения её назначения. По умолчанию игрок может сохранить до 24 точек; это ограничение можно изменить с помощью разрешения TPort.add.[X], где X — новое максимальное количество.

Для защиты от несанкционированного доступа к точкам реализована система приватности. Существует шесть состояний приватности:

• open: Все игроки могут телепортироваться в эту точку. Доступно для публичных точек (PublicTP).
• private: Телепортация возможна только для игроков из списка whitelists.
• online: При онлайне владельца точка открыта для всех, при оффлайне — закрыта (состояние private). Доступно для PublicTP.
• private online: При онлайне владельца точка закрыта (состояние private), при оффлайне — недоступна для всех. Доступно для PublicTP.
• consent private: При онлайне владельца все игроки должны получить согласие владельца для телепортации. При оффлайне точка закрыта.
• consent close: При онлайне владельца игроки из whitelists должны получить согласие, остальные не могут телепортироваться. При оффлайне точка закрыта.

Также поддерживаются списки разрешённых игроков (whitelist), настройка радиуса действия точки (доступна только при нахождении владельца в пределах этого радиуса) и ведение лога перемещений игроков.

!Приватное состояние: open
!Приватное состояние: private
!Приватное состояние: online
!Приватное состояние: private online
!Приватное состояние: consent private
!Приватное состояние: consent close
!Список разрешённых игроков

Дополнительные функции телепортации

Плагин предлагает широкий спектр дополнительных функций для управления перемещениями. Ключевые возможности включают:

• PLTP (Player Teleportation): Безопасный телепорт к другим игрокам с настройкой прав доступа.
• BiomeTP: Телепортация к заданному биому или его пресету. Поддерживает встроенные списки тегов Minecraft и имеет системы безопасности, предотвращающие падение в бездну в Эндере или в лаву в Незере.
• FeatureTP: Телепортация к конкретной генерационной особенности или списку особенностей.
• WorldTP: Телепортация к спавну в заданном мире.
• Back teleportation: Сохранение предыдущей локации, работающее с точкой смерти, а также с функциями BiomeTP, FeatureTP и PLTP.
• Preview: Возможность предпросмотра точки телепортации или позиции другого игрока перед перемещением.
• Teleporters: Создание предметов-телепортов, которые активируются правым кликом (работают даже в рамках предметных ячеек).
• Home: Установка точки TPort в качестве дома для быстрого возврата.
• Public TPorts: Список точек, полезных для всего сервера.
• Horse, boat and leash friendly: Телепортация сохраняет состояние, если игрок едет на лошади, управляет лодкой или тащит сущность на поводке.

!Телепортация к биому
!Телепортация к особенностям
!Телепортация к спавну мира
!Возврат к предыдущей локации
!Установка дома

Визуализация и пользовательский интерфейс

TPort делает акцент на визуализации. Большинство функций доступны как через команды, так и через окна инвентаря, заполненные кнопками. Интерфейс можно кастомизировать:

• Цветовая тема: Можно создать собственную цветовую схему или использовать предустановленные. Плагин автоматически адаптирует интерфейс под выбранные цвета.
• Кастомные иконки: Для каждой кнопки в окнах доступны уникальные иконки. Их можно включить командой /tport resourcePack state. В комплекте более 400 иконок (разрешения x16 и x32, тёмная и светлая темы) для удобного визуального поиска функций.
• Переводы: Плагин полностью переводимый, даже если на сервере не установлен ресурс-пак с нужным языком. Файлы переводов имеют структуру, идентичную ресурс-паку Minecraft, что позволяет использовать их как ресурс-пак.

!Цветовая тема
!Кастомные иконки
!Переводы

Интеграция с картами и история перемещений

Для наглядности на сервере можно настроить отображение точек телепортации на картах мира. Поддерживаются интеграции с:

• Dynmap: При загрузке плагина на сервере точки отображаются на карте (настройки кастомизируются для каждой точки).
• BlueMap: Аналогичная поддержка отображения точек на карте.

Также реализована функция History, которая отслеживает все перемещения игроков. Игроки могут просматривать историю и сортировать её с помощью фильтров. Функция способна определить, что телепортацию инициировал именно плагин TPort, а не другая система.

!Ведение лога перемещений
!История перемещений

Безопасность и ограничения

Плагин предоставляет инструменты для обеспечения безопасности телепортации и снижения нагрузки на сервер:

• Safety check: Проверка безопасности локации перед телепортацией. Если локация опасна, телепортация не произойдёт.
• Log: Ведение журнала перемещений игроков в точки, отмеченные как логированные.
• Cooldown: Установка задержки между телепортациями, чтобы предотвратить спам командами.
• Delay/Restriction: Настройка задержки, во время которой игрок не может мгновенно телепортироваться. Это полезно для PvP-серверов, чтобы предотвратить использование макросов. Во время задержки можно применить ограничения:
• WalkRestriction: Игрок не может ходить. Если попытается — телепортация отменится.
• InteractRestriction: Игрок не может взаимодействовать с миром. Если попытается — телепортация отменится.

!Проверка безопасности
!Журнал перемещений
!Задержка и ограничения

Уведомления и команды

Владелец точки может настроить уведомления о перемещениях в неё. Доступны три режима:

• none: Уведомления отключены.
• log: Уведомление пишется в лог.
• online: Игрок получает уведомление в чат.

Для получения помощи по плагину используется команда /tport help. Ввод /tport help TPort покажет все команды, начинающиеся с указанной префиксной части, с описанием их использования. В плагине доступно более 200 команд, каждая из которых имеет встроенную справку.

!Режимы уведомлений
!Режим уведомления в лог
!Онлайн уведомление

Совместимость и версии

Плагин разработан для серверных платформ Bukkit, Paper и Spigot. Поддерживается широкий спектр версий игры, начиная с 1.18.2 и заканчивая 1.21.11. Версионирование плагина следует циклам релизов Minecraft: TPort 1.X предназначен для Minecraft 1.X. С версии TPort 1.20.0 поддерживаются и более старые версии (до Minecraft 1.18). Рекомендуется использовать последнюю поддерживаемую версию плагина для текущей версии игры.

Плагин не работает в оффлайн-режиме. Для получения информации о версиях и совместимости следует обращаться к списку поддерживаемых сборок (комбинаций загрузчика и версии игры), доступному в метаданных проекта.

Автор: Uluruho · Лицензия: MIT