SimpleTPA - телепорт к игроку и дома в Minecraft

SimpleTPA - датапак для Майнкрафт, который закрывает две самые бытовые нужды любого сервера: "телепортни меня к Васе" и "верни меня домой, я опять заблудился". Ставится на сервер, работает на ванильных командах, ничего не требует от игроков.

Моды не нужны, клиент ничего не устанавливает, права оператора тоже не выдаются. Всё держится на /trigger, а это значит, что команды доступны обычному выживальщику без всяких привилегий.

По вайбу это чистая утилита для спокойного выживания с друзьями. Никакой эстетики хоррора или PvP-заточки, просто удобный сервисный слой, который обычно ставят в первый же вечер, а потом забывают, что он вообще отдельный проект. Зайдёт тем, кто держит небольшой сервер и не хочет городить плагины с зависимостями.

Какую проблему это решает

На ванильном сервере есть два варианта: либо звать друга на помощь голосом, либо раздавать всем /tp и молиться, чтобы кто-нибудь не улетел в лаву с чужим лутом. SimpleTPA убирает оба сценария.

Телепорт происходит только по согласию второй стороны. Дома привязаны к конкретному игроку, чужой /trigger их не тронет. И самое приятное - всё это работает в одиночном мире точно так же, как на сервере, так что соло-игроки получают ту же систему быстрых возвратов без модов.

Что умеет датапак

• Запросы на телепорт (TPA) - кликабельное меню со списком игроков онлайн, имя в чат вбивать не нужно
• Пять слотов входящих запросов - каждый запрос принимается или отклоняется отдельно, кнопками
• Пять личных домов - установка, телепорт и удаление через понятное меню
• Межмировой телепорт - дома работают в Верхнем мире, Незере и Крае
• Разумные значения по умолчанию - 60 секунд на ответ по запросу, 5 секунд отката на дом, 3 секунды между отправками
• Без OP - всё через ванильный /trigger, значит любой игрок пользуется без вмешательства админа

Как это выглядит в игре

Вы набираете /trigger tpa.home и получаете меню со слотами домов. Клик по слоту - телепорт, если дом там уже стоит. Никаких вкладок, конфигов и прочей бюрократии.

С запросами та же логика. /trigger tpa.menu показывает список игроков онлайн, клик по нику - запрос ушёл. У получателя в чате всплывает предложение с кнопками "принять" и "отклонить". До пяти таких висящих запросов одновременно, и разобрать их можно по одному, а не пачкой.

Меню домов в версии 1.1.0 переработали: добавили быстрый телепорт прямо из списка и починили досадный баг, когда запрос на телепорт уходил самому себе. Мелочь, а раньше путала.

Команды

Все команды идут через ванильный /trigger - работают и для игроков без прав оператора.

Команда	Что делает
/trigger tpa.menu	Список игроков онлайн для запроса телепорта
/trigger tpa.requests	Входящие запросы с кнопками принять и отклонить
/trigger tpa.cancel	Отменить свой исходящий запрос
/trigger tpa.home	Меню телепорта по домам
/trigger tpa.homes	Просмотр и управление домами
/trigger tpa.sethome set <1-5>	Поставить дом в слот N
/trigger tpa.delhome set <1-5>	Удалить дом из слота N
/trigger tpa.help	Показать все команды

Самый быстрый способ разобраться - написать /trigger tpa.help и дальше просто щёлкать по кнопкам. Синтаксис вида set <1-5> значит, что после set идёт номер слота от 1 до 5, а не буквальное слово.

Установка

1. Остановите сервер.
2. Скачайте SimpleTPA.zip.
3. Положите архив в папку datapacks вашего мира, например world/datapacks/.
4. Распакуйте архив. Внутри должно получиться world/datapacks/SimpleTPA/pack.mcmeta.
5. Запустите сервер. В чате появится [SimpleTPA] Datapack loaded!.

Проверить, что всё встало, можно командой /datapack list - в списке включённых должен быть [file/SimpleTPA].

Важный нюанс: именно распаковка. Если оставить лежать zip-архив, датапак не подхватится, и вы будете ломать голову, почему /trigger отвечает ошибкой. Вторая частая ошибка - лишняя вложенная папка после распаковки, когда путь получается вида datapacks/SimpleTPA/SimpleTPA/pack.mcmeta. Файл pack.mcmeta должен лежать ровно на один уровень ниже папки с названием датапака.

Ограничения, о которых стоит знать заранее

• Только ванильные измерения. Верхний мир, Незер и Энд. Модифицированные измерения вроде Aether или Twilight Forest домами не поддерживаются, точка там не создастся.
• Пять домов и пять запросов на игрока. Лимит жёсткий, в настройках не меняется.
• До 20 игроков в меню TPA. Если онлайн больше, список просто обрежется, и дальние ники в него не попадут.
• Точность до блока. Вы окажетесь в центре блока, где поставили дом. Точность внутри блока не сохраняется.

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

Советы из практики

Ставьте дома не "где красиво", а "где безопасно". Классическая история: игрок сохраняет точку на краю лавового озера, возвращается через час и оказывается в паре блоков от кипящей лавы. Датапак не проверяет, куда именно вы телепортируетесь.

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

Для одиночных миров это, пожалуй, самый недооценённый сценарий. Моды на дома обычно тянут за собой загрузчик и пару библиотек, а тут достаточно кинуть папку в сохранение. Никаких Fabric или Forge, никаких обновлений зависимостей после каждого патча.

На сервере с модпаком тоже работает. SimpleTPA собран и протестирован на Minecraft 1.20.1 и спокойно живёт в сборках вроде Better Minecraft (BMC4), потому что не трогает ничего, кроме ванильных команд. Если вы играете компанией в BMC4 и вам надоело каждый раз бегать через полкарты к базе друга, это ровно тот случай. Правда, держите в голове пункт про модифицированные измерения: дом в том же Aether поставить не выйдет.

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

Параметр	Значение
Платформа	Minecraft Java Edition
Тип	Датапак, серверная часть
Актуальный релиз	1.1.0
Ветки версий	1.20-1.20.1 и отдельный порт 1.21-1.21.4
Загрузчик	Не требуется
Зависимости	Нет
Лицензия	MIT, свободное использование и изменение

Поддержку 1.21 добавили отдельным портом, функционал там тот же. Так что если сервер уже переехал на свежую версию, ждать переписывания не придётся.

Кому подойдёт

Небольшим ванильным серверам, где админ не хочет ставить плагины и настраивать права. Компаниям на сборках модов, которым нужен телепорт без лишних библиотек. И одиночным игрокам, которые ценят быстрый возврат домой, но не хотят превращать мир в свалку модов.

Если вам нужно больше пяти домов, телепорт в модифицированные измерения или админские /tp с обходом согласия - это не тот инструмент, ищите плагин. А если задача ровно в том, чтобы удобно ходить друг к другу и возвращаться на базу, скачать SimpleTPA и распаковать в datapacks займёт меньше минуты.