Uso

Las pantallas#

Gym Creator tiene una ventana para construir gimnasios y tres pequeñas pantallas que los jugadores encuentran mientras entrenan. Ayuda saber desde el principio cuál es cuál.

Cada gimnasio se configura por gimnasio, en el juego. config/main.lua solo contiene los valores predeterminados y el calendario de todo el servidor: consulta la Referencia de configuración al final de esta página.

El creador#

/gymcreator abre a la izquierda una lista de todos los gimnasios y a la derecha el editor. La lista se puede buscar por nombre de gimnasio o de blip, y cada tarjeta muestra el logo del gimnasio, su número de estaciones y el precio de su membresía, con un botón teleport que te lleva a su blip tras una confirmación. Pulsa + para empezar un gimnasio nuevo, o haz clic en una tarjeta para editarlo.

El editor tiene cinco paneles. Rellénalos de arriba abajo y luego pulsa Create gym, o Save al editar. El gimnasio aparece para todos los jugadores al instante.

General#

Map blip#

La etiqueta, el sprite y el color del blip (estos dos elegidos de listas con búsqueda y vista previa), su escala (de 0.2 a 1.0; 0.8 es un blip de mapa estándar) y sus coordenadas. Pulsa Select, apunta al lugar y haz clic izquierdo.

Reception NPC#

El modelo de ped de la recepcionista (cualquier ped de GTA, a_f_y_fitness_01 por defecto) y dónde se coloca. Pulsa Select y una copia transparente de ese ped sigue tu punto de mira: usa la rueda para girarlo, las flechas para subirlo o bajarlo y haz clic izquierdo para colocarlo. Los jugadores compran su membresía a este NPC.

Exercise stations#

Una estación es un lugar donde se hace un ejercicio. Elige un ejercicio en Add station y luego pulsa Select: aparece un clon transparente de tu propio personaje en la pose de reposo del ejercicio (tumbado para las flexiones, colgado de la barra para las dominadas) para que puedas alinearlo con el banco, la barra o el saco reales. Añade tantas estaciones como quieras, de cualquier ejercicio y en cualquier orden.

Los campos que no toques usan los valores propios del ejercicio en config/exercises.lua, así que la mayoría de las estaciones solo necesitan una posición. El multiplicador del gimnasio se aplica encima.

Decoration props#

Bancos, barras, soportes de pesas, una cinta de correr y una estructura de dominadas, colocados en cualquier lugar: útil cuando no tienes un MLO de gimnasio y quieres convertir una sala vacía o una playa en uno. Elige un modelo en Add prop, pulsa Select y colócalo igual que la recepcionista.

Los props son solo decoración: se generan en el juego de cada jugador, congelados, y no cuestan nada al servidor. Una estación es lo que hace utilizable un lugar: coloca una encima de un prop para entrenar en él.

Controles de colocación#

Cada Select cierra la ventana y te deja apuntar con la cámara normal. Un marcador rojo muestra dónde quedará el punto, hasta a 50 metros, y las teclas aparecen en la parte inferior de la pantalla.

El creador se vuelve a abrir solo después de cada colocación, con las coordenadas rellenadas.

Editar y eliminar#

Haz clic en un gimnasio de la lista, cambia lo que quieras y pulsa Save: la recepcionista, las estaciones, los props y el blip se regeneran para todos los jugadores al momento. Delete elimina el gimnasio tras una confirmación; no se puede deshacer. Los jugadores que tenían una membresía allí conservan sus estadísticas.

Membresías#

Un jugador se acerca a la recepcionista y elige Purchase Membership. La pantalla muestra el logo del gimnasio, el precio y la duración en días, y le permite pagar con efectivo o banco. Se cobra el dinero y la membresía cuenta desde ese momento durante el número de días del gimnasio.

Los precios y fechas de esta pantalla se formatean con Config.Intl: tu símbolo de moneda, decimales y estilo de fecha.

Entrenar#

Ve a una estación y elige Start … (por ejemplo Start Push-ups). El servidor comprueba primero la membresía; sin ella el jugador ve "You do not have an active membership here."

1. Colócate en posición

   El personaje se mueve a la estación, se gira hacia donde la colocaste y se congela. Los props del ejercicio (la barra de curl para los curls con barra) se le ponen en las manos y se reproduce la animación de entrada.

2. Pulsa SPACE en cada repetición

   La superposición aparece a la izquierda, o a la derecha con Config.ExerciseUIPosition = 'right'. Cada pulsación reproduce una repetición y hace avanzar la barra; la siguiente pulsación se acepta cuando termina la repetición.

3. Termina la serie

   Al 100 % el personaje se levanta, se retiran los props y se añade la recompensa. Pulsa DELETE en cualquier momento para parar: una serie sin terminar no da nada.

Mientras una serie está en curso, el jugador no puede esprintar, saltar, disparar ni golpear, y no puede alejarse a menos que el ejercicio esté configurado con freeze = false.

Fuerza y resistencia#

Ambas estadísticas empiezan en 0 y se detienen en 100. Se guardan por personaje, así que un jugador con dos personajes entrena a cada uno.

Lo que da una serie. La recompensa de la estación (o la predeterminada del ejercicio) multiplicada por el multiplicador de estadísticas del gimnasio. Una serie de flexiones da 6 de fuerza y 3 de resistencia en un gimnasio de 1.0×, y 12 y 6 en uno de 2.0×.

Lo que hacen las estadísticas. Con Config.AffectPedStats = true (el valor predeterminado), ambas se escriben en las estadísticas propias de GTA MP0_STRENGTH y MP0_STAMINA, que cambian cuánto tiempo puede esprintar un jugador y lo fuerte que golpea. Se vuelven a aplicar cuando el jugador aparece y cada vez que cambian.

El HUD. F10 (o /gymstats) muestra ambas como medidores en la parte superior de la pantalla y vuelve a ocultarlas. Los jugadores pueden reasignarlo en Settings → Key Bindings → FiveM; la tecla predeterminada es Config.StatsHUDKey.

Una serie terminada solo puede contarse una vez cada tres segundos por jugador, y el servidor comprueba que la estación realmente tenga ese ejercicio en ese gimnasio. Un cliente modificado no puede inventar recompensas ni saltarse el entrenamiento.

Degradación diaria#

Una vez al día, a la hora de Config.StatDecay.hour y minute (22:00 hora del servidor por defecto), la fuerza y la resistencia bajan. Cuánto depende del último gimnasio en el que el jugador tuvo membresía:

Las estadísticas nunca bajan de 0. La degradación alcanza también a los jugadores desconectados (se aplica en la base de datos), y los jugadores conectados ven su HUD actualizarse al instante. Se ejecuta como máximo una vez al día: si el servidor está apagado en el minuto programado, esa noche se omite en lugar de recuperarse más tarde.

Para desactivar la degradación en todo el servidor, sin importar el ajuste de cada gimnasio:

Config.StatDecay = {
    enabled = false,
    hour = 22,
    minute = 0,
}

El catálogo de ejercicios#

Seis ejercicios vienen en config/exercises.lua. Estos son los valores predeterminados que usa una estación cuando no defines los suyos:

Añadir tu propio ejercicio#

Añade una entrada a Config.Exercises y aparecerá en la lista Add station del creador tras un reinicio, sin cambios de código. Dale una traducción en exercise en tu archivo de idioma.

Config.Exercises.yoga = {
    labelKey = 'exercise.yoga',   -- add "yoga": "Yoga" under "exercise" in locales/en.json
    stamina = 5,
    strength = 1,
    idleDict = 'amb@world_human_yoga@male@base',
    idleAnim = 'base_a',
    actionDict = 'amb@world_human_yoga@male@base',
    actionAnim = 'base_b',
    actionTime = 3000,
    actionProcent = 1,
    actionProcentTimes = 10,
    freeze = true,
}

Un diccionario de animación que no existe se omite con un aviso en la consola F8 en lugar de romper el ejercicio, así que una errata aparece como una fase que falta, no como un jugador atascado.

Referencia de configuración#

Todo lo que hay en config/main.lua: