SkriptPDC

插件

· 作者 3Fendi3

Skript 的高级持久化数据容器 API

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

最新 3.0 · 1.21.11 · Paper

一键开服(送7天)

SkriptPDC API

Version 3.0

适用于 Skript 2.14+ 的现代持久化数据容器 API


? 概述

SkriptPDC 是一个功能强大的 Skript 插件,为 Minecraft 的持久化数据容器(PDC)系统提供了全面支持。通过在物品、实体和区块上存储自定义数据,并配合自动类型检测和现代 Skript 2.14 API 支持,实现高效的数据管理。

v3.0 新增功能:

  • ? Skript 2.14 API:完全现代化,使用 Skript 的新注册系统,带来更好的性能和稳定性。
  • ? 区块支持:直接在区块上存储持久化数据,适用于基于区域系统和世界管理。
  • ? 自动类型检测:自动处理 Integer、Double、Float、Long、Byte、String、Boolean 以及复杂的 Skript 类型。
  • ? 标签管理:通过直观的表达式和效果列出、检查、清除和操作 PDC 标签。
  • ➕ 数学运算:直接从 PDC 标签中添加或移除数值,无需手动计算。
  • ⚡ 优化性能:增强的错误处理和高效的代码,适用于生产服务器。

? 安装与设置

  1. 要求:确保服务器上已安装 Skript 2.14+。
  2. 下载:获取最新版本的 SkriptPDC.jar。
  3. 安装:将下载的 .jar 文件放入服务器的 /plugins/ 目录中。
  4. 重启:完全重启服务器。
  5. 验证:检查服务器控制台是否出现启动消息:
╔══════════════════════════════╗
║  SkriptPDC-API v3.0 Enabled  ║
║  Full Modern 2.14 API        ║
╚══════════════════════════════╝

? 表达式

Expression PDC 标签

pdc tag %string% of %objects%

描述: 获取或设置 PDC 标签值。支持 get、set、delete、add 和 remove 操作。适用于物品、实体和区块。

? 示例:

# 设置不同类型的数据
set pdc tag "myplugin:level" of player's tool to 5
set pdc tag "myplugin:name" of player's tool to "Legendary Sword"
set pdc tag "myplugin:damage" of player's tool to 12.5

# 获取值
set {_level} to pdc tag "myplugin:level" of player's tool
send "Item level: %{_level}%"

# 删除标签
delete pdc tag "myplugin:level" of player's tool

# 数学运算
add 1 to pdc tag "myplugin:kills" of player
remove 10 from pdc tag "myplugin:mana" of player

# 区块支持
set pdc tag "region:protected" of chunk at player to true

Expression 所有 PDC 标签

[all] [the] pdc tag[s] of %objects%

描述: 返回对象上存在的所有 PDC 标签键列表。

? 示例:

# 获取物品的所有标签
set {_tags::*} to all pdc tags of player's tool
send "This item has %size of {_tags::*}% tags"

# 遍历玩家的所有标签
loop all pdc tags of player:
    set {_value} to pdc tag loop-value of player
    send "%loop-value%: %{_value}%"
    
# 获取区块标签
set {_chunkTags::*} to pdc tags of chunk at player

? 检查标签(条件)

Condition 检查标签是否存在

pdc tag %string% of %objects% is set pdc tag %string% of %objects% is not set

描述: 标准的 Skript 方式,用于检查对象是否具有特定的 PDC 标签。

? 示例:

# 检查物品标签是否存在
if pdc tag "myplugin:special" of player's tool is set:
    send "This is a special item!"

# 检查区块标签是否为真
if pdc tag "region:protected" of chunk at event-block is true:
    cancel event

Condition 检查 PDC 是否为空

size of all pdc tags of %objects% is 0

描述: 检查对象的 PDC 是否为空(不包含任何标签)。

? 示例:

# 检查物品的 PDC 是否为空
if size of all pdc tags of player's tool is 0:
    send "This item has no custom data"

⚙️ 效果

Effect 清除 PDC

clear [all] pdc (of|from) %objects%

描述: 从对象中移除所有 PDC 标签。

? 示例:

# 清除物品的所有标签
clear all pdc of player's tool

# 清除区块数据
clear pdc from chunk at player

Effect 移除 PDC 标签

(remove|delete) pdc tag[s] %strings% (of|from) %objects%

描述: 从对象中移除一个或多个特定的 PDC 标签。

? 示例:

# 移除单个标签
remove pdc tag "myplugin:temp" of player's tool

# 移除多个标签
remove pdc tags "myplugin:level", "myplugin:exp" from player's tool

? 使用示例

示例 1:物品升级系统

command /levelitem:
    trigger:
        give player diamond sword named "&6Legendary Sword"
        set pdc tag "weapon:level" of player's tool to 1
        set pdc tag "weapon:exp" of player's tool to 0

on death:
    if attacker is a player:
        if pdc tag "weapon:level" of attacker's tool is set:
            add 25 to pdc tag "weapon:exp" of attacker's tool
            
            set {_exp} to pdc tag "weapon:exp" of attacker's tool
            set {_level} to pdc tag "weapon:level" of attacker's tool
            if {_exp} >= {_level} * 100:
                add 1 to pdc tag "weapon:level" of attacker's tool
                set pdc tag "weapon:exp" of attacker's tool to 0
                send "&aLevel Up! Your weapon is now level %{_level} + 1%!" to attacker

示例 2:灵魂绑定物品

command /soulbind:
    trigger:
        if player's tool is air:
            send "&cYou must hold an item!"
            stop
        
        if pdc tag "soulbound:owner" of player's tool is set:
            send "&cThis item is already soulbound!"
            stop
            
        set pdc tag "soulbound:owner" of player's tool to player's uuid as string
        send "&aYour item is now soulbound!"

拾取时: 如果事件物品的 PDC 标签 "soulbound:owner" 已设置: 将 {_ownerUUID} 设置为事件物品的 PDC 标签 "soulbound:owner" 如果玩家的 UUID 字符串不等于 {_ownerUUID}: 取消事件 发送 "&c此物品属于他人!"


### 示例 3:受保护的区域与区块
```skript
命令 /protectchunk:
    触发器:
        将 `{_chunk}` 设置为玩家所在区块
        将 `{_chunk}` 的 PDC 标签 `"region:protected"` 设置为 true
        将 `{_chunk}` 的 PDC 标签 `"region:owner"` 设置为玩家的 UUID 字符串
        发送 "&a区块已保护!"

破坏时:
    将 `{_chunk}` 设置为事件方块所在区块
    如果 `{_chunk}` 的 PDC 标签 `"region:protected"` 为 true:
        将 `{_owner}` 设置为 `{_chunk}` 的 PDC 标签 `"region:owner"`
        如果玩家的 UUID 字符串不等于 `{_owner}`:
            取消事件
            发送 "&c该区块已受保护!"

示例 4:玩家统计数据

玩家死亡时:
    将受害者的 PDC 标签 `"stats:deaths"` 加 1

死亡时:
    如果攻击者是玩家:
        将攻击者的 PDC 标签 `"stats:kills"` 加 1

命令 /stats:
    触发器:
        将 `{_kills}` 设置为玩家的 PDC 标签 `"stats:kills"`(若未设置则为 0)
        将 `{_deaths}` 设置为玩家的 PDC 标签 `"stats:deaths"`(若未设置则为 0)
        发送 "&e击杀数: &f%{_kills}% &7| &e死亡数: &f%{_deaths}%"

? 支持的数据类型

SkriptPDC 智能处理数据类型。当你设置标签时,插件会自动检测类型并使用最合适的格式进行存储。

数据类型 Skript 等效类型 示例值
字符串 text "Hello World"
整数 integer 42
双精度/浮点数 number 3.14159
长整型 number 999999999
字节 number 127
布尔值 boolean true / false

复杂数据类型

对于其他任何 Skript 数据类型(如 location、itemstack 等),SkriptPDC 将使用 Skript 内置的序列化系统。这会将对象转换为文本进行存储,并在检索时反序列化为对象。

# 在玩家身上存储一个位置坐标
set pdc tag "homes:home1" of player to player's location
# ... 稍后
set {_home} to pdc tag "homes:home1" of player
teleport player to {_home}

重要提示: 当存储玩家等复杂对象时,建议以文本形式存储其 UUID(player's uuid as string),而不是玩家对象本身,因为玩家对象是临时的。


❓ 常见问题与故障排除

我如何使用命名空间键?

标签理想情况下应采用 namespace:key 格式(例如 myplugin:level)。命名空间可防止与其他插件发生冲突。如果你提供的键没有命名空间(例如 "level"),SkriptPDC 将自动使用你的脚本名称作为命名空间。

为什么我的物品数据没有保存?

当操作存储在变量或物品栏槽位中的物品时,你必须手动将修改后的物品放回原位。修改 player's tool(玩家手中的工具)会自动处理此问题。

# 更新特定槽位中物品的正确方式
set {_item} to slot 0 of player's inventory
set pdc tag "myplugin:tag" of {_item} to "value"
set slot 0 of player's inventory to {_item} # 这一行至关重要!

哪些对象支持 PDC?

SkriptPDC 支持所有实现 Bukkit PersistentDataHolder 接口的对象:

  • 物品:itemstack(物品堆)、itemtype(物品类型)、物品栏槽位
  • 实体:所有实体类型(玩家、生物、盔甲架等)
  • 区块:用于基于区域数据的世界区块

我如何检查标签是否存在?

最佳方法是使用 Skript 内置的 is set 条件。

if pdc tag "mydata" of player's tool is set:
    send "标签存在!"
else:
    send "标签不存在。"

我可以存储列表或多个值吗?

PDC 每个标签仅存储单个值。对于列表,主要有两种选择:

  1. 使用多个标签:创建类似 homes:1、homes:2 等的命名约定。
  2. 序列化列表:使用分隔符将列表连接成单个字符串,并在检索时将其拆分。如果你将列表变量设置为标签,Skript 会自动处理此过程。
# Skript 的序列化会自动处理此过程
set {_friends::*} to "Player1", "Player2" and "Player3"
set pdc tag "friends:list" of player to {_friends::*}

# 稍后...
set {_retrievedFriends::*} to pdc tag "friends:list" of player
# {_retrievedFriends::*} 现在再次成为一个列表

SkriptPDC API v3.0 - Created by Fendi

为方便起见,文档由 AI 生成,我对示例中的任何错误表示歉意。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源