Les paramètres Sandbox de Project Zomboid expliqués (Build 42)

Les paramètres Sandbox de Project Zomboid expliqués (Build 42)

Tous les paramètres sandbox de Project Zomboid tiennent dans un seul fichier : Pterodactyl_SandboxVars.lua. Chaque réglage de gameplay, population de zombies, multiplicateurs de loot, XP des compétences, durée du jour, météo, se pilote depuis là. C'est le fichier le plus important de votre serveur Project Zomboid. Ce guide décrit le fichier tel que Build 42 l'écrit réellement, avec les vrais noms de clés et les vraies valeurs par défaut.

Important : arrêtez le serveur avant toute modification. PZ réécrit SandboxVars.lua à l'extinction et écrasera vos changements si vous éditez pendant que le serveur tourne.

Où se trouve le fichier

/home/container/.cache/Server/Pterodactyl_SandboxVars.lua

Si vous avez renommé votre serveur, remplacez Pterodactyl par le nom du serveur.

Comment le fichier Build 42 est structuré

Build 42 a renommé beaucoup de clés et déplacé plusieurs groupes de réglages dans des tables imbriquées. Un fichier B42 commence ainsi :

SandboxVars = {
    VERSION = 6,
    Zombies = 4,
    Distribution = 1,
    ...
    ZombieLore = {
        Speed = 4,
        ...
    },
    ZombieConfig = {
        PopulationMultiplier = 0.65,
        ...
    },
    MultiplierConfig = {
        Global = 1.0,
        ...
    },
}

Quatre conséquences en découlent, et c'est là que la plupart des modifications échouent :

• VERSION = 6 identifie le format Build 42. Si votre fichier affiche un nombre inférieur, il a été écrit par Build 41 et les clés ci-dessous ne seront pas toutes présentes.
• Le comportement des zombies n'est pas au niveau racine. Speed, Sight, Hearing et les autres ne fonctionnent qu'à l'intérieur de ZombieLore = { ... }.
• Le respawn et les multiplicateurs de population sont dans ZombieConfig = { ... }.
• L'XP des compétences est une table (MultiplierConfig), pas une valeur unique.

Coller une clé au niveau racine alors que le jeu l'attend dans une table ne produit rien : le serveur démarre normalement et l'ignore.

Population de zombies

Le réglage principal de population est au niveau racine, et il compte six paliers, pas cinq.

Notez que Zombies pilote aussi ZombieConfig.PopulationMultiplier. Le jeu garde les deux synchronisés : Insane = 2.5, Very High = 1.6, High = 1.2, Normal = 0.65, Low = 0.15, None = 0.0.

Les réglages fins de population sont dans ZombieConfig = { ... } :

Réglage pratique : le B42 vanilla est livré avec le respawn désactivé (RespawnHours = 0.0), donc une ville nettoyée le reste. Pour qu'un serveur de longue durée se repeuple, il faut les trois clés de respawn, par exemple RespawnHours = 168.0, RespawnUnseenHours = 48.0, RespawnMultiplier = 0.1. Si RespawnMultiplier reste à 0.0, rien ne réapparaît, quelles que soient les valeurs horaires.

Laissez ZombiesCountBeforeDelete à 300. L'augmenter ou le mettre à 0 est une cause connue de graves problèmes de performances.

L'impact de ces multiplicateurs dépend de l'endroit où jouent vos joueurs : les villes denses comme Louisville comptent bien plus de zombies que la campagne. Notre carte Project Zomboid gratuite montre toutes les villes de Knox Country avec leurs coordonnées exactes.

Comportement des zombies (dans `ZombieLore`)

C'est là que se joue la difficulté, et tout se trouve dans la table ZombieLore = { ... }. Plusieurs valeurs par défaut de B42 valent "Random", ce qui surprend quiconque attend les valeurs de Build 41.

Il n'existe pas de clé MemoryDuration dans Build 42, ni aucune clé Smell. Le réglage de mémoire s'appelle Memory.

À propos des sprinters : la valeur par défaut Speed = 4 correspond à Random, et Random s'appuie sur SprinterPercentage, livré à 0. Un serveur B42 par défaut n'a donc aucun sprinter. Pour un serveur 100% sprinters, mettez Speed = 1. Pour un mélange, gardez Speed = 4 et montez SprinterPercentage (10 à 20 est déjà brutal).

Loot

Build 42 a remplacé les anciens menus de rareté 1-5 par des multiplicateurs décimaux, et les noms de clés ont pris le suffixe New. FoodLoot, WeaponLoot et OtherLoot n'existent plus.

La valeur 1.0 correspond au niveau prévu par les développeurs, le fichier livré est donc déjà en dessous sur la plupart des catégories. Doubler un nombre double en gros la fréquence d'apparition de la catégorie.

Le respawn du loot est un sujet à part, et il n'existe pas de clé LootRespawn dans Build 42 :

Pour les serveurs de longue durée : mettez HoursForLootRespawn = 720 (un mois de jeu) et SeenHoursPreventLootRespawn = 24. Sinon les joueurs vident la carte définitivement, et elle le reste.

Laissez RollsMultiplier à 1.0. Le fichier lui-même déconseille d'y toucher, et les valeurs élevées coûtent en performances.

Temps, météo et réseaux

Il n'existe pas de clé HoursPerDay dans Build 42. La durée du jour s'appelle DayLength, et son échelle monte jusqu'à 27 pour des journées en temps réel.

Serveurs de longue durée : poussez WaterShutModifier et ElecShutModifier à 60 ou plus, ou mettez WaterShut et ElecShut à 9 pour supprimer complètement la coupure. Sinon le deuxième mois se passe uniquement à transporter de l'eau.

XP des compétences (dans `MultiplierConfig`)

Il n'existe pas de clé XpMultiplier. Build 42 utilise une table MultiplierConfig = { ... } avec un taux global plus une entrée par compétence.

MultiplierConfig = {
    Global = 1.0,
    GlobalToggle = true,
    Fitness = 1.0,
    Strength = 1.0,
    Woodwork = 1.0,
    ...
}

Pour tripler l'XP partout, mettez Global = 3.0 et laissez GlobalToggle = true. Pour ne booster que les armes à feu, mettez GlobalToggle = false puis montez Aiming et Reloading. Modifier une valeur individuelle alors que GlobalToggle est encore true ne fait rien, et c'est la plainte la plus fréquente que nous voyons au sujet de l'XP.

Deux clés voisines restent au niveau racine : CharacterFreePoints (défaut 0, points supplémentaires à la création du personnage) et LevelForMediaXPCutoff (défaut 3).

Véhicules

Monde et construction

Notez que MaxFogIntensity et MaxRainFxIntensity sont des paliers entiers dans Build 42, plus les décimales 0.0-1.0 d'avant. MaxFogIntensity = 0.0 ne veut pas dire "aucun brouillard", c'est un palier invalide.

Modifier le fichier sans risque

1. Arrêtez le serveur depuis votre panel. Ce point n'est pas négociable
2. Ouvrez /home/container/.cache/Server/Pterodactyl_SandboxVars.lua dans le gestionnaire de fichiers ou en SFTP
3. Trouvez le paramètre avec Ctrl+F, et vérifiez s'il est au niveau racine ou dans ZombieLore, ZombieConfig, MultiplierConfig, Map ou Basement
4. Ne changez que la valeur après le =. Laissez le nom de clé, la virgule et les accolades en place
5. Enregistrez le fichier
6. Démarrez le serveur

Les valeurs doivent être du Lua valide : Speed = 1, et non Speed = "Sprinters". Les booléens s'écrivent true / false sans guillemets. Les clés de multiplicateur prennent des décimales (FoodLootNew = 1.2), les clés de palier des entiers (CarSpawnRate = 4).

Si le serveur refuse de démarrer après une modification, vous avez presque certainement perdu une virgule ou une accolade fermante. La console indique la ligne.

Quelles modifications s'appliquent à un monde existant

Les paramètres sandbox sont lus à la création du monde, beaucoup ne concernent donc que le terrain pas encore généré. Paramètres qui s'appliquent à une sauvegarde existante après redémarrage :

• Tout ce qui est dans ZombieLore (Speed, Strength, Cognition, Sight, Hearing)
• Les clés de respawn de ZombieConfig (RespawnHours, RespawnUnseenHours, RespawnMultiplier)
• Le respawn du loot (HoursForLootRespawn, SeenHoursPreventLootRespawn)
• Les taux d'XP de MultiplierConfig
• Les dates de coupure d'eau et d'électricité, tant que la coupure n'a pas déjà eu lieu

Paramètres qui ne changent pas rétroactivement un monde existant :

• StartMonth, StartDay, StartTime, StartYear
• Les multiplicateurs *LootNew, pour les conteneurs déjà générés
• CarSpawnRate et le placement des véhicules dans les chunks explorés
• Basement.SpawnFrequency, puisque les sous-sols sont posés avec le chunk

Préréglages sandbox

Project Zomboid embarque des préréglages que vous pouvez choisir dans le menu Custom Sandbox du jeu avant de générer un monde : Apocalypse (par défaut), Survivor, Survival, Builder, Initial Infection, Six Months Later. Sur un serveur dédié il n'y a pas de sélecteur de préréglage, la méthode pratique consiste donc à configurer le préréglage en solo puis à copier les valeurs du SandboxVars.lua de cette sauvegarde vers le fichier du serveur. Conservez l'imbrication en copiant.

FAQ

Mes modifications sont systématiquement annulées. Vous avez édité pendant que le serveur tournait. PZ a écrit son état mémoire à l'extinction et écrasé votre fichier. Arrêtez toujours le serveur d'abord.

J'ai changé un réglage de zombies et rien ne se passe. Vous l'avez très probablement placé au niveau racine. Speed, Sight, Hearing, Memory, Toughness et les autres ne fonctionnent que dans la table ZombieLore = { ... }. Le même piège vaut pour RespawnHours, qui appartient à ZombieConfig.

Pourquoi mes zombies réapparaissent-ils alors que j'ai réglé RespawnHours ? Ou l'inverse : rien ne réapparaît. Les trois clés comptent. RespawnHours fixe le cycle, RespawnUnseenHours le conditionne à la visibilité, et RespawnMultiplier décide combien reviennent. B42 livre les trois pratiquement désactivées.

Où est passé XpMultiplier ? Il a disparu. Build 42 utilise MultiplierConfig.Global, avec GlobalToggle = true pour l'appliquer à toutes les compétences.

Puis-je changer des réglages à chaud avec /changeoption ? Seulement une petite partie (PVP, max players, réglages vocaux). Les valeurs sandbox ne se changent pas à chaud, elles demandent un redémarrage.

Où trouver toutes les valeurs par défaut vanilla ? Démarrez un serveur neuf. Le panel génère SandboxVars.lua avec toutes les valeurs par défaut au premier démarrage, et le fichier porte un commentaire au-dessus de chaque clé indiquant son échelle et son défaut. C'est ce fichier la référence, pas un vieux guide Build 41.

Une population de zombies plus élevée pèse-t-elle sur les performances ? Oui, nettement. Doubler PopulationPeakMultiplier ajoute environ 30% de RAM et de charge CPU. Anticipez avec notre calculateur de RAM.

Les mods ajoutent-ils leurs propres paramètres sandbox ? Certains oui. Les mods qui enregistrent des options sandbox ajoutent leurs champs automatiquement au chargement, et ceux-ci apparaissent dans SandboxVars.lua après le démarrage suivant.