Serveur Assetto Corsa et mods : ajouter voitures et circuits

Installer des mods sur votre serveur Assetto Corsa se fait en trois étapes : vous envoyez les fichiers serveur des voitures et des circuits dans content/cars et content/tracks, vous inscrivez les noms de leurs dossiers dans cfg/server_cfg.ini (CARS=, TRACK= et CONFIG_TRACK=) et vous créez suffisamment de places dans cfg/entry_list.ini. Pour ajouter des voitures à un serveur Assetto Corsa, le plus rapide reste le bouton Pack de Content Manager, qui rassemble exactement ces fichiers. Une règle absolue : chaque joueur doit avoir exactement la même version des mods, sinon il ne pourra pas entrer.

Les sessions et le ping sont traités dans Hébergement de serveur Assetto Corsa.

Le serveur n'a besoin que de quelques fichiers par mod

Un serveur Assetto Corsa n'affiche rien et ne charge aucun modèle 3D. Il gère les sessions et vérifie que les voitures et le circuit de chaque joueur correspondent à ceux du serveur. Le code source de Content Manager montre ce que la fonction Pack emballe pour le serveur, et c'est peu par mod :

• par voiture : content/cars/<voiture>/data.acd, le dossier data de la voiture sous forme empaquetée ;
• par circuit : surfaces.ini et drs_zones.ini du dossier data du layout, plus models_<layout>.ini (ou models.ini pour un circuit sans layouts) ;
• une seule fois : system/data/surfaces.ini.

Ces fichiers servent au contrôle, la somme de contrôle (checksum). Ce sont vos joueurs qui ont besoin du mod complet avec modèles et textures, pas le serveur. Les noms de dossiers, en revanche, doivent être exacts. Nos serveurs utilisent la version Linux d'acServer, et sous Linux Ferrari_458 est un autre dossier que ferrari_458.

Ajouter des voitures : CARS=, TRACK= et CONFIG_TRACK= dans server_cfg.ini

Dans cfg/server_cfg.ini, le bloc [SERVER] indique quel contenu le serveur utilise. Avec le circuit du manuel serveur de Kunos et une voiture moddée de votre choix, cela donne :

[SERVER]
CARS=ferrari_458_gt2;ma_voiture_mod
TRACK=vallelunga
CONFIG_TRACK=extended_circuit
MAX_CLIENTS=15

• CARS= : les noms de dossiers de content/cars, séparés par un point-virgule. Pour ajouter une voiture moddée, placez le nom de son dossier à la fin.
• TRACK= : le nom du dossier du circuit dans content/tracks.
• CONFIG_TRACK= : le layout, c'est-à-dire le nom du sous-dossier que vous voyez dans votre propre jeu sous content/tracks/<circuit>/ui. Si le circuit n'a pas de layouts, Content Manager laisse cette ligne vide.
• MAX_CLIENTS= : le nombre de joueurs. Selon Kunos, il ne doit pas dépasser le nombre de stands (pit boxes) du circuit.

Si vous avez coché « Require CSP to join » dans Content Manager, le programme écrit quelque chose comme TRACK=csp/…/../vallelunga. C'est voulu : laissez-le tel quel.

entry_list.ini : un bloc par place sur la grille

Le serveur ne crée des places que pour les voitures de cfg/entry_list.ini. Chaque bloc s'appelle [CAR_0], [CAR_1], et ainsi de suite :

[CAR_0]
MODEL=ferrari_458_gt2
SKIN=black_matte
GUID=
BALLAST=0

[CAR_1]
MODEL=ma_voiture_mod
SKIN=nom_d_un_dossier_skin
GUID=
BALLAST=0

• MODEL= doit être l'une des voitures de CARS=.
• SKIN= est le nom d'un dossier dans content/cars/<voiture>/skins de votre propre jeu.
• Il vous faut au moins autant de blocs que MAX_CLIENTS : pour 15 joueurs, de [CAR_0] à [CAR_14] inclus.
• Un Steam64 ID après GUID= associe une place à un pilote attitré. BALLAST (kilos supplémentaires) et RESTRICTOR (de 0 à 100) servent à équilibrer les voitures.

Pack dans Content Manager : la voie la plus rapide

Content Manager (acstuff.ru) génère les deux fichiers et récupère les fichiers de contrôle dans votre propre installation. La version Lite est gratuite, mais acstuff.ru range la gestion de serveurs parmi les fonctions en développement, que l'on obtient sur ce site avec une clé d'application après un don ; dans Lite, elle peut donc être limitée. L'entrée de menu Server s'active dans les paramètres, sous Appearance, à la rubrique Links.

1. Créez un preset sous Server, choisissez le circuit et les voitures dans l'onglet Main et remplissez les places dans Entry list.
2. Dans le menu à côté de Pack, choisissez Options (Ctrl+Maj+P), désactivez Include executable (acServer est déjà sur votre serveur) et cliquez sur Pack. Target Windows produit un .zip, Linux un .tar.gz.
3. Faites d'abord une sauvegarde dans le panel, envoyez l'archive dans le dossier racine via le gestionnaire de fichiers ou SFTP avec WinSCP ou FileZilla, puis décompressez-la dans le gestionnaire de fichiers (Unarchive), afin que cfg, content et system se retrouvent au bon endroit.
4. Redémarrez le serveur.

Si une voiture moddée possède un dossier data non empaqueté au lieu d'un data.acd, Content Manager affiche l'avertissement « Data is not encrypted » : sans données empaquetées, les joueurs peuvent modifier la voiture. Si vous le laissez les empaqueter, transmettez aussi ce nouveau data.acd à vos joueurs, sinon leurs fichiers ne correspondront plus.

À chaque démarrage, notre panel réécrit dans server_cfg.ini le nom du serveur, le mot de passe, le mot de passe admin et les ports à partir des variables de démarrage. Ce que Content Manager y inscrit est donc écrasé ; ces réglages se modifient dans le panel.

Les joueurs ont besoin exactement des mêmes mods

Selon Kunos, une incohérence (mismatch) de voiture ou de circuit vous fait expulser du serveur : soit le joueur doit mettre son jeu à jour, soit le serveur n'est pas à jour. Donnez donc à tout le monde le même téléchargement et refaites un Pack dès que vous mettez un mod à jour.

Content Manager peut récupérer lui-même le contenu manquant. Dans votre preset, cochez les détails supplémentaires dans l'onglet Details, choisissez le mode « Via ID in name (recommended) », réglez Share mode sur Download URL pour chaque voiture et chaque circuit et saisissez le lien dans Download from. Content Manager ajoute alors après le nom du serveur un code commençant par x:, et les joueurs équipés de Content Manager voient dans la liste des serveurs un bouton pour installer le contenu manquant. Chez nous, le nom provient de la variable de démarrage Server Name : copiez donc le nom complet avec ce code depuis le server_cfg.ini empaqueté vers cette variable. Utilisez aussi dans votre preset le même mot de passe serveur et le même mot de passe admin que dans le panel, sinon Content Manager risque de signaler un mot de passe correct comme erroné. L'autre mode, AC Server Wrapper, est un programme distinct avec son propre port et ne fait pas partie de notre egg standard. Les joueurs sans Content Manager installent les mods à la main.

Ports : 9600 et 8081 chez Kunos, attribués chez nous

Par défaut, le serveur utilise le port 9600 en TCP et UDP et le port 8081 en HTTP, le port du lobby. Chez MC-Node, votre serveur reçoit deux ports attribués : un port principal pour TCP et UDP et un second pour HTTP (la variable « HTTP-poort », « port HTTP » en néerlandais). Le panel les renseigne à chaque démarrage ; inutile de les modifier dans le fichier.

Erreurs fréquentes

• « Le mod ne s'installe pas. » Souvent, il se retrouve un dossier trop bas après la décompression, comme content/content/cars, ou une majuscule diffère de ce qui figure dans CARS=.
• Erreur de checksum ou de mismatch. Un joueur a une autre version, le serveur a encore un ancien data.acd, ou vous avez fait empaqueter les données et les joueurs ont gardé l'ancienne version. Une seule version pour tous : refaire le Pack, l'envoyer, redémarrer.
• Désactiver le contrôle. Content Manager propose l'option « Disable integrity verification (not recommended) ». D'après l'infobulle, les joueurs peuvent alors modifier leurs voitures et circuits pour obtenir un avantage déloyal ; à réserver aux tests.
• Pas assez de places. Moins de blocs [CAR_x] que MAX_CLIENTS, un MODEL absent de CARS= ou plus de joueurs que de stands.
• Le serveur lui-même ne s'installe pas. Notre egg installe via SteamCMD. Si le journal d'installation affiche « No subscription » ou « Login Failure », renseignez dans les variables de démarrage un compte Steam qui possède Assetto Corsa, avec le code Steam Guard si nécessaire, puis réinstallez.

Enfin, choisissez votre propre mot de passe admin dans les variables de démarrage. Kunos le qualifie d'obligatoire ; avec /admin <mot_de_passe> dans le chat, vous pouvez ensuite expulser des joueurs et passer une session avec /next_session.

Quand vous n'en avez pas besoin

Si vous roulez uniquement avec le contenu de base de Kunos que tout le monde possède déjà, personne n'a rien à télécharger et le problème de version ne se pose guère ; le Pack reste toutefois le moyen le plus simple d'obtenir une configuration correcte. Vous n'avez pas encore de serveur ? Un serveur Assetto Corsa chez MC-Node démarre à 3,00 € par mois avec l'offre Amateur, 2 Go de RAM et 20 Go NVMe. Vous choisissez les Pays-Bas, l'Allemagne, la Pologne ou l'Amérique du Nord (Canada), la protection DDoS est incluse et l'offre est résiliable chaque mois.

Questions fréquentes

Comment ajouter des voitures à un serveur Assetto Corsa ?

Placez le nom du dossier de la voiture après CARS= dans cfg/server_cfg.ini, séparé par un point-virgule, et créez dans cfg/entry_list.ini des blocs avec MODEL= suivi de ce nom de dossier. Envoyez aussi content/cars/<voiture>/data.acd pour la somme de contrôle et redémarrez le serveur. Le bouton Pack de Content Manager fait tout cela en une seule fois.

Pourquoi suis-je expulsé d'un serveur Assetto Corsa à cause d'une erreur de checksum ?

Votre version de la voiture ou du circuit diffère de celle du serveur, par exemple un autre data.acd ou surfaces.ini. Installez la même version que le serveur, ou demandez à l'administrateur de refaire le Pack si le mod a été mis à jour. Kunos cite ces deux causes dans le manuel du serveur.

Quels ports utilise un serveur Assetto Corsa ?

Par défaut, le port 9600 en TCP et UDP et le port 8081 en HTTP, le port du lobby. Si vous faites tourner plusieurs serveurs sur une même machine, chacun a besoin de ses propres ports ; sur un serveur hébergé, le panel les attribue généralement lui-même.

Dois-je mettre le mod complet sur mon serveur Assetto Corsa ?

Non. Le serveur n'a besoin que de data.acd pour chaque voiture et de quelques fichiers par circuit, comme surfaces.ini, drs_zones.ini et models_<layout>.ini. Seuls vos joueurs ont besoin du mod complet avec modèles et textures.

À lire aussi

• Ping, tickrate et localisation du serveur : pourquoi les millisecondes comptent
• Créer un serveur BeamMP : AuthKey, mods, port et joueurs