原创 开源 工具 【Java插件】FmYunbei 云背包 · 格子随真实在线时长生长,堆叠倍数经济购买(Paper/Folia) v1.3.0 v1.3.0

[MD] > **云背包 —— 你的仓库会陪你肝。** > 格子数由**真实在线时长**解锁(默认每 3 小时 +1 格,肝到 891 格封顶),单格容量由**经济购买的倍数**决定(2× 起步,最高 12×)。附魔书、潜影盒、掉耐久的装备也能存,判等严格,绝不吞物品。Paper / Folia 双平台同一份代码。 > ⚠️ **开发说明**:本插件为 **AI 辅助开发**——作者负责需求设计、方案与实机测试,代码与文案主要由 AI(Claude)编写。帖内截图均为服务器实机截图,插件头图为 AI 生成。 --- ## 截图速览 **主界面 —— 41/891 格、2× 标题栏 + 黑玻璃工具栏(整理 / 翻页 / 取回 / 存入)**  **云背包档案 —— 累计在线、解锁进度、当前倍数一眼看清**  **堆叠倍数购买面板 —— 单格上限 = 基础堆叠 × 倍数,下一级 4× 点一下就买**  **物品格详情 —— 数量 / 上限 / 存入时间,四种取出手势**  --- ## 它能干什么 ### 1. 格子随在线时长「生长」 - 初始 27 格,每累计 **3 小时真实在线**自动 +1 格(每格时长配置文件可改); - 只统计真实在线秒数,挂机检测、离线时间一概不算; - 在线时长每 30 秒落盘一次,**踢线 / 崩服不丢进度**; - 第 1 页 36 格、之后每页 45 格,默认 20 页 = **891 格**封顶,页数上限可改、可设无限; - 管理员可额外补格(`giveslots`),活动奖励直接用指令发。 ### 2. 单格堆叠倍数,用经济买 - 每格容量 = 原版堆叠基数 × 倍数。倍数阶梯:**2× → 4× → 6× → 8× → 10× → 12×**(tier 0 未购买就是 2×); - 价格默认 5000 起,每级翻倍:5000 / 10000 / 20000 / 40000 / 80000,全部配置可改; - 走 Vault 经济,**没装经济插件自动隐藏购买入口**,其余功能照常; - 雪球一类基数 16 的物品按 16 放大(2× 时 32),不是无脑 ×64。 ### 3. 不可堆叠物品也能存(两种模式) 附魔书、潜影盒、带耐久的工具盔甲这类「原版上限 = 1」的物品: - `multiply` 模式:基数 1 × 倍数(2 / 4 / 6…); - `normal` 模式:基数 64 × 倍数(128 / 256…),只放大单格容量; - 两种模式都要求**物品完全相同**(附魔、耐久、命名、lore、潜影盒内容全一致,走 `ItemStack#isSimilar`)才允许合并,不同的永不混堆; - **取出永远按原版一组发放**——绝不把超过原版上限的堆叠塞给客户端,不存在「取出即销毁」的经典坑。 ### 4. GUI 细节 - 锁定格灰玻璃、下一解锁预览行浅蓝高亮、工具栏黑玻璃,视觉与 FmKit 统一; - 1 秒差量刷新:开着窗口格子一个个解锁是**实时长出来**的; - 左键取一组 / 右键取一半 / Shift+右键取 1 / Shift+左键尽量取; - 一键存入、一键取回、一键整理(合并可合并堆 + 前移压缩,只动已解锁格); - 翻页、解锁、购买、拒绝都有音效,事件名逐个可换,也能整体静音。 ### 5. 一键整理的排序键(三选一) | 键 | 效果 | | --- | --- | | `name` | 只按材质名 A→Z | | `api` | 先粗分类(方块→红石→交通→工具→战斗→食物→酿造→杂项),再按材质名 | | `categories` | ChestSort 风格分类文件,`categories/<权重>-<名字>.txt`,首次启用自动生成完整清单,改文件名前缀数字就改顺序 | ### 6. 管理员工具 & 审计 - `/fyba` 一整套:查他人背包、查档案、补格、加/设在线时长、设倍数、发物品进对方云背包、清空(不带 confirm 只预览件数)、热重载; - 审计日志按天切分:管理员命令 / 经济购买 / 解锁默认记录,高频的存取整理默认关、可打开; - `keep-days` / `max-files` / `max-total-mb` 三条保留策略任一满足即保留,不会被单条策略误删。 ### 7. PlaceholderAPI(软依赖,不装不影响) 可直接丢进 TAB 的 tablist / 侧边栏 / BossBar,**全部异步安全、零磁盘 IO**: ``` %fmyunbei_slots% 已解锁格子数(含实时进度) %fmyunbei_slots_max% 格子上限 %fmyunbei_used_slots% 已用格数 %fmyunbei_total_items% 背包内物品总件数 %fmyunbei_playtime_minutes% 累计真实在线分钟 %fmyunbei_next_slot_seconds% 距下一格剩余秒数 %fmyunbei_next_slot_formatted% 距下一格剩余时间(如 40m55s) %fmyunbei_multiplier% 当前堆叠倍数 %fmyunbei_multiplier_max% 倍数上限 %fmyunbei_next_multiplier_price% 下一级价格 ``` ### 8. Folia 原生 `folia-supported: true`。GUI 与存取走玩家实体调度器(区域线程),时长落盘与跨玩家读取走全局区域调度器;Paper 上同名回退,**一份代码两个平台,没有分叉**。 --- ## 版本要求 | 项 | 要求 | | --- | --- | | 服务端 | Paper / Folia 26.2+ | | Java | 21 | | 经济(可选) | VaultUnlocked + 任一经济插件 | | PlaceholderAPI | 可选软依赖 | ⚠️ 经济功能依赖 **VaultUnlocked**(插件名仍叫 `Vault`)。旧版 MilkBowl Vault 2022 年就停更了、没有 `folia-supported` 键,在 Paper/Folia 26.2 上起不来,**别拿旧 Vault 凑**。不装经济也行,购买入口自动隐藏。 ## 安装 1. `FmYunbei-1.3.0.jar` 丢进 `plugins/`; 2. 重启,自动生成 `plugins/FmYunbei/config.yml`(全部文案 MiniMessage,可改); 3. 玩家 `/fyb` 打开云背包,管理 `/fyba status <玩家>`。 ## 指令与权限 | 指令 | 说明 | 权限 | | --- | --- | --- | | `/fmyunbei [open\|help]`(别名 `/fyb`、`/yunbei`) | 打开云背包 | `fmyunbei.use`(默认所有人) | | `/fyba open <玩家>` | 查看他人云背包 | `fmyunbei.admin`(默认 OP) | | `/fyba status <玩家>` | 在线时长 / 格数 / 倍数等级 | `fmyunbei.admin` | | `/fyba giveslots <玩家> <数量>` | 补格 | `fmyunbei.admin` | | `/fyba addtime <玩家> <小时>` | 叠加在线时长(支持小数 / 负数) | `fmyunbei.admin` | | `/fyba settime <玩家> <小时>` | 直接设定在线时长 | `fmyunbei.admin` | | `/fyba settier <玩家> <等级>` | 设置倍数等级 | `fmyunbei.admin` | | `/fyba clear <玩家> confirm` | 清空内容(不带 confirm 只预览) | `fmyunbei.admin` | | `/fyba give <玩家> <物品> <数量>` | 发物品进对方云背包 | `fmyunbei.admin` | | `/fyba reload` | 热重载配置 | `fmyunbei.admin` | ## 常见问题 **Q:会不会刷物品 / 吞物品?** A:合并只认 `isSimilar` 完全相同;取出一律按原版单堆上限发放,超过上限的堆永远只存在于云背包自己的存储层,不会以非法 ItemStack 出网。 **Q:服务器重启 / 玩家被踢,在线时长丢吗?** A:不丢,每 30 秒落盘。 **Q:不用经济插件能玩吗?** A:能,格数生长、存取、整理、PAPI 全都在,只是没有倍数购买入口(默认所有人享受 2×)。 **Q:和箱子类插件(EnderStorage/ChestShop)冲突吗?** A:云背包是独立存储,不复制任何原版容器内容,只认玩家自己存进来的物品。 ## 更新日志 **v1.3.0** - 新增 PlaceholderAPI 扩展(10 个占位符,异步安全、零磁盘 IO) - 离线玩家数据不在缓存时宁可返回 `-`,也不触发同步加载 **v1.2.x** - 首发:云背包核心(在线时长生长、倍数经济购买、GUI 存取与整理、Folia 支持) ## 下载 > 【https://github.com/wosnxn123/FmYunbei/releases】 ## 许可证 GPL-3.0 开源。欢迎提意见、报 bug、催更,回帖即可。 **AI 开发声明**:本项目采用 AI 辅助编码(Claude)完成,作者负责架构设计、代码审校与实机验证;帖内截图为实机游戏截图,仅插件头图为 AI 生成。源码可查,欢迎审计。 [/MD]