Comment installer Project Viewpoint sur un serveur Project Zomboid

Comment installer Project Viewpoint sur un serveur Project Zomboid

Project Viewpoint est un mod de la communauté qui affiche Project Zomboid en 3D et permet de jouer à la première ou à la troisième personne. Il gère le multijoueur : vous pouvez donc l'utiliser sur votre propre serveur et jouer entre amis.

L'installation se fait en deux parties :

1. Le propriétaire du serveur ajoute deux mods à la configuration du serveur. Cela prend environ trois minutes et se fait une seule fois.
2. Chaque joueur installe le chargeur Java ZombieBuddy sur son propre PC. Cela se fait aussi une seule fois, et aucun serveur ne peut le faire à sa place.

Project Viewpoint est un mod Java, créé ni par Lobby Maker ni par The Indie Stone. The Indie Stone ne prend pas officiellement en charge les mods Java : ils ont un accès complet à votre ordinateur, n'installez donc que ceux en qui vous avez confiance. Sur le serveur lui-même, aucun code Java du mod ne s'exécute — il ne tourne que dans le jeu des joueurs.

Ce qu'il vous faut

Version du jeu. Viewpoint ne fonctionne que sur les versions du jeu indiquées par son auteur sur la page du Workshop — au moment de la rédaction, le Build 42.21, la version Stable actuelle. Le serveur et tous les joueurs doivent avoir la même version.

Partie 1 — le serveur (propriétaire)

Faites d'abord une sauvegarde (onglet Backups).

1. Ouvrez votre serveur dans le panneau (Mes serveurs de jeu → Panneau du serveur).
2. Si le serveur n'a jamais été démarré, démarrez-le une fois et attendez qu'il soit en ligne, pour que le fichier de configuration soit créé.
3. Arrêtez le serveur dans l'onglet Console. Project Zomboid réécrit sa configuration à l'arrêt : les modifications faites pendant qu'il tourne sont perdues.
4. Ouvrez la configuration : onglet Mods → Open config file, ou onglet Files → .cache/Server/ → le fichier .ini qui porte le nom de votre Server Name de l'onglet Startup.
5. Trouvez les lignes WorkshopItems= et Mods= et remplacez-les par :

WorkshopItems=3619862853;3809306528
Mods=\ZombieBuddy;\Viewpoint

6. Cliquez sur Save Content, puis sur Start dans l'onglet Console.

Le premier démarrage est plus long : le serveur télécharge les deux mods depuis le Steam Workshop avant de charger le monde. Quand la console indique que le serveur a démarré, il est prêt.

Règles importantes :

• Chaque Mod ID commence par une barre oblique inversée \ : c'est le format de Build 42.
• \ZombieBuddy vient avant \Viewpoint — Viewpoint en a besoin.
• Vous avez déjà d'autres mods ? Ajoutez les nouvelles valeurs aux lignes existantes, séparées par ;, au lieu de les remplacer :

WorkshopItems=1234567890;3619862853;3809306528
Mods=\ExampleMod;\ZombieBuddy;\Viewpoint

Facultatif : modèles 3D

Pour ajouter le pack de modèles 3D, mettez-le après Viewpoint sur les deux lignes :

WorkshopItems=3619862853;3809306528;3810302175
Mods=\ZombieBuddy;\Viewpoint;\PZVoxelStudioViewpoint

Le pack est volumineux (environ 535 Mo) : le démarrage suivant prend quelques minutes de plus et le serveur a besoin de l'espace disque. Chaque joueur le télécharge aussi, et l'auteur recommande au moins 4 Go de RAM pour le jeu.

Partie 2 — chaque joueur (une fois par PC)

1. Utiliser la version Stable du jeu

Dans Steam, faites un clic droit sur Project Zomboid → Properties → Game Versions & Betas et vérifiez qu'aucune branche bêta (par exemple Pre-Release) n'est sélectionnée. Votre jeu doit avoir la même version que le serveur.

2. S'abonner aux mods

Ouvrez ZombieBuddy et Project Viewpoint sur le Steam Workshop et cliquez sur Subscribe pour les deux. Le jeu les téléchargerait en rejoignant le serveur, mais les fichiers de ZombieBuddy doivent être sur votre PC avant de lancer le jeu.

3. Installer le chargeur Java ZombieBuddy

Windows — automatique (recommandé) :

1. Téléchargez ZombieBuddyInstaller.exe depuis les versions de ZombieBuddy sur GitHub.
2. Lancez-le et choisissez Install or update ZombieBuddy.
3. Choisissez Both comme mode de lancement.
4. Vérifiez la liste des modifications et confirmez. S'il vous demande de fermer Steam, faites-le.

Windows — manuel :

1. Copiez ZombieBuddy.jar et zbNative.dll depuis C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\3619862853\mods\ZombieBuddy\libs\ vers C:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid\.
2. Dans Steam, faites un clic droit sur Project Zomboid → Properties → Launch Options et saisissez :

-agentlib:zbNative --

Linux :

1. Copiez ZombieBuddy.jar depuis ~/.steam/steam/steamapps/workshop/content/108600/3619862853/mods/ZombieBuddy/libs/ vers ~/.steam/steam/steamapps/common/ProjectZomboid/projectzomboid/.
2. Définissez ces options de lancement dans Steam :

-javaagent:ZombieBuddy.jar --

macOS :

1. Copiez ZombieBuddy.jar depuis le même dossier libs/ de l'objet du Workshop vers ~/Library/Application Support/Steam/steamapps/common/ProjectZomboid/Project Zomboid.app/Contents/Java/.
2. Définissez ces options de lancement dans Steam :

-javaagent:ZombieBuddy.jar --

Le -- à la fin des options de lancement est obligatoire. Sans lui, ZombieBuddy ne démarre pas.

4. Lancer le jeu et autoriser Viewpoint

Quand ZombieBuddy trouve un mod Java qu'il n'a jamais vu, il affiche une fenêtre avec le nom du mod et son empreinte SHA-256. Cliquez sur Yes pour Viewpoint et choisissez de mémoriser la décision. La même fenêtre réapparaît après chaque mise à jour de Viewpoint.

5. Rejoindre le serveur

Rejoignez votre serveur comme d'habitude. Une fois dans le monde :

Si le jeu est lent, ouvrez les réglages avec Delete et choisissez le préréglage Vanilla, le plus léger.

Mises à jour du jeu

Viewpoint ne prend en charge que les versions du jeu testées par son auteur. Quand Project Zomboid reçoit une mise à jour, le mod peut cesser de fonctionner jusqu'à ce que l'auteur publie une nouvelle version.

• Votre serveur Lobby Maker installe les mises à jour du jeu au redémarrage, et le jeu des joueurs se met à jour via Steam. Avant qu'une mise à jour arrive sur la branche Stable, The Indie Stone la teste généralement au moins une semaine sur la branche Pre-Release.
• Après une mise à jour du jeu, vérifiez sur la page Workshop de Viewpoint quelle version est prise en charge. Si le mod n'est pas encore à jour, les joueurs peuvent quand même se connecter et jouer avec la vue normale (voir plus bas), ou vous pouvez retirer Viewpoint des deux lignes en attendant la mise à jour.

Problèmes courants

Le serveur a démarré, mais les mods n'y sont pas. Vérifiez la ligne Mods= : les Mod ID doivent correspondre exactement, majuscules comprises, et \ZombieBuddy doit venir avant \Viewpoint. Vérifiez aussi que le serveur était arrêté pendant que vous modifiiez le fichier.

« Workshop item version is different than server's » à la connexion. Un des mods a été mis à jour après que le serveur l'a téléchargé. Redémarrez le serveur, et le joueur devrait relancer son jeu.

Un joueur appuie sur O et rien ne se passe. ZombieBuddy ne tourne pas sur le PC de ce joueur : le jar n'est pas dans le bon dossier, les options de lancement manquent, ou le -- final manque. S'il a cliqué sur No par erreur dans la fenêtre d'autorisation, il peut maintenir Shift pendant le chargement du jeu pour la faire réapparaître.

Le jeu demande à nouveau s'il faut charger Viewpoint. Le mod a été mis à jour et son fichier a changé. Vérifiez qu'il s'agit toujours de Project Viewpoint et cliquez sur Yes.

Le mod ne marche plus après une mise à jour du jeu. La nouvelle version du jeu n'est pas encore prise en charge. Voir Mises à jour du jeu plus haut.

Foire aux questions

Des amis sans ZombieBuddy peuvent-ils se connecter ? Oui. Ils téléchargent les mods comme tout le monde, mais sans le chargeur Java Viewpoint ne démarre pas : ils jouent donc avec la vue normale de dessus.

Viewpoint fonctionne-t-il avec d'autres mods ? Selon son auteur, la plupart des mods du Workshop fonctionnent avec. Ajoutez-les comme indiqué dans Comment installer des mods sur un serveur Project Zomboid.

Le serveur a-t-il besoin de plus de RAM pour Viewpoint ? Non. Le mod fait son rendu sur les PC des joueurs, et le serveur ne fait que distribuer les fichiers du mod. Le pack facultatif de modèles 3D demande surtout de l'espace disque.

Pas encore de serveur ? Louez un serveur Project Zomboid sur Lobby Maker — il est prêt en une minute environ, et vous pouvez ajouter Project Viewpoint tout de suite.