原创 工具 WarZStacker - 高级自定义物品堆叠上限插件 | 权限分级 | 世界限定 | 热重载 1.1.0

---

---

[MD] # 🔥【原创插件】WarZStacker - 高级自定义物品堆叠插件 | InfinitySlot虚拟堆叠 | 权限分级 | 世界限定 | 热重载 ## 📋 插件简介 **WarZStacker** 是一款功能强大的自定义物品堆叠插件，专为 Minecraft 1.20+ 服务器设计。插件支持灵活的堆叠规则配置、权限分级管理、世界限定功能，让服务器管理员能够精确控制每种物品的堆叠数量，提升玩家游戏体验。 ### ✨ 核心特色 - 🎯 **多维度规则匹配** - 支持材质、CustomModelData、Lore 三种匹配方式 - 👑 **权限分级系统** - VIP/SVIP/管理员不同权限等级，享受不同堆叠上限 - 🌍 **世界限定功能** - 可指定特定世界启用/禁用堆叠规则 - 🔄 **热重载支持** - 无需重启服务器即可重新加载配置 - 🌐 **完整中文化** - 全中文界面，支持自定义语言文件 - 🐛 **调试模式** - 内置调试功能，方便排查问题 - ⚡ **高性能优化** - 异步处理，不影响服务器性能 - ♾️ **InfinitySlot 模式** - 参考 InfinitySlots 的虚拟堆叠方案，支持突破原版 64 上限 - 🛡️ **拾取防重复结算** - 修复背包已有同类物品时可能重复入包的问题 --- [ATTACH]116429[/ATTACH][ATTACH]116430[/ATTACH] ## 🚀 主要功能 ### 📦 智能堆叠系统 - **自动堆叠检测** - 玩家拾取、移动、合成物品时自动应用堆叠规则 - **超量拆分** - 当物品数量超过堆叠上限时，自动拆分为多个堆叠 - **背包整理** - 提供 `/wzs organize` 命令一键整理背包 ### 🎛️ 灵活规则配置 ```yaml # 按材质匹配 materials: DIAMOND: max-stack: 16 enabled: true worlds: [] # 按 CustomModelData 匹配 custom-model-data: 1001: max-stack: 64 enabled: true worlds: ["world"] # 按 Lore 内容匹配 lore-contains: - match: "§6传说武器" max-stack: 1 enabled: true worlds: [] ``` ### 👥 权限分级管理 | 权限节点 | 默认堆叠上限 | 说明 | |---------|-------------|------| | `warzstacker.admin` | 512 | 管理员权限 | | `warzstacker.svip` | 256 | SVIP 权限 | | `warzstacker.vip` | 128 | VIP 权限 | | 无权限 | 64 | 普通玩家 | ### 🌍 世界管理功能 - **启用世界列表** - 指定插件生效的世界 - **禁用世界列表** - 指定插件不生效的世界 - **规则世界限定** - 每条规则可单独指定适用世界 --- ## 📥 安装教程 ### 系统要求 - **Minecraft 版本**: 1.20+ - **服务端**: Spigot/Paper/Purpur 等 - **Java 版本**: Java 17+ ### 安装步骤 1. 下载 `WarZStacker-1.1.0.jar` 文件 2. 将文件放入服务器 `plugins` 文件夹 3. 重启服务器或使用 `/reload` 命令 4. 编辑 `plugins/WarZStacker/config.yml` 配置文件 5. 使用 `/wzs reload` 重新加载配置 --- ## 🎮 命令说明 ### 主命令 ``` /warzstacker [子命令] [参数] 别名: /wzs, /stacker ``` ### 子命令列表 | 命令 | 权限 | 说明 | |------|------|------| | `/wzs help` | 无 | 显示帮助信息 | | `/wzs info` | `warzstacker.admin` | 查看插件信息和状态 | | `/wzs reload` | `warzstacker.admin` | 重新加载配置文件 | | `/wzs test [物品]` | `warzstacker.admin` | 测试物品堆叠规则 | | `/wzs organize` | `warzstacker.organize` | 整理背包物品 | ### 使用示例 ``` # 查看插件信息 /wzs info # 重新加载配置 /wzs reload # 测试手持物品的堆叠规则 /wzs test # 整理背包 /wzs organize ``` --- ## ⚙️ 配置文件详解 ### 主配置文件 (config.yml) ```yaml # 全局设置 global: enabled: true # 是否启用插件 debug: false # 是否启用调试模式 default-stack-limit: 64 # 默认堆叠上限 # 权限等级堆叠上限 permission-limits: warzstacker.vip: 128 # VIP 权限堆叠上限 warzstacker.svip: 256 # SVIP 权限堆叠上限 warzstacker.admin: 512 # 管理员权限堆叠上限 # 世界限定设置 worlds: enabled-worlds: [] # 启用的世界列表 disabled-worlds: [] # 禁用的世界列表 # 物品堆叠规则 stack-rules: materials: # 按材质匹配的规则 DIAMOND: max-stack: 16 enabled: true worlds: [] custom-model-data: # 按 CustomModelData 匹配 1001: max-stack: 64 enabled: true worlds: ["world"] lore-contains: # 按 Lore 包含内容匹配 - match: "§6传说武器" max-stack: 1 enabled: true worlds: [] ``` ### 语言文件 (lang.yml) 插件支持完整的中文化，所有消息都可以在 `lang.yml` 中自定义修改。 ### InfinitySlot 模式配置 ```yaml advanced: infinity-slot: enabled: true # 启用虚拟堆叠模式 lore-format: "&7数量: &e{count}" # 虚拟堆叠显示格式 extract-batch: 64 # 每次右键解包数量 require-sneak: true # 需要潜行右键才解包 ``` --- ## 🔧 高级功能 ### 调试模式 在 `config.yml` 中设置 `debug: true` 开启调试模式，控制台将输出详细的堆叠处理信息，方便排查问题。 ### 热重载 使用 `/wzs reload` 命令可以在不重启服务器的情况下重新加载配置文件，立即应用新的堆叠规则。 ### 性能优化 - 使用 ConcurrentHashMap 确保线程安全 - 异步处理大量物品操作 - 智能缓存减少重复计算 --- ## 📸 效果展示 ### 启动信息 ``` ▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃ [WarZStacker] 插件已启用 版本: 1.1.0 作者: Crazy_Jky ✔ 堆叠系统已启动 ✔ 配置文件加载完成 ✔ 已加载 15 条堆叠规则 插件技术交流群: 398893720 末日类服务器交流群: 1063544727 插件定制开发: QQ 1285988665 支持作者: https://afdian.com/a/sunjood ▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃▃ ``` ### 命令执行效果 - **物品测试**: 显示物品的匹配规则、权限限制、最终堆叠上限 - **背包整理**: 自动合并相同物品，显示整理结果统计 - **配置重载**: 实时重新加载配置，无需重启服务器 --- ## 🛠️ 技术支持 ### 联系方式 - **插件技术交流群**: 398893720 - **末日类服务器交流群**: 1063544727 - **插件定制开发**: QQ 1285988665 - **支持作者**: https://afdian.com/a/sunjood ### 常见问题 1. **Q: 插件不生效怎么办？** A: 检查 `config.yml` 中 `enabled` 是否为 `true`，确认权限节点配置正确。 2. **Q: 如何添加自定义物品堆叠规则？** A: 在 `config.yml` 的 `stack-rules` 部分添加对应规则，然后使用 `/wzs reload` 重载。 3. **Q: 权限不生效怎么办？** A: 确认权限插件正确安装，检查权限节点拼写是否正确。 ### 更新日志 - **v1.1.0** (2026-03-08) - 新增 InfinitySlot 虚拟堆叠模式（PDC存储真实数量 + Lore显示） - 支持潜行右键解包虚拟堆叠物品 - 拦截虚拟堆叠物品参与合成，避免误用 - 修复拾取时背包已有同类物品导致重复入包问题 - 优化超量拆分开关生效范围，提升行为一致性 - **v1.0.0** (2024-01-XX) - 首次发布 - 支持多维度堆叠规则匹配 - 权限分级系统 - 世界限定功能 - 完整中文化支持 --- ## 📄 许可证 本插件为原创作品，版权归作者所有。 --- ## 💝 支持作者 如果这个插件对你有帮助，欢迎： - ⭐ 给帖子点赞收藏 - 💬 分享使用体验 - 💰 [爱发电支持](https://afdian.com/a/sunjood) - 🎯 推荐给其他服主 **感谢你的支持，这是我继续开发的动力！** --- *最后更新: 2026-03-08 | 版本: v1.1.0 | 作者: Crazy_Jky* [/MD]