ItemTag
在您的 Paper Minecraft 服务器上追踪物品所有权和历史记录。自动为物品打上所有者信息标签,记录转移过程,并通过 Skript 查询所有权历史。
功能
- 自动所有权追踪 - 在物品创建、掉落或转移时为其打上标签
- 事件日志记录 - 记录 ORIGINAL(初始)、STOLEN(被盗)、GIFTED(赠送)、RETURNED(归还)和 LOOTED(拾取)事件及时间戳
- 多种存储后端 - 支持 Base64 编码的 NBT 存储,并配备 SQLite 备用方案以确保可靠性
- 可配置的追踪规则 - 可追踪特定材料或整个类别(工具、武器、护甲)
- 所有权查询 - 检查当前/原始所有者、转移次数以及是否被盗状态
- Skript 集成 - 通过 Skript 条件和表达式提供完整的 API 访问权限
安装
要求:
- Java 21 或更高版本
- Paper 1.21.11 或更高版本
- Skript 2.12.1+(可选,用于 Skript 集成)
- 从 Releases 下载最新 JAR 文件
- 将
itemtaghistory-1.0.jar放入您的plugins/文件夹 - 重启服务器
- 根据需要编辑
plugins/ItemTag/config.yml - 再次重启以应用配置更改
配置
编辑 plugins/ItemTag/config.yml 以自定义追踪行为:
# 要追踪的物品(特定材料或类别:TOOLS, WEAPONS, ARMOR)
tracked-items:
- DIAMOND_HELMET
- DIAMOND_CHESTPLATE
- DIAMOND_LEGGINGS
- DIAMOND_BOOTS
- TOOLS
- WEAPONS
- ARMOR
# 判定物品为“赠送”的掉落时间窗口(秒)
gift-window-seconds: 45
# 物品 Lore 中的时间戳格式
timestamp-format: "yyyy-MM-dd HH:mm:ss"
# 为每种事件类型自定义 Lore 行
history-title: "&6物品历史"
original-1: "&6[原始所有者]"
original-2: "&7%owner%"
stolen-1: "&c[已被盗]"
stolen-2: "&7来自 %pastowner%"
gifted-1: "&a[已赠送]"
gifted-2: "&7来自 %owner%"
returned-1: "&b[已归还]"
returned-2: "&7归向 %pastowner%"
looted-1: "&e[已拾取]"
looted-2: "&7来自 %pastowner%"
占位符: %owner%, %pastowner%, %timestamp%
Skript 集成
条件
%itemstack% belongs to %offlineplayer%
%itemstack% has [itemtag] history
%itemstack% is [itemtag] tracked
%itemstack% was [itemtag] stolen
%itemstack% is [itemtag] ignored
%itemstack% has been owned by %offlineplayer%
表达式
owner of %itemstack%
history of %itemstack%
original owner of %itemstack%
ownership transfer count of %itemstack%
formatted history of %itemstack%
API 用法
从您的代码中访问插件 API:
ItemTagApi api = ((ItemTag) Bukkit.getPluginManager().getPlugin("itemtaghistory")).getApi();
api.belongsToPlayer(playerUuid, itemStack); // 检查玩家是否拥有该物品
api.getHistory(itemStack); // 获取所有历史记录条目
api.getCurrentOwner(itemStack); // 获取当前所有者 UUID
api.getOriginalOwner(itemStack); // 获取原始所有者 UUID
api.isTracked(itemStack); // 检查物品是否被追踪
api.hasHistory(itemStack); // 检查物品是否有历史记录
api.hasBeenOwned(itemStack); // 检查物品是否曾被拥有过
api.wasStolen(itemStack); // 检查物品是否曾被盗窃
api.getOwnershipTransferCount(itemStack); // 统计所有权转移次数
api.getFormattedHistory(itemStack); // 获取格式化后的历史字符串
api.markEvent(itemStack, type, owner, pastOwner); // 记录历史事件
api.clearHistory(itemStack); // 清除所有历史记录
api.addIgnoredItem(itemStack); // 将物品标记为忽略
api.removeIgnoredItem(itemStack); // 取消忽略物品
api.isIgnoredItem(itemStack); // 检查物品是否被忽略
api.listIgnoredItems(player); // 获取背包中被忽略的物品列表
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧