FanTPA

FanTPA

Мощный мод телепортации для Minecraft Fabric, предоставляющий функции TPA, дома, возврата и другие возможности телепортации с расширенным функционалом.

中文版本 | English)

Возможности

Основные возможности

• Асинхронная загрузка чанков — продвинутая система асинхронной загрузки чанков обеспечивает плавную телепортацию без лагов сервера
• Поддержка пользовательских языков — полная поддержка пользовательских переводов с более чем 17 встроенными языками
• Высокая совместимость с версиями — поддерживает Minecraft 26.1+

Система телепортации TPA

Система домов

Функция возврата

Административные команды

Расширенные возможности

Асинхронная загрузка чанков

FanTPA реализует продвинутый механизм асинхронной загрузки чанков, который:

• Загружает чанки назначения в фоне, не блокируя основной поток
• Обеспечивает плавную телепортацию даже в отдалённые места
• Предотвращает лаги сервера во время телепортации

Поддержка пользовательских языков

• Более 17 встроенных языков с полным покрытием перевода
• Простая в использовании система настройки языков
• Поддержка добавления пользовательских языковых пакетов

Высокая совместимость с версиями

• Требование к версии сервера: >= 26.1
• Регулярные обновления для поддержки последних версий Minecraft

Установка

Установка на сервер

1. Убедитесь, что на вашем сервере установлены Fabric Loader и Fabric API
2. Поместите FanTPA-x.x.x.jar в папку mods сервера
3. Запустите сервер, мод автоматически создаст файлы конфигурации

Установка на клиент (необязательно)

• Если вы хотите использовать мод в одиночной игре, также установите Fabric Loader и Fabric API
• Поместите мод в папку mods клиента

Файл конфигурации

Мод автоматически создаст файл конфигурации по пути config/fantpa/fantpa.conf при первом запуске.

Структура конфигурации

fantpa {
    teleport { 
        timeout = 30    # Тайм-аут запроса TPA в секундах
        cooldown = 5    # Перезарядка телепортации в секундах
        delay = 3       # Задержка телепортации в секундах
    }
    language { 
        default-language = "en_us"  # Язык по умолчанию
    }
    commands {
        tpa { enabled = true }      # Включить команду /tpa
        tpahere { enabled = true }  # Включить команду /tpahere
        back { enabled = true }     # Включить команду /back
        home { enabled = true }     # Включить команду /home
        sethome { enabled = true }  # Включить команду /sethome
        delhome { enabled = true }  # Включить команду /delhome
    }
}

Параметры конфигурации

Как изменить конфигурацию

1. Остановите сервер
2. Отредактируйте файл config/fantpa/fantpa.conf
3. Сохраните и перезапустите сервер

Сборка из исходного кода

Требования

• Java 25 или выше
• Git

Шаги сборки

1. Клонируйте репозиторий

git clone https://github.com/yourusername/FanTPA.git
cd FanTPA

2. Соберите мод

# Windows
gradlew.bat build

# Linux/macOS
./gradlew build

3. Получите результат Собранный jar-файл будет находиться по пути build/libs/FanTPA-1.0.0.jar

Команды для разработки

Поддерживаемые языки

Система событий

Мод предоставляет богатый набор событий для прослушивания другими модами:

• TpaRequestEvent — вызывается при отправке запроса TPA
• TpaHereRequestEvent — вызывается при отправке запроса TPAHere
• TpaAcceptEvent — вызывается при принятии запроса на телепортацию
• TpaDenyEvent — вызывается при отклонении запроса на телепортацию
• HomeSetEvent — вызывается при установке дома
• HomeTeleportEvent — вызывается при телепортации к дому
• BackEvent — вызывается при использовании /back
• TeleportEvent — вызывается при телепортации

Техническая информация

• ID мода: fantpa
• Версия: 1.0.0
• Версия Minecraft: 1.20.1+
• Требование к версии сервера: >= 26.1
• Зависимость: Fabric API

Лицензия

MIT License

Участие в разработке

Вклад приветствуется! Смело создавайте issues и pull requests.