StackMore

插件

· 作者 Couqui

StackMore 是一个 Paper 插件,允许玩家将超过 64 个方块压缩为一种特殊的大型可堆叠物品,在保持原有视觉外观和放置逻辑的同时,突破了原版堆叠数量的限制。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.4 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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)包含所有消息,支持 & 颜色代码。

用法

  1. 将插件 Jar 文件放入 plugins/ 目录,重启或重载服务器。
  2. 创建特殊堆叠:手持一个方块(不能是潜影盒),运行 /stack all 以合并背包中该类型的方块。
  3. 放置方块:正常放置;数量随之减少。当数量降至 ≤ 64 时,它将变为普通堆叠。
  4. 拆分堆叠:手持特殊堆叠并运行 /unstack 64 以取出 64 个方块(若数量更多则保留剩余部分);运行 /unstack all 可拆分全部。
  5. 管理员权限:拥有 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)内可自定义所有提示消息,支持 & 颜色代码。

使用方法

  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 文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源