Ajouter du contenu

Ekto fournit le code de la base. Les véhicules, mappings, armes, vêtements et scripts, c'est vous qui les ajoutez, depuis la page Contenu (groupe Gameplay). Sans pack, le serveur tourne avec le contenu d'origine de GTA V.

Envoyer, remplacer, activer ou supprimer un pack demande le droit « Contenu : Modifier » ; « Contenu : Voir » montre la liste et le détail des packs. Redémarrer le serveur depuis cette page demande aussi « Démarrer, arrêter, redémarrer ».

Envoyer un pack#

Un pack est une archive .zip, .tar, .tar.gz ou .tgz qui contient une ou plusieurs ressources FiveM (un dossier avec un fxmanifest.lua). Glissez-la dans la zone d'envoi, ou utilisez Choisir un fichier ou Ajouter un pack. Un seul fichier est pris à la fois. La taille maximale d'une archive est indiquée dans la zone.

• Les gros fichiers passent : l'envoi se fait par morceaux. Mettre en pause l'arrête, Reprendre le relance, Annuler l'envoi l'abandonne (il faudra alors renvoyer le fichier depuis le début).
• Vous pouvez changer de page dans l'espace client, ou d'onglet dans le navigateur, pendant l'envoi. Fermer ou recharger la page l'interrompt : le navigateur vous demande d'abord de confirmer.
• Un envoi interrompu reste affiché dans la liste. Pour le reprendre là où il s'était arrêté, choisissez à nouveau le même fichier (même nom, même taille) avant la date indiquée : 24 heures après le dernier morceau reçu. Abandonner l'envoi le retire.
• Trois envois au plus peuvent être en cours en même temps sur un serveur.
• L'espace total des packs dépend de votre formule : 2 Go sur Essai, 10 Go sur Essentiel, 20 Go sur Communauté, 40 Go sur Grand serveur, 100 Go sur Serveur dédié. Il est affiché à droite, dans « Espace des packs ».

Comment l'espace est compté#

Chaque pack compte pour la plus grande de ces deux tailles : son archive, ou ses fichiers une fois extraits. Un envoi en cours ou interrompu réserve sa taille jusqu'à la fin de l'envoi ou à son abandon (« Dont ... réservés par les envois en cours »). Un pack refusé ne compte pas. Quand le quota est atteint, la zone d'envoi se désactive et l'encart indique « Quota atteint : supprimez un pack ou changez de formule. »

Passer à une formule plus petite ne supprime aucun pack, mais vous ne pourrez plus en ajouter tant que l'espace utilisé dépasse le nouveau quota.

Avant l'envoi, vérifiez votre archive#

• Une ressource par dossier, chacune avec son fxmanifest.lua (ou __resource.lua), écrit en minuscules. Un manifeste nommé autrement, par exemple FXManifest.lua, est ignoré. Une ressource placée dans le dossier d'une autre ressource est ignorée aussi.
• Un nom de ressource fait de lettres, de chiffres, de - et de _, 64 caractères au plus, qui ne commence ni par - ni par _. Une ressource dont le manifeste est à la racine de l'archive prend le nom du fichier : mon pack v2.zip serait refusé à cause des espaces.
• Un nom qui n'existe pas déjà dans un autre de vos packs. Les noms des ressources de la base et de FiveM sont réservés, notamment ekto, oxmysql, ox_lib, pma-voice, txadmin, monitor et chat, quelle que soit la casse.
• Pas d'archive dans l'archive (.zip, .rar, .7z, .tar, .gz...) : extrayez-la d'abord.
• Pas de fichiers dont le nom ne diffère que par les majuscules dans une même ressource (Car.ytd et car.ytd).
• Un zip sans mot de passe, compressé de façon standard (Deflate). Un zip créé par 7-Zip en LZMA ou en Deflate64 est refusé.
• Dans le fxmanifest.lua, seulement des chemins de fichiers de la ressource elle-même, écrits avec /. Un chemin qui sort du dossier (../), un chemin absolu, une barre \ ou un fichier d'une autre ressource (@autre_ressource/...) fait refuser le pack. Seuls @ox_lib/init.lua et @oxmysql/lib/MySQL.lua sont acceptés.
• Les fichiers placés hors de toute ressource ne sont pas installés. Au-delà de 256 Mo de tels fichiers, le pack est refusé.

Les fichiers ajoutés par les systèmes (__MACOSX, .DS_Store, Thumbs.db, desktop.ini, dossiers .git) sont ignorés.

Messages à l'envoi#

« Ce fichier n'est pas une archive .zip, .tar ou .tar.gz lisible » et « Cette archive est identique au pack ... » n'apparaissent qu'à la fin de l'envoi.

Ce qui se passe ensuite#

Chaque pack est analysé avant d'arriver sur votre serveur.

Si le même code, ressource entière et à l'octet près, a déjà été validé par l'équipe Ekto, le pack est installé sans nouvelle relecture. Le détail affiche alors la note « Validé sans relecture : code identique à celui d'un pack déjà validé ». Cette règle ne s'applique jamais au code serveur chiffré par l'escrow : l'équipe Ekto le valide au cas par cas.

Une fois installé, le pack passe en « Installé, redémarrage requis ». Il n'est chargé qu'au redémarrage. Le bandeau « Redémarrage nécessaire » propose de le faire tout de suite avec Redémarrer ; les joueurs connectés sont déconnectés le temps du redémarrage (quelques minutes). Tout redémarrage lancé depuis l'espace client compte aussi : vue d'ensemble, redémarrages planifiés, démarrage après un arrêt. Après le redémarrage, le pack passe en « Actif ».

Les états d'un pack#

La validation par l'équipe Ekto#

L'équipe Ekto est prévenue dès qu'un pack attend une validation. Vous ne recevez pas de message quand elle a décidé : revenez sur la page Contenu, l'état du pack y change.

• Validé : le pack s'installe tout seul, puis attend le redémarrage. Une remarque éventuelle de l'équipe s'affiche dans le détail, sous « Note de l'équipe Ekto ».
• Refusé : le motif écrit par l'équipe s'affiche sous le nom du pack et dans le détail, sous « Pack refusé ». Corrigez l'archive, puis renvoyez-la avec Remplacer.

Un pack en attente peut être supprimé ou remplacé à tout moment.

Un script serveur ou partagé doit pouvoir être relu en entier, sinon le pack ne peut pas être validé et sera refusé. C'est le cas quand le script :

• dépasse 200 000 caractères (environ 200 Ko), ce qui arrive souvent avec un script JavaScript compilé ou minifié ;
• est un fichier binaire ;
• est chiffré par l'escrow et pèse plus de 512 Ko ;
• est cité dans le manifeste mais absent de l'archive. Les noms sont comparés avec leurs majuscules : Server.lua ne remplace pas server.lua.

L'ensemble du code serveur et partagé d'un pack doit aussi rester sous 2 millions de caractères.

Les motifs de refus les plus fréquents#

Quand il y a plusieurs motifs, les trois premiers s'affichent, suivis de « (et ... autres) ». La liste complète est dans le détail, sous « Résultat de l'analyse ».

Packs qui utilisent ox_lib#

Beaucoup de scripts du marché s'appuient sur ox_lib. La base en livre une édition Ekto, qui affiche l'interface d'ox_lib (notifications, barres, menus, formulaires) dans la direction artistique et la couleur de votre serveur. Elle ne démarre que si un de vos packs actifs en a besoin : l'espace client s'en charge, vous n'avez rien à faire. N'ajoutez pas votre propre ox_lib à l'archive, le nom est réservé. Charger @ox_lib/init.lua ne déclenche pas de validation à lui seul ; le reste du code serveur du pack, lui, est relu comme d'habitude.

Si l'installation d'un tel pack échoue avec « Ce pack a besoin de ox_lib, livré avec les versions récentes de la base : mettez votre serveur à jour, puis réessayez. », la version de la base installée ne livre pas encore ox_lib. Faites la mise à jour de la base, puis supprimez le pack en erreur (Détail, Supprimer) et envoyez-le à nouveau : une archive identique à un pack encore présent, même en erreur, est refusée.

Activer ou désactiver un pack#

L'interrupteur Actif désactive un pack installé sans le supprimer. Le pack passe tout de suite en « Désactivé », mais il reste chargé jusqu'au prochain redémarrage. Ses véhicules sortent des modèles autorisés au prochain redémarrage, et y reviennent quand vous le réactivez. Si vous le réactivez avant le redémarrage, aucun redémarrage n'est nécessaire.

L'interrupteur n'apparaît pas sur un écran de téléphone : passez par un ordinateur.

Un pack en erreur#

L'état « Erreur » s'accompagne d'un message dans le détail :

L'installation ne se relance pas toute seule. Une fois la cause réglée, supprimez le pack en erreur et envoyez-le à nouveau.

Le détail d'un pack#

Cliquez sur Détail, ou sur la ligne du pack, pour voir ce que l'analyse a trouvé.

En haut, un encadré rappelle l'état du pack quand il le faut (« Pack refusé », « En attente de validation », « Erreur », « Redémarrage nécessaire », « Nouvelle version », « Note de l'équipe Ekto »). Viennent ensuite le type du pack (Véhicules, Mappings, Armes, Vêtements, Mixte ou Autre), sa taille extraite, la taille de l'archive et sa date d'envoi.

Véhicules. Les modèles déclarés dans les fichiers vehicles.meta sont ajoutés tout seuls aux modèles autorisés du serveur, tant que le pack est installé et actif. Il reste à les mettre en vente ou à les donner aux métiers, en jeu (voir plus bas). Si l'encadré « Modèles autorisés non mis à jour » apparaît, la base du serveur n'a pas répondu : cliquez sur Réessayer. Les véhicules restent utilisables quand un joueur est connecté.

Armes. Elles sont listées, mais pas encore utilisables : voir Ajouter une arme.

Vêtements. Le détail compte les pièces homme et femme, par catégorie. Elles apparaissent toutes seules dans les magasins de vêtements et le créateur de personnage après le redémarrage. Au-delà de 10 places, les vêtements ajoutés ne s'affichent qu'avec une clé Cfx.re liée à l'offre Argentum de l'Element Club : sans elle, ils restent invisibles en jeu.

Mappings. Le détail liste les intérieurs MLO et les fichiers de carte. Ils se chargent tout seuls. Placez ensuite vos points (vestiaires, coffres, garages, portes) dans les builders.

Ressources FiveM. Chaque ressource du pack, avec son nombre de fichiers, sa taille et ses scripts client. Le badge « Escrow » signale une ressource protégée par l'escrow Cfx.re, le badge « Code serveur » une ressource qui exécute du code sur le serveur.

Résultat de l'analyse. Les motifs de refus, les points à valider par l'équipe Ekto et les simples remarques. Une remarque n'empêche pas l'installation. Par exemple, « « ... » dépend de « ... », absente de ce pack : elle ne démarrera pas sans elle » signale une dépendance manquante : la ressource sera installée mais ne démarrera pas.

Animations. Les animations contenues dans un pack (fichiers .ycd) sont envoyées toutes seules au studio d'animations à l'installation, si le serveur tourne. Sinon, ou pour un pack installé avant, utilisez « Envoyer au serveur » dans la page Éléments du jeu, onglet Animations (voir Les réglages des modules).

Rendre le contenu utilisable en jeu#

Tout se fait dans le menu F10, entrée Builders (voir Les builders), ou dans la page Éléments du jeu de l'espace client.

Ajouter une arme#

1. Builders, rubrique Armes, Catalogue d'armes, Ajouter une arme : le nom de l'arme (par exemple WEAPON_LSL_PISTOL) et son libellé. Son objet d'inventaire (weapon_lsl_pistol) est créé tout seul.
2. Dans sa fiche, choisissez sa Munition (par exemple ammo_pistol), sa catégorie et son chargeur.
3. Builders, rubrique Armes, Armureries, GÉRER LES ARTICLES : ajoutez l'article weapon_lsl_pistol avec son prix, puis réglez son permis et son quota.

Ne créez pas l'objet de l'arme à la main avec le type « Arme » : il ne se sortirait pas de l'inventaire. Le détail est au chapitre Armes et objets.

Un véhicule n'apparaît pas ? Tapez /vehscan en jeu (voir Les modèles connus).

Mettre à jour un pack#

Détail, puis Remplacer, et choisissez la nouvelle archive. Remplacer est disponible pour un pack installé, validé, en attente de validation, en erreur ou refusé, et grisé tant qu'une nouvelle version de ce pack est déjà en cours.

Si vous déposez une archive au nom proche d'un pack déjà présent (par exemple ekto_vetements_v2.zip ou ekto_vetements (1).zip à côté de ekto_vetements.zip), l'espace client demande « Nouvelle version d'un pack ? » (ou « Ce pack est déjà sur votre serveur » pour un nom identique) et propose Remplacer, Ajouter comme nouveau pack ou Annuler. Si la nouvelle archive garde les mêmes noms de ressources, Ajouter comme nouveau pack la fera refuser : choisissez Remplacer.

L'ancienne version reste en place pendant l'envoi, l'analyse et l'installation de la nouvelle, puis elle est retirée. Son espace compte pour la nouvelle version. La nouvelle version garde le réglage Actif de l'ancienne. Si elle est refusée, rien ne change. Si son installation échoue, l'ancienne version est remise en place. Pendant l'installation, l'ancienne version ne peut être ni désactivée ni supprimée. Comme pour un ajout, la nouvelle version est chargée au prochain redémarrage.

Une nouvelle version dont le code serveur a changé repasse en validation.

Une archive identique à un pack déjà présent est refusée : il n'y a rien à mettre à jour.

Supprimer un pack#

Détail, puis Supprimer. Le bouton n'apparaît pas pendant l'analyse, l'installation ou la suppression du pack.

• Un pack installé est retiré du serveur. Ses véhicules sont retirés des modèles autorisés et ses animations du studio d'animations (si le serveur est arrêté, retirez-les depuis la page Éléments du jeu, onglet Animations). Il reste chargé jusqu'au prochain redémarrage.
• Un pack en attente de validation, validé ou refusé est effacé tout de suite avec son archive.

L'espace qu'il occupait est libéré.

Ekto ne vous renvoie pas les fichiers de vos packs, et ils sont effacés avec le serveur s'il est supprimé : gardez vos propres copies.

Quand le contenu ne peut pas être modifié#

Un message s'affiche en haut de la page dans ces cas :

• avant la mise en service : « Les packs s'ajoutent une fois le serveur mis en service. » ;
• serveur suspendu : « Le serveur est suspendu : régularisez le paiement pour modifier son contenu. » ;
• abonnement résilié : « L'abonnement est résilié : le contenu ne peut plus être modifié. ».

Questions fréquentes#

Comment installer un script ?#

Comme un pack : une archive qui contient le dossier de la ressource avec son fxmanifest.lua. Un script qui ne tourne que chez les joueurs (scripts client et interface) s'installe tout seul. Un script avec du code serveur passe en « En attente de validation », puis s'installe une fois validé. Dans les deux cas, il est chargé au prochain redémarrage.

Puis-je envoyer un script ESX ou QBCore ?#

La base Ekto n'utilise ni ESX ni QBCore. Un script qui charge un fichier de ces frameworks dans son manifeste (par exemple @es_extended/imports.lua ou @qb-core/...) est refusé, car une ressource d'un pack ne peut nommer que ses propres fichiers. Un script qui déclare seulement la dépendance s'installe, mais ne démarre pas, faute de la ressource.

Puis-je installer un script payant protégé par l'escrow ?#

Oui, si vous l'avez acheté sur le compte Cfx.re de la clé de votre serveur : il ne démarre qu'avec cette clé. S'il contient du code serveur chiffré, il passe en validation à chaque envoi, et l'équipe Ekto décide au cas par cas. Un fichier serveur chiffré de plus de 512 Ko ne peut pas être validé.

Mon pack est refusé, pourquoi ?#

Le motif s'affiche sous le nom du pack et dans son détail, sous « Pack refusé » et « Résultat de l'analyse ». Les causes les plus fréquentes et leur correction sont dans Les motifs de refus les plus fréquents. Un pack refusé ne compte pas dans votre espace : supprimez-le, ou envoyez une archive corrigée avec Remplacer.

Combien de temps dure la validation ? Serai-je prévenu ?#

L'équipe Ekto est prévenue dès l'arrivée du pack. Vous ne recevez pas de message à la décision : l'état du pack change sur la page Contenu. D'ici là, le pack ne touche pas à votre serveur.

Mon pack reste en « Installé, redémarrage requis »#

Redémarrez le serveur depuis l'espace client : bandeau « Redémarrage nécessaire », vue d'ensemble ou redémarrage planifié. Le pack passe alors en « Actif ».

Mon pack est actif mais ne fonctionne pas en jeu#

Ouvrez son détail et lisez « Résultat de l'analyse ». Une dépendance absente du pack empêche la ressource de démarrer : ajoutez-la à l'archive, puis Remplacer.

Mon véhicule n'apparaît pas#

Vérifiez que le pack est « Actif » : désactivé, ses modèles sont retirés des modèles autorisés. Vérifiez que son détail liste bien le véhicule : seuls les modèles déclarés dans un vehicles.meta sont reconnus. Si l'encadré « Modèles autorisés non mis à jour » apparaît, cliquez sur Réessayer. Tapez ensuite /vehscan en jeu, puis ajoutez le véhicule à une concession ou à une boutique.

Mes vêtements ne s'affichent pas#

Au-delà de 10 places, les vêtements ajoutés ne s'affichent qu'avec une clé Cfx.re liée à l'offre Argentum de l'Element Club. Vérifiez aussi que le serveur a redémarré depuis l'installation du pack.

Mon zip est refusé alors qu'il s'ouvre sur mon ordinateur#

Les causes habituelles : un zip compressé autrement qu'en Deflate (7-Zip en LZMA ou Deflate64), un mot de passe, un .rar ou un .7z renommé en .zip, un lien symbolique, un nom de fichier qui contient : ou un caractère invisible, ou un chemin trop long. Refaites l'archive en zip standard.

Puis-je envoyer plusieurs packs en même temps ?#

Oui, trois envois au plus en même temps sur un serveur. Déposez les archives une par une.

Je n'ai plus de place dans mon quota#

Supprimez un pack ou changez de formule. Pensez aux envois interrompus, qui réservent leur taille tant que vous ne les avez pas abandonnés ou qu'ils n'ont pas expiré.

Mon pack est en erreur après une mise à jour de la base#

L'installation ne se relance pas toute seule. Supprimez le pack en erreur, puis envoyez-le à nouveau.

Ekto peut-il me renvoyer les fichiers de mes packs ?#

Non : gardez vos propres copies. Les packs sont effacés avec le serveur s'il est supprimé.