Simple Jobs

SimpleJobs

Un complemento integral de trabajos y economía para servidores de Hytale

SimpleJobs es un complemento de sistema de trabajos rico en características, diseñado específicamente para servidores de Hytale. Los jugadores pueden unirse a diversas profesiones, ganar experiencia, subir de nivel sus habilidades y ganar dinero a través de actividades como cazar monstruos, minar minerales, talar árboles y cultivar cosechas. Perfecto para servidores RPG, comunidades enfocadas en la economía o cualquier servidor que busque agregar sistemas de progresión.

Características

Sistema de Múltiples Trabajos

• Cuatro Trabajos Implementados – Cazador, Minero, Leñador y Agricultor con bucles de juego únicos
• Subida de Nivel y Progresión – Cada trabajo tiene su propia barra de experiencia y niveles (1-100)
• Cambio de Trabajo – Los jugadores pueden unirse o dejar cualquier trabajo en cualquier momento
• Progreso Persistente – Todos los datos del trabajo se guardan en la base de datos con almacenamiento en caché automático

Trabajo de Cazador

• Asesino de Monstruos – Gana dinero matando mobs y monstruos hostiles
• Recompensas por Niveles – Diferentes monstruos dan diferentes recompensas base
• Requisitos de Nivel – Los monstruos de mayor nivel requieren niveles de trabajo más altos
• Detección Inteligente de NPCs – Solo se recompensa por mobs naturalmente agresivos

Trabajo de Minero

• Recompensas por Minería de Minerales – Gana dinero y XP por romper minerales valiosos
• Detección Automática de Minerales – Identifica inteligentemente bloques de minerales por patrones de nombre
• Seis Niveles – Minerales Comunes, Poco Comunes, Raros, Épicos y Legendarios con recompensas escaladas
• Bonificación por Calidad de Herramienta – Mejores herramientas = mejores recompensas
• Escalado de Calidad de Bloques – Bloques de mayor calidad proporcionan recompensas incrementadas

Trabajo de Leñador

• Recompensas por Talar Árboles – Gana dinero y XP por cosechar troncos
• Detección de Troncos – Identifica automáticamente todos los tipos de bloques de madera/troncos
• Seis Niveles de Madera – Desde troncos comunes hasta madera antigua legendaria
• Bonificación por Calidad de Hacha – Mejores hachas = mejores recompensas
• Escalado Progresivo – Las recompensas crecen tanto con la calidad de la herramienta como con el nivel del jugador

Trabajo de Agricultor

• Cosecha de Cultivos – Gana dinero recogiendo cultivos cosechados
• Reconocimiento de Cultivos – Identifica artículos de agricultura como Zanahorias, Trigo, Papas, Melones, Calabazas y más
• Seis Niveles de Cultivos – Cultivos comunes hasta variedades legendarias
• Clasificación Inteligente – Clasifica automáticamente los cultivos por patrones de nombre
• Perfecto para Servidores Agrícolas – Recompensa a tus jugadores agrícolas

Rendimiento y Fiabilidad

• Caché Rápido como un Rayo – Almacenamiento en caché en memoria con Caffeine para búsquedas instantáneas
• Operaciones Asíncronas – Todas las operaciones de base de datos se ejecutan en segundo plano utilizando corutinas de Kotlin
• Soporte de Base de Datos Dual – SQLite para configuraciones simples, PostgreSQL para redes grandes
• Integración Inteligente de Economía – Depósitos sin problemas a través de la API de Economía de Cassaforte
• Diseño Seguro para Hilos – Modelos de datos inmutables garantizan consistencia

Amigable para Desarrolladores

• Arquitectura Limpia – Base de código moderna que sigue las mejores prácticas
• API Integral – Integración fácil para otros complementos
• Diseño Modular – Casos de Uso, Servicios y Sistemas están completamente desacoplados
• Bien Documentado – Documentación completa de la arquitectura incluida

Comandos

Comandos del Jugador

Comando
Descripción
Permiso

/jobs help
Mostrar mensaje de ayuda de trabajos y trabajos disponibles
jobs.user

/jobs join <job>
Unirse a un trabajo (cazador, minero, leñador, agricultor)
jobs.join

/jobs leave <job>
Dejar tu trabajo actual
jobs.leave

/jobs info
Ver todos tus trabajos y progreso
jobs.info

/jobs info <job>
Ver información detallada sobre un trabajo específico
jobs.info

Tipos de Trabajo Disponibles

• Cazador – Gana dinero matando monstruos
• Minero – Gana dinero minando minerales
• Leñador – Gana dinero talando árboles
• Agricultor – Gana dinero cultivando cosechas

Configuración

SimpleJobs crea archivos de configuración en el primer lanzamiento:

Configuración de Base de Datos (jobs_config.json)

SQLite (Predeterminado) – Perfecto para la mayoría de los servidores

{
  "database": {
    "type": "SQLITE",
    "sqlite": {
      "path": "jobs_data/jobs.db"
    }
  }
}

• No se requiere configuración
• Almacenamiento basado en archivos en jobs_data/jobs.db
• Ideal para servidores pequeños a medianos

PostgreSQL – Para redes de alto rendimiento

{
  "database": {
    "type": "POSTGRESQL",
    "postgresql": {
      "host": "localhost",
      "port": 5432,
      "database": "jobs",
      "username": "jobs_user",
      "password": "your_password",
      "poolSize": 10
    }
  }
}

• Conexión en grupo para un rendimiento óptimo
• Recomendado para servidores con grandes cantidades de jugadores

Configuración de Trabajos (jobs_config.json)

{
  "jobs": {
    "enableLeveling": true,
    "maxLevel": 100,
    "baseExperienceMultiplier": 1.0
  }
}

Permisos

SimpleJobs utiliza un sistema de permisos sencillo:

Permisos de Jugador (otorgados a todos los jugadores por defecto)

• jobs.user – Permiso base de usuario
• jobs.join – Unirse a trabajos
• jobs.leave – Dejar trabajos
• jobs.info – Ver información del trabajo

Permisos de Administrador (otorgados automáticamente a los operadores del servidor)

• jobs.admin – Acceso administrativo completo

Sistema de Niveles

Fórmula de Experiencia

Experiencia requerida para el siguiente nivel: 100 × level^1.5

Ejemplos:

• Nivel 1→2: 100 XP
• Nivel 10→11: 3,162 XP
• Nivel 50→51: 35,355 XP
• Nivel 99→100: 98,995 XP

Escalado de Recompensas

Todas las recompensas escalan con el nivel del jugador: baseReward × (1 + level × 0.05)

Ejemplo: En el nivel 10, una recompensa base de 10 monedas se convierte en: 10 × (1 + 10 × 0.05) = 15 monedas

Integración y API

Integración Económica

SimpleJobs implementa la API de Economía de Cassaforte, asegurando:

• Depósitos automáticos de dinero en cuentas de jugadores
• Comportamiento económico consistente a través de complementos
• Compatibilidad a prueba de futuro con complementos de economía

API para Desarrolladores

val jobs = SimpleJobs.instance

// Obtener datos del trabajo del jugador
val jobPlayer = jobs.getJobPlayer(playerUuid, JobType.HUNTER)

// Verificar nivel del jugador
println("El jugador es nivel Cazador ${jobPlayer.level}")
println("Progreso: ${jobPlayer.getLevelProgress()}%")

Comenzando

Instalar – Coloca SimpleJobs.jar en la carpeta plugins/ de tu servidor

Instalar Economía – Asegúrate de que el complemento SimpleEconomy también esté instalado

Iniciar Servidor – Lanza tu servidor de Hytale

Configuración – Edita jobs_config.json para personalizar configuraciones

Unirse a un Trabajo – Los jugadores usan /jobs join <job> para comenzar a ganar!

Ejemplo de Juego

Experiencia de Nuevo Jugador:

Jugador: /jobs help
Servidor: === SimpleJobs ===
Servidor: ¡Gana dinero y XP a través de varios trabajos!
Servidor:
Servidor: Trabajos Disponibles:
Servidor:   cazador: Gana dinero matando monstruos
Servidor:   minero: Gana dinero minando minerales
Servidor:   leñador: Gana dinero talando árboles
Servidor:   agricultor: Gana dinero cultivando cosechas

Jugador: /jobs join cazador
Servidor: ¡Te uniste al trabajo de Cazador!
Servidor: Descripción: Gana dinero matando monstruos

Jugador: /jobs info cazador
Servidor: === Trabajo de Cazador ===
Servidor: Descripción: Gana dinero matando monstruos
Servidor: Tu Progreso:
Servidor:   Nivel: 1
Servidor:   Experiencia: 0.0 / 100.0
Servidor:   Progreso: 0.0%
Servidor:   Ganancias Totales: 0.00

Después de Matar un Mob:

Consola: [Cazador] Jugador mató a Mob - +10 XP, +5 monedas
Jugador: +10 XP (Cazador)
Jugador: +5 monedas añadidas a tu saldo

Requisitos

• Java 25+ – Requerido para complementos de servidor de Hytale
• Complemento SimpleEconomy – Requerido para recompensas y depósitos de dinero
• Servidor de Hytale – Última versión recomendada

Detalles Técnicos

• Lenguaje: Kotlin
• Arquitectura: Arquitectura Limpia con Casos de Uso
• Base de Datos: SQLite / PostgreSQL con ORM expuesto
• Caché: Caffeine (caché en memoria)
• Concurrencia: Corutinas de Kotlin
• Herramienta de Construcción: Gradle con complemento Shadow

Mejoras Futuras

Características planeadas para futuras versiones:

• Trabajo de Pescador – Atrapa peces y gana recompensas
• Clasificaciones de Trabajo – Mejores jugadores para cada tipo de trabajo
• Misiones Diarias – Desafíos específicos de trabajo
• Interfaz GUI – Selección visual de trabajos y visualización de progreso

Créditos

Construido para la comunidad de modding de Hytale.

Se integra con la API de Economía de Cassaforte para una gestión económica sin problemas.