Guide

Playlists et vote

Installer une playlist prête à l’emploi

Le dépôt ElDewrito Server Hosting fournit des playlists pour la version 0.7, notamment Halo Online, Halo 3, des rotations avec mods et un exemple minimal. Installez une seule playlist choisie par serveur ; copier toutes les playlists les unes sur les autres ne les combine pas.

  1. Arrêtez le conteneur, ou le script de surveillance Windows et le serveur. Sauvegardez autoexec.cfg et le dossier data entier, en particulier les préférences, data/server et les variantes personnalisées. Gardez les paquets de mods existants nécessaires pour restaurer l’ancienne rotation.
  2. Clonez le dépôt ou téléchargez son ZIP, puis extrayez-le.
  3. Copiez d’abord le contenu de 0. Stock maps and gametypes/data dans le dossier data du serveur, en fusionnant les dossiers. Cela installe les variantes de carte et de mode de jeu d’origine attendues par les playlists.
  4. Copiez ensuite le contenu du dossier data de la playlist choisie dans la même destination, en autorisant ses fichiers à écraser la configuration précédente. Sous Linux, cette destination est /opt/eldewrito/data ; sous Windows, c’est data à côté d’eldorado.exe. Ne créez pas data/data et ne copiez pas uniquement voting.json en oubliant les variantes requises.
  5. Examinez le data/server/voting.json obtenu et tout fichier mods.json ; installez ou vérifiez le contenu référencé comme indiqué plus bas. Remplacez Voting.SystemType 0 dans autoexec.cfg par le bloc suivant, en conservant les commandes initiales de carte et de mode pour la première partie :
Voting.JsonPath "data/server/voting.json"
Voting.SystemType 1
Voting.ReloadJson
  1. Démarrez le serveur, terminez la première partie et vérifiez le vote, la carte gagnante, les téléchargements de mods requis et une reconnexion. Testez les combinaisons carte/mode prévues avant de rendre la rotation publique.

Sous Windows, le dépôt fournit aussi le script d’aide Get playlist #.ps1 en version bêta. Enregistrez-le à côté d’eldorado.exe, remplacez # dans son nom par l’identifiant numérique du dossier choisi et exécutez-le dans une session PowerShell dont le répertoire de travail est cette installation du jeu. Par exemple, après l’avoir enregistré sous Get playlist 6.ps1, lancez & '.\Get playlist 6.ps1' pour l’exemple minimal. Examinez le script téléchargé avant de l’exécuter et suivez les recommandations sur la stratégie d’exécution PowerShell si votre système le bloque ; ne désactivez pas globalement la stratégie simplement pour installer une playlist.

Le script télécharge le dépôt actuel, copie d’abord les variantes d’origine en forçant l’écrasement, puis fait de même pour la playlist choisie. Il écrit dans le répertoire de travail courant, ne crée aucune sauvegarde et n’active pas le vote à votre place. La procédure manuelle fonctionne sur les deux plateformes et facilite le contrôle de l’ordre d’écrasement.

Ajouter une petite rotation avec vote

Pour une petite rotation que vous pouvez modifier vous-même, commencez avec des cartes du jeu de base. La référence du vote couvre les variantes personnalisées, les restrictions de cartes compatibles, les modèles, les mods et les playlists avec veto. Vous pouvez aussi consulter data\server\voting.json.example, mais ne l’activez pas tel quel : l’un de ses exemples contient une virgule finale, invalide en JSON.

  1. Arrêtez le conteneur, ou le script de surveillance Windows et le serveur, puis enregistrez ce qui suit dans data/server/voting.json dans le dossier du jeu. Il propose Slayer sur Guardian ou Valhalla. Utilisez les identifiants internes des cartes, par exemple riverworld pour Valhalla, plutôt que leurs noms affichés.
{
  "maps": [
    { "displayName": "Guardian", "mapName": "guardian" },
    { "displayName": "Valhalla", "mapName": "riverworld" }
  ],
  "types": [
    { "displayName": "Slayer", "typeName": "Slayer" }
  ]
}
  1. Dans autoexec.cfg, remplacez Voting.SystemType 0 par le bloc suivant. Conservez les commandes initiales de carte et de mode pour la première partie. Vous pouvez aussi sélectionner le vote via Host Settings → Voting Mode → Vote.
Voting.JsonPath "data/server/voting.json"
Voting.SystemType 1
Voting.VoteOptionCount 2
Voting.DuplicationLevel 1
Voting.ReloadJson
  1. Démarrez le serveur, rejoignez-le et terminez la première partie. Vérifiez que le vote ne propose que les paires carte/mode prévues et que la partie gagnante se charge. Reconnectez-vous après la transition et refaites le test après un redémarrage volontaire.

Voting.SystemType vaut 0 sans vote, 1 pour le vote et 2 pour le veto. L’exemple utilise le niveau de duplication 1, soit Gametype or Map Can Repeat dans l’interface, afin que le même mode Slayer puisse apparaître avec deux cartes différentes. Le veto suit un fonctionnement distinct avec vetoPlaylist ; passer simplement cet exemple à deux cartes en mode veto ne fournit pas une playlist de veto ordonnée.

Faire tourner des mods et variantes personnalisées sans risque

Une entrée de rotation jouable est une combinaison compatible de paquet de mod, carte de base ou variante Forge, et mode de jeu. Installez les variantes sur le serveur en suivant Contenu personnalisé, et jouez chaque combinaison en privé avant de l’ajouter à un vote public.

  • displayName est le libellé du vote. mapName et typeName doivent identifier du contenu que le serveur peut charger ; changer un libellé ne renomme pas une carte.
  • Le champ specificMaps d’un mode le limite à ses cartes compatibles. Cela empêche un mode spécialisé d’apparaître sur toutes les cartes de la liste globale.
  • Le champ modPack d’un mode désigne une entrée de mod. data\server\mods.json associe les noms sous mods à un objet contenant une package_url. Gardez ce nom cohérent avec l’entrée de vote et l’URL liée à la version prévue du paquet.
  • Server.ModsJsonFile sélectionne la liste de mods pour les téléchargements automatiques de paquets au démarrage. Son chemin par défaut est data\server\mods.json, pas data\server\server.json.
  • Utilisez une URL stable de téléchargement direct du paquet que vous avez l’autorisation de partager. Les joueurs doivent pouvoir le télécharger sans se connecter à un compte. Vérifiez que le lien fonctionne hors de votre propre compte et évitez les liens de pièces jointes qui expirent.
  • commands et endOfMatchCommands peuvent appliquer puis annuler des réglages propres à chaque mode. Évitez ces réglages dans votre première playlist ; lorsque vous en ajoutez, rétablissez l’état que doit recevoir la partie suivante plutôt que de laisser des réglages persister d’un mode à l’autre.

ED Resurgence Voting JSON Builder crée des fichiers voting.json et mods.json pour la version 0.7. Faites pointer sa sélection du dossier de variantes vers le dossier data de l’installation, qui contient map_variants et game_variants. Enregistrez les fichiers générés aux emplacements configurés pour votre serveur. Vérifiez les URL de mods fournies et essayez chaque paquet avant de l’ajouter à votre rotation ; certaines URL peuvent être obsolètes ou ne plus fonctionner.