Venir d’un autre framework

01Ce que Nova reprend à sa charge

Nova est bâti sur QBox et fournit déjà le socle d'une ville : le framework, l'inventaire, le téléphone, le ciblage, le panel d'administration en jeu, tenus à jour par nous. Une migration ne consiste donc pas à transporter tout votre ancien serveur, mais à reprendre ce qui vous est propre : vos scripts uniques, leurs données, et le réglage de votre ville.

Sur la page du serveur, répondez « Migrer depuis ESX, QBCore ou autre » à la question de la liste « Ma ville est prête ? » : les étapes et les articles proposés s'adaptent. Pour comparer les frameworks avant de vous lancer, lisez ESX, QBCore ou QBox ; pour le détail du passage, migrer d'ESX ou de QBCore vers QBox.

02Vos scripts QBCore et QBox

Un script écrit pour QBox trouve le cœur qu'il attend. Beaucoup de scripts écrits pour QBCore passent par le pont de compatibilité de QBox, actif par défaut : c'est le réglage « Bridge QB » de l'écran Configuration, section « Framework QBox ». Laissez-le actif tant qu'un de vos scripts en a besoin.

Déposez les scripts dans resources/[client] depuis l'écran Fichiers, activez-les dans la carte « Ressources », redémarrez, puis testez-les un par un en jeu. La plupart des scripts récents chargent ox_lib : dans leur fxmanifest, la ligne @ox_lib/init.lua se remplace par @nova_lib/shared/lib_init.lua (ajouter vos propres scripts détaille le reste).

03Vos scripts ESX et alt:V

Un script écrit pour ESX ne fonctionnera pas sans être adapté : ses appels au framework n'existent pas sous QBox. Nova ne convertit pas de script ; comptez une réécriture de la partie qui parle au framework, la logique propre au script se garde souvent.

Un serveur alt:V ne se transpose pas tel quel : l'API de FiveM est différente, et la couche qui parle au jeu se réécrit. Le guide migrer d'alt:V vers FiveM dit ce qui se reprend, ce qui se réécrit, et dans quel ordre s'y prendre.

04Ce qu’il ne faut pas importer

N'importez ni un framework entier, ni ses ressources de base : inventaire, téléphone, ciblage, HUD, gestion des personnages. Nova les fournit déjà, et deux versions de la même ressource se marchent dessus même sous des noms différents. Un dossier qui porte le nom d'une ressource du framework Nova ne peut pas être activé : la carte « Ressources » le range dans « À corriger ».

05Vos données

Personnages, inventaires et véhicules ne sont pas convertis automatiquement : la base de Nova n'a pas la même forme que celle d'ESX ou de QBCore, et vos joueurs recréent leur personnage. Annoncez-le à votre communauté avant l'ouverture.

Les données de vos propres scripts, elles, se reprennent. Exportez seulement leurs tables depuis l'ancien serveur, puis importez le fichier .sql dans la base principale : Bases de données, « Gérer », puis « Importer un fichier .sql ». C'est elle que lisent les scripts qui passent par oxmysql, comme la plupart.

Un export complet de l'ancienne base sera refusé : le fichier est relu en entier avant de s'exécuter, et une seule instruction qui nomme une table du framework Nova (players, users, player_vehicles…) suffit pour que rien ne parte. Une fois l'import lancé, la première instruction en erreur l'arrête, et celles qui la précèdent restent appliquées. Le fichier est limité à 10 Mo et 50 000 instructions ; découpez un gros export, et faites une sauvegarde avant (bases de données).

06Votre ville, et si un point bloque

Métiers, économie, objets, propriétés et permissions se recréent en jeu avec /admin, sans toucher à un fichier ; le guide configurer un serveur FiveM en jeu en fait le tour. Si un point bloque, ouvrez une demande depuis la page du serveur : elle joint son état, et dites au support que vous migrez et depuis quel framework.