\n
\n Version 3.0<\/strong>\n <\/p>\n \n Modern Persistent Data Container API for Skript 2.14+<\/em>\n <\/p>\n<\/p>\n —<\/p>\n ## \ud83d\udcda Overview<\/p>\n SkriptPDC is a powerful addon for Skript that provides comprehensive support for Minecraft’s Persistent Data Container (PDC) system. Store custom data on **items, entities, and chunks** with automatic type detection and modern Skript 2.14 API support.<\/p>\n ### What’s New in v3.0? —<\/p>\n ## \ud83d\ude80 Installation & Setup<\/p>\n 1. **Requirements**: Ensure you have **Skript 2.14+** installed on your server. “` —<\/p>\n ## \ud83d\udcdd Expressions<\/p>\n ### `Expression` PDC Tag **Description:** Gets or sets a PDC tag value. Supports `get`, `set`, `delete`, `add`, and `remove` operations. Works with items, entities, and chunks.<\/p>\n **\ud83d\udca1 Examples:** # Get values # Delete tag # Math operations # Chunk support ### `Expression` All PDC Tags **Description:** Returns a list of all PDC tag keys present on an object.<\/p>\n **\ud83d\udca1 Examples:** # Loop through all tags of a player # Get chunk tags —<\/p>\n ## \ud83d\udcdd Checking Tags (Conditions)<\/p>\n ### `Condition` Check if Tag Exists **Description:** The standard Skript way to check if an object has a specific PDC tag.<\/p>\n **\ud83d\udca1 Examples:** # Check if a chunk tag is true ### `Condition` Check if PDC is Empty **Description:** Checks if an object’s PDC is empty (contains no tags).<\/p>\n **\ud83d\udca1 Examples:** —<\/p>\n ## \u2699\ufe0f Effects<\/p>\n ### `Effect` Clear PDC **Description:** Removes all PDC tags from an object.<\/p>\n **\ud83d\udca1 Examples:** # Clear chunk data ### `Effect` Remove PDC Tags **Description:** Removes one or more specific PDC tags from an object.<\/p>\n **\ud83d\udca1 Examples:** # Remove multiple tags —<\/p>\n ## \ud83d\udca1 Usage Examples<\/p>\n ### Example 1: Item Leveling System on death: set {_exp} to pdc tag “weapon:exp” of attacker’s tool ### Example 2: Soulbound Items if pdc tag “soulbound:owner” of player’s tool is set: set pdc tag “soulbound:owner” of player’s tool to player’s uuid as string on pickup: ### Example 3: Protected Regions with Chunks on break: ### Example 4: Player Statistics on death: command \/stats: ## \ud83d\udcbe Supported Data Types<\/p>\n SkriptPDC intelligently handles data types. When you set a tag, the addon automatically detects the type and stores it using the most appropriate format.<\/p>\n | Data Type | Skript Equivalent | Example Value | ### Complex Data Types “`skript > **Important:** When storing complex objects like players, it’s recommended to store their UUID as text (`player’s uuid as string`) instead of the player object itself, as player objects are temporary.<\/p>\n —<\/p>\n ## \u2753 FAQ & Troubleshooting<\/p>\n ### How do I use namespaced keys? ### Why isn’t my item data saving? “`skript ### What objects support PDC? ### How do I check if a tag exists? ### Can I store lists or multiple values? “`skript # Later… —<\/p>\n \n SkriptPDC API v3.0 – Created by Fendi\n<\/p>\n \n For convenience, the docs was generated by AI, I apologize for any errors in the examples.<\/i><\/p>\n","protected":false},"excerpt":{"rendered":" Advanced Persistent Data Container API for Skript<\/p>\n","protected":false},"featured_media":142394,"template":"","meta":{"_minecraft_slug":"skriptpdc","_minecraft_project_id":"5Iw6RqxX","_minecraft_author":"3Fendi3","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":135,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"skriptpdc.zip","_minecraft_size_bytes":47390,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T18:53:54.933167Z","_minecraft_date_created":"2025-11-01T07:38:59.440554Z","_minecraft_date_modified":"2026-01-24T21:32:06.004135Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/skriptpdc","_minecraft_icon_attachment_id":142394,"_minecraft_imported_at":"2026-06-08T11:18:54+00:00","_minecraft_import_hash":"a07e0ce1c098b6939ef72742aafa7f6e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,126,90,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-142393","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n* **\ud83d\ude80 Skript 2.14 API**: Fully modernized using Skript’s new registration system for better performance and stability.
\n* **\ud83c\udf0d Chunk Support**: Store persistent data directly on chunks for region-based systems and world management.
\n* **\ud83c\udfaf Auto Type Detection**: Automatically handles Integer, Double, Float, Long, Byte, String, Boolean, and complex Skript types.
\n* **\ud83d\udccb Tag Management**: List, check, clear, and manipulate PDC tags with intuitive expressions and effects.
\n* **\u2795 Math Operations**: Add and remove numeric values directly from PDC tags without manual calculations.
\n* **\u26a1 Optimized Performance**: Enhanced error handling and efficient code for production servers.<\/p>\n
\n2. **Download**: Get the latest version of `SkriptPDC.jar`.
\n3. **Install**: Place the downloaded `.jar` file into your server’s `\/plugins\/` directory.
\n4. **Restart**: Restart your server completely.
\n5. **Verify**: Check your server console for the startup message:<\/p>\n
\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
\n\u2551 SkriptPDC-API v3.0 Enabled \u2551
\n\u2551 Full Modern 2.14 API \u2551
\n\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d
\n“`<\/p>\n
\n> `pdc tag %string% of %objects%`<\/p>\n
\n“`skript
\n# Set different data types
\nset pdc tag “myplugin:level” of player’s tool to 5
\nset pdc tag “myplugin:name” of player’s tool to “Legendary Sword”
\nset pdc tag “myplugin:damage” of player’s tool to 12.5<\/p>\n
\nset {_level} to pdc tag “myplugin:level” of player’s tool
\nsend “Item level: %{_level}%”<\/p>\n
\ndelete pdc tag “myplugin:level” of player’s tool<\/p>\n
\nadd 1 to pdc tag “myplugin:kills” of player
\nremove 10 from pdc tag “myplugin:mana” of player<\/p>\n
\nset pdc tag “region:protected” of chunk at player to true
\n“`<\/p>\n
\n> `[all] [the] pdc tag[s] of %objects%`<\/p>\n
\n“`skript
\n# Get all tags from an item
\nset {_tags::*} to all pdc tags of player’s tool
\nsend “This item has %size of {_tags::*}% tags”<\/p>\n
\nloop all pdc tags of player:
\n set {_value} to pdc tag loop-value of player
\n send “%loop-value%: %{_value}%”<\/p>\n
\nset {_chunkTags::*} to pdc tags of chunk at player
\n“`<\/p>\n
\n> `pdc tag %string% of %objects% is set`
\n> `pdc tag %string% of %objects% is not set`<\/p>\n
\n“`skript
\n# Check if an item tag exists
\nif pdc tag “myplugin:special” of player’s tool is set:
\n send “This is a special item!”<\/p>\n
\nif pdc tag “region:protected” of chunk at event-block is true:
\n cancel event
\n“`<\/p>\n
\n> `size of all pdc tags of %objects% is 0`<\/p>\n
\n“`skript
\n# Check if an item’s PDC is empty
\nif size of all pdc tags of player’s tool is 0:
\n send “This item has no custom data”
\n“`<\/p>\n
\n> `clear [all] pdc (of|from) %objects%`<\/p>\n
\n“`skript
\n# Clear all tags from an item
\nclear all pdc of player’s tool<\/p>\n
\nclear pdc from chunk at player
\n“`<\/p>\n
\n> `(remove|delete) pdc tag[s] %strings% (of|from) %objects%`<\/p>\n
\n“`skript
\n# Remove single tag
\nremove pdc tag “myplugin:temp” of player’s tool<\/p>\n
\nremove pdc tags “myplugin:level”, “myplugin:exp” from player’s tool
\n“`<\/p>\n
\n“`skript
\ncommand \/levelitem:
\n trigger:
\n give player diamond sword named “&6Legendary Sword”
\n set pdc tag “weapon:level” of player’s tool to 1
\n set pdc tag “weapon:exp” of player’s tool to 0<\/p>\n
\n if attacker is a player:
\n if pdc tag “weapon:level” of attacker’s tool is set:
\n add 25 to pdc tag “weapon:exp” of attacker’s tool<\/p>\n
\n set {_level} to pdc tag “weapon:level” of attacker’s tool
\n if {_exp} >= {_level} * 100:
\n add 1 to pdc tag “weapon:level” of attacker’s tool
\n set pdc tag “weapon:exp” of attacker’s tool to 0
\n send “&aLevel Up! Your weapon is now level %{_level} + 1%!” to attacker
\n“`<\/p>\n
\n“`skript
\ncommand \/soulbind:
\n trigger:
\n if player’s tool is air:
\n send “&cYou must hold an item!”
\n stop<\/p>\n
\n send “&cThis item is already soulbound!”
\n stop<\/p>\n
\n send “&aYour item is now soulbound!”<\/p>\n
\n if pdc tag “soulbound:owner” of event-item is set:
\n set {_ownerUUID} to pdc tag “soulbound:owner” of event-item
\n if player’s uuid as string is not {_ownerUUID}:
\n cancel event
\n send “&cThis item belongs to someone else!”
\n“`<\/p>\n
\n“`skript
\ncommand \/protectchunk:
\n trigger:
\n set {_chunk} to chunk at player
\n set pdc tag “region:protected” of {_chunk} to true
\n set pdc tag “region:owner” of {_chunk} to player’s uuid as string
\n send “&aChunk protected!”<\/p>\n
\n set {_chunk} to chunk at event-block
\n if pdc tag “region:protected” of {_chunk} is true:
\n set {_owner} to pdc tag “region:owner” of {_chunk}
\n if player’s uuid as string is not {_owner}:
\n cancel event
\n send “&cThis chunk is protected!”
\n“`<\/p>\n
\n“`skript
\non death of player:
\n add 1 to pdc tag “stats:deaths” of victim<\/p>\n
\n if attacker is a player:
\n add 1 to pdc tag “stats:kills” of attacker<\/p>\n
\n trigger:
\n set {_kills} to pdc tag “stats:kills” of player ? 0
\n set {_deaths} to pdc tag “stats:deaths” of player ? 0
\n send “&eKills: &f%{_kills}% &7| &eDeaths: &f%{_deaths}%”
\n“`
\n—<\/p>\n
\n|—————–|——————-|——————-|
\n| String | `text` | `”Hello World”` |
\n| Integer | `integer` | `42` |
\n| Double \/ Float | `number` | `3.14159` |
\n| Long | `number` | `999999999` |
\n| Byte | `number` | `127` |
\n| Boolean | `boolean` | `true` \/ `false` |<\/p>\n
\nFor any other Skript data type (like `location`, `itemstack`, etc.), SkriptPDC will use Skript’s built-in serialization system. This converts the object into text, stores it, and deserializes it back into an object when you retrieve it.<\/p>\n
\n# Storing a location on a player
\nset pdc tag “homes:home1” of player to player’s location
\n# … later
\nset {_home} to pdc tag “homes:home1” of player
\nteleport player to {_home}
\n“`<\/p>\n
\nTags should ideally be in the format `namespace:key` (e.g., `myplugin:level`). The namespace prevents conflicts with other plugins. If you provide a key without a namespace (e.g., `”level”`), SkriptPDC will automatically use your script’s name as the namespace.<\/p>\n
\nWhen manipulating items stored in **variables** or **inventory slots**, you must manually apply the modified item back to its original place. Modifying `player’s tool` handles this automatically.<\/p>\n
\n# Correct way to update an item in a specific slot
\nset {_item} to slot 0 of player’s inventory
\nset pdc tag “myplugin:tag” of {_item} to “value”
\nset slot 0 of player’s inventory to {_item} # This line is crucial!
\n“`<\/p>\n
\nSkriptPDC supports all objects that implement Bukkit’s `PersistentDataHolder` interface:
\n* **Items**: `itemstack`, `itemtype`, inventory slots
\n* **Entities**: All entity types (Players, Mobs, Armor Stands, etc.)
\n* **Chunks**: World chunks for region-based data<\/p>\n
\nThe best way is to use Skript’s built-in `is set` condition.
\n“`skript
\nif pdc tag “mydata” of player’s tool is set:
\n send “Tag exists!”
\nelse:
\n send “Tag does not exist.”
\n“`<\/p>\n
\nPDC stores single values per tag. For lists, you have two main options:
\n1. **Use Multiple Tags**: Create a naming convention like `homes:1`, `homes:2`, etc.
\n2. **Serialize the List**: Join the list into a single string with a delimiter, and split it when you retrieve it. Skript handles this automatically if you set a list variable to a tag.<\/p>\n
\n# Skript’s serialization handles this automatically
\nset {_friends::*} to “Player1”, “Player2” and “Player3”
\nset pdc tag “friends:list” of player to {_friends::*}<\/p>\n
\nset {_retrievedFriends::*} to pdc tag “friends:list” of player
\n# {_retrievedFriends::*} is now a list again
\n“`<\/p>\n