StackMore - 超级堆叠方块插件
概述
StackMore 是一款 Paper 插件,允许玩家将超过 64 个方块压缩为特殊的超大可堆叠物品,在保持原有视觉外观和放置逻辑的同时,打破了原版游戏的堆叠上限。
它支持数量控制、防分裂保护以及与土地保护插件的兼容性——非常适合生存建筑和服务器使用。
特性
- 超级堆叠:将普通方块转换为特殊堆叠,最多可存储 64 × max_stack_multiplier 个方块。
- 智能放置:放置方块时内部数量递减;当数量降至 64 或以下时,物品自动恢复为普通堆叠。
- 灵活解叠:部分或完全解叠物品;无法放入背包的多余物品会掉落至地面。
- 管理员模式:拥有
stackmore.admin 权限的玩家可通过 /stack 或 /stackto 直接设置任意数量,无需消耗背包中的物品。
- 安全性:所有潜影盒被强制禁用;容器方块(箱子、熔炉等)在堆叠时会清除 NBT 数据,以防止物品复制。
- HUD 显示:操作栏显示物品名称和当前数量(可切换开关)。
- 多语言支持:内置 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 | — | 无 | 显示当前手持的特殊堆栈的详细信息(物品、UUID、数量、所有者)。 | stackmore.use |
| /stackmore reload | — | 无 | 重新加载配置文件和语言文件。 | stackmore.admin |
| /stackmore setlanguage | — | <code> | 切换游戏内语言(例如 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、lang/en_us.yml)包含所有消息,支持 & 颜色代码。
用法
- 将插件 Jar 文件放入
plugins/ 目录,重启或重载服务器。
- 创建特殊堆叠:手持一个方块(不能是潜影盒),运行
/stack all 以合并背包中该类型的方块。
- 放置方块:正常放置;数量随之减少。当数量降至 ≤ 64 时,它将变为普通堆叠。
- 拆分堆叠:手持特殊堆叠并运行
/unstack 64 以取出 64 个方块(若数量更多则保留剩余部分);运行 /unstack all 可拆分全部。
- 管理员权限:拥有
stackmore.admin 权限时,可直接使用 /stack 1000 将手持方块设为 1000 个,而无需消耗任何物品。
注意事项
- 潜影盒:所有潜影盒均已硬编码为禁用状态——无法堆叠,以防止内容重复。
- 容器方块:箱子、熔炉、炼药锅等转化为特殊堆叠时会丢失所有 NBT 数据;放置时作为空容器处理。
- 保护插件:如果放置被其他插件(例如 WorldGuard)阻止,将正常消耗一个物品。
- 兼容性:专为 Paper 1.21.3+ 构建,兼容 1.21.x。旧版本需调整 API。
常见问题解答
问:为什么我无法堆叠潜影盒?
答:出于安全考虑,所有潜影盒的功能已被永久禁用,且无法通过配置文件覆盖此设置。
问:执行 /stack 命令后数量没有变化?
答:作为非管理员,你的物品栏中必须包含足够数量的该类型普通方块。否则会出现“达到上限”的提示。此外,由其他插件标记的物品(例如 Infinite-Blocks)会被自动跳过。
问:放置方块后方块消失了?
答:该插件对方块放置的处理非常谨慎;如果你仍然遇到问题,请检查是否存在冲突的插件(例如反作弊插件)以及服务器日志。
问:如何更改语言?
答:在游戏中使用 /stackmore setlanguage <code>(例如 en_us、zh_cn、de_de),或在 config.yml 中设置 language 并重新加载。
问:升级插件 JAR 后消息为空?
答:该插件仅在语言文件尚不存在时才会提取它们。如果新版本添加了新的消息键,请删除(或重命名)旧的 plugins/StackMore/lang/ 文件夹并重新启动,以获取更新后的文件。
构建与开发
使用 Gradle 进行构建:gradle build → Jar 包位于 build/libs/ 中。
源代码:GitHub 仓库
注意: 本插件的开发借助了人工智能辅助,包括代码生成、架构设计和文档审查。
许可证
本项目遵循 GNU通用公共许可证v3.0。
完整文本请参阅 LICENSE。
插件概述
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)内可自定义所有提示消息,支持 & 颜色代码。
使用方法
- 将插件 Jar 放入
plugins 文件夹,重启服务器或执行 /reload。
- 创建特殊堆叠:手持方块(非潜影盒),输入
/stack all 即可将该方块及背包同类普通方块合并为一个特殊堆叠。
- 放置方块:像普通方块一样放置,内部计数自动减少;低于 64 时变回原版堆叠。
- 解压:手持特殊堆叠,
/unstack 64 解压出 64 个方块(若剩余多于 64 则保留手中);/unstack all 全部解压。
- 管理员模式:拥有
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 文件。
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
- Place the plugin Jar in
plugins/, restart/reload the server.
- Create a special stack: hold a block (no shulker boxes) and run
/stack all to merge that block type from your inventory.
- Place blocks: place as normal; count decreases. When it falls to ≤ 64, it becomes a normal stack.
- Unstack: hold a special stack and run
/unstack 64 to extract 64 blocks (remains if more); /unstack all unstacks everything.
- 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)内可自定义所有提示消息,支持 & 颜色代码。
使用方法
- 将插件 Jar 放入
plugins 文件夹,重启服务器或执行 /reload。
- 创建特殊堆叠:手持方块(非潜影盒),输入
/stack all 即可将该方块及背包同类普通方块合并为一个特殊堆叠。
- 放置方块:像普通方块一样放置,内部计数自动减少;低于 64 时变回原版堆叠。
- 解压:手持特殊堆叠,
/unstack 64 解压出 64 个方块(若剩余多于 64 则保留手中);/unstack all 全部解压。
- 管理员模式:拥有
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 文件。
评论 0
登录后参与评分
还没有评论,来抢沙发吧