• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
WarZItems —— 次世代物品库插件|类RpgItems的自动同步更新玩家物品|跨版本兼容|完全本地化

原创 付费 WarZItems —— 次世代物品库插件|类RpgItems的自动同步更新玩家物品|跨版本兼容|完全本地化 1.2.1

请登录后获取
版权类型
原创
插件中文名称
WarZ物品库
插件英文名称
WarZItems
原帖地址
#
支持的核心(服务端)
  1. Spigot
  2. Paper
语言支持
中文(简体)
适配版本(Java)
  1. 1.20


WarZItems
是一款类似 RPGItems 却更加轻量、高度稳定、并专为大服优化的 物品库管理插件
它可以将自定义物品保存到配置文件,并实现 玩家背包中的物品实时更新 —— 当你修改配置后,无需重新发放,物品会自动刷新为最新版本!
适用于 RPG 服务器、战术类服务器、末日生存、HI-Tech、MMO、技能服 等需要大量自定义物品管理的场景。

✨ 插件亮点功能​

✅ 物品库一键管理​

将手中物品保存至配置文件,支持多文件分类,自带稳定序列化机制(兼容各类附魔、Lore、属性、标记等)。

✅ 自动同步更新(核心功能)

当配置文件中的物品被修改后,玩家手上的老版本物品会 自动更新

  • 玩家进入服务器 → 自动更新

  • 玩家拾取物品 → 自动更新

  • 玩家左右键使用物品 → 自动更新

  • 玩家在背包内点击整理物品 → 自动更新

  • 支持手动 /wzi update 强制更新
物品数量不会被重置
NBT 自动识别 ID,不会误伤其他物品

✅ 多文件存储​

物品保存在 items/ 文件夹中,你可以按功能拆分多个 .yml 分类管理。

✅ 全属性保存​

包含以下全部内容:

  • DisplayName

  • Lore

  • Attributes

  • 附魔

  • 随机标签

  • ModelData

  • Unbreakable

  • Flags

  • 自定义 NBT

  • 宝可梦、MMOItems、TACZ 类物品的完整数据(依赖容器原生序列化)

📘 指令(Commands)​

主命令:/warzitems
别名:/wzi/items
指令用途
/wzi save <ID>保存手中物品到物品库
/wzi give <ID> [玩家]发放物品
/wzi list查看所有物品 ID
/wzi update手动更新背包中 WarZItems 物品
/wzi reload重载配置与物品数据

🔐 权限(Permissions)​

节点功能
warzitems.admin使用 save、give、reload 等管理功能
无权限要求玩家可用 /wzi update 用于调试

📂 配置结构说明​

主配置 config.yml

代码:
Message:
  prefix: "§f[§6§lWarZ§f§lItems§f] "
  onlyplayer: "§c只有玩家可以使用此命令"
  nopermission: "§c你没有权限执行此命令"

物品文件(items/*.yml)

示例:
代码:
example_sword:
  ==: org.bukkit.inventory.ItemStack
  v: 3465
  type: DIAMOND_SWORD
  meta:
    ==: ItemMeta
    display-name: "§6示例之剑"
    lore:
    - "§7这是一把示例武器"
    - "§7它会自动同步更新"

🔄 自动更新机制(工作原理)​

  1. 使用 /wzi save 保存物品时,会向物品写入隐藏 NBT:item_id
  2. 当管理员修改物品配置并 /wzi reload
  3. 玩家手中任何带 item_id 的物品都会在以下事件中自动更新:
    • Join
    • Interact(左键/右键)
    • Pickup
    • InventoryClick / Drag
不会重置数量、不影响非本插件物品、不吞物品

👨‍💻 开发者 API(可与任意插件联动)​

代码:
ItemManager itemManager = WarZItems.getInstance().getItemManager();

// 获取物品
ItemStack item = itemManager.getItem("item_id");

// 获取物品ID
String id = itemManager.getItemId(itemStack);

// 判断是否存在
boolean exists = itemManager.getItemIds().contains("item_id");
可用于:技能插件、商店插件、任务插件、装备系统、掉落系统 等二次开发。

📦 插件信息​

  • 插件名称: WarZItems
  • 作者: Crazy_Jky
  • 版本: 1.0.0
  • 兼容: Spigot / Paper / Purpur / Folia(1.8–1.21+ 全版本支持)
  • 插件交流群: 398893720

❤️ 支持作者​

📌 插件技术交流群:398893720
📌 末日类服务器交流群:1063544727
📌 插件定制开发:QQ 1285988665
📌 支持作者: https://afdian.com/a/sunjood
如果我的插件对你有所帮助,非常感谢你的支持!
  • 喜欢
反馈: z77z43883
作者
Crazy_Jky
查看
500
首次发布
最后更新

评分

0.00 星 0 次评分

Crazy_Jky 的其他资源

最新更新

  1. 1.2.1

    - 添加控制台执行支持 : - 修改了 update 命令逻辑,现在支持指定玩家参数: /wzi update [玩家] 。 - 后台/控制台 现在可以通过 /wzi update...
  2. 1.2更新

    增加了自动更新方式相关设置 Settings: # ... # 物品更新模式 / Item Update Mode # 可选值 / Options: # -...
  3. 1.1更新

    1. 新增功能:Lore 保留机制 为了解决物品更新时丢失镶嵌宝石或其他动态属性的问题,我们添加了 Lore 智能保留 功能。 - 配置文件更新 ( config.yml ) : -...
后退
顶部 底部