InvSee++

Плагин InvSee++ для Minecraft — просмотр и редактирование инвентарей игроков

InvSee++ — это серверный плагин для платформ CraftBukkit и её форков (Paper, Spigot, Purpur), предназначенный для глубокого анализа инвентарей игроков. Он позволяет администраторам просматривать содержимое инвентаря, сундука Эндера, крафтовых столов и предметов, удерживаемых в руке, даже если игрок находится оффлайн. Плагин поддерживает кастомные макеты инвентарей и предоставляет расширенный API для интеграции с другими проектами.

Возможности и функционал

Основная задача плагина — предоставить администратору полный контроль над инвентарями игроков. С помощью команд можно просматривать и редактировать содержимое инвентаря и сундука Эндера (enderchest) любого игрока. Функционал охватывает не только стандартные слоты, но и предметы в слоте брони (armour) и слоте с курсора (off-hand).

Плагин автоматически подгружает содержимое крафтовых столов: верстака (workbench), наковальни (anvil), каменоруба (stonecutter), точила (grindstone), прялки (loom) и стола чародея (enchanting table). Также учитываются предметы торговцев (merchant). Особенностью является поддержка гибридных серверов, работающих на Forge/Bukkit или Fabric/Bukkit, а также возможность интеграции с плагин PerWorldInventory при включении соответствующей опции в его конфиге.

Команды и управление

Управление плагин осуществляется через консольные команды. Для просмотра инвентаря игрока используется команда /invsee, а для сундука Эндера — /endersee. Обе команды поддерживают параметры для фильтрации данных.

Для перезагрузки конфигурации плагина применяется команда invseeplusplusreload.

Важно отметить, что плагин продолжает работать корректно даже в случае, если целевой игрок находится оффлайн или никогда ранее не заходил на сервер. При повторном входе игрока (relog) инвентарь наблюдателя (spectator) автоматически обновляется.

Доступ и права (Permissions)

Плагин использует систему прав доступа для разграничения функций просмотра и редактирования. Базовые права делятся на две группы: просмотр и редактирование.

Права просмотра:

• invseeplusplus.invsee.view — доступ к команде /invsee. По умолчанию выдано только операторам сервера.
• invseeplusplus.endersee.view — доступ к команде /endersee. По умолчанию выдано только операторам сервера.

Права редактирования:

• invseeplusplus.invsee.edit — возможность изменять содержимое инвентаря целевого игрока. По умолчанию выдано только операторам сервера.
• invseeplusplus.endersee.edit — возможность изменять содержимое сундука Эндера целевого игрока. По умолчанию выдано только операторам сервера.

Существуют также права для исключения (exempt), позволяющие запретить просмотр инвентаря владельцу конкретного права, и права для игнорирования исключений (bypass-exempt).

Для автоматического завершения ввода имен игроков (tab-completion) в командах /invsee и /endersee требуется право invseeplusplus.tabcomplete.

Дополнительные модули (Addons)

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

Модуль InvSee++_Give позволяет выдавать предметы игрокам, даже если они находятся оффлайн. Команды для этого: /invgive (для инвентаря) и /endergive (для сундука Эндера). Синтаксис команд зависит от версии игры: начиная с версии 1.20.5 используется формат с указанием максимального размера стопки предметов (max_stack_size).

Модуль InvSee++_Clear предназначен для удаления предметов из инвентарей и сундуков Эндера игроков. Команды: /invclear и /enderclear. Примеры использования включают удаление конкретных предметов по ID и количеству.

Интеграция и метрики

Плагин собирает анонимные метрики использования, передавая данные в сервисы bStats и FastStats. Это помогает разработчику понимать, как используется плагин, и планировать дальнейшие улучшения. Сбор метрик можно отключить, отредактировав файлы конфигурации config.yml в папке /plugins/bstats или config.properties в папке /plugins/faststats.

Для разработчиков доступна документация API на официальной вики проекта. Плагин распространяется под лицензией LGPL-2.1-only.

Связанные материалы

• WorldGuard — похожий плагин
• Multiverse-Core — похожий плагин
• Multiverse-Inventories — похожий плагин

Автор: Jannyboy11 · Лицензия: LGPL-2.1-only