Actualizar desde versionesanteriores

Radial Menu 2.x sustituye a las versiones 1.x y a las primeras 2.0. El nombre del recurso y los exports son los mismos, pero la configuración se movió a config/, la interfaz se reconstruyó y todo lo que guarda el editor del juego ahora está en la base de datos en lugar de en archivos JSON dentro de la carpeta del recurso.

Mezclar archivos antiguos y nuevos no funciona: una interfaz antigua con los scripts nuevos, o al revés, abre un editor vacío o ninguno. Sustituye la carpeta entera y luego vuelve a copiar tus propias modificaciones.

Qué se ha movido#

Cada archivo que probablemente editabas tiene una nueva ubicación:

Se conservan el aspecto y los atajos de cada jugador. Se guardan en el PC del jugador con el mismo nombre que antes, y los ajustes nuevos completan lo que los antiguos no tenían.

Actualización paso a paso#

1. Haz una copia de seguridad de la carpeta antigua

   Copia qs-radialmenu en algún lugar fuera de resources/. Necesitas su config.lua, menu.lua, cualquier archivo de ropa o de idioma que hayas editado, y todos los archivos .json que contenga.

2. Sustituye la carpeta

   Detén el servidor, borra la antigua qs-radialmenu y pon la nueva en su lugar. Mantén el mismo nombre. Asegúrate de que ensure oxmysql vaya antes en server.cfg; las versiones antiguas no lo necesitaban.

3. Traslada tus modificaciones

   Copia tus ajustes en config/main.lua valor por valor, y tu árbol de menú en config/menu.lua. No pongas el antiguo config.lua encima del nuevo: 2.x añade Config.CloseKeys, Config.DevOpenEditor y Config.Clothing.

4. Inícialo una vez

   Inicia el servidor. El primer inicio crea la tabla qs_radialmenu. Si nunca usaste el antiguo /radialedit, ya has terminado.

5. Trae los datos del editor

   Cada archivo JSON antiguo se convierte en una fila, con exactamente el mismo contenido. Pega el texto de cada archivo entre las comillas y ejecútalo en tu base de datos (HeidiSQL, phpMyAdmin o el panel de tu hosting); omite las líneas de los archivos que no tengas:

   INSERT INTO `qs_radialmenu` (`name`, `data`) VALUES
       ('menu_overrides',  '<contents of menu_overrides.json>'),
       ('custom_registry', '<contents of custom_registry.json>'),
       ('server_defaults', '<contents of server_defaults.json>')
   ON DUPLICATE KEY UPDATE `data` = VALUES(`data`);

   Si una etiqueta contiene un apóstrofo, duplícalo (''). Después reinicia el recurso: las filas se leen al iniciarse. ¿Prefieres no tocar SQL? Abre /radialedit y recréalo; Import from menu.lua te ahorra la mayor parte del trabajo.

6. Guarda los permisos una vez

   Los aspectos de servidor antiguos usaban dos interruptores, allowPlayersChangeColorsShapes y allowPlayersReposition. La versión actual no lee ninguno, así que ambos cuentan como permitidos hasta que abras /radialedit → Permissions, configures los tres interruptores y guardes.

Qué cambia para tu staff y tus jugadores#

Para desarrolladores#

AddCategory, AddItem, AddOption y RegisterItemProvider siguen existiendo, así que los scripts escritos para versiones antiguas siguen cargando. Por debajo cambiaron dos cosas:

• Las categorías se buscan solo por ID. Una llamada como AddItem('Vehicle', ...) que dependía de una etiqueta ahora devuelve category not found.

• Los ítems van en categorías creadas por un export. Para poner botones bajo una sección de config/menu.lua, asigna a esa sección un id, crea tu propia categoría con parent apuntando a ella y añade los ítems a la tuya.

El código nuevo debería usar CreateCategory y CreateItem; Comandos y exports incluye ambos, con ejemplos.

Comprobar la actualización#

• La consola del servidor muestra Server framework loaded con tu framework, y ninguna línea roja de qs-radialmenu.

• F3 abre la rueda con tu menú dentro.

• /radialedit se abre con cuatro pestañas (Menu, Actions, Appearance, Permissions) y, si trajiste los datos, tu árbol y tus acciones antiguas están en él.

• Un jugador que había personalizado la rueda sigue viendo su propio aspecto.

Volver atrás es seguro: la versión actual nunca escribe en los archivos JSON antiguos, así que restaurar la carpeta de la copia de seguridad devuelve la versión antigua exactamente como estaba.