Volver al blog
Scripts7 min de lectura

Agency-Minerjob: Cómo debería funcionar realmente un script de trabajo

Agency-Minerjob demuestra lo que se consigue al diseñar un trabajo de FiveM con profundidad y progresión, en vez de convertirlo en una rutina repetitiva.

Agency Scripts

Fundador y desarrollador principal en Agency Scripts

Por qué los trabajos suelen sentirse planos

La mayoría de los scripts de trabajo para FiveM son un ciclo repetitivo: ve a X, pulsa E, espera, vende en Y. Los jugadores lo hacen una vez para ganar dinero, nunca interactúan con él como RP y pasan a otra cosa. Agency-Minerjob se diseñó para que un solo trabajo merezca la pena durante decenas de horas gracias a la progresión, la profundidad social y la producción variable.

Una progresión de habilidades que importa

Los mineros suben de nivel desde novatos hasta maestros en aproximadamente 30 horas de juego. Cada nivel desbloquea nuevas zonas mineras, mejores herramientas, tipos de mineral más raros y una extracción más rápida. La progresión no es solo un multiplicador de ganancias, también desbloquea una experiencia de juego realmente distinta en cada etapa.

Mecánicas del entorno

La producción minera depende de la calidad de la ubicación, la hora del día, el clima y el estado de las herramientas. La mina de oro de noche, con buen tiempo y un pico bien mantenido, produce resultados distintos a los de la veta de carbón bajo la lluvia y con una herramienta desgastada. Estas variables no son evidentes para los jugadores nuevos, pero los mineros experimentados aprenden a optimizarlas, justo el tipo de dominio que mantiene los trabajos interesantes a largo plazo.

Profundidad social

La minería permite formar grupos de 2-6 jugadores con reservas de XP compartidas y multiplicadores de bonificación. Los grupos más grandes ganan más, pero son objetivos más visibles para los secuestros. Esto crea una experiencia social real, donde la coordinación importa y la confianza entre jugadores se convierte en una moneda dentro del juego.

El vínculo con la economía

Los minerales en bruto alimentan cadenas de refinamiento de las que depende el resto de la economía del servidor. Los fabricantes de armas necesitan metales. Los constructores necesitan materiales de construcción. Agency-Minerjob no es un ciclo repetitivo aislado, es un rol de proveedor dentro de un sistema económico más amplio. Eso es lo que hace que un trabajo realmente importe en el servidor.

Instalación y configuración

Agency-Minerjob requiere oxmysql para los datos de progresión de los jugadores y el seguimiento del rendimiento de mineral. Importa minerjob.sql, copia la carpeta del recurso y añade ensure agency-minerjob a server.cfg . Las coordenadas de las ubicaciones mineras, las definiciones de tipos de mineral y los objetos de la cadena de refinamiento se definen en config.lua, la configuración predeterminada incluye ocho ubicaciones mineras repartidas por el mapa predeterminado de GTA V.

Los objetos de mineral y de materiales refinados deben existir en el registro de objetos de tu framework. La configuración incluye definiciones completas de objetos para QBCore y ESX. Las configuraciones standalone gestionan la entrega y retirada de objetos mediante hooks de configuración.

Opciones de configuración

El config.lua ofrece un control detallado sobre las mecánicas del trabajo:

  • Calidad de la ubicación, cada yacimiento tiene un modificador de rendimiento base. Los yacimientos de mayor calidad producen más por acción, pero pueden requerir un nivel de habilidad superior para acceder a ellos.
  • Umbrales de nivel de habilidad, define la XP necesaria para cada nivel y qué desbloquea cada uno, como ubicaciones, herramientas y tipos de mineral.
  • Modificadores ambientales, activa o desactiva los efectos del clima y la hora del día sobre el rendimiento, y configura el rango del multiplicador.
  • Durabilidad de las herramientas, cuántas acciones de minería dura una herramienta antes de necesitar una reparación. Desactívala para simplificar la experiencia de juego.
  • Bonificación de grupo, el multiplicador de XP y rendimiento por cada miembro adicional del grupo, además del tamaño máximo del grupo.
  • Sistema de secuestros, activa eventos de emboscada de NPC hostiles o jugadores a partir de tamaños de grupo configurables.
  • Cadena de refinamiento, define qué minerales en bruto se refinan para obtener qué materiales, con qué proporción y tiempo requerido.

Compatibilidad con frameworks

El paquete incluye adaptadores completos para QBCore y ESX. Para standalone, implementa cinco funciones de configuración: entregar y retirar objetos, añadir dinero, comprobar el trabajo (para acceder a la zona minera) y almacenar la XP. El motor de progresión de habilidades, el sistema de grupos, las mecánicas ambientales y la cadena de refinamiento son independientes del framework.

Por qué esto importa para el roleplay

Un trabajo que existe únicamente como fuente de ingresos siempre se sentirá vacío. Agency-Minerjob trata el trabajo de minería como una profesión con verdadera profundidad. Un personaje que lleva 30 horas minando realmente ha desarrollado algo: conocimiento de las ubicaciones, habilidad con las herramientas, una red de compañeros de grupo y relaciones con refinadores y compradores. Ese capital que el personaje ha acumulado es lo que hace que el RP laboral sea sostenible.

El sistema de grupos, en particular, crea interacciones sociales de RP que la mayoría de los scripts de trabajos no ofrecen. Dos jugadores que minan juntos no solo duplican la producción, también conversan, construyen confianza y deciden si invitan a una tercera persona a la que todavía no conocen del todo. El riesgo de secuestro cuando los grupos son más grandes obliga a evaluar la confianza: ¿vale la pena traer a este desconocido si eso nos convierte en un objetivo más grande?

La integración con la cadena de suministro es la función que convierte Agency-Minerjob de un «script de minería» en una «capa de economía del servidor». Cuando los fabricantes de armas, los constructores y los fabricantes de kits de reparación necesitan materiales que vienen de la minería, el trabajo de minero siempre tiene relevancia. Los mineros no solo acumulan recursos por su cuenta, también abastecen a otros jugadores y tienen relaciones con sus compradores.

Preguntas frecuentes

¿Puedo añadir ubicaciones de minería en mapas personalizados de un DLC o MLO?

Sí. Las ubicaciones de minería se definen mediante coordenadas y un radio en config.lua. Añade las coordenadas del interior de tu MLO con una marca de interior, y Agency-Minerjob detectará automáticamente la entrada al interior. Añadir tipos de mineral personalizados en ubicaciones personalizadas es igual de sencillo.

¿Cómo se guarda la progresión de habilidades al reiniciar el servidor?

Los datos de habilidades se guardan en oxmysql y se vinculan al identificador del jugador. La progresión se conserva después de reinicios, cambios de framework e intercambios de personajes (con sistemas de múltiples personajes). El progreso solo se reinicia si ejecutas manualmente el SQL de borrado o cambia el identificador del jugador.

¿Puedo desactivar las mecánicas ambientales para tener un servidor más sencillo?

Sí. Configura Config.UseEnvironmentalModifiers = false en config.lua. El rendimiento dependerá entonces únicamente del nivel de habilidad, la calidad de la herramienta y la calidad de la ubicación, un sistema más sencillo que aun así mantiene los niveles. Puedes volver a activar las mecánicas ambientales más adelante; la progresión existente de los jugadores se conservará sin problemas.

¿Agency-Minerjob está equilibrado para servidores donde es la fuente principal de ingresos, en lugar de ser uno de muchos trabajos?

La configuración predeterminada da por hecho que la minería es una de varias opciones de trabajo. Si es tu fuente principal de ingresos, aumenta las tasas de rendimiento entre un 40 y un 60 % en general, hay un Config.GlobalYieldMultiplier para este propósito exacto. No ajustes las tasas de ubicaciones individuales para compensarlo, usa el multiplicador global para mantener el equilibrio relativo.

Requisitos

  • Servidor FiveM (QBCore, ESX o standalone)
  • oxmysql
  • cuenta de cfx.re con una licencia válida de Agency-Minerjob
  • Opcional: Agency-Repairkit (para integrar la fabricación)
  • Opcional: Agency-Blackmarket (para conectar con la economía de venta de minerales)

Dirigir una empresa minera

El sistema de grupos y el seguimiento de progresión de Agency-Minerjob permiten dirigir empresas mineras reales como negocios del servidor, en lugar de limitarse a que cada jugador acumule recursos por su cuenta. Así funciona una empresa minera en la práctica:

El personaje propietario de la empresa recluta trabajadores (otros jugadores), los asigna a ubicaciones de minería según su nivel de habilidad y organiza ventas al por mayor de materiales refinados a fabricantes de armas, constructores o al mercado negro. La logística de coordinar a varios mineros, gestionar el suministro de herramientas (asegurándose de que todos tengan buenas herramientas) y proteger los grandes cargamentos de mineral frente a secuestros genera una complejidad organizativa real.

El multiplicador de bonificación por grupo crea un incentivo económico para coordinarse que no se diseñó de forma artificial, sino que surgió de las mecánicas. Cinco mineros que se coordinan ganan bastante más por hora que cinco mineros en solitario que hacen lo mismo. Eso significa que el esfuerzo de coordinación tiene un beneficio económico cuantificable. Esa es la condición de diseño que hace sostenibles a las organizaciones empresariales: organizarse debe ser más rentable que trabajar en solitario, o los jugadores no se molestarán en asumir el esfuerzo de coordinarse.

El script adecuado

Listo para tu servidor, con actualizaciones incluidas.

¿Listo para empezar?

Consigue los scripts en nuestra tienda, o únete al Discord para soporte, novedades y un adelanto de lo que viene.