Itemstacking

ItemStacking

ItemStacking — лёгкий и высокопроизводительный плагин оптимизации для серверов Minecraft на Paper, созданный для устранения лагов от сущностей-предметов без ущерба для ванильного ощущения игры. На выживательных серверах такие занятия, как добыча гор, рубка деревьев или работа на больших фермах культур, роняют на землю тысячи предметов. Стандартное время исчезновения предметов в Minecraft — 5 минут, и всё это время они висят в загруженных чанках, вызывая серьёзные лаги отрисовки на клиенте и задержки тиков сервера. ItemStacking решает эту проблему, объединяя одинаковые предметы на земле в одну сущность — даже сверх ванильного лимита стака в 64!

🚀 Ключевые возможности

• Бесконечное стакание на земле: складывайте блоки и предметы на земле в стаки по 100, 1 000 или больше.
• Настраиваемые материалы: вы сами выбираете, какие именно предметы должны стакаться (например, булыжник, камень, земля, незерак), так что редкие/кастомные предметы остаются нетронутыми.

• Многоуровневый движок объединения:

  • Объединение при появлении: предметы сливаются мгновенно в момент выпадения.
  • Перехват стандартного объединения: бесшовно работает со встроенным объединением стаков в Bukkit.
  • Периодическое сканирование воды и потоков: высокооптимизированное фоновое сканирование объединяет предметы, сносимые вместе водными потоками.

• Умная оптимизация производительности:

  • Фактическое количество предметов надёжно хранится в метаданных сущности (PDC). Физический размер предмета на земле никогда не превышает 64, что предотвращает графические баги на стороне клиента.
  • Использует нативное пространственное индексирование Mojang (октодерево) для поиска ближайших предметов вместо тяжёлых циклических вычислений.

• Ванильно-безопасная логика подбора:

  • Когда игрок проходит над стакнутым предметом, тот наполняет его инвентарь стандартными, ванильно-безопасными стаками по 64.
  • Если в инвентаре игрока есть место только для 30 предметов, он подберёт ровно 30, а оставшийся стак останется на земле.
• Поддержка воронок и вагонеток с воронкой: воронки вытягивают предметы из стака по одному, сохраняя скорость сортировки воронок и предметные конвейеры.
• Визуальные таблички с названием: над стакнутыми предметами отображается аккуратная плавающая текстовая метка (например, Cobblestone (x350)). Можно настроить метку так, чтобы она показывалась только при размере стака больше 64, — так мир остаётся чистым и ванильным для небольших выпадений.

🛠️ Команды и права

• /itemstacking reload (псевдоним: /istack reload)
• Описание: перезагружает конфигурацию плагина на лету.
• • Право: itemstacking.admin (по умолчанию: OP сервера)

⚙️ Конфигурация (config.yml)

Файл конфигурации по умолчанию чистый и полностью документирован:

# Configuration for ItemStacking plugin
# Enable or disable the plugin
enabled: true
# The radius in blocks to search for matching items to stack
merge-radius: 3.0
# The frequency in ticks to scan for items on the ground (20 ticks = 1 second)
# Set to 0 to disable periodic scanning and only stack on spawn.
scan-interval: 40
# Minimum count of items in a stack before the custom name tag is displayed.
# Set to 65 to only show the tag when the item exceeds the vanilla stack size (64).
# Set to -1 to never show the name tag.
min-count-for-name: 65
# Format for the custom name tag displayed above stacked items
# Use %material% for the item name, %count% for the quantity.
display-name-format: "&7%material% &e(x%count%)"
# List of materials that are allowed to stack beyond 64.
stackable-items:
  - COBBLESTONE
  - STONE
  - DIRT
  - GRASS_BLOCK
  - SAND
  - GRAVEL
  - NETHERRACK
  - OAK_LOG
  - DEEPSLATE
  - COBBLED_DEEPSLATE
  - ANDESITE
  - DIORITE
  - GRANITE
  - COAL
  - RAW_IRON
  - RAW_GOLD
  - RAW_COPPER
  - REDSTONE
  - LAPIS_LAZULI
  - WHEAT
  - POTATO
  - CARROT