Skip to content

README.md

Latest commit

 

History

History
227 lines (155 loc) · 8.73 KB

README.md

File metadata and controls

227 lines (155 loc) · 8.73 KB
Raw

English • Русский

AdvancedSpyInventory

🔍 Продвинутый плагин для просмотра инвентаря игроков на сервере PaperMC

Java PaperMC License

📌 Описание

AdvancedSpyInventory — это плагин для PaperMC, позволяющий администраторам и модераторам сервера удобно просматривать содержимое инвентаря, эндерчеста и других хранилищ любого игрока в реальном времени. Идеален для проверки честности игроков и борьбы с читерством.

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

  • ✅ Просмотр инвентаря игроков в реальном времени
  • ✅ Просмотр эндерчеста (если поддерживается)
  • ✅ Защита от модификаций во время просмотра
  • ✅ Удобный интерфейс с поддержкой навигации
  • ✅ Логирование действий администраторов
  • ✅ Полная локализация на русский язык
  • ✅ Конфигурируемость под твой сервер

🚀 Быстрый старт

Требования

  • Java: 11 или выше
  • PaperMC: Latest версия рекомендуется
  • Права администратора на сервере

Установка

  1. Скачай последнюю версию плагина (.jar файл)
  2. Положи файл в папку plugins/ твоего сервера
  3. Перезагрузи сервер командой /reload или перезапусти его
  4. Плагин готов к работе!
# Если нужна перезагрузка конфигурации
/reload

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

Основная команда

/spy <ник игрока>

Пример:

/spy PlayerName

Кто может использовать?

По умолчанию необходимо одно из следующих прав:

  • Оператор сервера (/op)
  • Роль с разрешением advancedspyinventory.spy или advancedspyinventory.admin

Команды

Команда Описание Разрешение
/spy <ник> Открыть инвентарь игрока advancedspyinventory.spy
/spy reload Перезагрузить конфиг плагина advancedspyinventory.admin
/spy help Справка по командам advancedspyinventory.spy

⚙️ Конфигурация

После первого запуска плагина в папке plugins/AdvancedSpyInventory/ будет создан файл config.yml.

Пример config.yml

# Основные настройки
settings:
  # Показывать уведомления при просмотре инвентаря
  notify-player: true
  
  # Логировать действия в консоль
  logging-enabled: true
  
  # Префикс сообщений плагина
  prefix: "&8[&3SpyInventory&8]"

# Сообщения (кастомизация)
messages:
  player-offline: "&cИгрок не найден или оффлайн"
  no-permission: "&cУ вас нет доступа к этой команде"
  success: "&aИнвентарь загружен"

Отредактируй файл под свои нужды и используй /spy reload для применения изменений.

🔐 Разрешения (Permissions)

advancedspyinventory.spy          # Базовое разрешение на просмотр инвентаря
advancedspyinventory.admin        # Полный доступ + команды администратора
advancedspyinventory.notify       # Получать уведомления о просмотре
advancedspyinventory.reload       # Перезагружать конфигурацию

Пример с Permission плагином (LuckPerms)

/lp user <username> permission set advancedspyinventory.spy true
/lp user <username> permission set advancedspyinventory.notify true

🐛 Частые проблемы

Плагин не работает после установки

  1. Убедись, что версия Java не ниже 11
  2. Проверь консоль сервера на ошибки: /say test
  3. Попробуй перезагрузить сервер полностью (не просто /reload)

Команда /spy не работает

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

Ошибка при открытии инвентаря

Это может быть вызвано:

  • Конфликтом с другим плагином
  • Некорректным config.yml (проверь синтаксис YAML)
  • Устаревшей версией PaperMC

Решение: Удали config.yml, перезагрузи плагин, он создаст новый конфиг по умолчанию.

📊 Версионирование

Проект использует Semantic Versioning:

  • MAJOR — несовместимые изменения API
  • MINOR — новые функции, совместимые с предыдущими версиями
  • PATCH — исправления ошибок

Текущая версия: 2.4.13

🤝 Вклад в проект

Мы приветствуем любые улучшения! Если хочешь помочь:

  1. Форк репозитория
  2. Создай ветку для твоей функции (git checkout -b feature/AmazingFeature)
  3. Закоммитай изменения (git commit -m 'Add some AmazingFeature')
  4. Запуши ветку (git push origin feature/AmazingFeature)
  5. Открой Pull Request

Рекомендации

  • Следуй существующему стилю кода
  • Добавляй комментарии к сложным логикам
  • Обновляй документацию при необходимости
  • Убедись, что плагин скомпилировался без ошибок

📝 Лицензия

Проект распространяется под лицензией MIT. Подробнее см. файл LICENSE.

Ключевые моменты:

  • ✅ Можешь использовать в коммерческих целях
  • ✅ Можешь модифицировать
  • ✅ Можешь распространять
  • ❌ Обязателен указание авторства и лицензии

👤 Автор

Mukller
GitHub: @Mukller

📮 Поддержка

Если у тебя возникли вопросы или ты нашел баг:

  1. Проверь Issues — может быть уже есть решение
  2. Создай новую Issue с подробным описанием
  3. Укажи версию плагина и PaperMC

При создании Issue укажи:

Версия плагина: 2.4.13
Версия PaperMC: X.X.X
Java версия: 11/17/21
Описание проблемы: ...

🎮 Совместимость

Версия Статус
1.20+ ✅ Полная поддержка
1.19 ✅ Поддерживается
1.18 ⚠️ Возможны проблемы
< 1.18 ❌ Не поддерживается

📚 Дополнительные ресурсы

Made with ❤️ by Mukller

⭐ Если проект помог, поставь звезду!