HyDB – API de Base de Datos SQLite Profesional para Hytale

📊 Resumen

HyDB es un plugin base profesional para Hytale que proporciona una API de base de datos SQLite completa para el almacenamiento de datos persistentes. Permite a otros plugins almacenar y recuperar datos fácilmente sin tener que gestionar las conexiones a la base de datos por sí mismos.

Piénsalo como una capa de servicio de base de datos: instala HyDB una vez, y todos tus otros plugins pueden utilizarlo para un almacenamiento de datos fiable, rápido y seguro para hilos.

✨ Características Clave

🗄️ Gestión de Bases de Datos

• SQLite con JDBC – Base de datos embebida estándar de la industria (sin servidor externo necesario)
• Bases de Datos por Mundo y Globales – Almacena datos globalmente en todos los mundos o por mundo
• Gestión Automática de Conexiones – HyDB gestiona todo el ciclo de vida de la base de datos
• Almacenamiento Basado en Archivos – Cada plugin obtiene su propio archivo de base de datos para una completa aislamiento

⚡ Rendimiento y Seguridad

• Operaciones Asíncronas – Llamadas a la base de datos no bloqueantes utilizando hilos virtuales de Java 25
• Seguro para Hilos – Acceso concurrente seguro desde múltiples plugins/hilos
• Pooled de Conexiones – Gestión eficiente de recursos
• Modo WAL – Registro de escritura anticipada para un mejor rendimiento

🔧 API Completa

• Operaciones CRUD Completas – Crear, Leer, Actualizar, Eliminar con una API sencilla
• Migraciones de Esquema – Versiona y actualiza esquemas de base de datos automáticamente
• Soporte de Transacciones – Ejecuta múltiples operaciones de forma atómica
• Almacenamiento de Blobs – Almacena datos binarios (imágenes, archivos, objetos serializados)
• Constructor de Consultas – API fluida para construir consultas SQL complejas
• Sentencias Preparadas – Protección incorporada contra inyecciones SQL

🎮 Comandos de Administración en el Juego

• /hydb list – Ver todas las bases de datos con tamaños de archivo
• /hydb info <db> – Mostrar detalles y estadísticas de la base de datos
• /hydb tables <db> – Listar todas las tablas con conteos de filas
• /hydb query <db> "SQL" – Ejecutar consultas SELECT para depuración
• Las consultas de solo lectura garantizan la seguridad de los datos

📦 Instalación

Descarga HyDB-1.0.0.jar

Coloca en la carpeta mods de tu servidor

Reinicia tu servidor

¡Listo! Otros plugins pueden ahora usar HyDB

Requisitos:

• Servidor Hytale (última versión)
• Java 25+

👨‍💻 Para Desarrolladores de Plugins

Inicio Rápido

// Obtener la API
HyDBAPI api = HyDBPlugin.getAPI();

// Obtener o crear una base de datos
Database db = api.getGlobalDatabase("myplugin");

// Crear una tabla
db.createTable("users",
    "id INTEGER PRIMARY KEY AUTOINCREMENT",
    "uuid TEXT NOT NULL UNIQUE",
    "username TEXT NOT NULL",
    "coins INTEGER DEFAULT 0"
);

// Insertar datos (asíncrono)
Map<String, Object> data = new HashMap<>();
data.put("uuid", player.getUniqueId().toString());
data.put("username", player.getName());
data.put("coins", 100);

db.insertAsync("users", data).thenAccept(rows -> {
    System.out.println("¡Datos del jugador guardados!");
});

// Consultar datos (asíncrono)
db.queryFirstAsync("SELECT * FROM users WHERE uuid = ?", playerUUID.toString())
    .thenAccept(user -> {
        if (user != null) {
            int coins = (int) user.get("coins");
            // Usar los datos
        }
    });

Alcance de la Base de Datos

// Base de datos global - compartida en todos los mundos (economía, estadísticas de jugadores)
Database global = api.getGlobalDatabase("economy");

// Base de datos por mundo - aislada por mundo (reclamos, regiones)
Database world = api.getWorldDatabase(world, "claims");

🎯 Casos de Uso

Perfecto para plugins que necesitan:

• ✅ Sistemas de Economía – Balances de jugadores, tiendas, transacciones
• ✅ Estadísticas de Jugadores – Seguimiento de estadísticas, tablas de clasificación, logros
• ✅ Reclamos de Terreno – Propiedad de territorios, permisos
• ✅ Modos de Juego Personalizados – Estado del juego, seguimiento de progreso
• ✅ Características Sociales – Listas de amigos, gremios, fiestas
• ✅ Herramientas de Administración – Prohibiciones, advertencias, registros de acciones
• ✅ Sistemas RPG – Datos de personajes, habilidades, inventario
• ✅ Cualquier Dato Persistente – Cualquier cosa que necesite sobrevivir a los reinicios

🏗️ Arquitectura

Estructura de la Base de Datos

HyDB/
├── global/              # Bases de datos globales
│   ├── economy.db       # Plugin de economía
│   ├── stats.db         # Plugin de estadísticas
│   └── yourplugin.db    # Tu plugin
└── worlds/              # Bases de datos por mundo
    ├── world1/
    │   └── claims.db
    └── world2/
        └── claims.db

Cada plugin obtiene su propio archivo de base de datos que contiene múltiples tablas, proporcionando:

• Aislamiento completo de datos
• Fácil copia de seguridad/restauración
• Escalado independiente
• Sin conflictos de nombres de tablas

📖 Documentación

Archivos incluidos:

• README.md – Documentación completa de la API con ejemplos
• COMMANDS.md – Referencia de comandos de administración
• QUICK_START.md – Guía de referencia rápida
• EXAMPLE_USAGE.java – Ejemplo completo de plugin en funcionamiento
• DATABASE_STRUCTURE.md – Detalles de la arquitectura

🔒 Características de Seguridad

• Comandos de Administración de Solo Lectura – Los comandos de consulta solo permiten SELECT/PRAGMA
• Protección contra Inyecciones SQL – Sentencias preparadas en todas partes
• Rollback Automático – Fallos de transacciones se revierten automáticamente
• Manejo de Errores – Mensajes de error y registro completos

🛠️ Detalles Técnicos

• Lenguaje: Java 25 con características modernas (hilos virtuales, expresiones switch)
• Base de Datos: SQLite 3.47.1.0 con JDBC
• Construcción: Script de construcción bash simple (sin herramientas de construcción complejas)
• Dependencias: Incluidas (SQLite JDBC, SLF4J)
• Tamaño: ~14MB (incluye todas las dependencias)

🌟 ¿Por Qué Usar HyDB?

Para Propietarios de Servidores

✅ Instala una vez, beneficios para todos los plugins ✅ Gestión centralizada de bases de datos ✅ Comandos de depuración en el juego ✅ Mejor rendimiento del servidor (pooling de conexiones compartido)

Para Desarrolladores de Plugins

✅ No se necesita código de gestión de bases de datos ✅ API simple e intuitiva ✅ Operaciones asíncronas previenen el lag ✅ Bien documentado con ejemplos ✅ Soporte para migraciones de esquemas

📊 Comparativa

Característica
HyDB
Archivos JSON
Código DB Personalizado

Fácil de Usar
✅ API Simple
✅ Muy Simple
❌ Complejo

Rendimiento
✅ Rápido
❌ Lento
✅ Rápido

Consultas
✅ SQL
❌ Limitado
✅ SQL

Seguro para Hilos
✅ Sí
❌ No
⚠️ Depende

Asíncrono
✅ Incorporado
❌ Manual
⚠️ Manual

Migraciones
✅ Incorporado
❌ Manual
⚠️ Manual

Transacciones
✅ Incorporado
❌ No
✅ Sí

🚀 Ejemplos de Plugins Usando HyDB

La descarga incluye un plugin de ejemplo completo que muestra:

• Configuración de base de datos con migraciones
• Gestión de datos de jugadores
• Operaciones basadas en transacciones
• Uso del constructor de consultas
• Mejores prácticas

📝 Licencia

Código abierto – gratuito para usar en servidores Hytale y desarrollo de plugins.

🤝 Soporte y Contribuciones

• Problemas: Reporta errores o solicita características
• Documentación: Guías completas incluidas
• Ejemplos: Ejemplos de código en funcionamiento proporcionados

🎉 ¡Empieza Hoy!

Instala HyDB en tu servidor

Otros plugins pueden usar inmediatamente la API

Usa comandos /hydb para depuración y monitoreo

¡Disfruta de un almacenamiento de base de datos fiable y rápido!

Versión: 1.0.0 Compatibilidad: Hytale (versión actual) Autor del Mod: Oceride

¡Haciendo que la persistencia de datos sea simple y poderosa para los plugins de Hytale! Este es un mod de dependencia requerida / base de datos de backend.

Imagen generada por GPT-4