📖 Documentación del Plugin Debuggy v1.1.1

📋 Índice

1. Introducción
2. Funcionalidades Principales
3. Guía de Comandos
4. Configuración
5. Consideraciones de Seguridad
6. Solución de Problemas

🎯 Introducción

Debuggy es un plugin avanzado para servidores de Minecraft que ofrece un conjunto de herramientas para la manipulación y gestión de datos NBT y PDC.

• Manipular datos NBT de items, entidades y bloques
• Gestionar datos PDC personalizados
• Copiar, pegar y transferir datos entre objetivos
• Guardar y cargar configuraciones JSON
• Depurar y analizar información en tiempo real

Versión mínima: 1.21+ (Spigot/Paper/Purpur)
Dependencia: PlaceholderAPI

⚙️ Funcionalidades Principales

📦 Gestión de Datos PDC

Permite almacenar información personalizada persistente entre reinicios del servidor.

Jugador → Comando PDC → Validación → Resultado

🏷️ Manipulación de Datos NBT

Modifica las propiedades internas de items, entidades y bloques.

Target → Validación NBT → Modificación → Guardado

📋 Sistema de Clipboard

Permite copiar y pegar datos NBT o PDC entre diferentes objetivos. Cada jugador tiene su propio clipboard temporal.

💾 Sistema de Persistencia

Guarda y carga configuraciones JSON para respaldos o plantillas reutilizables.

🎮 Guía de Comandos

Comando Principal

/debuggy <grupo> <acción> [argumentos...]
Alias: /ds

Grupos:

• pdc – Comandos PersistentDataContainer
• nbt – Comandos Named Binary Tag
• commons – Comandos generales

📦 Ejemplos PDC

/ds pdc set @s miplugin:nivel 5
/ds pdc get @s miplugin:nivel
/ds pdc save @s backup_jugador
/ds pdc load backup_jugador @s

🏷️ Ejemplos NBT

/ds nbt set @hand display.Name "Espada Legendaria"
/ds nbt get @hand display.Name
/ds nbt save @hand espada_legendaria
/ds nbt load espada_legendaria @hand

🔧 Comando General

/ds commons reload

⚙️ Configuración

Archivos:

• plugin.yml – Configuración principal
• plugins/Debuggy/data/pdc/ – Datos PDC
• plugins/Debuggy/data/nbt/ – Datos NBT

Ejemplo plugin.yml

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

Permisos Recomendados

Desarrollo:

debuggy.*: true

Producción:

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

Administradores:

debuggy.admin: true
debuggy.reload: true

🔒 Consideraciones de Seguridad

Permisos Principales

debuggy.access
debuggy.reload
debuggy.use.main

Permisos PDC y NBT

debuggy.pdc.*
debuggy.nbt.*

Buenas Prácticas

• Aplicar el principio de menor privilegio
• Validar siempre las entradas de los comandos
• Registrar acciones sensibles en logs

[INFO] [Debuggy] Player Admin usó /ds pdc set @s custom:level 5
[WARN] [Debuggy] Player User intentó acceso no autorizado

🧩 Solución de Problemas

• "No tienes permisos" → Asigna el permiso correspondiente.
• "Target inválido" → Verifica el objetivo o la sintaxis (@s, @p, etc.).
• "Archivo no encontrado" → Asegúrate de que el archivo existe en /data/.

Comandos de Diagnóstico

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

Contacto y Soporte

Autor: DarkBladeDev
Versión: 1.1.1
Compatibilidad: Minecraft 1.21+

Esta documentación corresponde a Debuggy v1.1.1.
Para versiones anteriores o futuras, consulta la documentación específica de la versión.