> For the complete documentation index, see [llms.txt](https://codingguru1968.gitbook.io/inventorystacks-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codingguru1968.gitbook.io/inventorystacks-wiki/getting-started.md).

# ✨ Getting Started

### ✅ Requirements

* Java Version: The plugin requires the Java version matching your Minecraft server's specific version.
* Server Software: Runs on Spigot, Paper, Purpur, or Folia.
* Bedrock Support: Native compatibility with Geyser + Floodgate.

### 💾 Installation Steps

1. Download: Grab the latest `InventoryStacks.jar` file.
2. Upload: Place the `InventoryStacks.jar` file into your server's `/plugins/` folder.
3. Start/Restart: Start your server to generate the default configuration files.
4. Configure: Navigate to `/plugins/InventoryStacks/config.yml` to adjust your settings (see the [Configuration](/inventorystacks-wiki/configuration.md) page for a full breakdown).
5. Apply: Run the command `/stacks reload` in your game console or in-game (if you have the correct permissions) to apply changes without a full server restart.

### ⚠️ Important Version Notes

**For 1.20.5 and Newer**

If you are running a modern version of Minecraft, the plugin utilizes advanced ItemMeta handling by default.

* `use-legacy-reflection`:
  * Disabled (Recommended): Uses native ItemMeta handling. This is the most stable method, though it requires more CPU overhead than the legacy approach.
  * Enabled: Forces legacy reflection-based stack handling. This is primarily a fallback for compatibility.
  * *Note:* While this helps the server process larger stacks, container GUIs (chests, hoppers, etc.) may still experience visual display inconsistencies. The Minecraft client sometimes struggles to render stack counts above the vanilla limit (e.g., it may cap the visual number at 64, even if 99 are present). 
  * [Click here to learn more about why these visual glitches occur in the client.](https://www.spigotmc.org/threads/using-reflection-to-change-stack-size.657204/)
* `auto-stack-cleanup`: Enabled by default; this resets items not listed in your config to vanilla limits to ensure server stability.

**For Versions 1.8 – 1.20.3**

There is a known visual glitch regarding container inventory slots when items exceed the default vanilla stack limit. While the items themselves are held correctly in the player's inventory, you may notice display inconsistencies when viewing them inside chests or hoppers.

[Read this technical explanation](https://www.spigotmc.org/threads/using-reflection-to-change-stack-size.657204/) regarding how reflection interacts with client-side stack rendering.

*For the best experience on these older versions, test your custom stack sizes in common containers before going live. Larger values may work correctly server-side but still render incorrectly for players.*

> 💡 Need help? If you are running into compatibility issues with other plugins or specific Minecraft versions, please check our [Troubleshooting](/inventorystacks-wiki/troubleshooting-and-faq.md) section or reach out on our [Discord](https://discord.gg/Rqmngywv57).