Migrardesde 1.x

Gym Creator 2.0 sustituye a Realistic Gym (qs-gym 1.x). Es una reescritura, no una actualización: el único gimnasio definido en la configuración antigua se convierte en cualquier número de gimnasios construidos en el juego, y los datos de los jugadores pasan de la antigua tabla gym_data a la nueva qs_gym_player_data. Las consultas de esta página trasladan la fuerza y resistencia de tus jugadores, para que nadie pierda su progreso.

Actualizar paso a paso#

1. Detén el servidor y haz una copia de seguridad de la base de datos

   Exporta toda la base de datos, o al menos gym_data, con HeidiSQL, phpMyAdmin o la herramienta de copias de seguridad de tu panel.

2. Elimina Realistic Gym

   Borra la antigua carpeta qs-gym de tus recursos y quita su línea ensure de server.cfg. Dos versiones ejecutándose a la vez generarían NPCs y escribirían las mismas estadísticas nativas.

3. Instala Gym Creator

   Sigue Instalación: copia la nueva carpeta, añádela a server.cfg después de tu framework e importa database/database.sql.

4. Copia la fuerza y la resistencia

   Realistic Gym guardaba cada personaje en una fila de gym_data: el id del personaje en citizenid y todo lo demás como JSON en data. Ejecuta esta consulta en la misma base de datos: lee ambas estadísticas del JSON, las redondea hacia abajo y las mantiene entre 0 y 100:

   INSERT IGNORE INTO `qs_gym_player_data` (identifier, strength, stamina, last_decay)
   SELECT
       citizenid,
       LEAST(100, GREATEST(0, FLOOR(CAST(COALESCE(JSON_UNQUOTE(JSON_EXTRACT(`data`, '$.strength')), '0') AS DECIMAL(10,2))))),
       LEAST(100, GREATEST(0, FLOOR(CAST(COALESCE(JSON_UNQUOTE(JSON_EXTRACT(`data`, '$.stamina')),  '0') AS DECIMAL(10,2))))),
       0
   FROM `gym_data`
   WHERE citizenid IS NOT NULL AND `data` IS NOT NULL;

   Es seguro ejecutarla más de una vez: se omiten los jugadores que ya tienen una fila. Ambas versiones identifican a un personaje de la misma forma, el identifier de ESX o el citizenid de QBCore / Qbox, así que cada fila llega al personaje correcto.

5. Opcional: conserva las membresías activas

   Inicia el servidor, construye tu primer gimnasio con /gymcreator y anota su id: aparece en el título del editor, Edit gym #1. Después ejecuta esta consulta con @default_gym_id igual a ese id. Todos aquellos cuya membresía de 1.x aún no ha vencido conservan la misma fecha de vencimiento, en ese gimnasio:

   SET @default_gym_id = 1;
   
   UPDATE `qs_gym_player_data` p
   INNER JOIN `gym_data` g
       ON p.identifier = CONVERT(g.citizenid USING utf8mb4) COLLATE utf8mb4_unicode_ci
   SET p.membership_gym_id = @default_gym_id,
       p.membership_expiry = CAST(JSON_UNQUOTE(JSON_EXTRACT(g.`data`, '$.membershipExpiry')) AS UNSIGNED)
   WHERE CAST(COALESCE(JSON_UNQUOTE(JSON_EXTRACT(g.`data`, '$.membershipExpiry')), '0') AS UNSIGNED) > UNIX_TIMESTAMP();

6. Vuelve a construir tus gimnasios

   Usa /gymcreator para colocar los gimnasios que tenías: el blip, la recepcionista, una estación por ejercicio y, si no usas ningún MLO, los bancos y pesas a su alrededor. Uso explica cada panel.

7. Elimina la tabla antigua

   Cuando hayas comprobado a algunos jugadores en el juego (F10 muestra sus estadísticas), elimina la tabla antigua:

   DROP TABLE gym_data;

Ambas consultas necesitan funciones JSON, disponibles en MySQL 5.7+ y MariaDB 10.2+, todas las versiones que admite oxmysql. Si obtienes Unknown column 'identifier', ejecutaste una consulta escrita para otra estructura de tabla; usa las de esta página.

Qué cambió para los jugadores#

• Un gimnasio es ahora un lugar en el mapa con su propia recepcionista, precio y duración de membresía: un servidor puede tener un gimnasio público barato y otro premium caro.

• Una membresía pertenece a un gimnasio. Comprar una en otro gimnasio la traslada allí.

• Las estadísticas siguen yendo de 0 a 100 y siguen alimentando la fuerza y la resistencia nativas de GTA, pero cada gimnasio decide cuánto da un entrenamiento y si sus miembros pierden estadísticas durante la noche.

• Una serie completada da una recompensa fija, definida por ejercicio o por estación, en lugar de un rango aleatorio.

• Los ejercicios de 1.x bench y dumbbells no están en el catálogo de 2.0. Las flexiones, los abdominales, las dominadas y los curls con barra sí lo están, junto con el nuevo saco de boxeo y la cinta de correr, y puedes añadir los tuyos en config/exercises.lua (consulta Uso).

• F10 activa o desactiva un pequeño HUD con ambas estadísticas.