原创 付费 鲸鱼灵魂空间 | JYSoulBag 1.0

[MD] # 🐋 鲸鱼灵魂空间 | JYSoulBag > Minecraft 1.12.2 - 1.21.2 的灵魂空间插件。给玩家一个随身的虚拟仓库：自动拾取、分解兑换、回收站、二级密码、日志审计，数据支持 YAML / MySQL / SQLite。 > > 主指令 `/jysb`，权限前缀 `jysoulbag.*`。 --- ## 简介 玩家背包总是不够用？**鲸鱼灵魂空间** 给每个玩家一个可以无限扩容的随身仓库： - 按页组织的虚拟空间，可用解锁石扩页 - 捡到的物品自动进仓，击杀怪物掉落直存 - 多余装备一键分解成材料/货币，碎片兑换高级物品 - 删除的东西先进回收站，误删可恢复 - 贵重仓库可设二级密码，密码错误还会锁定防爆破 - 管理员可在控制台查看/编辑任意玩家（含离线）的空间 一套插件，把"玩家储物"和"经济回收"都做了。 --- ## 功能特色 | 功能 | 说明 | |---|---| | 🎒 灵魂空间 | 每页 36 格（可配 45），页数可用解锁石扩充，容量按格精确控制 | | ♾️ 堆叠无上限 | 仓库单格可突破原版 64 上限，同类物品自动合并成一格 | | 🎯 自动拾取 | 捡起地面掉落 / 击杀怪物掉落自动存入仓库，满仓自动退回或留地 | | 🐲 MM 掉落直存 | 击杀 MythicMobs 怪自动存掉落，支持白名单/黑名单/仅 MM 原生物品 | | ⚗️ 分解系统 | 名称/Lore/材质匹配配方，奖励支持 MM 物品、原版、金币、点券、指令 | | 🔁 灵魂兑换 | 消耗匹配物品兑换奖励，背包不够自动从仓库补扣 | | 🗑️ 回收站 | 删除/分解先进回收站，可恢复或清空，过期自动清理 | | 🔒 二级密码 | 密码加密存储，取出/分解/删除需验证；连续输错锁定一段时间 | | 📦 一键整理 | 同类堆叠 + 自动排序，单页或全仓 | | 🔍 搜索 | 关键词搜仓库（可含回收站），结果界面直接取回 | | 📥 一键收纳 | 把背包物品批量存入仓库 | | 💍 灵魂戒指 | 右键开仓库，Shift+左键切换自动拾取，支持 MM 物品外观 | | 📐 精确容量 | 管理员可设置任意格数（如 68 格），未解锁格显示屏障不可放入 | | 🧾 全链路日志 | 拾取/存取/发放全程记录，可按玩家/日期查询 | | 🚫 禁存黑名单 | 按名称/Lore/材质拦截禁止入仓的物品 | | 🌐 三端存储 | YAML / MySQL / SQLite 随意切换，支持一键迁移 | --- ## 指令一览 ### 玩家指令 | 指令 | 说明 | |---|---| | `/jysb` | 查看帮助 | | `/jysb open [页码]` | 打开自己的灵魂空间 | | `/jysb search <关键词>` | 搜索空间物品 | | `/jysb exchange` | 打开灵魂兑换 | | `/jysb ring` | 领取灵魂戒指 | | `/jysb buyunlock [数量]` | 花费货币解锁页数 | | `/jysb pin` | 二级密码（设置/修改/移除/锁定/状态） | | `/jysb capacity` | 查看/购买仓库容量 | ### 管理员指令 | 指令 | 说明 | |---|---| | `/jysb dopen <玩家>` | 查看/编辑任意玩家（在线或离线）的空间 | | `/jysb give <玩家> <物品> [数量]` | 发放物品到玩家仓库（支持 MM 物品） | | `/jysb giveunlock <玩家> <数量>` | 发放解锁石 | | `/jysb capacity set <玩家> <格数>` | 设置玩家精确容量 | | `/jysb recipe` | 打开分解配方可视化编辑器 | | `/jysb log [玩家] [日期] [页码]` | 查询仓库日志 | | `/jysb migrate <yaml\|mysql\|sqlite>` | 迁移存储数据 | | `/jysb reload` | 重载全部配置 | > 所有子命令均支持 Tab 补全。 --- ## 权限节点 | 权限 | 说明 | 默认 | |---|---|---| | `jysoulbag.use` | 使用灵魂空间 | 玩家 | | `jysoulbag.pickup` | 自动拾取 | 玩家 | | `jysoulbag.decompose` | 分解功能 | 玩家 | | `jysoulbag.exchange` | 灵魂兑换 | 玩家 | | `jysoulbag.ring` | 灵魂戒指 | 玩家 | | `jysoulbag.pin` | 二级密码 | 玩家 | | `jysoulbag.capacity.buy` | 购买容量 | 玩家 | | `jysoulbag.admin` | 管理员 | op | | `jysoulbag.inspect` | 查看/编辑他人空间 | op | | `jysoulbag.capacity.set` | 设置玩家容量 | op | | `jysoulbag.log` | 查看日志 | op | --- ## 配置文件 首次启动自动生成，修改后 `/jysb reload` 生效（不会覆盖已有配置）： | 文件 | 作用 | |---|---| | `config.yml` | 全局配置（存储/空间/解锁石/戒指/拾取/回收站/日志/容量等） | | `gui.yml` | 空间界面标题与按钮 | | `messages.yml` | 全部消息文本与指令帮助 | | `decompose.yml` | 分解配方（可用 `/jysb recipe` 可视化编辑） | | `exchange.yml` | 兑换配方 | | `blacklist.yml` | 禁存黑名单 | **容量计算**：`容量 = 自定义格数 / 页数×每页格数 / 权限容量，取最大`，上限可在配置中调大。 **奖励格式**：分解/兑换奖励支持 `MM物品 / 原版物品 / 金币 / 点券 / 执行指令 / 消息`，每行一条配置。 --- ## 数据存储 | 类型 | 适用场景 | |---|---| | YAML | 小型服务器，开箱即用（默认） | | MySQL | 大型服务器，多服共享数据 | | SQLite | 中型服务器，无需额外数据库 | - 驱动缺失时自动下载（国内镜像），失败自动回退 YAML，不影响运行 - 玩家数据内存缓存，存取毫秒级响应；关键操作同步落盘，不怕宕机丢数据 --- ## 兼容性 - **Minecraft 1.12.2 - 1.21.2** 跨版本兼容，物品数据不丢 - **MythicMobs** 4.1.x / 4.5.x / 5.7.x 兼容（软依赖） - **Vault / PlayerPoints** 金币/点券经济（软依赖） - **PlaceholderAPI** 变量支持（软依赖，未装不影响） 未安装以上插件时，对应功能自动跳过，插件基础功能不受影响。 --- ## 常见问题 **Q：修改配置后不生效？** 配置已存在时不会被覆盖，请手动修改后 `/jysb reload`。 **Q：物品删了能找回吗？** 删除先进回收站（默认 24 小时），过期或清空后才永久删除。 **Q：二级密码忘了？** 管理员执行 `/jysb pin reset <玩家>` 重置。 **Q：怎么换数据存储？** `/jysb migrate <yaml|mysql|sqlite>` 迁移，改配置重启。 --- [ATTACH]145152[/ATTACH][ATTACH]145153[/ATTACH][ATTACH]145154[/ATTACH][ATTACH]145155[/ATTACH][ATTACH]145156[/ATTACH][ATTACH]145157[/ATTACH][ATTACH]145158[/ATTACH][ATTACH]145159[/ATTACH][ATTACH]145160[/ATTACH][ATTACH]145161[/ATTACH][ATTACH]145162[/ATTACH] [/MD]