ItemStacker | Efficient Item Stacking

YouTube 视频：只有点击观看时才会加载。

1. Overview

ItemStacker is an ultra-high performance Minecraft item stacking plugin designed for modern survival, skyblock, and farm-heavy servers. Large mob farms and automatic crop harvesting systems frequently drop hundreds of thousands of loose item entities on the floor, resulting in severe tick lag, entity processing bottlenecks, and memory bloat.

ItemStacker solves this problem by merging nearby ground items into a single representative item entity. Rather than creating heavy server-side armor stand holograms or modifying persistent entity display names, ItemStacker renders stack counts and real-time despawn timers exclusively through client-side packets using PacketEvents. The server tracks large numbers cleanly as hidden 64-bit integers while preserving vanilla item mechanics, hoppers, and player inventory distribution.

2. Key Features

• Pure Packet-Based Displays: Stack labels and amounts are rendered entirely via client metadata packets. Zero physical holograms, zero invisible armor stands, and zero server-side custom name corruption.
• Despawn Countdown Timer: Real-time display of the remaining time until a pile despawns using the {time} or {timer} placeholder (similar to RoseStacker).
• Fork-Native Despawn Detection: Automatically reads and respects the item despawn rate defined in your server's fork configuration (such as spigot.yml or Paper world configurations), rather than forcing a rigid hardcoded timer.
• MiniMessage & HEX Color Support: Full support for rich Adventure MiniMessage formatting (<gradient:#00d2ff:#3a7bd5>, <#00ffc8>, <green>) and legacy HEX codes (&#00d2ff). Rich colors automatically downsample cleanly on legacy client versions.
• Toggleable Displayname Timer: Controlled directly in config.yml via despawn_timer_active with customizable formatting (e.g. {mm}:{ss} or {m}m {s}s).
• Extreme Scalability: Supports pile quantities up to millions of items per stack without entity overflow or client crashes.
• Smart Item Merging: Only merges items that share identical attributes (Material, durability, custom display names, lore, enchantments, and persistent data tags). Custom RPG items and enchanted gear are never accidentally merged with vanilla items.
• Intelligent Inventory Filling: Picking up a pile tops up existing partial stacks in the player's inventory first, then fills open slots up to capacity, leaving any remainder safely on the floor.
• Optimized Hopper Transfers: Hoppers collect items with rate-limited transfer ticks, preventing hopper lag storms across dense mob grinders.
• Native Folia & Paper Compatibility: Built from the ground up to respect Folia threaded regions, entity schedulers, and asynchronous packet events.

3. Platform Compatibility

4. Requirements & Dependencies

5. Installation Guide

1. Download the latest ItemStacker-1.1.0.jar.
2. Place the jar file into your server's plugins/ directory.
3. Start or restart your Minecraft server to generate default configurations.
4. Customize your desired stacking distance, format, and timer settings in plugins/ItemStacker/config.yml.
5. Type /itemstacker reload in console or in-game to apply configuration changes instantly.

6. Commands & Permissions

7. Configuration Reference (config.yml)

Below is an excerpt of the core options available in config.yml:

Config:
    # Prefix shown in console messages.
    tag: "&6[ItemStacker]"

    # Name format. Supports MiniMessage (<gradient:#00d2ff:#3a7bd5>, <#00ffc8>),
    # HEX colors (&#00d2ff), and legacy color codes (&b).
    # Placeholders: {displayname}, {amount}, {short}, {time}, {timer}, {despawn}
    displayname_format: "&b{displayname} &a{amount}x"

    # Display remaining despawn time above stacked items.
    despawn_timer_active: false

    # Despawn time format: {mm} (minutes), {ss} (seconds), {total_seconds}.
    despawn_time_format: "{mm}:{ss}"

    # Suffix appended when despawn_timer_active is true and {time} is omitted.
    despawn_timer_suffix: " &7({time})"

    # Visibility controls
    displayname_active: true
    displayname_always: true
    displayname_min_amount: 2
    view_range: 32
    visual_interval: 5

    # Merge behavior
    stack_distance: 8
    delayCheckItems: 3000
    merge_on_spawn: true
    stack_size: 100000
    playsound: true

8. Frequently Asked Questions (FAQ)