English • Русский

AdvancedSpyInventory

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

📌 Описание

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	❌ Не поддерживается

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

• PaperMC Документация
• Bukkit API
• SpigotMC (скачивание плагинов)

---

Made with ❤️ by Mukller

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