|
1 | 1 | # 🧭 AuthCompass |
2 | 2 |
|
3 | | -**AuthCompass** — это плагин для Minecraft (Paper 1.21.10), который работает совместно с **AuthMe** и **VelocityConnect**. |
| 3 | +**AuthCompass** — это плагин для Minecraft (Paper 1.20+), который работает совместно с **AuthMe** и **VelocityConnect**. |
4 | 4 | После успешной авторизации через AuthMe плагин выдаёт игроку **компас**, который при нажатии подключает его к серверу **survival**. |
5 | 5 |
|
6 | | ---- |
7 | | - |
8 | 6 | ## ⚙️ Зависимости |
9 | 7 |
|
10 | 8 | Для корректной работы необходимы следующие плагины: |
11 | 9 | - [AuthMe Reloaded](https://www.spigotmc.org/resources/authme-reloaded.6269/) |
12 | 10 | - И настроенный [VelocityConnect](https://github.com/flyawaymaking/VelocityConnect) на вашем Velocity-сервере |
13 | 11 |
|
14 | | ---- |
15 | | - |
16 | 12 | ## 🚀 Возможности |
17 | 13 |
|
18 | 14 | - ✅ Автоматическая выдача компаса после авторизации |
19 | 15 | - 🔒 Проверка авторизации через API AuthMe |
20 | 16 | - ⏱️ Защита от спама нажатием (2 секунды кулдаун) |
21 | 17 | - 🧰 Защита от выбрасывания и перемещения компаса |
22 | 18 | - 🌍 Подключение к серверу `survival` через Velocity |
23 | | - |
24 | | ---- |
| 19 | +- 📢 Уведомление игроков о доступности сервера Survival после перезагрузки |
| 20 | +- 🔁 Автоматическое подключение игроков с правом `rejoin.reloaded` |
25 | 21 |
|
26 | 22 | ## 📦 Установка |
27 | 23 |
|
28 | 24 | 1. Скачайте **последний релиз** из раздела [Releases](../../releases). |
29 | | -2. Поместите `.jar` файл в папку `plugins` вашего Paper-сервера. |
30 | | -3. Убедитесь, что на Paper-сервере установлен **AuthMe**. |
| 25 | +2. Поместите `.jar` файл в папку `plugins` вашего **Auth-сервера (Paper)**. |
| 26 | +3. Убедитесь, что на сервере установлен **AuthMe Reloaded**. |
31 | 27 | 4. Убедитесь, что на Velocity-сервере установлен **VelocityConnect**. |
32 | 28 | 5. Перезапустите сервер. |
33 | 29 |
|
34 | | ---- |
35 | | - |
36 | 30 | ## 🪄 Использование |
37 | 31 |
|
38 | 32 | 1. Игрок заходит на сервер и проходит авторизацию через AuthMe. |
39 | 33 | 2. После входа ему автоматически выдаётся компас. |
40 | 34 | 3. При нажатии на компас игрок будет перенаправлен на сервер `survival`. |
41 | 35 |
|
| 36 | +После перезагрузки сервера **survival**: |
| 37 | + |
| 38 | +- Все игроки на Auth-сервере получают уведомление, что сервер снова доступен. |
| 39 | +- Игроки с правом `rejoin.reloaded` автоматически подключаются к серверу `survival`. |
| 40 | + |
42 | 41 | > 💡 Компас нельзя выбросить или переместить — он защищён до момента переключения сервера. |
43 | 42 |
|
44 | | ---- |
| 43 | +## 🔔 Отправка уведомления после перезагрузки Survival |
45 | 44 |
|
46 | | -## ⚠️ Замечания |
| 45 | +Чтобы Auth-сервер узнал, что сервер `survival` снова доступен, можно отправить **PluginMessage** после полной загрузки сервера. |
| 46 | + |
| 47 | +Пример простого плагина для **survival сервера**: |
| 48 | + |
| 49 | +```java |
| 50 | +package com.example.survivalnotify; |
| 51 | + |
| 52 | +import com.google.common.io.ByteArrayDataOutput; |
| 53 | +import com.google.common.io.ByteStreams; |
| 54 | +import org.bukkit.Bukkit; |
| 55 | +import org.bukkit.entity.Player; |
| 56 | +import org.bukkit.event.Listener; |
| 57 | +import org.bukkit.event.server.ServerLoadEvent; |
| 58 | +import org.bukkit.plugin.java.JavaPlugin; |
47 | 59 |
|
48 | | -- Плагин работает только при корректно настроенном **Velocity** с плагином **VelocityConnect**. |
49 | | -- Название целевого сервера (`survival`) можно изменить в коде (в методе `sendToServer`). |
| 60 | +public class SurvivalNotifyPlugin extends JavaPlugin implements Listener { |
| 61 | + |
| 62 | + @Override |
| 63 | + public void onEnable() { |
| 64 | + Bukkit.getPluginManager().registerEvents(this, this); |
| 65 | + getServer().getMessenger().registerOutgoingPluginChannel(this, "authcompass:reload"); |
| 66 | + } |
| 67 | + |
| 68 | + @org.bukkit.event.EventHandler |
| 69 | + public void onServerLoad(ServerLoadEvent event) { |
| 70 | + Bukkit.getScheduler().runTaskLater(this, () -> { |
| 71 | + Player player = Bukkit.getOnlinePlayers().stream().findFirst().orElse(null); |
| 72 | + if (player == null) return; |
| 73 | + |
| 74 | + ByteArrayDataOutput out = ByteStreams.newDataOutput(); |
| 75 | + out.writeUTF("Reloaded"); |
| 76 | + |
| 77 | + player.sendPluginMessage(this, "authcompass:reload", out.toByteArray()); |
| 78 | + }, 40L); |
| 79 | + } |
| 80 | +} |
| 81 | +```` |
| 82 | + |
| 83 | +Этот код: |
| 84 | + |
| 85 | +1. Ждёт полной загрузки сервера (`ServerLoadEvent`) |
| 86 | +2. Через 2 секунды отправляет **PluginMessage** |
| 87 | +3. AuthCompass на auth сервере: |
| 88 | + |
| 89 | + * уведомляет игроков |
| 90 | + * автоматически переподключает игроков с правом `rejoin.reloaded` |
| 91 | + |
| 92 | +## ⚠️ Замечания |
50 | 93 |
|
51 | | ---- |
| 94 | +* Плагин работает только при корректно настроенном **Velocity** с плагином **VelocityConnect**. |
| 95 | +* Название целевого сервера (`survival`) можно изменить в коде (в методе `sendToServer`). |
| 96 | +* Автоподключение выполняется только для игроков с правом `rejoin.reloaded`. |
52 | 97 |
|
53 | 98 | ## 📝 Лицензия |
54 | 99 |
|
55 | | -Этот проект распространяется под лицензией **MIT**. |
| 100 | +Этот проект распространяется под лицензией **MIT**. |
56 | 101 | Свободно используйте и модифицируйте плагин при сохранении указания автора. |
0 commit comments