QBox hébergé et étendu : 67 modules prêts

01QBox en bref : ce que fait le framework

QBox, dont le cœur s'appelle qbx_core, est né le 27 septembre 2022 pour succéder à qb-core, le cœur de QBCore. Il est publié sous licence GPL-3.0 par le projet Qbox et ses contributeurs, et s'appuie sur des briques reconnues de l'écosystème FiveM : ox_lib pour les fonctions communes, oxmysql pour parler à la base de données.

• Plusieurs personnages par compte, avec leur création et leur choix à la connexion.
• Plusieurs métiers et plusieurs gangs par joueur, si le serveur le permet.
• Une file d'attente intégrée, pour les soirs où le serveur est plein.
• Un pont de compatibilité, qui fait répondre QBox à la plupart des ressources écrites pour QBCore.
• Une interface de programmation par exports, pour lire et écrire les données du cœur depuis un autre script.

Ce que QBox n'est pas, en revanche, c'est une ville. Le cœur sait qu'un joueur est policier, combien il a en banque et à quel grade il travaille ; il ne fournit ni terminal de police, ni téléphone, ni guichet, ni concession. Tout cela s'ajoute par-dessus, ressource par ressource, et c'est là que commence le vrai travail d'un serveur roleplay.

02Héberger QBox soi-même : ce que ça demande

Monter un serveur QBox à la main suit presque toujours le même chemin, que l'on parte d'une machine nue ou d'un hébergeur de jeux qui ne fournit que la machine :

1. Une machine pour faire tourner FXServer, le serveur de FiveM, et une base MariaDB ou MySQL à côté.
2. Une clé Cfx, créée sur le portail Cfx.re, sans laquelle le serveur ne démarre pas.
3. Le cœur qbx_core et ses dépendances (ox_lib, oxmysql), puis l'inventaire, le ciblage et la voix, chacun dans une version compatible avec les autres.
4. Les ressources de la ville : métiers, police, santé, téléphone, véhicules, logements, à choisir, installer et accorder entre elles.
5. La configuration, dans des fichiers Lua : les métiers de QBox vivent dans shared/jobs.lua, les gangs dans shared/gangs.lua, et chaque script ajoute les siens.
6. Les mises à jour : suivre FiveM, QBox et chaque script, puis rejouer ses propres retouches à chaque nouvelle version.

Rien de tout cela n'est hors de portée d'un développeur. C'est simplement un métier à part entière, qui ne s'arrête pas le jour de l'ouverture : le guide combien coûte un serveur FiveM le chiffre poste par poste, sur douze mois.

03QBox hébergé par Nova : le cœur gardé d'origine

Nova ne réécrit pas QBox. Le cœur qbx_core est livré tel que le projet Qbox le publie, en source, à un seul correctif près : une vérification ajoutée à la suppression d'un personnage, qui empêche un client modifié d'effacer les personnages des autres joueurs. Ce correctif est déclaré dans la notice de la ressource, et réappliqué à chaque nouvelle version du cœur.

Garder le cœur d'origine, c'est garder ce qui fait l'intérêt de QBox : son interface de programmation, son pont vers QBCore, et la compatibilité avec ce que la communauté écrit pour lui. Un script pensé pour QBox appelle qbx_core, et il le trouve, à l'endroit où il l'attend.

04Ce que Nova ajoute : 67 modules, une ville entière

Par-dessus le cœur, Nova livre 67 modules écrits pour lui, livrés et mis à jour ensemble. Ils se rangent en onze familles :

Ces modules ne sont pas des scripts posés côte à côte. Ils partagent la même configuration, la même interface et le même calendrier de mises à jour, et ils écrivent dans QBox au lieu de le contourner : un métier créé dans le panneau est inscrit dans qbx_core lui-même, si bien qu'un script tiers qui lit le métier d'un joueur voit ceux que vous avez créés en jeu.

05Les ressources QBox remplacées, sous leur nom d'origine

Un serveur QBox classique tourne avec une série de ressources compagnes : clés de véhicule, véhicules des joueurs, santé, apparition, carte d'identité, ciblage. Nova les remplace par ses propres modules, mais ceux-ci répondent sous le nom d'origine. Un script qui appelle les clés ou le ciblage de QBox trouve donc ce qu'il cherche, sans la moindre adaptation.

• qbx_vehiclekeys : les clés, qui peut ouvrir, démarrer, prêter ou voler un véhicule.
• qbx_vehicles : les véhicules de chaque joueur, leur propriété et leur état, en base.
• qbx_medical et qbx_ambulancejob : le moteur médical et le SAMU.
• qbx_spawn et qbx_idcard : l'apparition en ville et les papiers d'identité.
• ox_target, ainsi que l’ancien qtarget : le ciblage, par le moteur de ciblage de Nova.
• ox_lib fait exception : ox_lib est fourni par nova_lib, et aucun dossier ox_lib n'existe sur le disque : dans le fxmanifest d'un script, la ligne @ox_lib/init.lua se remplace par @nova_lib/shared/lib_init.lua, sinon la console affiche « Failed to load script ».

06Configuré en jeu, pas dans les fichiers Lua

Sur un QBox monté à la main, créer un métier veut dire éditer un fichier, puis redémarrer. Sur Nova, métiers, grades, salaires, gangs, économie, objets, propriétés et permissions se règlent depuis le jeu, en tapant /admin : un panneau d'administration de 40 écrans écrit en base de données, et la plupart des réglages s'appliquent aussitôt.

Les rangs de votre équipe viennent des rôles de votre Discord : le serveur se relie au bot Discord de Nova, et retirer un rôle sur Discord retire le rang en jeu. Les journaux du staff, eux, partent dans les salons que vous choisissez.

07QBox monté soi-même ou QBox hébergé : la comparaison

Le premier chemin donne la main sur tout, y compris sur ce qui casse. Le second retire le travail d'assemblage et d'entretien, avec une règle en échange : le framework et ses modules restent gérés par nous. La comparaison complète, hébergeur nu contre serveur hébergé, est dans hébergement FiveM RP.

08Vos scripts QBCore et QBox sur un QBox hébergé

Vos propres ressources se déposent dans le dossier resources/[client], depuis l'écran Fichiers de l'espace client, en fichiers ou en archive .zip ou .tar.gz. Une ressource nouvelle arrive éteinte : vous l'activez, puis vous redémarrez le serveur. La documentation détaille chaque étape.

Les scripts écrits pour QBox trouvent le cœur qu'ils attendent, et la plupart de ceux écrits pour QBCore passent par le pont de compatibilité, activé par défaut. Presque tous chargent ox_lib, et demandent donc une retouche de leur manifeste. ox_lib est fourni par nova_lib, et aucun dossier ox_lib n'existe sur le disque : dans le fxmanifest d'un script, la ligne @ox_lib/init.lua se remplace par @nova_lib/shared/lib_init.lua, sinon la console affiche « Failed to load script ». Les données de vos scripts se reprennent aussi : leur fichier .sql s'importe dans une base supplémentaire, depuis l'écran Bases de données (NOVA+ en offre une en plus de celle du framework, NOVA INFINITY deux).

09Combien coûte un QBox hébergé et étendu

Un abonnement par serveur, hébergement, mises à jour et support compris, sans frais d'installation : NOVA à 99 € par mois pour 64 joueurs, NOVA+ à 149 € pour 128 joueurs, NOVA INFINITY à 229 € pour 256 joueurs, extensible jusqu'à 1 024 joueurs avec des places en supplément. En annuel, dix mois sont payés pour douze.

Avant la première version stable, seules les offres qui donnent accès au canal beta s'achètent. La clé Cfx reste à votre nom : elle se crée sur le portail Cfx.re, et Nova ne la vend pas.

Pour voir ce que comprend chaque offre et ce qui est ouvert aujourd'hui, passez par la page des tarifs : votre serveur QBox est installé dès la souscription.

Questions fréquentes