📖 Debuggy Plugin Documentation v1.1.1

📋 Table of Contents

1. Introduction
2. Main Features
3. Commands Guide
4. Configuration
5. Security Considerations
6. Troubleshooting

🎯 Introduction

Debuggy is an advanced Minecraft plugin providing a full toolkit for manipulating and managing NBT and PDC data.

• Manipulate NBT data of items, entities, and blocks
• Manage PDC data for custom persistent storage
• Copy, paste, and transfer data easily
• Save and load configurations for backups
• Debug and analyze data in real-time

Compatible Versions: Minecraft 1.21+ (Spigot, Paper, Purpur)
Dependencies: PlaceholderAPI (required)

⚙️ Main Features

📦 PDC Data Management

Store and manage persistent player, entity, and block data.

Player → PDC Command → Validation → Result

🏷️ NBT Data Manipulation

Modify internal item and entity properties.

Target → Validation → Modification → Save

📋 Clipboard System

Copy and paste NBT/PDC data between targets. Each player has their own clipboard.

💾 Persistence System

Save and load JSON templates for backups and reusability across servers.

🎮 Commands Guide

Main Command

/debuggy <group> <action> [arguments...]
Alias: /ds

Groups:

• pdc – PersistentDataContainer commands
• nbt – Named Binary Tag commands
• commons – General plugin commands

📦 PDC Commands

/ds pdc set @s myplugin:level 5
/ds pdc get @s myplugin:level
/ds pdc save @s player_backup
/ds pdc load player_backup @s

🏷️ NBT Commands

/ds nbt set @hand display.Name "Legendary Sword"
/ds nbt get @hand display.Name
/ds nbt save @hand sword_template
/ds nbt load sword_template @hand

🔧 General Commands

/ds commons reload

⚙️ Configuration

Directories:

• plugins/Debuggy/data/pdc/ – PDC files
• plugins/Debuggy/data/nbt/ – NBT files

Example plugin.yml

name: Debuggy
version: 1.1.1
main: com.darkbladedev.Main
depend: [PlaceholderAPI]
api-version: 1.21

Recommended Permissions

Development:

debuggy.*: true

Production:

debuggy.pdc.get: true
debuggy.nbt.get: true

Administrators:

debuggy.admin: true
debuggy.reload: true

🔒 Security Considerations

Permission System

debuggy.access
debuggy.reload
debuggy.use.main

debuggy.pdc.get
debuggy.pdc.set
debuggy.pdc.remove
debuggy.pdc.list
debuggy.pdc.copy
debuggy.pdc.paste
debuggy.pdc.save
debuggy.pdc.load
debuggy.pdc.clear

debuggy.nbt.get
debuggy.nbt.set
debuggy.nbt.remove
debuggy.nbt.list
debuggy.nbt.copy
debuggy.nbt.paste
debuggy.nbt.save
debuggy.nbt.load
debuggy.nbt.clear

Implementation Best Practices

• Grant minimal necessary permissions per role
• All command input is validated and sanitized
• Automatic logging for sensitive actions

[INFO] Player Admin used /ds pdc set @s custom:level 5
[WARN] Player User tried unauthorized NBT command

🧩 Troubleshooting

Common Issues

• "You don't have permission" → Check assigned permission nodes
• "Invalid target" → Verify correct syntax (e.g., @s, @p, player:name)
• "File not found" → Ensure the JSON file exists in /data/

Diagnostic Commands

/ds pdc list @s
/ds pdc load [TAB]
/ds pdc paste @s

Contact and Support

Author: DarkBladeDev
Version: 1.1.1
Compatibility: Minecraft 1.21+

This documentation corresponds to Debuggy v1.1.1.
For later versions, please check the version-specific documentation.