QSJobs Plugin (Jobs + Misiones)

Sistema de trabajos para servidores de Minecraft (Paper 1.21+).

Combina:

• Jobs (trabajos con niveles)
• Misiones por capítulos (tipo historia/progresión)
• Economía integrada
• Sistema de XP y Level Up

✨ Características

‍ Jobs

• Sistema de trabajos con:
  • Nivel
  • XP
  • Recompensas por acción
  • Recompensas por nivel
• Límite de jobs por jugador (por permisos)
• Progreso guardado en SQLite

Misiones (Sistema por capítulos)

• Sistema tipo RPG / historia
• Progresión lineal por capítulos
• Misiones automáticas basadas en acciones del jugador
• Compatible con:
  • mobs normales
  • MythicMobs
  • WorldGuard (regiones)
  • NPCs (metadata)

Estructura de Misiones



Tipos de misiones soportadas

• BREAK
• PLACE
• KILL
• KILL_BOSS
• KILL_MYTHIC_MOB
• DAMAGE
• FISH
• ENCHANT
• BREW
• FARM
• INTERACT
• INTERACT_ENTITY
• CONSUME
• USE_ITEM
• ENTER_REGION
• LEAVE_REGION

Ejemplo real

✔ El jugador mata zombies
✔ Se detecta automáticamente
✔ Se actualiza progreso
✔ Se paga recompensa al completar



⚙️ Cómo funciona internamente

Flujo de eventos

1. Jugador hace acción (romper, matar, etc)
2. Listener detecta evento
3. Se ejecuta:
   • Code (Text):

     handleMission(...)
   • Code (Text):

     handleJobs(...)

Misiones

• Se valida:
  • capítulo actual
  • misión actual
  • tipo de acción
  • target
• Se aumenta progreso
• Se muestra en ActionBar:

• Al completar:
  • ✔ mensaje
  • dinero
  • ⚙ comandos
  • ➡ siguiente misión

Jobs

• Se valida:
  • si tiene el job
  • permisos
  • acción válida
• Se da:
  • dinero
  • XP

Sistema de niveles

XP requerida:

Ejemplo:

• Nivel 1 → 100 XP
• Nivel 2 → 200 XP
• Nivel 3 → 300 XP

Recompensas por nivel

Configurable en :

✔ Se ejecuta automáticamente al subir de nivel



️ GUI de Jobs

El menú muestra:

• Nivel actual
• XP actual
• Barra de progreso
• Estado del job

Ejemplo visual

Barra de progreso



Base de datos

SQLite automática:

Tablas

• player_jobs
• player_missions
• player_chapters

✔ Sin configuración externa
✔ Guardado automático



Permisos

Define cuántos jobs puede tener el jugador.



Compatibilidad

• ✔ Vault (economía)
• ✔ MythicMobs
• ✔ WorldGuard
• ✔ Citizens (NPC metadata)

Instalación

1. Coloca el
   Code (Text):

   .jar
   en
   Code (Text):

   /plugins
2. Inicia servidor
3. Edita:
   • Code (Text):

     jobs.yml
     para trabajos
   • Code (Text):

     missions.yml
     para misiones
   • Code (Text):

     messages.yml
     para mensajes
   • GUIs:
     • Code (Text):

       chapter.yml
       para misiones
     • Code (Text):

       gui.yml
       para trabajos
4. Reinicia

Tips avanzados

• Usa
  Code (Text):

  ANY
  para targets globales
• Puedes mezclar:
  • jobs → farmeo infinito
  • misiones → progresión guiada
• Usa comandos para recompensas personalizadas

Ideas futuras

• Soporte de PlaceholderAPI (scoreboard/tablist)
• Completar mensajes faltantes
• Soporte Bedrock para menús
• Skills por job

‍ Autor

Desarrollado por Quesito_ecu
⚙️ Framework RPG modular para Minecraft

Discord:
https://dsc.gg/quesitosvr



Licencia

Libre uso para servidores.
Modifica bajo tu responsabilidad.