yourShika Backpack's
⚠️ 免责声明: 本项目——包括其代码和项目美术资源——均在人工智能的协助下创建。插件本身由真人测试,漏洞和问题正在积极修复中。
一个适用于 Paper/Spigot 的独立、完全服务端背包系统。
玩家无需安装客户端模组。
? 描述
yourShika Backpack's 为你的生存服务器带来了高质量、可染色的背包,并拥有独立的物品栏。这些背包能够防止复制漏洞,持久化存储,并支持自定义纹理。
本插件灵感来源于 Sophisticated Backpacks
(GitHub),但它是完全独立的重新实现。未从该模组中获取任何代码、资产或纹理。这不是 Forge/Fabric/NeoForge 模组,而是一个 Paper/Spigot 插件。
? v1.3.2
- ? 磁铁吸附已修复 – 解决了两个恼人的问题:
- 物品不再飞过头顶。之前的吸附力会强制施加持续的向上推力并瞄准髋部高度;现在它瞄准你的胸部(拾取中心点),并且只提升明显位于你下方的物品。
- 修复了无法拾取的物品。当物品靠近时,磁铁曾停止吸附并留下剩余的向上动量,导致物品漂移而过;现在它会抑制物品的动量使其进入拾取框内,以便原版拾取机制可靠地抓取。
?️ v1.3.1
- ? 压缩过滤器在重连后不再重置 – 过滤器现在存储样本物品的独立副本,而不是实时库存引用。由于异步写回缓存(v1.2.0),这些引用可能在延迟保存之前失效,导致过滤器序列化为空,并在重新登录后看起来被清空。相同的加固措施也应用于拾取过滤器。
- ? 压缩开启/关闭切换 – 每个背包的压缩升级现在在其过滤器菜单中都有开/关开关。当处于关闭状态时,关闭背包时物品不再压缩成方块。此状态按每个背包单独保存。
? v1.3.0
- ? 支持 Minecraft / Paper 26.2 – 插件现基于
paper-api:26.2.build.62-beta 构建,并可在 Paper 26.1.2 – 26.2 上运行。无需破坏 API:26.2 仍针对 Java 25,且未使用 26.2 专属 API,因此同一个 jar 包可在两者上运行。
- ?️
api-version 更新为 '26.1.2' – 旧的 '1.21' 声明早于新的 YY.D.H 版本方案。api-version 是最低服务器版本要求,因此 26.1.2 既保持 26.1.2 服务器的兼容性,又正确声明了对新方案的兼容。
- ? 铁砧重命名功能面向未来 – 从已弃用的
AnvilInventory#getRenameText()(标记为即将移除)切换到 AnvilView#getRenameText()。构建现在无警告。
注意: Paper 26.2 目前仅发布 alpha/beta 构建(最新 26.2.build.62-beta);尚无 -stable 的 26.2 构建。本插件使用的 API 表面不受影响。
?️ v1.2.3
- ?️ 补给与喂食升级使用其预制的 Oraxen 纹理 – 在 v1.2.0 中,这两个新升级绑定到了虚构的模型 ID,与其他物品发生冲突,因此在启用 Oraxen 时显示错误的纹理。现在它们绑定到捆绑资产
ysbp_upgrade_restock (restock.png, CMD 2110) 和
ysbp_upgrade_feeding (feeding.png, CMD 2137)。自动补给升级现在简称为 补给。 (配置版本 11;全新/合并的配置会自动应用此项 — 来自 v1.2.0–1.2.2 的测试服务器应删除其 config.yml 以重新生成,或手动设置 feeding CMD 2137 / 将 auto_restock 重命名为 restock。)
?? v1.2.2
- ?? 波兰语翻译已完成 – 波兰语本地化缺少 25 个键(整个
rename、transfer、locate、assets、doctor、trash 部分以及一些帮助/错误条目),这些条目曾回退到英语。现在所有三个捆绑本地化文件(en、de、pl)均已达到完整键值对等(102/102) – 波兰语玩家不再有英语回退。
? v1.2.1
- ? 所有语言通过配置就绪 –
en、de 和 pl 现在在启动时全部提取到数据文件夹,因此你可以将 language: 设置为其中任意一种,并直接编辑任何 messages_<lang>.yml(此前仅写出活动语言和英语)。
- ?️ 翻译在更新中得以保留 – 每次启动时,每个捆绑的语言文件都会进行合并:新增的消息键会被添加,而你自己的编辑保持不变,因此升级插件永远不会丢失或覆盖你的翻译。通过创建
messages_<code>.yml 并将 language: 设置为该代码来添加你自己的语言。
✨ v1.2.0
新功能与体验优化
- ⚡ 异步存储缓存 – 背包数据现在存储在内存缓存中,采用异步、批处理的写回机制。读取操作(打开、翻页、拾取、熔炉刻、
%ysbp_*% 占位符)不再在主线程上访问磁盘,写入则在后台线程打包进行。在干净关闭时始终执行完整刷新。可通过 storage.flush-seconds 调整间隔(默认值为 5)。
- ? 更新时合并配置 – 升级到新的配置版本现在会保留你自己的设置,仅添加新的键/注释(仍会写入带时间戳的备份),而不是覆盖整个文件。
- ? 自动补给升级 (新增) – 当快捷栏/物品栏中的堆叠耗尽时,它将从背包中用相同的物品补充。使用比较器和箱子围绕升级皮革制作。
- ? 喂食升级 (新增) – 当你饥饿时,自动从背包中吃食物(伴有咀嚼声)。使用干草捆和面包围绕升级皮革制作。
- ? 快速堆叠 – Shift+点击信息按钮,可将你物品栏中所有匹配的物品扫入背包。(普通点击仍执行排序。)
- ? Shift+点击填充所有页面 – 现在在多页背包中 Shift+点击物品会将它们分散到每一页,而不仅仅是当前可见的那一页。
- ? 记住最后一页 – 多页背包重新打开时会停留在你上次使用的页面。
- ?
/bp stats – 显示总数量 / 已放置数量 / 各等级背包数量及存储大小。
- ?
/bp purge [dry|confirm] – 安全移除空的和孤立的背包数据(被销毁或转换后的空背包)。非空数据永远不会被触碰,因此离线玩家仍持有的内容不会丢失。
错误修复与强化
- ? 灵魂绑定防复制修复 – 当另一个插件在死亡事件开始后设置
keepInventory 时,背包不再发生复制;断开连接时的返还现在是安全的,不会丢失。
- ? 副手切换 (F) 不再能将背包潜行放入坐骑物品栏。
- ? 创造模式保护 现在涵盖所有子 GUI(升级 / 熔炉 / 过滤器 / 垃圾桶 / 经验)。
- ? 损坏恢复能力 – 单个损坏的物品不再导致加载整个背包失败;按槽位恢复机制可保留其余部分。
- ? 更深层嵌套检查、
/bp list [Open] 对拥有者有效、配方/成就编辑在 /bp reload 后生效,以及一系列空指针安全检查修复。
? v1.1.3
- ? 磁力聊天消息修复 –
/bp magnet on|off(以及无参数切换)现在正确显示 “磁力已启用/已禁用” 确认信息,而不是 “Missing message: magnet.on / magnet.off” 错误。原因:on 和 off 是保留的 YAML 布尔值,因此这些键被解析为 magnet.true / magnet.false 且从未解析成功。现在所有消息文件(messages_de/en/pl.yml)中的键都已加引号,因此修复适用于所有语言——无需删除消息文件。
✨ v1.1.2
- ? 磁力开关 – 使用
/bp magnet on|off(无参数则切换)为每个玩家开启/关闭磁力吸引。一条简短的聊天消息会确认新状态;该设置也控制高级拾取真空功能。
- ? 同时只能有一个磁力/一个拾取背包 – 你可以拥有许多带有这些升级的背包,但你的物品栏中只能激活一个磁力背包和一个拾取背包。携带更多会自动禁用该升级(防止复制/行为异常),直到只剩一个为止,并会在动作栏以限流方式提示。
- ? 拾取过滤器 – 拾取升级现在拥有过滤器菜单(类似于压缩过滤器)。只有你放在那里的物品才会直接被吸入背包。匹配方式为 NBT 精确匹配,因此可以精确地将自定义物品 / 自定义 NBT 加入白名单。空过滤器将拾取所有物品。从背包菜单中的 拾取过滤器 按钮打开它。
? v1.1.1
- ?
/oraxen reload 后的纹理更新 – 在重新部署资源包并重新加载 Oraxen 后,新添加/更改的纹理未应用于crafted、给予或 /bp info 的物品(插件仍提供其缓存的物品模型),直到你关闭再开启模块。现在插件监听 Oraxen 的重载事件,并自动同步其标准物品、携带的背包和放置的模型,以便新纹理立即生效——无需切换模块。
- ? 放置的模型跟随模块状态 – 禁用 Oraxen 模块(或完全移除 Oraxen)会导致世界中的放置背包 3D 模型残留,一旦 Oraxen 消失,这些模型将显示缺失纹理。当钩子关闭时,放置的模型现在回退到原版外观——对于已加载的模型,在切换/重载时更新,并在区块加载时自动更新。
✨ v1.1.0
- ? 灵魂绑定升级(新增) – 一种新的功能升级,拥有独立的 Oraxen 纹理。拥有此升级的背包在你死亡时不会掉落,而是跟随你,并在重生后保留。它与墓碑/尸体插件兼容防复制:死亡处理器以
LOWEST 优先级运行,在墓碑插件读取之前从死亡掉落物中移除灵魂绑定背包,且背包内容通过 ID 存在于服务器端(因此即使是意外副本也共享相同的存储)。使用不死图腾 + 灵魂沙围绕升级皮革制作。
- ? 携带的背包现在使用你的颜色 – 携带/手持的 Oraxen 背包将层级颜色烘焙到其叠加层中(例如,翡翠背包保持绿色,染色 accents 无法完全显示)。现在叠加层变为中性(独立于层级),因此主体采用你的主颜色(可染色的基础色),而 accent 变体颜色用于背带/口袋——这与 v1.0.9 为放置背包提供的修复相同。(资源包变更——更新后运行
/oraxen reload;现有背包在打开/加入时自动刷新。)
? v1.0.9
- ? 放置背包现在使用主色调 – 之前放置的 Oraxen 背包主体 baked(固化)了该层级的默认主色调(例如 Emerald 背包保持绿色),而忽略了所选颜色。现在背包主体纹理支持染色(
tintindex 0 + 中性底色),因此放置后的背包主体会采用你的主色调,而强调色变体仍用于着色边框/侧面部分。(资源包变更 – 更新后请运行 /oraxen reload。)
? v1.0.8
- ? 染色时强调色现在会更新 – 对背包进行染色(或执行
/bp color)之前仅重新着色主色调和描述文本,但保留了旧的 Oraxen 强调色模型,导致强调色保持之前的颜色。现在物品已完全刷新,强调色纹理也会切换为新颜色。
- ? 现有背包得到更新 – 打开背包现在还会刷新玩家携带的所有其他背包,从而使之前染色的背包获取修正后的强调色模型(除了加入时的现有刷新机制外)。
? v1.0.7
- ? 成就聊天广播修复 – 解锁成就现在会在聊天栏可靠地显示。在此版本中,以编程方式授予进度仅触发通知提示(toast),而未发送聊天行,因此现在由插件本身发送广播(受
achievements.broadcast 配置项控制,默认开启)。
? v1.0.6
- ?️ MC 26.x 的标签页背景已修复 – 较新版本通过纹理 ID 约定解析背景(客户端会自动添加
textures/ + .png)。即使使用经典完整路径,在这些版本中也会渲染为缺失纹理。现在默认使用确保有效的 minecraft:block/dirt。可通过 achievements.background 更改(如 block/stone、block/netherrack… 或 none 表示无背景)。
? v1.0.5
- ?️ 标签页背景可配置 + 新纹理格式 – 如果显示为缺失纹理,可以在不发布新版本的情况下在配置文件中更改它。
- ? 聊天广播默认开启 – 解锁的成就现在默认会在聊天栏中宣布(
achievements.broadcast: true,遵循 announceAdvancements 游戏内规则)。
- ? 更美观的菜单 – 成就现在被链接成主题分支(层级、自定义、放置、升级、工作站),而不是一个长长的列;层级成就使用“目标”框架,高难度成就使用“挑战”框架。
? v1.0.4
- ?️ 将标签页背景切换为专用的进度背景纹理。
- ? 标签页及所有成就可见 – (不可见的)根节点会在玩家加入时授予给每位玩家,以便显示成就标签页并展示所有成就(获得前呈灰色显示)。
? v1.0.3
- ?️ 进度数据包修复 – 成就标签页的
background 字段必须是字符串;否则进度将无法加载(报错:Not a string: {...})。现在标签页和所有成就均可正常加载。
✨ v1.0.2
- ? 成就现在是真正的 Minecraft 进度 – 它们不再作为自定义命令/菜单出现,而是以自己的标签页("yourShika Backpack's")形式出现在正常的进度界面中(通知提示和进度由原版处理)。插件自动生成一个小数据包并在首次启动时加载。仍可通过
achievements.enabled / broadcast / disabled 进行配置。
- ? 移除了
/bp achievements 命令(已被原生集成替代)。
✨ v1.0.1
- ? 成就 – 28 个成就(标题、描述、图标)。解锁时会给予消息和音效,可选服务器全服公告。完全可配置。
- ? 拾取音效 – “拾取”升级在真空吸取物品时会播放拾取音效。
- ? 磁铁 现在从方块上方吸取物品,而不是将其拖入地下(稍微抬起,物品不会再消失)。
- ?️ 压缩配方重做 – 此前与铁质升级冲突;现在由活塞 + 铁块合成(区分度高且稍难制作)。
- ? 永恒升级更昂贵 – 现在需要下界之星(凋灵掉落)+ 下界合金 + 黑曜石。
- ? 铁砧保护 – 升级物品(皮革升级、层级升级和功能升级)无法再在铁砧中重命名。
? v1.0.0 – 首个稳定版本
第一个官方里程碑。包含 0.x 系列的所有功能 – 层级与升级链、可染色背包、带全息图的放置背包、功能性升级(拾取、磁铁、锻造/熔炉/切石机、便携式熔炉/烟熏炉/高炉后台运行、带过滤器的压缩、末影链接、垃圾桶、召回、永恒、经验存储)、防复制存储、Oraxen 资产(包括放置背包的 3D 模型),以及多语言支持(英/德/波兰语)。
- ? 经验存储升级 现在拥有与其风格匹配的专属物品资产(经验瓶)供 Oraxen 使用。
- ?️ 层级升级保留名称 – 在锻造台上升级时,自定义背包名称(包括颜色)会被保留。
- ✅ 最终审查:资产、代码和配方已检查;CI 模型检查通过。
✨ v0.9.1
- ? 全息图名称正确渲染 – 带有渐变/十六进制/颜色代码名称的放置背包现在能正确显示名称(而不再显示类似 "<#aabbcc>…" 的代码)。
- ? 新的经验存储升级 – 将你的经验值存储在背包中,并可随时提取。控制面板上有专用按钮和 GUI(存款/取款,1 级或全部),并有实时显示的存储经验值。
✨ v0.9.0
- ?️ 铁砧重命名 – 背包可以直接在铁砧中重命名,
支持全彩显示:十六进制色值(
&#RRGGBB / <#RRGGBB>)、
渐变/彩虹色(<gradient:#a:#b>…)以及 Minecraft 颜色代码(&a, &l …)。
- ? 放置后名称保留 – 放置后再拾起的背包不再丢失自定义名称(名称存储在服务器端)。
- ? 便携熔炉后台运行 – 冶炼站即使在菜单关闭时也能继续工作。背包中的熔炉图标会显示
实时更新的描述信息:正在冶炼的物品、燃料类型/数量以及总共将冶炼多少物品。
- ? 压缩聊天消息 – 关闭背包时会报告压缩了哪些物品(例如“3x 钻石块”)。
- ?
/bp recall 菜单现在显示每个已放置背包的所有者。
- ?️ 垃圾桶保护背包 – 背包(包括位于潜影盒/聚拢袋内的)不再能放入垃圾桶。
- ?️ 站点上限 – 每个背包最多容纳 5 个站点升级,以确保控制栏中的所有图标保持可见且不互相遮挡。
✨ v0.8.0
命令与管理
- ?️
/bp rename <name|reset> – 重命名背包(配置项 rename.allow-players,管理员始终允许)
- ?️ 可点击的
/bp list – [Open] [Copy] [TP]
- ?
/bp locate [player|ID] + /bp goto <ID> – 定位已放置的背包并传送至其位置
- ?
/bp transfer <ID> <player> – 更改所有者
- ?
/bp recall 在你拥有多个背包时打开选择菜单(否则直接召回)
- ?
/bp assets <status|redeploy> & /bp doctor(诊断工具)
- ? 管理员审计日志 (
audit.log):记录给予/打开/转移/召回/拾取操作
- ? 更多 PlaceholderAPI 变量:
placed、used_slots、free_slots、tiers、count_<tier>
图形用户界面 (GUI)
- ? 信息物品显示已用/剩余槽位
- ⏮️ Shift+点击分页箭头可跳转到第一页/最后一页
已放置的背包
- ? 旋转以面向玩家;可选的全息投影(名称 + 所有者);放置/拾取时的粒子效果与音效
升级模块
- ?️ 带删除确认的垃圾桶 (
trash.confirm) – 未点击确认即关闭会将物品退回
- ? 压缩预览(聊天栏)+ 预设方案(矿石/农场/红石/其他)
- ? 磁力吸引:限制以防止卡顿 + 尊重物品所有者与拾取延迟
鲁棒性与持续集成 (CI)
- ?️ 深层嵌套保护:检测到背包位于潜影盒/聚拢袋内时予以阻止
- ♻️ 自动恢复:页面切换时保存 + 崩溃检测
- ✅ 配方验证:提供清晰的配置错误提示
- ? CI 资产检查:防止 Oraxen 模型中出现单面纹理
✨ v0.7.2 (已放置背包几何结构)
- ? 已放置的 Oraxen 背包现在使用真实的立方体几何结构来渲染 flap(翻盖)、pocket(口袋)、
side pouches(侧袋)、straps(肩带)和 buckle(搭扣),而不再是单面贴图,因此从某些视角观看时不再消失。
- ? Oraxen 资产包版本提升至第 6 版,以便自动更新受管理的模型文件,同时确保由部署者控制的自定义服务器资产不受影响。
✨ v0.7.1 (便携站点、过滤器、可配置配方)
- ? 加入/更新时物品自动同步: 当玩家加入服务器(及重载插件)时,现有的背包和升级物品会被更新至最新状态,确保插件更新后不会出现数据损坏或视觉陈旧的问题。
- ? 便携熔炉 / 高炉 / 烟熏炉: “冶炼/灼烧/烟熏”升级现在添加了一个GUI 站点(背包中的图标),其运作方式如同真正的熔炉。状态保存在背包内——登出、崩溃或服务器停止都不会导致物品丢失,且进度得以保留。每个背包仅限一个熔炉类升级。
- ? 压缩过滤器: “压缩”升级增加了一个过滤器 GUI(背包中的图标),你可以在其中选择关闭背包时哪些物品会被压缩(留空表示全部压缩)。
- ? 升级槽仅接受功能升级 – “升级皮革”和等级升级(铁级、下界合金级升级等)不再能放置在此处。
- ? 升级按钮移至背包菜单的左下角。
- ?️ 可配置配方: 功能升级配方(包括高级 ➜ 需要基础升级的规则)、等级升级的合成形状以及锻造台
配方(模板材料、下界合金基础/附加材料)均可在
config.yml 中进行编辑(配置文件版本 7,支持自动迁移)。
- ?
/bp info: 配方箭头现在仅为 → / ↓;高级升级显示所需的基础升级作为 X 材料。
? v0.6.1
- 马铠方块加固: 背包不能再通过交互、物品栏或发射器放置在任何坐骑上——包括马、僵尸/骷髅马、驴、骡子、羊驼、骆驼。
- 冶炼状态显示在背包的信息物品中:剩余需冶炼的数量、燃料可冶炼的物品数以及预估时间。
- 背包信息物品现在为英文。
✨ v0.6.0 (更多升级、语言支持、/bp give all)
- ? 语言支持: 内置英语、德语、波兰语(
messages_en/de/pl.yml)。
消息文件在插件更新时自动同步(新增键值会自动合并,你的修改会被保留)。
- ?
/bp give 现在给予全部内容 – 背包、升级皮革、等级升级(upgrade_copper …)以及所有功能升级(pickup, magnet …)。
- ? 新功能升级: 末影链接、压缩、冶炼/灼烧/烟熏、召回、垃圾桶。
- ? 高级升级需要其基础升级才能合成(例如高级拾取升级需要一个拾取升级)。
- ? 移除了 PacketEvents – 放置操作使用原版的显示实体,从未需要过它。
- ?️ Oraxen 纹理现在为所有物品部署(与备份解耦)。
✨ v0.5.0 (英语支持 + 功能升级)
- ? 插件默认改为英文(
language: en, messages_en.yml)。
- ? 功能性升级模块:你可以通过合成制作并安装到背包中的功能模块,包括拾取/高级拾取、磁铁/高级磁铁、合成台/切石机/锻造台、永恒。每个模块都有合理的配方(
'U' = 皮革升级),并在 /bp info 中显示。
- ?
/bp info 完全支持英文;锻造视图经过重新设计。
- ?️ 配置文件版本 5(自动迁移;旧文件已备份)。
? v0.4.0(稳定性与模块)
- 类原版 Oraxen 默认设置: 背包纹理使用内置参考图作为样式基础。所有包 PNG 均为 64x64 像素,由真实的 16x16 像素艺术放大而来。
- 切换模块时不再卡顿或崩溃。 配方现在以幂等方式注册,且在切换模块时不会被修改。
- 禁用 Oraxen 后恢复为普通马铠。 禁用 Oraxen 模块会干净地移除自定义模型;启用时会在线更新玩家的背包。
- 模块/信息 GUI: 物品无法再被取出或移动。
/bp info: 更清晰地展示锻造配方,并配有英文槽位标签。
✨ v0.3.5
- ? 真正的次要强调色:通过 Oraxen 变体实现(例如
ysbp_leather_backpack_accent_red)。主色调仍保持使用真实的 LEATHER_HORSE_ARMOR 着色。
- ? Oraxen YAML 配置包含 178 个唯一的 provider/CustomModelData 值。
- ? 带版本控制的资源部署器: 更新旧的默认资源,并在
AssetBackups/ 下创建备份。
- ? Oraxen 物品 YAML 在覆盖前会进行备份。
- ⚒️ 锻造修复: 层级和颜色在
SmithItemEvent 事件中写入,而不是在预览阶段。
✨ v0.3.0
- ?️ 集成 Oraxen 纹理: 当 Oraxen 模块处于激活状态时,插件会自动附带纹理及物品定义。只需执行
/oraxen reload。
- ?
/bp info – 配方浏览器: 一个包含所有背包和升级物品的 GUI;点击物品可查看其合成/锻造配方。
- ? 现有背包的自动更新: 每次打开时,名称、描述和模型都会更新至最新版本——不会更改 ID、颜色、所有者或内容。
- ? 防止升级物品滥用: 皮革升级和层级升级只能用于背包配方中。
- ? 移除了重复的颜色显示;优化了名称和描述。
- ? 染色功能现在可以可靠地获取结果。
? v0.2.2
- 修复颜色 bug: 染色后的背包在放置并捡起后仍能保持颜色(之前会恢复为默认色)。
- 升级颜色: 升级时默认颜色会提升至新层级,单独染色的背包保留其原有颜色。
- 钩子自动开启: 外部钩子会在相应插件安装后自动激活。
- 所有者: 每个背包都记录是谁合成的它。可选设置
security.owner-only: true → 仅所有者(或管理员)可以打开/捡起。默认关闭。
- 升级物品已准备好支持自定义纹理: CustomModelData(2000–2006)以及每个升级项目可选的
item_model,均可配置。
- 下界合金升级在锻造台中制作。
? v0.2.1(Bug 修复)
- 配置文件自动更新: 结构发生变化时,
config.yml 会自动更新自身(旧文件备份为 config-backup-*.yml)。
- 只有皮革可以直接合成——所有更高层级均来自升级链(锻造)。
- ID 在合成后立即出现在描述中。
- 下界合金升级现在在锻造台中制作。
- 皮革升级会被拒绝放入升级模板槽位。
- 染色: 结果现在可以可靠地取出(进入玩家物品栏)。
? v0.2.0
- ? 安全存储更新(必须): 内容以带版本控制的 Paper 字节格式存储(包含 Minecraft 数据版本 + DataFixer)。物品——包括任意自定义 NBT/组件——在服务器和插件更新后保持完整无损。
- ? 升级链: 皮革 → 铜 → 铁 → 金 → 钻石 → 绿宝石 → 下界合金。锻造台升级保留 ID、内容和颜色。
- ? 升级 GUI: 每个背包专用的库存界面(背包 GUI 中的按钮)。
- ? 在合成台中染色: 背包置于中央,染料放在左列 = 主色调,右列 = 辅助色调(混合为 hex 十六进制色值)。
- ? 可放置的背包: Shift+右键点击地面放置(ItemDisplay + Interaction),右键打开,潜行+右键捡起。
- ? 保护机制: 背包不能用作马铠,也不能被漏斗/自动化装置移动。
- ?
/bp update: 从 GitHub 下载最新的发布 JAR 包。
- ? 模块 GUI:
/bp modules 允许通过点击实时切换钩子。
- ? 配方书 + JEI/REI/EMI: 所有真实配方均已解锁并可见。
- ➖ 自定义物品钩子: 仅支持 Oraxen(Nexo 和 ItemsAdder 已移除)。
? Minecraft/Paper 版本要求
- 目标平台: Paper(也兼容 Spigot,但 MiniMessage 视觉效果可能受限)
- 基于以下版本构建:
io.papermc.paper:paper-api:26.2.build.62-beta
- 运行于: Paper 26.1.2 – 26.2 (
api-version: '26.1.2'; 未使用任何仅限 26.2 的 API)
- Java: 需要 Java 25(Minecraft 26.x 需要 Java 25,Microsoft OpenJDK 25)
- 版本号方案: 由于新的
YY.D.H 方案,Paper API 使用 <version>.build.<n>-<stage> 替代 -R0.1-SNAPSHOT。目标版本可通过 pom.xml 中的 paper.version 属性轻松更改。
✨ 功能特性
- ✅ 背包作为普通物品,拥有唯一的、防伪造的 ID(PDC)
- ✅ 每个背包拥有独立的库存 – 外观相同,但内容不同
- ✅ 持久化存储(SQLite 或 YAML)
- ✅ 安全的 GUI,具备全面的防复制/防丢失保护
- ✅ 双箱布局(54 个槽位) – 仅启用的字段可用
- ✅ 更高级别的背包 = 更多空间,超出单页容量时自动分页
- ✅ 6 种背包等级(皮革、铜、铁、金、钻石、下界合金)+ 绿宝石
- ✅ 真正可染色,通过可染色的皮革物品实现(支持 DyeColor 或十六进制
#RRGGBB)–
颜色即使在没有资源包的情况下也能显示
- ✅ 合成配方(可配置,可选择启用/禁用)
- ✅ 右键点击打开(主手和副手均可)以及通过命令打开
- ✅ 管理员给予命令和通过 ID 打开
- ✅ CustomModelData + 每个等级的
item_model 组件 – 为资源包做好准备
- ✅ 模块化钩子系统 – 通过
/bp modules 查看实时状态
- ✅ 可配置的消息(MiniMessage +
& 代码),内置 EN/DE/PL 语言文件
- ✅ 防止背包套背包的保护
- ❌ 无需 Vault(已故意移除)
?️ 安装
- 从 Releases 下载插件 JAR 文件
(
yourShika-Backpacks-1.3.2.jar)。
- 将其放入 Paper 26.1.2 – 26.2 (Java 25) 服务器的
plugins/ 文件夹中。
- 启动服务器 – 数据文件夹
plugins/yourShika Backpack's/ 将自动创建,
包含 config.yml、消息文件和数据库。
- 可选:调整
config.yml 并运行 /bp reload。
⌨️ 命令
主命令:/backpack · 别名:/bp, /ybackpack, /ysbackpack
| 命令 |
描述 |
/bp help |
显示帮助信息 |
/bp open |
打开你手中的背包 |
/bp info |
在 GUI 中查看背包、升级项和配方 |
/bp list [player] |
列出背包(可点击:打开/复制/传送) |
/bp rename <name|reset> |
重命名你手中的背包 |
/bp recall |
召回已放置的背包(需要 Recall 升级;多个时提供选择菜单) |
/bp locate [player|ID] |
显示已放置背包的坐标 |
/bp goto <ID> |
传送到已放置的背包 |
/bp transfer <ID> <player> |
更改背包的所有者(管理员) |
/bp color <color> [accent] |
给背包染色(DyeColor 名称 或 #RRGGBB)— 管理员 |
/bp give <player> <tier> [amount] [color] [accent] |
给予一个背包(管理员) |
/bp openid <ID> |
通过 ID 打开背包(管理员) |
/bp modules |
通过 GUI 切换外部模块(管理员) |
/bp assets <status|redeploy> |
检查 / 重新部署 Oraxen 资产(管理员) |
/bp doctor |
诊断(Oraxen, config, DB, assets, versions)(管理员) |
/bp stats |
背包统计信息:总数、已放置数量、各等级数量、存储大小(管理员) |
/bp purge [dry|confirm] |
删除空的、孤立的背包数据 — 安全操作,非空数据不受影响(管理员) |
/bp update |
从 GitHub 下载最新版本(管理员,需要重启) |
/bp reload |
重新加载配置(管理员) |
/bp version |
插件信息 |
玩家染色通过合成台完成(见下文);
/bp color 命令被特意设计为管理员功能。
成就是真正的 Minecraft 进度,并在进度屏幕中显示为单独的标签页 — 没有对应的命令。
? 权限
| 权限 |
描述 |
默认值 |
yourshika.backpack.use |
使用背包 |
所有人 |
yourshika.backpack.open |
打开自己的背包 |
所有人 |
yourshika.backpack.list |
列出自己的背包 |
所有人 |
yourshika.backpack.place |
放置/拾取背包 |
所有人 |
yourshika.backpack.rename |
重命名背包 |
所有人 |
yourshika.backpack.craft.<tier> |
合成特定等级的背包 |
所有人 |
yourshika.backpack.admin.color |
通过命令给背包染色 |
OP |
yourshika.backpack.admin.give |
给予背包 |
OP |
yourshika.backpack.admin.openid |
通过 ID 打开背包 |
OP |
yourshika.backpack.admin.openother |
打开他人的背包 |
OP |
yourshika.backpack.admin.listother |
列出他人的背包 |
OP |
yourshika.backpack.admin.modules |
打开/切换模块 GUI |
OP |
yourshika.backpack.admin.update |
自更新器 |
OP |
yourshika.backpack.admin.reload |
重新加载 |
OP |
yourshika.backpack.admin.debug |
调试模式 |
OP |
? 背包、等级、大小与分页
每个背包都以双箱(54 个槽位)的形式打开。底行(9 个槽位)是控制栏(分页、信息、升级项)。剩余的 45 个槽位中,只有与等级允许的数量相匹配的槽位会被启用 – 其余槽位处于锁定状态。超过 45 个存储槽位的等级会自动分页(◀ / ▶)。
| 等级 |
存储槽位 |
页数* |
升级槽位 |
CustomModelData |
| 皮革 |
9 |
1 |
1 |
1001 |
| 铜 |
18 |
1 |
2 |
1002 |
| 铁 |
27 |
1 |
3 |
1003 |
| 金 |
45 |
1 |
4 |
1004 |
| 钻石 |
54 |
2 |
5 |
1005 |
| 绿宝石 |
81 |
2 |
6 |
1006 |
| 下界合金 |
108 |
3 |
6 |
1007 |
* 每页最多 45 个可用槽位(gui.storage-slots-per-page)。
升级槽位可通过背包 GUI 中的 Upgrades 按钮作为独立库存使用。
身份与安全
每个背包都将其 ID、等级和颜色存储在 PersistentDataContainer 中 – 而不是存储在名称或描述中。这使得背包无法通过重命名来伪造。
内容永远不会存储在物品本身中,而是服务器端绑定到 ID。这是防复制保护的核心:复制出的物品共享相同的库存。在分页时,只有可见页面会在库存和缓冲区之间同步 – 操作保持原子性且防复制。
颜色(真正可染色)
背包默认基于可染色的皮革物品(LEATHER_HORSE_ARMOR)。主色调会真实地改变物品外观 – 即使在没有资源包的情况下也能看到 – 并且可以通过 /bp color 进行更改。DyeColor 名称(BROWN, CYAN, …)和十六进制值(#A0703C)均被允许。
? CustomModelData、item_model 和资源包
- 每个等级都有各自的 CustomModelData(1001–1007),并且可以选择设置一个
现代的
item_model 组件(item-model: "namespace:path")。
- 没有资源包时,背包作为正常的(可染色的)皮革物品运作。
- 有资源包时,它们看起来像自定义物品。
- 外部物品系统(Oraxen)是可选的。默认始终使用内置的原版提供程序。
Oraxen 资源
在 src/main/resources/oraxen/ 下有一个现成的 Oraxen 捆绑包,包含所有背包等级、等级升级物品以及许多准备好的功能升级项的 64x64
原版风格 PNG 图片。真实的背包仍然通过插件合成、锻造或
/bp give 命令创建,以保留 ID、内容、所有者和颜色。
? 合成、升级链与染色
只有皮革背包是直接合成的(8× 皮革围绕一个 箱子)。
所有更高等级都来自锻造台中的升级链。刚合成的背包会在描述中立即显示其 ID。
升级链 — 皮革 → 铜 → 铁 → 金 → 钻石 → 绿宝石 → 下界合金:
- 合成 升级用皮革:1× 皮革(中心)+ 4× 线(工作台)。
- 合成一个等级升级物品:升级用皮革 + 8× 等级材料(例如铜)→
铜升级(工作台)。下界合金升级:锻造台 – 升级用皮革(模板)+ 下界合金锭(基座)+ 线(附加)。
- 在锻造台中升级: 普通皮革(模板)+ 上一个等级的背包(基座)+ 等级升级物品(附加)→ 下一个等级的背包。
ID、内容和颜色保持不变。
染色(工作台): 背包放在中间列,染料放在左列 = 主色,右列 = 点缀色。列内的位置无关紧要;多种染料混合成一个 十六进制颜色值。背包内容完全保留。
实际的配方会出现在 配方书 以及 JEI/REI/EMI 中。
位置无关的染色不是固定配方,因此不会列出在那里。
? 存储
- SQLite(默认,推荐)→
backpacks.db
- YAML(替代方案)→
backpacks.yml
在关闭、页面切换、登出、插件禁用、服务器停止以及通过自动保存进行保存。
更新安全(必须): 内容以带版本号的 Paper 字节格式(serializeAsBytes)存储——包括 Minecraft 数据版本号。加载时 DataFixer 会自动迁移到当前版本,因此带有任意自定义 NBT/组件的物品在更新后不会丢失或损坏。
? 外部模块 / 钩子(自动)
该插件完全独立运行。外部钩子被封装为模块,并在安装了相应插件且配置中启用了该模块时自动激活(默认:启用)。如果缺少该插件,模块将保持静默未激活状态。
通过 GUI 查看实时状态及切换:/bp modules。
| 模块 |
用途 |
默认值 |
| PlaceholderAPI |
%ysbp_count%, %ysbp_highest_tier%, %ysbp_open% … |
自动 |
| Oraxen |
自定义模型/纹理 |
自动 |
自定义物品: 仅支持 Oraxen 作为自定义物品钩子(免费使用,成熟 API)。Nexo 和 ItemsAdder 已被有意移除。
故意不支持 Vault。
禁用单个模块(示例):
hooks:
modules:
oraxen: false
?️ 路线图
- 更多功能升级效果(虚空、过滤、堆叠、 inception …)—— 升级槽位和物品已经存在。
- 自有资源包 + 更深入的 Oraxen 集成。
- 背包嵌套背包 仅通过计划的 Inception 升级实现(有限制和防复制保护)。
? 构建说明
要求:JDK 25 和 Maven。
mvn clean package
完成的插件位于:
target/yourShika-Backpacks-1.3.2.jar
目标 Paper 版本可以通过 pom.xml 中的 paper.version 属性进行调整。
? 许可证
根据 MIT License 发布。
灵感来源于 Sophisticated Backpacks —— 但这是一个独立的实现,没有任何采用的代码、资产或纹理。
yourShika Backpack's
⚠️ Disclaimer: This project — its code and its project artwork — was created with the help of AI. The plugin itself is tested by real people, and bugs and issues are actively fixed.
A standalone, fully server-side backpack system for Paper/Spigot.
Players need no client mod.
? Description
yourShika Backpack's brings high-quality, dyeable backpacks with their own
inventories to your survival server – safe against dupe bugs, persistently stored
and prepared for custom textures.
The plugin is inspired by Sophisticated Backpacks
(GitHub), but is a
completely standalone re-implementation. No code, no asset and no texture
was taken from the mod. This is not a Forge/Fabric/NeoForge mod, but a
Paper/Spigot plugin.
? v1.3.2
- ? Magnet pull fixed – two annoyances gone:
- Items no longer fly up over your head. The pull previously forced a constant
upward boost and aimed at hip height; it now targets your chest (the pickup
centre) and only lifts items that are clearly below you.
- Items you couldn't pick up are fixed. When an item got close the magnet used
to stop pulling and leave its leftover upward momentum, so it drifted past you;
it now dampens the item into the pickup box so vanilla collection grabs it
reliably.
?️ v1.3.1
- ? Compacting filter no longer resets on rejoin – the filter now stores an
independent copy of its sample items instead of live inventory references. With
the async write-behind cache (v1.2.0), those references could go stale before the
delayed save, so the filter serialized empty and looked cleared after a relog. The
same hardening applies to the Pickup filter.
- ? Compacting on/off toggle – each backpack's Compacting upgrade now has an
ON/OFF switch in its filter menu. When OFF, items are no longer compacted into
blocks on close. The state is saved per backpack.
? v1.3.0
- ? Minecraft / Paper 26.2 support – the plugin is now built against
paper-api:26.2.build.62-beta and runs on Paper 26.1.2 – 26.2. No API
breakage was needed: 26.2 still targets Java 25, and no 26.2-exclusive API
is used, so the same jar works on both.
- ?️
api-version updated to '26.1.2' – the old '1.21' declaration
predates the new YY.D.H versioning scheme. api-version is the minimum
server version, so 26.1.2 keeps 26.1.2 servers working while correctly
declaring modern-scheme compatibility.
- ? Anvil rename future-proofed – switched from the deprecated
AnvilInventory#getRenameText() (marked for removal) to AnvilView#getRenameText().
The build is now warning-free.
Note: Paper 26.2 currently only publishes alpha/beta builds (latest
26.2.build.62-beta); there is no -stable 26.2 build yet. The API surface this
plugin uses is unaffected.
?️ v1.2.3
- ?️ Restock & Feeding upgrades use their prepared Oraxen textures – in v1.2.0
these two new upgrades were bound to made-up model IDs that collided with other
items, so with Oraxen active they showed the wrong texture. They now bind to the
bundled assets
ysbp_upgrade_restock (restock.png, CMD 2110) and
ysbp_upgrade_feeding (feeding.png, CMD 2137). The Auto-Restock upgrade is now
simply called Restock. (config-version 11; fresh/merged configs pick this up —
a test server from v1.2.0–1.2.2 should delete its config.yml to regenerate, or set
feeding CMD 2137 / rename auto_restock→restock by hand.)
?? v1.2.2
- ?? Polish translation completed – the Polish locale was missing 25 keys
(whole
rename, transfer, locate, assets, doctor, trash sections plus
some help/error entries) that fell back to English. All three bundled locales
(en, de, pl) are now at full key parity (102/102) – no more English
fallback for Polish players.
? v1.2.1
- ? All languages ready via config –
en, de and pl are now all extracted
to the data folder on startup, so you can switch language: to any of them and
edit any messages_<lang>.yml directly (previously only the active language and
English were written out).
- ?️ Translations survive updates – on every start each bundled language file is
merged: new message keys are added while your own edits are kept untouched, so
upgrading the plugin never loses or overwrites your translations. Add your own
language by creating
messages_<code>.yml and setting language: to that code.
✨ v1.2.0
New features & QoL
- ⚡ Async storage cache – backpack data now lives in an in-memory cache with
asynchronous, batched write-behind. Reads (open, page-flip, pickup, furnace
ticks,
%ysbp_*% placeholders) no longer hit the disk on the main thread, and
writes are bundled off-thread. A full flush always runs on a clean shutdown.
Tune the interval with storage.flush-seconds (default 5).
- ? Config merge on update – updating to a new config version now keeps your
own settings and only adds the new keys/comments (a timestamped backup is still
written), instead of overwriting the whole file.
- ? Auto-Restock Upgrade (new) – when a hotbar/inventory stack runs out, it is
refilled from the backpack with the same item. Craft with Comparators + Chests
around Upgrade Leather.
- ? Feeding Upgrade (new) – automatically eats food from the backpack when you
get hungry (with an eat sound). Craft with Hay Bales + Bread around Upgrade Leather.
- ? Quick-Stack – Shift-click the Info button to sweep all matching items from
your inventory into the backpack. (Normal click still sorts.)
- ? Shift-click fills all pages – shift-clicking items in now spreads them across
every page of a multi-page backpack, not just the visible one.
- ? Last page remembered – a multi-page backpack reopens on the page you last used.
- ?
/bp stats – total / placed / per-tier backpack counts and storage size.
- ?
/bp purge [dry|confirm] – safely removes empty, orphaned backpack data
(destroyed or churned empties). Non-empty data is never touched, so nothing an
offline player still holds can be lost.
Bug fixes & hardening
- ? Soulbound dupe fixed – a backpack no longer duplicates when another plugin sets
keepInventory after the death event starts; give-back is now loss-safe on disconnect.
- ? Off-hand swap (F) can no longer sneak a backpack into a mount inventory.
- ? Creative protection now covers every sub-GUI (Upgrade / Furnace / Filter / Trash / XP).
- ? Corruption resilience – a single broken item no longer aborts loading the whole
backpack; per-slot recovery keeps the rest.
- ? Deeper nesting check,
/bp list [Open] works for owners, recipe/achievement
edits apply on /bp reload, and assorted null-safety fixes.
? v1.1.3
- ? Magnet chat messages fixed –
/bp magnet on|off (and the no-argument
toggle) now correctly shows the “Magnet enabled/disabled” confirmation
instead of a “Missing message: magnet.on / magnet.off” error. Cause: on
and off are reserved YAML booleans, so the keys were parsed as
magnet.true / magnet.false and never resolved. The keys are now quoted in
all message files (messages_de/en/pl.yml), so the fix applies to every
language – deleting a message file is not required.
✨ v1.1.2
- ? Magnet toggle – switch the magnet pull on/off per player with
/bp magnet on|off (no argument toggles). A short chat message confirms the
new state; the setting also gates the Advanced Pickup vacuum.
- ? One Magnet / one Pickup backpack at a time – you can own many backpacks
with these upgrades, but only one Magnet backpack and one Pickup backpack may be
active in your inventory. Carrying more auto-disables that upgrade (dupe/behaviour
safety) until only one remains, with a throttled action-bar notice.
- ? Pickup filter – the Pickup upgrade now has a filter menu (like the
Compacting filter). Only the items you place there are pulled straight into the
backpack. Matching is NBT-exact, so custom items / custom NBT can be
whitelisted precisely. An empty filter picks up everything. Open it from the
Pickup Filter button in the backpack menu.
? v1.1.1
- ? Textures update after
/oraxen reload – after redeploying assets and
reloading Oraxen, freshly added/changed textures didn't apply to crafted, given
or /bp info items (the plugin still served its cached item models) until you
toggled the module off and on. The plugin now listens for Oraxen's reload event
and auto-resyncs its canonical items, carried backpacks and placed models, so
new textures apply immediately – no module toggle needed.
- ? Placed models follow the module state – disabling the Oraxen module (or
removing Oraxen entirely) left placed backpack 3D models in the world, which would
show missing textures once Oraxen is gone. Placed models now fall back to the
vanilla look when the hook is off – updated on toggle/reload for loaded ones and
automatically when their chunks load.
✨ v1.1.0
- ? Soulbound Upgrade (new) – a new functional upgrade with its own Oraxen
texture. A backpack with this upgrade stays with you when you die instead of
dropping, and you keep it after respawn. It is dupe-safe next to grave/deadbody
plugins: the death handler runs at
LOWEST priority and removes soulbound
backpacks from the death drops before grave plugins read them, and the backpack
content lives server-side by ID (so even a stray copy shares the same storage).
Craft it with a Totem of Undying + Soul Soil around Upgrade Leather.
- ? Carried backpack now uses your colors – the carried/held Oraxen backpack
baked the tier color into its overlay layer (e.g. an Emerald backpack stayed
green and dyeing the accent didn't fully show). The overlay is now neutral
(tier-independent), so the body takes your main color (dyeable base) and the
accent variant colors the straps/pockets – the same fix v1.0.9 shipped for placed
backpacks. (Resource-pack change – run
/oraxen reload after updating; existing
backpacks refresh automatically on open/join.)
? v1.0.9
- ? Placed backpack now uses the main color – the body of a placed Oraxen
backpack had the tier's default main color baked in (e.g. an Emerald backpack
stayed green) regardless of the chosen color. The body texture is now dyeable
(
tintindex 0 + neutral base), so the placed backpack body takes your main
color while the accent variant still colors the frame/side parts. (Resource-
pack change – run /oraxen reload after updating.)
? v1.0.8
- ? Accent color now updates when dyeing – dyeing a backpack (or
/bp color)
only re-tinted the main color and lore but kept the old Oraxen accent model, so
the accent stayed at its previous color. The item is now fully refreshed so the
accent texture switches to the new color too.
- ? Existing backpacks get updated – opening a backpack now also refreshes all
other backpacks carried by the player, so previously dyed backpacks pull the
corrected accent model (in addition to the existing refresh on join).
? v1.0.7
- ? Achievement chat broadcast fixed – unlocks are now announced in chat
reliably. Programmatically awarding an advancement only fired the toast (not the
chat line) on this version, so the broadcast is now sent by the plugin itself
(gated by
achievements.broadcast, default on).
? v1.0.6
- ?️ Tab background fixed for MC 26.x – newer versions resolve the background
via the texture-id convention (the client adds
textures/ + .png). Even the
classic full path renders as a missing texture there. The default is now the
guaranteed minecraft:block/dirt. Changeable via achievements.background
(block/stone, block/netherrack, … or none for no background).
? v1.0.5
- ?️ Tab background configurable + new texture format – it can be changed in
the config without a new release if it shows up as missing texture.
- ? Chat broadcast on by default – unlocked achievements are now announced in
chat by default (
achievements.broadcast: true, respects the
announceAdvancements gamerule).
- ? Nicer menu – achievements are now chained into themed branches (tiers,
customization, placing, upgrades, stations) instead of one long column; tier
achievements use the "goal" frame, hard ones the "challenge" frame.
? v1.0.4
- ?️ Switched the tab background to a dedicated advancement background texture.
- ? Tab & all achievements visible – the (invisible) root is granted to every
player on join so the achievement tab appears and all achievements (greyed
out until earned) are shown.
? v1.0.3
- ?️ Advancement datapack fix – the
background field of the achievement tab
must be a string; otherwise the advancements failed to load (Not a string: {...}). The tab and all achievements load cleanly now.
✨ v1.0.2
- ? Achievements are now real Minecraft advancements – instead of a custom
command/menu they appear as their own tab ("yourShika Backpack's") in the
normal advancements screen (toast + progress handled by vanilla). The plugin
generates a small datapack automatically and loads it on first start. Still
configurable via
achievements.enabled / broadcast / disabled.
- ?
/bp achievements was removed (replaced by the native integration).
✨ v1.0.1
- ? Achievements – 28 achievements (title, description, icon). Unlocking gives
a message + sound, optional server-wide announcement. Fully configurable.
- ? Pickup sound – the Pickup upgrade plays a pickup sound when vacuuming items.
- ? Magnet now pulls items over blocks instead of dragging them into the
ground (a slight lift, nothing disappears anymore).
- ?️ Compacting recipe reworked – it collided with the Iron upgrade before; now
made from pistons + iron blocks (distinct and a bit harder).
- ? Everlasting more expensive – now needs a Nether Star (Wither) + netherite + obsidian.
- ? Anvil protection – upgrade items (Upgrade Leather, tier & function upgrades)
can no longer be renamed in an anvil.
? v1.0.0 – First stable release
The first official milestone. Contains all features of the 0.x line – tiers &
upgrade chain, dyeable backpacks, placeable backpacks with holograms, functional
upgrades (Pickup, Magnet, Crafting/Smithing/Stonecutter, portable
Furnace/Smoker/Blast Furnace with background operation, Compacting with filter,
Ender-Link, Trash, Recall, Everlasting, XP Storage), dupe-safe storage, Oraxen
assets incl. 3D models for placed backpacks, plus multi-language support (EN/DE/PL).
- ? The XP Storage upgrade now has its own, style-matching item asset
(experience bottle) for Oraxen.
- ?️ Tier upgrade keeps the name – a custom backpack name (incl. colors) is kept
when upgrading at the smithing table.
- ✅ Final review: assets, code and recipes checked; CI model check green.
✨ v0.9.1
- ? Hologram name rendered correctly – placed backpacks with gradient/hex/
color-code names now show the name properly (instead of e.g. "<#aabbcc>…").
- ? New XP Storage upgrade – store your experience in the backpack and
withdraw it any time. Own button in the control bar with a GUI
(deposit/withdraw, 1 level or all) and a live display of the stored XP.
✨ v0.9.0
- ?️ Rename in the anvil – backpacks can be renamed directly in an anvil,
with full color support: hex (
&#RRGGBB / <#RRGGBB>),
gradient/rainbow (<gradient:#a:#b>…) and Minecraft color codes (&a, &l …).
- ? Name persists when placed – a placed and then picked-up backpack no longer
loses its custom name (the name is stored server-side).
- ? Portable furnace runs in the background – smelting stations keep working
even when the menu is closed. The furnace icon in the backpack shows a
live-updating lore: what is being smelted, fuel type/amount and how many
items will be smelted in total.
- ? Compacting chat message – on close the backpack reports what was compacted
(e.g. "3x Diamond Block").
- ?
/bp recall menu now shows the owner of each placed backpack.
- ?️ Trash protects backpacks – backpacks (also inside shulkers/bundles) can no
longer be put into the trash.
- ?️ Station limit – at most 5 station upgrades fit per backpack so all icons
in the control bar stay visible and don't fight for space.
✨ v0.8.0
Commands & management
- ?️
/bp rename <name|reset> – rename backpacks (config rename.allow-players, admins always)
- ?️ Clickable
/bp list – [Open] [Copy] [TP]
- ?
/bp locate [player|ID] + /bp goto <ID> – locate placed backpacks & teleport to them
- ?
/bp transfer <ID> <player> – change owner
- ?
/bp recall opens a selection menu when you have several backpacks (otherwise direct)
- ?
/bp assets <status|redeploy> & /bp doctor (diagnostics)
- ? Admin audit log (
audit.log): give/openid/transfer/recall/pickup
- ? More PlaceholderAPI:
placed, used_slots, free_slots, tiers, count_<tier>
GUI
- ? Info item shows used/free slots
- ⏮️ Shift-click the paging arrows jumps to the first/last page
Placed backpacks
- ? Rotate to face the player; optional hologram (name + owner); particles + sound when placing/picking up
Upgrades
- ?️ Trash with delete confirmation (
trash.confirm) – closing without a click returns the items
- ? Compacting preview (chat) + presets (ores/farm/redstone/misc)
- ? Magnet: throttle against lag + respect for item owner & pickup delay
Robustness & CI
- ?️ Deep-nesting protection: backpacks in shulkers/bundles are detected & blocked
- ♻️ Auto-recovery: save on page change + crash detection
- ✅ Recipe validation with clear config error messages
- ? CI asset check: prevents one-sided faces in Oraxen models
✨ v0.7.2 (Placed Backpack Geometry)
- ? Placed Oraxen backpacks now use real cuboid geometry for flap, pocket,
side pouches, straps and buckle instead of one-sided faces, so they no longer
disappear from certain viewing angles.
- ? Oraxen asset bundle bumped to version 6 so managed model files update
automatically while custom server assets stay protected by the deployer.
✨ v0.7.1 (Portable Stations, Filter, configurable recipes)
- ? Items auto-update on join/update: existing backpacks and upgrade items are
brought to the latest state when a player joins (and on reload), so nothing
breaks or looks stale after a plugin update.
- ? Portable Furnace / Blast Furnace / Smoker: the Smelting/Blasting/Smoking
upgrade now adds a GUI station (icon in the backpack) that smelts like a real
furnace. State is saved in the backpack – logout, crash or server stop never
lose items, and progress persists. Only one furnace-type upgrade per backpack.
- ? Compacting Filter: the Compacting upgrade gets a filter GUI (icon in the
backpack) where you pick which items get compacted on close (empty = everything).
- ? Upgrade slots accept only function upgrades – Upgrade Leather and tier
upgrades (Iron-, Netherite-Upgrade …) can no longer be placed there.
- ? Upgrades button moved to the bottom-left corner of the backpack menu.
- ?️ Configurable recipes: function-upgrade recipes (incl. the advanced ➜ needs
its base upgrade rule), the tier-upgrade crafting shape and the Smithing
recipes (template material, Netherite base/addition) are all editable in
config.yml (config version 7, auto-migrates).
- ?
/bp info: recipe arrows are now just → / ↓; advanced upgrades show the
required base upgrade as the X ingredient.
? v0.6.1
- Horse-armor block hardened: a backpack can no longer be put on any
mount – horses, zombie/skeleton horses, donkeys, mules, llamas, camels –
via interaction, inventory, or dispenser.
- Smelting status is shown in the backpack's Info item: how much is left to
smelt, how many items the fuel can smelt, and an estimated time.
- Backpack Info item is now English.
✨ v0.6.0 (more upgrades, languages, /bp give all)
- ? Languages: bundled English, German, Polish (
messages_en/de/pl.yml).
Message files auto-update on plugin updates (new keys are merged in,
your edits are kept).
- ?
/bp give now gives everything – backpacks, Upgrade Leather, tier
upgrades (upgrade_copper …) and every function upgrade (pickup, magnet …).
- ? New functional upgrades: Ender-Link, Compacting, Smelting/Blasting/Smoking,
Recall, Trash.
- ? Advanced upgrades require their base to craft (e.g. Advanced Pickup needs
a Pickup Upgrade).
- ? PacketEvents removed – placement uses vanilla display entities and never
needed it.
- ?️ Oraxen textures now deploy for all items (decoupled from backups).
✨ v0.5.0 (English + Functional Upgrades)
- ? Plugin is now English by default (
language: en, messages_en.yml).
- ? Functional upgrades you craft and install into a backpack: Pickup/Advanced
Pickup, Magnet/Advanced Magnet, Crafting/Stonecutter/Smithing, Everlasting. Each
has a fair recipe (
'U' = Upgrade Leather) and appears in /bp info.
- ?
/bp info fully English; smithing view reworked.
- ?️ Config version 5 (auto-migrates; old file backed up).
? v0.4.0 (Stability & Modules)
- Vanilla-like Oraxen defaults: backpack textures use the bundled reference as
their style base. All pack PNGs are 64x64, upscaled from real 16x16 pixel art.
- No more freeze/crash when toggling modules. Recipes are now registered
idempotently and not touched when toggling.
- Oraxen off = back to normal horse armor. Disabling the Oraxen module removes
the custom model cleanly; enabling auto-updates online players' backpacks.
- Module/info GUIs: items can no longer be taken/moved.
/bp info: smithing recipes shown more clearly with English slot labels.
✨ v0.3.5
- ? Real second accent color via Oraxen variants (e.g.
ysbp_leather_backpack_accent_red). The main color stays real
LEATHER_HORSE_ARMOR tinting.
- ? Oraxen YAMLs with 178 unique provider/CustomModelData values.
- ? Versioned asset deployer: updates old defaults and creates backups under
AssetBackups/.
- ? Oraxen item YAMLs are backed up before overwriting.
- ⚒️ Smithing fix: tier & color are written on
SmithItemEvent, not in the preview.
✨ v0.3.0
- ?️ Oraxen textures integrated: when the Oraxen module is active, the plugin
ships bundled textures & item definitions automatically. Just
/oraxen reload.
- ?
/bp info – recipe browser: a GUI with all backpacks and upgrade items;
clicking an item shows its crafting/smithing recipe.
- ? Auto-update of existing backpacks: name, lore and model are brought up to
date on each open – without changing ID, color, owner or contents.
- ? Upgrade items abuse-proof: Upgrade Leather and tier upgrades can only
be used in the backpack recipes.
- ? Removed the duplicate color display; polished names & lore.
- ? Dyeing is reliably retrievable again.
? v0.2.2
- Color bug fixed: dyed backpacks keep their color even after placing &
picking up (previously reverted to default).
- Upgrade colors: default colors are raised to the new tier on upgrade,
individually dyed backpacks keep their color.
- Hooks auto-on: external hooks activate themselves once the respective plugin
is installed.
- Owner: every backpack remembers who crafted it. Optional
security.owner-only: true → only owner (or admins) may open/pick up. Default: off.
- Upgrade items prepared for custom textures: CustomModelData (2000–2006) and
optional
item_model per upgrade, configurable.
- Netherite upgrade is created in the smithing table.
? v0.2.1 (Bugfixes)
- Config auto-update: on structure changes
config.yml updates itself (old
file backed up as config-backup-*.yml).
- Only leather is directly craftable – all higher tiers come from the upgrade
chain (smithing).
- ID appears immediately in the lore on crafting.
- Netherite upgrade is now created in the smithing table.
- Upgrade Leather is rejected in the template slot of the upgrade.
- Dyeing: the result can now reliably be taken out (lands in the inventory).
? v0.2.0
- ? Update-safe storage (MUST): contents are stored in the versioned Paper byte
format (with Minecraft data version + DataFixer). Items – including arbitrary
custom NBT/components – survive server and plugin updates intact.
- ? Upgrade chain: Leather → Copper → Iron → Gold → Diamond → Emerald →
Netherite. The smithing-table upgrade keeps ID, contents and color.
- ? Upgrade GUI: a dedicated inventory per backpack (button in the backpack GUI).
- ? Dyeing in the crafting table: backpack in the center, dyes in the left
column = main color, right column = accent color (mixed to hex).
- ? Placeable backpacks: shift-right-click the ground to place
(ItemDisplay + Interaction), right-click opens, sneak-right-click picks up.
- ? Protection: backpacks cannot be used as horse armor and cannot be moved by
hoppers/automation.
- ?
/bp update: downloads the latest release JAR from GitHub.
- ? Module GUI:
/bp modules toggles hooks live by clicking.
- ? Recipe Book + JEI/REI/EMI: all real recipes are unlocked and visible.
- ➖ Custom-item hooks: Oraxen only (Nexo & ItemsAdder removed).
? Minecraft/Paper version
- Target platform: Paper (also runs on Spigot, with possibly limited MiniMessage visuals)
- Built against:
io.papermc.paper:paper-api:26.2.build.62-beta
- Runs on: Paper 26.1.2 – 26.2 (
api-version: '26.1.2'; no 26.2-exclusive API is used)
- Java: 25 required (Minecraft 26.x requires Java 25, Microsoft OpenJDK 25)
- Version scheme: since the new
YY.D.H scheme, the Paper API uses
<version>.build.<n>-<stage> instead of -R0.1-SNAPSHOT. The target version is
easily changed via the paper.version property in pom.xml.
✨ Features
- ✅ Backpacks as normal items with a unique, forgery-proof ID (PDC)
- ✅ Own inventory per backpack – same items, different contents
- ✅ Persistent storage (SQLite or YAML)
- ✅ Safe GUI with comprehensive dupe/loss protection
- ✅ Double-chest layout (54 slots) – only enabled fields are usable
- ✅ Bigger tiers = more space, with automatic paging beyond one page
- ✅ 6 backpack tiers (Leather, Copper, Iron, Gold, Diamond, Netherite) + Emerald
- ✅ Truly dyeable via dyeable leather items (DyeColor or hex
#RRGGBB) –
color visible even without a resource pack
- ✅ Crafting recipes (configurable, can be enabled/disabled)
- ✅ Open by right-click (main & off hand) and command
- ✅ Admin give command and open by ID
- ✅ CustomModelData +
item_model component per tier – prepared for resource packs
- ✅ Modular hook system – live status via
/bp modules
- ✅ Configurable messages (MiniMessage +
& codes), bundled EN/DE/PL
- ✅ Protection against backpacks-in-backpacks
- ❌ No Vault (deliberately removed)
?️ Installation
- Download the plugin JAR from the Releases
(
yourShika-Backpacks-1.3.2.jar).
- Put it into the
plugins/ folder of your Paper 26.1.2 – 26.2 (Java 25) server.
- Start the server – the data folder
plugins/yourShika Backpack's/ is created
automatically with config.yml, the message files and the database.
- Optionally adjust
config.yml and run /bp reload.
⌨️ Commands
Main command: /backpack · aliases: /bp, /ybackpack, /ysbackpack
| Command |
Description |
/bp help |
Show help |
/bp open |
Open the backpack in your hand |
/bp info |
View backpacks, upgrades & recipes in a GUI |
/bp list [player] |
List backpacks (clickable: Open/Copy/TP) |
/bp rename <name|reset> |
Rename the backpack in your hand |
/bp recall |
Recall placed backpacks (needs Recall upgrade; selection menu for several) |
/bp locate [player|ID] |
Show coordinates of placed backpacks |
/bp goto <ID> |
Teleport to a placed backpack |
/bp transfer <ID> <player> |
Change a backpack's owner (admin) |
/bp color <color> [accent] |
Dye a backpack (DyeColor name or #RRGGBB) — admin |
/bp give <player> <tier> [amount] [color] [accent] |
Give a backpack (admin) |
/bp openid <ID> |
Open a backpack by ID (admin) |
/bp modules |
Toggle external modules via GUI (admin) |
/bp assets <status|redeploy> |
Check / redeploy Oraxen assets (admin) |
/bp doctor |
Diagnostics (Oraxen, config, DB, assets, versions) (admin) |
/bp stats |
Backpack statistics: total, placed, per tier, storage size (admin) |
/bp purge [dry|confirm] |
Remove empty, orphaned backpack data — safe, non-empty data untouched (admin) |
/bp update |
Download the latest version from GitHub (admin, restart needed) |
/bp reload |
Reload the configuration (admin) |
/bp version |
Plugin info |
Dyeing for players works via the crafting table (see below); the
/bp color command is deliberately an admin function.
Achievements are real Minecraft advancements and appear as their own tab in
the advancements screen — there is no command for them.
? Permissions
| Permission |
Description |
Default |
yourshika.backpack.use |
Use backpacks |
all |
yourshika.backpack.open |
Open your own backpack |
all |
yourshika.backpack.list |
List your own backpacks |
all |
yourshika.backpack.place |
Place/pick up backpacks |
all |
yourshika.backpack.rename |
Rename backpacks |
all |
yourshika.backpack.craft.<tier> |
Craft a specific tier |
all |
yourshika.backpack.admin.color |
Dye a backpack via command |
OP |
yourshika.backpack.admin.give |
Give backpacks |
OP |
yourshika.backpack.admin.openid |
Open by ID |
OP |
yourshika.backpack.admin.openother |
Open others' backpacks |
OP |
yourshika.backpack.admin.listother |
List others' backpacks |
OP |
yourshika.backpack.admin.modules |
Open/toggle module GUI |
OP |
yourshika.backpack.admin.update |
Self-updater |
OP |
yourshika.backpack.admin.reload |
Reload |
OP |
yourshika.backpack.admin.debug |
Debug |
OP |
? Backpacks, tiers, size & paging
Each backpack opens as a double chest (54 slots). The bottom row (9 slots) is
the control bar (paging, info, upgrades). Of the remaining 45 slots only as
many are enabled as the tier allows – the rest is locked. Tiers with more than
45 storage slots are paged automatically (◀ / ▶).
| Tier |
Storage slots |
Pages* |
Upgrade slots |
CustomModelData |
| Leather |
9 |
1 |
1 |
1001 |
| Copper |
18 |
1 |
2 |
1002 |
| Iron |
27 |
1 |
3 |
1003 |
| Gold |
45 |
1 |
4 |
1004 |
| Diamond |
54 |
2 |
5 |
1005 |
| Emerald |
81 |
2 |
6 |
1006 |
| Netherite |
108 |
3 |
6 |
1007 |
* At 45 usable slots per page (gui.storage-slots-per-page).
The upgrade slots are usable as their own inventory via the Upgrades button in
the backpack GUI.
Identity & security
Every backpack carries its ID, tier and colors in the PersistentDataContainer –
not in name or lore. This makes backpacks not forgeable by renaming.
Contents are never stored in the item, but server-side bound to the ID. That is
the core of the dupe protection: a copied item shares the same inventory. When
paging, only the visible page is synced between inventory and buffer – the
operation stays atomic and dupe-safe.
Colors (truly dyeable)
Backpacks are based on a dyeable leather item (LEATHER_HORSE_ARMOR) by
default. The main color tints the item for real – visible even without a
resource pack – and is changeable via /bp color. Both DyeColor names
(BROWN, CYAN, …) and hex values (#A0703C) are allowed.
? CustomModelData, item_model & resource packs
- Each tier has its own CustomModelData (1001–1007) and can optionally set a
modern
item_model component (item-model: "namespace:path").
- Without a resource pack backpacks work as normal (dyed) leather items.
- With a resource pack they look like custom items.
- External item systems (Oraxen) are optional. The default is always the
built-in vanilla provider.
Oraxen assets
Under src/main/resources/oraxen/ there is a ready-made Oraxen bundle with 64x64
PNGs in vanilla style for all backpack tiers, tier-upgrade items and many prepared
function upgrades. Real backpacks are still created via plugin crafting, smithing or
/bp give so that ID, contents, owner and color are preserved.
? Crafting, upgrade chain & dyeing
Only the leather backpack is crafted directly (8× leather around a chest).
All higher tiers come from the upgrade chain in the smithing table. Freshly
crafted backpacks show their ID immediately in the lore.
Upgrade chain — Leather → Copper → Iron → Gold → Diamond → Emerald → Netherite:
- Craft Upgrade Leather: 1× leather (center) + 4× string (crafting table).
- Craft a tier upgrade: Upgrade Leather + 8× tier material (e.g. copper) →
Copper Upgrade (crafting table). Netherite upgrade: smithing table –
Upgrade Leather (template) + Netherite Ingot (base) + string (addition).
- Upgrade in the smithing table: plain leather (template) + previous
backpack (base) + tier upgrade (addition) → next backpack.
ID, contents and color are kept.
Dyeing (crafting table): backpack in the center column, dyes in the left
column = main color, right column = accent color. Position within a column
does not matter; several dyes are mixed into a hex value. The backpack contents
are fully preserved.
The real recipes appear in the Recipe Book and in JEI/REI/EMI. The
position-independent dyeing is not a fixed recipe and is therefore not listed there.
? Storage
- SQLite (default, recommended) →
backpacks.db
- YAML (alternative) →
backpacks.yml
Saved on close, page change, logout, plugin disable, server stop
and via autosave.
Update-safe (MUST): contents are stored in the versioned Paper byte format
(serializeAsBytes) – incl. Minecraft data version. On load the DataFixer migrates
automatically to the current version, so items with arbitrary custom NBT/components
are not lost or corrupted after updates.
? External modules / hooks (automatic)
The plugin runs fully standalone. External hooks are encapsulated as modules
and activate automatically as soon as the respective plugin is installed and the
module is enabled in the config (default: enabled). If the plugin is missing,
the module stays silently inactive.
Live status & toggling via GUI: /bp modules.
| Module |
Purpose |
Default |
| PlaceholderAPI |
%ysbp_count%, %ysbp_highest_tier%, %ysbp_open% … |
auto |
| Oraxen |
Custom models/textures |
auto |
Custom items: only Oraxen is supported as a custom-item hook (free to use,
mature API). Nexo and ItemsAdder were deliberately removed.
Vault is deliberately not supported.
Disable a single module (example):
hooks:
modules:
oraxen: false
?️ Roadmap
- More functional upgrade effects (Void, Filter, Stack, Inception, …) – the
upgrade slots & items already exist.
- Own resource pack + deeper Oraxen integration.
- Backpacks-in-backpacks only via the planned Inception upgrade (with limits
& dupe protection).
? Build notes
Requirements: JDK 25 and Maven.
mvn clean package
The finished plugin is then located at:
target/yourShika-Backpacks-1.3.2.jar
The target Paper version can be adjusted via the paper.version property in
pom.xml.
? License
Released under the MIT License.
Inspired by Sophisticated Backpacks – but a standalone implementation without any
taken code, assets or textures.
评论 0
登录后参与评分
还没有评论,来抢沙发吧