Skip to content

README.md

Latest commit

 

History

History
100 lines (71 loc) · 5.3 KB

README.md

File metadata and controls

100 lines (71 loc) · 5.3 KB

🧭 AuthCompass

AuthCompass — это плагин для Minecraft (Paper 1.20+), который работает совместно с AuthMe и VelocityConnect.
После успешной авторизации через AuthMe плагин выдаёт игроку компас, который при нажатии подключает его к серверу survival.

⚙️ Зависимости

Для корректной работы необходимы следующие плагины:

🚀 Возможности

  • ✅ Автоматическая выдача компаса после авторизации
  • 🔒 Проверка авторизации через API AuthMe
  • ⏱️ Защита от спама нажатием (2 секунды кулдаун)
  • 🧰 Защита от выбрасывания и перемещения компаса
  • 🌍 Подключение к серверу survival через Velocity
  • 📢 Уведомление игроков о доступности сервера Survival после перезагрузки
  • 🔁 Автоматическое подключение игроков с правом rejoin.reloaded

📦 Установка

  1. Скачайте последний релиз из раздела Releases.
  2. Поместите .jar файл в папку plugins вашего Auth-сервера (Paper).
  3. Убедитесь, что на сервере установлен AuthMe Reloaded.
  4. Убедитесь, что на Velocity-сервере установлен VelocityConnect.
  5. Перезапустите сервер.

🪄 Использование

  1. Игрок заходит на сервер и проходит авторизацию через AuthMe.
  2. После входа ему автоматически выдаётся компас.
  3. При нажатии на компас игрок будет перенаправлен на сервер survival.

После перезагрузки сервера survival:

  • Все игроки на Auth-сервере получают уведомление, что сервер снова доступен.
  • Игроки с правом rejoin.reloaded автоматически подключаются к серверу survival.

💡 Компас нельзя выбросить или переместить — он защищён до момента переключения сервера.

🔔 Отправка уведомления после перезагрузки Survival

Теперь уведомление отправляется без привязки к игроку через TCP-сокет.

Пример простого плагина для survival сервера:

package com.example.survivalnotify;

import org.bukkit.Bukkit;
import org.bukkit.event.Listener;
import org.bukkit.event.server.ServerLoadEvent;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.PrintWriter;
import java.net.Socket;

public class SurvivalNotifyPlugin extends JavaPlugin implements Listener {
    @Override
    public void onEnable() {
        Bukkit.getPluginManager().registerEvents(this, this);
    }

    @org.bukkit.event.EventHandler
    public void onServerLoad(ServerLoadEvent event) {
        Bukkit.getScheduler().runTaskLaterAsynchronously(this, () -> {
            try (Socket socket = new Socket("IP_AUTH_SERVER", 38123);
                 PrintWriter out = new PrintWriter(socket.getOutputStream(), true)) {

                out.println("reloaded");
                getLogger().info("Отправлено уведомление Auth-серверу о запуске Survival.");
            } catch (Exception e) {
                getLogger().warning("Не удалось отправить уведомление Auth-серверу: " + e.getMessage());
            }
        }, 40L);
    }
}

На Auth-сервере:

AuthCompass слушает этот порт и обрабатывает сообщение reloaded:

  • Уведомляет всех онлайн игроков
  • Автоматически переподключает игроков с правом rejoin.reloaded

⚠️ Замечания

  • Плагин работает только при корректно настроенном Velocity с плагином VelocityConnect.
  • Название целевого сервера (survival) можно изменить в коде (в методе sendToServer).
  • Автоподключение выполняется только для игроков с правом rejoin.reloaded.
  • TCP-порт для уведомления (38123 в примере) должен быть открыт и доступен с Survival сервера.

📝 Лицензия

Этот проект распространяется под лицензией MIT. Свободно используйте и модифицируйте плагин при сохранении указания автора.