<p align="center"> <h1 align="center">SkriptPDC API</h1> <p align="center"> <strong>Version 3.0</strong> </p> <p align="center"> <em>Modern Persistent Data Container API for Skript 2.14+</em> </p> </p> --- ## 📚 Overview 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. ### What's New in v3.0? * **🚀 Skript 2.14 API**: Fully modernized using Skript's new registration system for better performance and stability. * **🌍 Chunk Support**: Store persistent data directly on chunks for region-based systems and world management. * **🎯 Auto Type Detection**: Automatically handles Integer, Double, Float, Long, Byte, String, Boolean, and complex Skript types. * **📋 Tag Management**: List, check, clear, and manipulate PDC tags with intuitive expressions and effects. * **➕ Math Operations**: Add and remove numeric values directly from PDC tags without manual calculations. * **⚡ Optimized Performance**: Enhanced error handling and efficient code for production servers. --- ## 🚀 Installation & Setup 1. **Requirements**: Ensure you have **Skript 2.14+** installed on your server. 2. **Download**: Get the latest version of `SkriptPDC.jar`. 3. **Install**: Place the downloaded `.jar` file into your server's `/plugins/` directory. 4. **Restart**: Restart your server completely. 5. **Verify**: Check your server console for the startup message: ``` ╔══════════════════════════════╗ ║ SkriptPDC-API v3.0 Enabled ║ ║ Full Modern 2.14 API ║ ╚══════════════════════════════╝ ``` --- ## 📝 Expressions ### `Expression` PDC Tag > `pdc tag %string% of %objects%` **Description:** Gets or sets a PDC tag value. Supports `get`, `set`, `delete`, `add`, and `remove` operations. Works with items, entities, and chunks. **💡 Examples:** ```skript # Set different data types 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 # Get values set {_level} to pdc tag "myplugin:level" of player's tool send "Item level: %{_level}%" # Delete tag delete pdc tag "myplugin:level" of player's tool # Math operations add 1 to pdc tag "myplugin:kills" of player remove 10 from pdc tag "myplugin:mana" of player # Chunk support set pdc tag "region:protected" of chunk at player to true ``` ### `Expression` All PDC Tags > ` pdc tag of %objects%` **Description:** Returns a list of all PDC tag keys present on an object. **💡 Examples:** ```skript # Get all tags from an item set {_tags::*} to all pdc tags of player's tool send "This item has %size of {_tags::*}% tags" # Loop through all tags of a player loop all pdc tags of player: set {_value} to pdc tag loop-value of player send "%loop-value%: %{_value}%" # Get chunk tags set {_chunkTags::*} to pdc tags of chunk at player ``` --- ## 📝 Checking Tags (Conditions) ### `Condition` Check if Tag Exists > `pdc tag %string% of %objects% is set` > `pdc tag %string% of %objects% is not set` **Description:** The standard Skript way to check if an object has a specific PDC tag. **💡 Examples:** ```skript # Check if an item tag exists if pdc tag "myplugin:special" of player's tool is set: send "This is a special item!" # Check if a chunk tag is true if pdc tag "region:protected" of chunk at event-block is true: cancel event ``` ### `Condition` Check if PDC is Empty > `size of all pdc tags of %objects% is 0` **Description:** Checks if an object's PDC is empty (contains no tags). **💡 Examples:** ```skript # Check if an item's PDC is empty if size of all pdc tags of player's tool is 0: send "This item has no custom data" ``` --- ## ⚙️ Effects ### `Effect` Clear PDC > `clear pdc (of|from) %objects%` **Description:** Removes all PDC tags from an object. **💡 Examples:** ```skript # Clear all tags from an item clear all pdc of player's tool # Clear chunk data clear pdc from chunk at player ``` ### `Effect` Remove PDC Tags > `(remove|delete) pdc tag %strings% (of|from) %objects%` **Description:** Removes one or more specific PDC tags from an object. **💡 Examples:** ```skript # Remove single tag remove pdc tag "myplugin:temp" of player's tool # Remove multiple tags remove pdc tags "myplugin:level", "myplugin:exp" from player's tool ``` --- ## 💡 Usage Examples ### Example 1: Item Leveling System ```skript 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