PlayerData Core

Una biblioteca ligera para almacenar y recuperar datos de jugadores en los plugins del servidor Hytale.

Características

API de clave-valor simple para cualquier tipo de dato
Persistencia automática en JSON en disco
Operaciones seguras para hilos
Aislamiento de datos por jugador
Sin configuración requerida
Claves con espacio de nombres forzadas para prevenir conflictos entre plugins

Para Desarrolladores de Plugins

Las claves deben tener espacio de nombres utilizando el formato pluginname:keyname para evitar conflictos entre plugins.

  // Almacenar datos
  PlayerData.set(playerId, "myplugin:coins", 100)
  PlayerData.set(playerId, "myplugin:rank", "VIP")

  // Recuperar datos
  val coins = PlayerData.get<Int>(playerId, "myplugin:coins") ?: 0
  val rank = PlayerData.get<String>(playerId, "myplugin:rank")

  // Incrementar valores numéricos
  PlayerData.increment(playerId, "myplugin:coins", 50)

  // Eliminar datos
  PlayerData.remove(playerId, "myplugin:temp_data")

  Claves inválidas generarán un error:
  "nonamespace"  → Error: La clave debe tener espacio de nombres
  ":keyonly"     → Error: Espacio de nombres vacío
  "plugin:"      → Error: Nombre de clave vacío

  Tipos de Datos Soportados

  - String
  - Int / Long / Double / Float
  - Boolean
  - List<*> (de primitivos)
  - Map<String, *> (de primitivos)

Instalación

Descarga el archivo JAR

Colócalo en la carpeta de plugins de tu servidor

Reinicia el servidor

Para Propietarios de Servidores

Este es un plugin de biblioteca – no hace nada por sí solo. Instálalo si otro plugin (como AFKManager) lo requiere como dependencia.