Плагин Утилита ServerScope [ServerScope-1.0.0]

ServerScope — мониторинг и диагностика Minecraft-сервера

---

📊 О плагине​

ServerScope — это современный плагин мониторинга и observability с WEB-панелью для серверов Minecraft на Paper / Folia 1.21+.

Он даёт администраторам полный контроль над состоянием сервера: производительность, лаги, нагрузка, подозрительные события — всё в одном месте.

💡 Подходит для:

• SMP серверов
• ваниль+ серверов
• крупных проектов с нагрузкой

---

⚡ Зачем он нужен​

С помощью ServerScope ты можешь быстро понять:

• ❓ Почему сервер лагает прямо сейчас
• 🌍 Какие чанки создают нагрузку
• 🐄 Не растёт ли количество сущностей
• ⚠️ Это реальная проблема или просто warning
• 🔌 Какие плагины ведут себя подозрительно

---

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

• 📈 Живые метрики
  • TPS, MSPT, сущности, чанки
• 🌍 Диагностика миров и чанков
• 🔍 Profiling событий и плагинов
• 🚨 Система alert-ов
• 🌐 Встроенная web-панель
• 🔗 JSON API
• 🎮 Игровые команды администратора
• 💾 Хранение данных (SQLite)

---

📦 Требования​

• Java 21+
• Paper / Folia 1.21+

---

📥 Установка​

1. Скачай .jar файл
2. Перемести его в папку plugins/
3. Запусти сервер
4. Дождись генерации конфигов

📁 Конфиг:
plugins/ServerScope/config.yml

---

⚙️ Что включено сразу​

После первого запуска уже активны:

• storage
• collectors
• alerts
• profiling
• web-панель

🔒 Web-панель по умолчанию:

• доступ только локально (127.0.0.1)
• порт 8080
• токен генерируется автоматически

---

🌐 Как открыть web-панель​

Если ты на той же машине:
Дальше:

1. Открой config.yml
2. Найди web.auth-token
3. Вставь его в панель

WebPanel:

---

🌍 Как открыть доступ извне (хостинг)​

Если сервер на хостинге:

1. Узнай, можно ли открыть порт
2. Укажи в конфиге:
3. Код:

   web:
     host: 0.0.0.0
     port: 25656
4. Перезапусти сервер
5. Открой:

http://IP:PORT/

📌 Важно:

• токен обязателен
• порт должен быть разрешён хостингом

---

🔐 Безопасность (ВАЖНО)​

• ❌ Не публикуй токен
• ❌ Не открывай панель без защиты
• ✅ Лучше использовать reverse p####i (Nginx / Caddy) + HTTPS

---

🧠 Profiling​

Позволяет отслеживать:

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

📌 По умолчанию:

• player_interact
• block_break / place
• entity_damage
• inventory_click
• creature_spawn

---

🚨 Alerts​

Система уведомлений:

• 🔴 CRITICAL — приходит в игру
• 🟡 WARN — остаётся в UI / консоли

Примеры:

• низкий TPS
• высокий MSPT
• перегруз чанков
• много сущностей

---

💾 Storage​

• SQLite база
• асинхронная запись
• минимальная нагрузка

📁 Файл:
plugins/ServerScope/serverscope-mvp.db

---

🎮 Команды​

/serverscope
/serverscope status
/serverscope reload
/serverscope report
/serverscope findings
/serverscope alerts
/serverscope web regenerate-token

---

🔑 Права​

• serverscope.admin
• serverscope.command.*
• serverscope.alerts

📌 По умолчанию: доступны OP

---

⚠️ Частые проблемы​

❌ Панель есть, но нет данных​

→ неверный токен

❌ 401 Unauthorized​

→ токен отсутствует

❌ 429 Too Many Requests​

→ слишком частые запросы

❌ Панель не открывается​

→ проверь:

• порт
• host
• firewall
• хостинг

---

🔄 Смена токена​

/serverscope web regenerate-token

---

💡 Итог​

ServerScope — это фактически "Grafana для Minecraft", но прямо внутри сервера.

Если ты хочешь:

• быстрее находить лаги
• понимать поведение сервера
• контролировать нагрузку

→ этот плагин must-have.