yourShika's Backpacks

插件

· 作者 yourShika

一个适用于 Paper/Spigot 的独立服务器端背包系统

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

最新 1.3.2 · 26.2 · Paper / Spigot

一键开服(送7天)

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(已故意移除)

?️ 安装

  1. 从 Releases 下载插件 JAR 文件 (yourShika-Backpacks-1.3.2.jar)。
  2. 将其放入 Paper 26.1.2 – 26.2 (Java 25) 服务器的 plugins/ 文件夹中。
  3. 启动服务器 – 数据文件夹 plugins/yourShika Backpack's/ 将自动创建, 包含 config.yml、消息文件和数据库。
  4. 可选:调整 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. 合成 升级用皮革:1× 皮革(中心)+ 4× 线(工作台)。
  2. 合成一个等级升级物品:升级用皮革 + 8× 等级材料(例如铜)→ 铜升级(工作台)。下界合金升级:锻造台 – 升级用皮革(模板)+ 下界合金锭(基座)+ 线(附加)。
  3. 在锻造台中升级: 普通皮革(模板)+ 上一个等级的背包(基座)+ 等级升级物品(附加)→ 下一个等级的背包。 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 —— 但这是一个独立的实现,没有任何采用的代码、资产或纹理。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源