ItemTag

插件

· 作者 EternalFrost

这个项目添加了在 bliss 上使用的物品标签插件的重制版

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

最新 2.0 · 26.3 · Paper / Purpur

一键开服(送7天)

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 集成)
  1. 从 Releases 下载最新 JAR 文件
  2. 将 itemtaghistory-1.0.jar 放入您的 plugins/ 文件夹
  3. 重启服务器
  4. 根据需要编辑 plugins/ItemTag/config.yml
  5. 再次重启以应用配置更改

配置

编辑 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);                         // 获取背包中被忽略的物品列表

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源