StackMore - Super Stackable Blocks Plugin

---

Overview

StackMore is a Paper plugin that allows players to compress more than 64 blocks into a special oversized stackable item, breaking the vanilla stack limit while preserving visual identity and placement logic.
It supports quantity control, anti-split protection, and compatibility with land protection plugins — ideal for survival and building servers.

Features

• Super Stacking: Convert normal blocks into special stacks storing up to 64 × max_stack_multiplier blocks.
• Smart Placement: Placing blocks decrements the internal count; when it reaches 64 or less, the item automatically reverts to a normal stack.
• Flexible Unstacking: Partially or fully unstack items; excess items that don't fit in the inventory are dropped on the ground.
• Admin Mode: Players with stackmore.admin can set any amount directly via /stack or /stackto without consuming inventory items.
• Secure: All shulker boxes are forcibly disabled; container blocks (chests, furnaces, etc.) have NBT cleared when stacked to prevent item duplication.
• HUD Display: ActionBar shows item name and current amount (can be toggled).
• Multi-language: 7 built-in languages (Chinese, English, German, Russian, Spanish, French, Japanese), switchable in-game or via config.
• Third-party Item Protection: Items tagged by other plugins (e.g. Infinite-Blocks) are automatically rejected to prevent accidental destruction.

Commands

Command	Aliases	Arguments	Description	Permission
/stack	sm, stk	[amount | all]	Convert held normal block to a special stack and absorb the same type from inventory; all stacks to the maximum limit. Admins set directly to the limit without consuming items.	stackmore.use
/stackto	stkto	<amount>	Fill up to the specified amount (only if greater than current). Admins set directly.	stackmore.use
/unstack	unstk	[amount | all]	Unstack as much as possible (keep remainder); all fully unstacks and drops excess; with an amount less than current, unstacks that many.	stackmore.use
/unstackto	unstkto	<amount>	Unstack until the held stack contains exactly the specified amount (excess dropped if inventory full).	stackmore.use
/stackinfo	—	none	Show details of the held special stack (item, UUID, amount, owner).	stackmore.use
/stackmore reload	—	none	Reload configuration and language files.	stackmore.admin
/stackmore setlanguage	—	<code>	Switch language in-game (e.g. en_us, zh_cn). Lists available codes with <Tab>.	stackmore.admin

• stackmore.use is default for all players.
• stackmore.admin is default for OPs only.

Configuration

On first start, the plugin generates config.yml and lang/ inside plugins/StackMore/.

Sample config.yml:

language: zh_cn              # Language file (inside lang/)
max_stack_multiplier: 54     # Max stack = 64 × 54 = 3456
hud_enabled: true            # Toggle ActionBar display
disabled_materials: []       # Extra block materials to disable (uppercase), e.g., ["BEDROCK"]

Language files (lang/zh_cn.yml, lang/en_us.yml) contain all messages, supporting & colour codes.

Usage

1. Place the plugin Jar in plugins/, restart/reload the server.
2. Create a special stack: hold a block (no shulker boxes) and run /stack all to merge that block type from your inventory.
3. Place blocks: place as normal; count decreases. When it falls to ≤ 64, it becomes a normal stack.
4. Unstack: hold a special stack and run /unstack 64 to extract 64 blocks (remains if more); /unstack all unstacks everything.
5. Admin: with stackmore.admin, /stack 1000 directly sets the held block to 1000 without consuming any items.

Important Notes

• Shulker Boxes: All shulker boxes are hardcoded as disabled — cannot be stacked to prevent content duplication.
• Container Blocks: Chests, furnaces, brewing stands, etc., lose all NBT when turned into a special stack; placed as empty containers.
• Protection Plugins: If placement is blocked by another plugin (e.g., WorldGuard), one item is consumed as normal.
• Compatibility: Built for Paper 1.21.3+, works on 1.21.x. Adjust API for older versions.

FAQ

Q: Why can't I stack shulker boxes?
A: For security, all shulker boxes are permanently disabled and cannot be overridden in config.

Q: The amount didn't change after /stack?
A: As a non-admin, your inventory must contain enough normal blocks of that type. Otherwise a "reached limit" message appears. Also, items tagged by other plugins (e.g. Infinite-Blocks) are automatically skipped.

Q: Blocks disappear after placement?
A: The plugin handles block placement carefully; if you still see issues, check for conflicting plugins (e.g. anti‑cheat) and server logs.

Q: How do I change the language?
A: Use /stackmore setlanguage <code> in-game (e.g. en_us, zh_cn, de_de), or set language in config.yml and reload.

Q: Messages are empty after upgrading the plugin JAR?
A: The plugin only extracts language files when they don't exist yet. If a new version added message keys, delete (or rename) the old plugins/StackMore/lang/ folder and restart to get updated files.

Build & Development

Build with Gradle: gradle build → Jar in build/libs/.
Source: GitHub Repository

Note: This plugin was developed with AI assistance, including code generation, architecture design, and documentation review.

License

This project is licensed under the GNU General Public License v3.0.
See LICENSE for the full text.

---

插件概述

StackMore 是一个 Paper 插件，允许玩家将超过 64 个的方块压缩为特殊超大堆叠物品，突破原版堆叠限制，同时保留物品视觉与放置逻辑。
支持数量控制、防拆分保护、与领地/保护插件兼容，适合生存与建筑服务器。

功能特点

• 超大堆叠：将普通方块转换为特殊堆叠，存储高达 64 × max_stack_multiplier 个方块。
• 智能放置：放置方块时数量递减，当数量降至 64 或以下时自动变回普通堆叠。
• 解压灵活：可部分解压或全部解压；背包满时多余物品掉落地面。
• 管理员模式：拥有 stackmore.admin 权限的玩家使用 /stack 或 /stackto 时，可直接设定任意数量，不消耗背包物品。
• 安全防护：所有潜影盒强制禁用；容器类方块（箱子、熔炉等）堆叠时清除 NBT，杜绝物品复制。
• HUD 显示：手持特殊堆叠时 ActionBar 显示物品名称与当前数量（可开关）。
• 多语言支持：内置 7 种语言（简体中文、英语、德语、俄语、西班牙语、法语、日语），游戏内或配置文件随时切换。
• 第三方物品保护：不会被其他插件（如 Infinite-Blocks）标记的物品，防止意外破坏数据。

指令列表

指令	别名	参数	说明	权限
/stack	sm、stk	[数量 | all]	将手持普通方块变为特殊堆叠并吸收背包同类物品；all 堆叠至上限；管理员直接设为上限	stackmore.use
/stackto	stkto	<数量>	仅当数量 > 当前时，向上填充到指定数量；管理员直接设置	stackmore.use
/unstack	unstk	[数量 | all]	无参数尽量解压（保留剩余）；all 强制全解压并掉落多余物品；带数量且 < 当前则解压该数量	stackmore.use
/unstackto	unstkto	<数量>	解压到手中只剩指定数量（背包满则掉落差额）	stackmore.use
/stackinfo	—	无	查看手持特殊堆叠详细信息	stackmore.use
/stackmore reload	—	无	重载配置文件与语言文件	stackmore.admin
/stackmore setlanguage	—	<语言代码>	游戏内切换语言（如 en_us、zh_cn），支持 <Tab> 列出可用代码	stackmore.admin

• stackmore.use 默认赋予所有玩家。
• stackmore.admin 默认仅 OP 拥有。

配置文件

首次启动后，插件在 plugins/StackMore/ 下生成 config.yml 和 lang/ 文件夹。

config.yml 示例：

language: zh_cn              # 语言文件名（位于 lang/）
max_stack_multiplier: 54     # 最大堆叠 = 64 × 54 = 3456
hud_enabled: true            # 是否启用 ActionBar 显示
disabled_materials: []       # 额外禁止堆叠的方块材质（大写），如 ["BEDROCK"]

语言文件（lang/zh_cn.yml）内可自定义所有提示消息，支持 & 颜色代码。

使用方法

1. 将插件 Jar 放入 plugins 文件夹，重启服务器或执行 /reload。
2. 创建特殊堆叠：手持方块（非潜影盒），输入 /stack all 即可将该方块及背包同类普通方块合并为一个特殊堆叠。
3. 放置方块：像普通方块一样放置，内部计数自动减少；低于 64 时变回原版堆叠。
4. 解压：手持特殊堆叠，/unstack 64 解压出 64 个方块（若剩余多于 64 则保留手中）；/unstack all 全部解压。
5. 管理员模式：拥有 stackmore.admin 权限后，/stack 1000 直接将手中方块设为 1000 个，无需消耗背包物品。

注意事项

• 潜影盒：所有颜色的潜影盒均禁止堆叠，且无法通过配置文件更改。
• 容器方块：箱子、熔炉、酿造台等会在创建特殊堆叠时清除内部 NBT，放置后为空容器。
• 保护插件：放置被第三方插件（如 WorldGuard）阻止时，特殊堆叠正常消耗一个物品。
• 兼容性：基于 Paper 1.21.3 开发，适用于 1.21.x 版本。旧版需自行调整 API。

常见问题

Q：为什么无法堆叠潜影盒？
A：出于防止物品复制的安全考量，所有潜影盒被硬编码禁用。

Q：使用 /stack 后数量没变？
A：普通玩家需要背包或副手有足够同类方块可供吸收，否则会提示已达上限。被其他插件标记的物品（如 Infinite-Blocks）会被自动跳过。

Q：放置方块后消失？
A：插件已妥善处理方块同步；若仍有问题，请检查是否有冲突插件（如反作弊）并查看服务器日志。

Q：如何更改语言？
A：游戏内使用 /stackmore setlanguage <代码>（如 en_us、zh_cn、de_de），或修改 config.yml 的 language 后重载。

Q：升级插件 JAR 后消息变空白？
A：插件仅在语言文件不存在时提取。若新版本增加了消息 key，请删除（或重命名）旧的 plugins/StackMore/lang/ 文件夹后重启。

构建与开发

使用 Gradle 构建：gradle build，Jar 文件生成在 build/libs/ 下。
项目地址：GitHub

许可证

本项目使用 GNU General Public License v3.0 开源。
完整许可证文本请见 LICENSE 文件。