InventoryWizard

🧙‍♂️ InventoryWizard

Магический помощник для сортировки в вашем мире Minecraft! ✨ InventoryWizard — это мощный плагин для PaperMC, который приносит на ваш сервер умную сортировку инвентаря в один клик. С интуитивным управлением и умной категоризацией управлять предметами ещё никогда не было так просто!

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

✨ Умная сортировка

• Умная категоризация — предметы группируются логически (оружие, инструменты, еда, блоки и т.д.)
• Оптимизация хотбара — оружие и инструменты в приоритете для PvP/выживания
• Объединение стаков — автоматически соединяет неполные стаки
• Настраиваемая сортировка неполных стаков — выберите, сортировать только полные стаки или включать неполные (см. конфиг)
• Сохранение метаданных — сохраняет зачарования, названия и данные предметов

🖱️ Несколько способов управления

• Shift+ПКМ — сортировка инвентаря, сундуков и хотбара
• Двойной клик — альтернативная сортировка хотбара
• Команды — /iwiz для программной сортировки
• Shift+ПКМ по слоту 4 хотбара — переключение режимов сортировки

🎒 Полный охват

• Инвентарь игрока — организуйте основное хранилище
• Хотбар — оптимизирован для быстрого доступа к боевым/выживательным предметам
• Сундуки — держите контейнеры в порядке
• Всё сразу — сортируйте всё одновременно

📥 Установка

1. Скачайте последний InventoryWizard-x.x.x.jar со страницы релизов
2. Поместите JAR-файл в папку plugins вашего сервера
3. Перезапустите сервер
4. Настройте плагин через plugins/InventoryWizard/config.yml (необязательно)

Требования

• Minecraft: 26.1.
• Сервер: PaperMC, Spigot или совместимый форк
• Java: 26 или выше

База данных

• База данных H2: встроенная, внешняя настройка не требуется
• Хранилище: plugins/InventoryWizard/player_preferences.mv.db
• Производительность: оптимизирована для серверов с 1–10 000+ игроков

🎮 Руководство по использованию

Обзор схемы управления

Сортировка инвентаря

• Откройте инвентарь (E)
• Shift+ПКМ по любому слоту в области основного инвентаря (слоты 9-35)
• Смотрите, как творится магия! ✨

Сортировка хотбара

• Способ 1: Shift+ПКМ по любому слоту хотбара (0-8) с разрешением inventorywizard.hotbar
• Способ 2: Двойной клик по любому слоту хотбара
• Способ 3: Используйте команду /iwiz hotbar

Сортировка сундуков

• Откройте любой сундук
• Shift+ПКМ по любому слоту в сундуке
• Весь сундук будет приведён в порядок!

Сортировка всего

• Shift+ПКМ в хотбаре (слоты 0-8) с разрешением inventorywizard.all
• Будут отсортированы и инвентарь, и хотбар!

Переключение режимов сортировки

• Shift+ПКМ по слоту 4 хотбара (средний слот), чтобы переключать режимы сортировки
• Режим по умолчанию: умная категоризация по типу предмета
• Алфавитный режим: сортировка предметов по названию в алфавитном порядке
• Режим по стакам: группировка по типу предмета, затем сортировка по размеру стака (полные стаки первыми)
• Ваш предпочитаемый режим сохраняется и запоминается для будущей сортировки!

🧙‍♂️ Команды

🔐 Разрешения

Группы разрешений

# Пример настройки разрешений
groups:
  default:
    permissions:
      - inventorywizard.use
      - inventorywizard.inventory
      - inventorywizard.hotbar
  
  vip:
    permissions:
      - inventorywizard.*  # Все разрешения

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

Плагин создаёт файл config.yml со следующими опциями:

# Конфигурация InventoryWizard
settings:
  # Воспроизводить магические звуковые эффекты при сортировке
  play-sound: true
  
  # Настройки звука для магии волшебника
  sound:
    type: UI_BUTTON_CLICK
    volume: 0.5
    pitch: 1.2

  # Метод сортировки: "TYPE" для умной категоризации или "ALPHABETICAL"
  sort-method: "TYPE"

# Включение/отключение магических функций
features:
  chest-sorting: true
  inventory-sorting: true
  hotbar-sorting: true
  show-messages: true
  
  # Разрешить сортировку неполных стаков в сундуках (false — сортировать только полные стаки)
  allow-partial-stacks-chest: true
  # Разрешить сортировку неполных стаков в инвентаре игрока (false — сортировать только полные стаки)
  allow-partial-stacks-inventory: true

# Приоритеты сортировки хотбара (оптимизировано для PvP/выживания)
hotbar-priorities:
  weapons: 100        # Мечи, луки, арбалеты — первыми
  tools: 200          # Кирки, топоры, лопаты — вторыми
  food: 300           # Еда — третьей
  building-blocks: 400 # Материалы для быстрой постройки — четвёртыми
  utility-items: 500  # Эндер-жемчужины, вёдра, факелы
  other: 999          # Всё остальное

Поведение сортировки неполных стаков

• allow-partial-stacks-chest и allow-partial-stacks-inventory определяют, включаются ли неполные стаки в сортировку для сундуков и инвентаря игрока соответственно.
• Если true: все предметы, включая неполные стаки, сортируются и по возможности объединяются.
• Если false: сортируются только полные стаки. Оставшиеся неполные стаки остаются несортированными в конце инвентаря или сундука.

📋 Режимы сортировки

Режим по умолчанию (умная категоризация)

Предметы сортируются по логическим категориям:

1. Каменные породы — камень, гранит, булыжник, глубинный сланец и т.д.
2. Земляные породы — земля, песок, гравий, глина, бетон и т.д.
3. Древесина — брёвна, доски, листва, саженцы
4. Руды и металлы — железные блоки, алмазные блоки и т.д.
5. Прочие блоки — оставшиеся строительные материалы
6. Инструменты — кирки, топоры, лопаты, ножницы и т.д.
7. Оружие — мечи, луки, стрелы, трезубцы
8. Броня — шлемы, нагрудники, ботинки, щиты
9. Еда — все съедобные предметы
10. Redstone — компоненты и механизмы Redstone
11. Транспорт — лодки, вагонетки, сёдла
12. Декор — цветы, ковры, баннеры и т.д.
13. Разное — всё остальное

Алфавитный режим

Предметы сортируются по алфавиту по названию материала (A-Z).

Режим по стакам

Предметы сначала группируются по типу, затем сортируются по размеру стака внутри каждого типа. Полные стаки идут перед неполными стаками того же предмета.

Порядок сортировки хотбара (оптимизировано для PvP/выживания)

1. Оружие — боевые предметы для быстрого доступа
2. Инструменты — необходимые инструменты для выживания
3. Еда — восстановление здоровья
4. Строительные блоки — булыжник, земля для быстрой постройки
5. Полезные предметы — эндер-жемчужины, вёдра, факелы
6. Прочие предметы — разное

🔧 Сборка из исходников

# Клонировать репозиторий
git clone https://github.com/VanishingTacos/inventorywizard.git
cd inventorywizard

# Собрать с помощью Maven
mvn clean package

# JAR будет в target/InventoryWizard-1.0.0.jar

Требования для разработки

• Java 26+
• Maven 3.9.12+
• PaperMC API 26.1.2+

🤝 Участие в разработке

Вклад приветствуется! Не стесняйтесь отправлять пул-реквесты, сообщать об ошибках или предлагать функции.

1. Форкните репозиторий
2. Создайте ветку для функции: git checkout -b feature-name
3. Закоммитьте изменения: git commit -am 'Add some feature'
4. Запушьте в ветку: git push origin feature-name
5. Отправьте пул-реквест

📜 Список изменений

Версия 1.2.0

• 🔧 Обновлены зависимости проекта, совместимость с Java 26
• 🔧Добавлена возможность настраивать ограничение частоты для каждого игрока отдельно nickcisne
• 🔧Добавлена возможность сортировать другие контейнеры nickcisne

Версия 1.1.1

• 🛡️ Добавлено ограничение частоты — предотвращает чрезмерную сортировку во избежание лагов сервера и злоупотреблений (настраивается для каждого игрока)
• 🗃️ База данных H2 — улучшена производительность и безопасность хранения данных инвентаря
• 🐛 Исправления ошибок — исправлены редкие проблемы с синхронизацией инвентаря и граничные случаи сортировки
• 📚 Улучшена документация — расширен README и внутриигровая справка по новым функциям

Версия 1.1.0

• ✨ Новый режим сортировки по стакам — группировка предметов по типу, затем сортировка по размеру стака (полные стаки первыми)

  • 🔄 Сохранение отдельных стаков — неполные стаки сохраняют исходный размер без объединения
• 📦 Алфавитная группировка материалов — предметы группируются по алфавиту по названию материала в режиме по стакам
• 🎯 Улучшенная логика сортировки — улучшена сортировка по размеру стака (от большего к меньшему внутри каждого типа материала)
• 🧙‍♂️ Переключение режимов — лёгкое переключение между режимами по умолчанию, алфавитным и по стакам

Версия 1.0.1

• 🔧 Исправлена схема управления — убран средний клик, улучшена логика Shift+ПКМ
• 🎯 Улучшена сортировка хотбара — приоритетная система разрешений для комбинированной сортировки
• 🛠️ Оптимизация кода — устранены дублирующиеся обработчики событий, повышена надёжность
• 📝 Обновлена документация — более понятные инструкции и требования к разрешениям

Версия 1.0.0

• ✨ Первый релиз
• 🧙‍♂️ Умная сортировка инвентаря с категоризацией по типу
• 🎯 Оптимизация хотбара для PvP/выживания
• 📦 Поддержка организации сундуков
• 🖱️ Несколько способов управления (клики и команды)
• 🔊 Звуковая обратная связь и магические сообщения
• ⚙️ Полные параметры конфигурации

📄 Лицензия

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

🙏 Благодарности

• Команде PaperMC за отличное серверное ПО
• Сообществу Minecraft за вдохновение и обратную связь
• Разработчикам плагинов, проложившим путь качественным плагинам Bukkit

☕ Поддержать InventoryWizard

Если вам нравится InventoryWizard и вы хотите поддержать его разработку, можете угостить меня кофе! https://buymeacoffee.com/vanishingtacos