LevelingCore

LevelingCore es un sistema de niveles potente y flexible diseñado para propietarios de servidores que desean implementar un sistema de niveles similar al de un RPG en sus servidores de Hytale.

Los servidores pueden elegir entre múltiples fórmulas de nivelación, incluyendo exponencial, lineal, basada en tablas (formato CSV) y expresiones matemáticas completamente personalizadas, permitiendo que la progresión se ajuste con precisión a los objetivos de diseño del servidor.

LevelingCore soporta múltiples bases de datos a través de JDBC, incluyendo H2, MySQL, MariaDB y PostgreSQL, lo que lo hace adecuado tanto para entornos locales como distribuidos. Los datos de XP y nivel se almacenan de forma segura y eficiente, con un agrupamiento de conexiones configurable para servidores con alto tráfico.

Incluido en LevelingCore también se encuentra la migración de XP, que recalcula automáticamente el XP almacenado cuando cambia la fórmula de nivelación, asegurando que los niveles de los jugadores se conserven incluso a medida que evolucionan las reglas de progresión.

Ejemplo de configuración:

# Configuración de LevelingCore
#
# =========================
# Configuración de la base de datos
# =========================
#
# URLs JDBC soportadas:
#   H2 (archivo):
#     jdbc:h2:file:./mods/levelingcore_LevelingCore/data/levelingcore;MODE=PostgreSQL
#
#   MySQL:
#     jdbc:mysql://host:port/dbname
#     jdbc:mysql://host:port/dbname?user=dbuser&password=dbpass
#
#   MariaDB:
#     jdbc:mariadb://host:port/dbname
#     jdbc:mariadb://host:port/dbname?user=dbuser&password=dbpass
#
#   PostgreSQL:
#     jdbc:postgresql://host:port/dbname
#     jdbc:postgresql://host:port/dbname?user=dbuser&password=dbpass
#
# Notas:
# - H2 comúnmente usa un nombre de usuario/contraseña vacíos a menos que se haya configurado de otra manera.
# - Para MySQL/MariaDB/Postgres, establece nombre de usuario/contraseña.
#
database:
  jdbcUrl: "jdbc:h2:file:./mods/levelingcore_LevelingCore/data/levelingcore;MODE=PostgreSQL"
  username: ""
  password: ""
  maxPoolSize: 10

# =========================
# Fórmula de nivelación
# =========================
#
# Tipos soportados:
#   - EXPONENCIAL: El XP mínimo en el nivel L es baseXp * (L - 1) ^ exponente
#   - LINEAL:      El XP mínimo en el nivel L es xpPerLevel * (L - 1)
#   - TABLA:       El XP mínimo en el nivel L se define en un archivo CSV
#   - PERSONALIZADO: El XP mínimo en el nivel L se define mediante una expresión matemática
#
# Notas:
# - La migración de XP está habilitada por defecto. Establece migrateXP en false para deshabilitar.
# - Cambiar la fórmula recalculará el XP para preservar los niveles de los jugadores.
#
formula:
  type: "EXPONENTIAL"
  migrateXP: true
  exponential:
    baseXp: 100.0
    exponent: 1.7
    # Nivel máximo soportado por esta fórmula
    maxLevel: 100000
  linear:
    xpPerLevel: 100
    # Nivel máximo soportado por esta fórmula
    maxLevel: 100000
  table:
    # Archivo CSV relativo al directorio de datos
    file: "levels.csv"
  custom:
    # La expresión devuelve el XP mínimo para un nivel.
    #
    # Variables disponibles:
    #   - level      (nivel actual, entero >= 1)
    #
    # También puedes hacer referencia a cualquier constante definida a continuación.
    #
    # Ejemplo:
    #   exp(a * (level - 1)) * b / c
    #
    xpForLevel: "exp(a * (level - 1)) * b / c"

    # Constantes opcionales referenciadas en la expresión
    constants:
      a: 0.12
      b: 100
      c: 1

    # Nivel máximo soportado por esta fórmula (utilizado para búsqueda binaria)
    maxLevel: 100000