📚 Tutoriel - Init.c Builder

1. Qu'est-ce que init.c et pourquoi cette application ?

Le fichier init.c est le cœur de votre serveur DayZ. C'est lui qui contrôle :

• L'initialisation de l'économie (système de loot, persistence, etc.)
• La date et l'heure du monde (saison, météo)
• La création des personnages joueurs
• L'équipement de départ (loadout au spawn)
• Les modules custom : ATM Expansion, téléport quêtes, bridge Discord, etc.

Sans cette application, il faut écrire ce fichier à la main en EnforceScript, le langage de DayZ. C'est complexe, source d'erreurs, et chaque petite modification peut casser le serveur.

2. Avant de commencer : sauvegardes obligatoires

3. Onglet 🏁 Démarrage : par où commencer ?

3 options s'offrent à vous selon votre situation :

Option A : Templates prédéfinis (recommandé pour débuter)

5 modèles prêts à l'emploi :

Sélectionnez un template dans le menu, cliquez "Charger le template". Tous les onglets sont pré-remplis. Vous pouvez ensuite modifier ce qui ne vous convient pas.

Option B : Uploader votre init.c existant

Si vous avez déjà un init.c fonctionnel sur votre serveur et que vous voulez juste y apporter des modifications via une interface, c'est l'option idéale. L'application va analyser votre fichier et pré-remplir tous les onglets.

Voir section 4 pour le détail.

Option C : Partir de zéro

Construction manuelle complète. Réservé aux utilisateurs qui savent exactement ce qu'ils veulent et qui veulent un contrôle total.

4. Importer votre init.c existant (analyse automatique)

C'est la fonctionnalité la plus puissante de l'application : elle vous permet de conserver votre travail existant tout en passant à une édition graphique.

L'application va alors détecter automatiquement :

• ✅ Le reset de date (mois et jour configurés)
• ✅ L'initialisation météo (overcast, rain, fog)
• ✅ Les cases d'équipement aléatoires (nombre + items par case)
• ✅ Les boosts de stats (water, energy, blood, health)
• ✅ Le module ATM Expansion (montant, intervalle)
• ✅ Les téléports de quêtes Expansion (IDs et coordonnées)
• ✅ Le bridge Discord (lecture bot_message.txt)
• ✅ Le log des connexions

Un message vous indiquera le nombre de sections détectées. Vous pouvez ensuite naviguer dans tous les onglets pour modifier ce qui existe ou ajouter du neuf.

5. Onglet 📅 Date & Météo

Reset de date

Force la date du serveur à une valeur fixe au démarrage. Utile pour :

• Avoir toujours la même saison (automne pour une ambiance sombre, été pour la chaleur)
• Éviter les bugs de croissance des plantes liés à la date
• Maintenir la cohérence d'un lore (ex : un serveur figé au 20 septembre 2024)

Décochez la case "Activer le reset de date" pour utiliser la date réelle du système.

Initialisation météo

Définit les conditions météo au démarrage du serveur. Les valeurs vont de 0 (rien) à 1 (au maximum).

• Overcast (couverture nuageuse) : 0 = ciel bleu, 1 = ciel totalement couvert
• Rain (pluie) : 0 = sec, 1 = orage
• Fog (brouillard) : 0 = clair, 1 = brouillard épais

Les valeurs min/max définissent une plage aléatoire à chaque démarrage. Si min=0.4 et max=0.6, le serveur choisira aléatoirement entre 0.4 et 0.6.

6. Onglet 👤 Équipement de spawn

Définit ce que les joueurs ont sur eux quand ils apparaissent sur le serveur (loadout de spawn).

Mode "Vanilla"

Reproduit le comportement par défaut de DayZ : bandage + chemlight aléatoire + fruit aléatoire (Apple/Pear/Plum), avec quickbar pré-assignée et santé randomisée sur les vêtements.

Choisissez ce mode si vous voulez le spawn vanilla mais juste configurer la date ou des modules custom.

Mode "Équipement fixe"

Tous les joueurs spawnent avec exactement le même équipement. Idéal pour les serveurs hardcore ou les serveurs avec un thème précis (prison, militaire, médical).

1. Cliquez sur "Configurer les cases"
2. Une seule case s'affiche
3. Sélectionnez les items dans les listes déroulantes (maintenez Ctrl pour multi-sélection)
4. Tous les items seront donnés à tous les joueurs au spawn

Mode "Multi-cases aléatoires"

Le serveur choisit une case au hasard parmi N possibilités. Chaque joueur peut spawner avec un équipement différent.

1. Définissez le "Nombre de cases aléatoires" (entre 1 et 20)
2. Cliquez sur "Configurer les cases"
3. Pour chaque case, sélectionnez les items dans les catégories de la BDD
4. Au spawn, le serveur tirera une case au hasard

Options supplémentaires

• Santé aléatoire (45-65%) : applique une usure réaliste aux vêtements (Body, Legs, Feet) au lieu du 100% par défaut
• Vider l'inventaire vanilla avant : appelle RemoveAllItems() pour effacer ce que DayZ aurait donné par défaut. Activez cette option sauf si vous voulez ajouter votre équipement EN PLUS du vanilla

7. Onglet 🎭 Classes RP / Militaires

Système avancé de classes avec armes principales, secondaires, attachements et chargeurs. Différent du mode "Multi-cases aléatoires" car il gère intelligemment les armes en main, les magazines compatibles, et les kits médicaux.

Configuration commune (en bas de l'onglet)

• Sac à dos commun : type de sac donné à toutes les classes (ex: SmershBag)
• Items utilitaires : nourriture, soins de base (ex: BandageDressing, Apple, Canteen)
• Armes de mêlée aléatoires : un couteau au hasard parmi cette liste

8. Onglet 💪 Stats joueur

Donne un boost aux stats du joueur au spawn. Utile pour les serveurs PvP où on ne veut pas que les joueurs commencent affamés/déshydratés.

9. Onglet 🎮 Modules Expansion

Téléport sur complétion de quête

Quand un joueur termine une quête Expansion (ID de quête défini dans votre config Expansion-Quests), il est téléporté automatiquement à des coordonnées que vous définissez.

Pour chaque téléport :

• Nom : commentaire (ex: "Trader Klen")
• ID de la quête : doit correspondre à un fichier de quête Expansion (ex: 1001)
• Positions : une par ligne, format X Y Z (ex: 7403.7 15.2188 2268.64). Si plusieurs positions, le joueur sera téléporté à une au hasard

Paiement automatique ATM

Verse automatiquement de l'argent sur le compte bancaire ATM des joueurs connectés, à intervalle régulier.

• Montant : nombre d'unités à ajouter (ex: 500)
• Intervalle : en minutes (ex: 30 = toutes les 30 min)
• Message : notification affichée au joueur. %1 sera remplacé par le montant

10. Onglet 💬 Bridge Discord

Bridge Discord (messages bot → serveur)

Permet à un bot Discord externe d'envoyer des messages dans le jeu sans utiliser de mod RCON.

Comment ça marche :

1. Votre bot Discord écrit un message dans le fichier bot_message.txt dans le dossier profil du serveur
2. Le serveur lit ce fichier toutes les X millisecondes (par défaut 2000ms = 2s)
3. Si du contenu est trouvé, il est diffusé à tous les joueurs avec le préfixe défini (ex: [SERVEUR] Message...)
4. Le fichier est supprimé après diffusion

Configuration :

• Préfixe des messages : ce qui apparaît devant chaque message (ex: [SERVEUR], [ADMIN], 📢)
• Intervalle de check : fréquence de lecture du fichier en millisecondes (2000 = équilibre performance/réactivité)

Log des connexions

Écrit dans un fichier toutes les connexions/déconnexions des joueurs. Format de chaque ligne :

Ce log peut ensuite être lu par votre bot Discord pour annoncer les connexions dans un salon dédié.

11. Onglet ⚙️ Code Custom (avancé)

3 zones d'injection de code personnalisé :

Code à injecter dans main()

Ce code est exécuté une fois au démarrage du serveur, après l'init économie et le reset de date. Exemples d'usage :

Code à injecter dans CustomMission (méthodes/variables)

Ce code ajoute des méthodes ou variables à la classe CustomMission. Exemples :

Code à injecter dans StartingEquipSetup

Ce code est exécuté à chaque spawn d'un joueur, à la fin de la fonction d'équipement. Exemples :

12. Onglet 📄 Aperçu & Export

Une fois votre configuration prête, allez dans cet onglet pour visualiser et télécharger votre fichier.

Boutons disponibles

• 🔄 Régénérer l'aperçu : recalcule le fichier en fonction de votre config actuelle. À cliquer après chaque modification dans les autres onglets.
• ⬇️ Télécharger init.c : télécharge le fichier brut, prêt à déposer sur votre serveur
• 📦 Télécharger ZIP : télécharge un ZIP contenant init.c + un README.txt récapitulant les modules activés et les dépendances mods
• 📋 Copier dans le presse-papier : copie le contenu pour le coller ailleurs (ex: dans votre éditeur de texte)

Que faire de l'aperçu ?

L'aperçu affiche le code EnforceScript généré. Lisez-le rapidement avant de télécharger pour vérifier que tout ce que vous attendez est là. Si vous voyez des trucs bizarres ou des sections manquantes, retournez modifier les onglets correspondants.

13. Installation du fichier sur votre serveur

Étape 1 : Identifier le bon emplacement

Le fichier init.c se place dans le dossier de mission de votre serveur :

Étape 2 : Upload via FTP/SFTP

1. Connectez-vous à votre serveur avec FileZilla, WinSCP ou autre client FTP
2. Naviguez jusqu'au dossier de mission
3. Renommez l'ancien init.c en init_old.c (sécurité supplémentaire)
4. Uploadez le nouveau init.c téléchargé depuis l'application

Étape 3 : Vérifier les dépendances mods

Si vous avez activé des modules dans l'application, vérifiez que les mods correspondants sont installés et chargés :

Étape 4 : Redémarrer le serveur

1. Arrêtez le serveur DayZ
2. Démarrez-le
3. Surveillez les logs (server_console.log et script.log) pendant les 30 premières secondes

Étape 5 : Tester en jeu

• Connectez-vous au serveur
• Vérifiez votre équipement de spawn
• Si vous avez configuré ATM Expansion, attendez l'intervalle pour vérifier le crédit
• Si vous avez le bridge Discord, faites un test depuis le bot

14. FAQ et résolution de problèmes

❓ Mon serveur ne démarre plus après avoir mis le nouveau init.c

Causes possibles :

• Mod manquant : vous avez activé un module Expansion mais le mod n'est pas chargé. Vérifiez votre startup.bat / launcher
• Classname inexistant : un item dans l'équipement n'existe pas dans les mods chargés. Regardez script.log pour la ligne qui pose problème
• Erreur de syntaxe : si vous avez utilisé l'onglet Code Custom, une virgule ou un point-virgule oublié peut tout casser

Solution rapide : restaurez votre init.c de sauvegarde, le serveur redémarrera. Puis revenez dans l'application pour corriger.

❓ Les joueurs spawnent nus / sans équipement

• Avez-vous bien activé l'onglet 👤 Équipement ?
• Êtes-vous en mode "Multi-cases aléatoires" mais vos cases sont vides ?
• Les classnames sont-ils corrects (case sensitive) ?

❓ Le bridge Discord ne fonctionne pas

• Le fichier bot_message.txt est-il bien créé dans le dossier profil du serveur ? (pas dans le dossier de mission)
• Le bot a-t-il les permissions d'écriture sur ce dossier ?
• L'intervalle de check est-il raisonnable (entre 1000 et 5000 ms) ?

❓ J'ai perdu ma configuration en fermant le navigateur

Pensez à utiliser le bouton "💾 Sauvegarder projet" en haut. Vous pouvez rappeler vos configs avec "📂 Charger projet".

❓ Comment ajouter un mod custom à ma classe ?

Dans l'onglet 🎭 Classes, tapez simplement le classname du mod dans les champs (ex: Mystic_CustomGun). L'application ne vérifie pas l'existence : c'est à vous de vous assurer que le mod est chargé.

❓ Mon serveur est sur Nitrado / Gportal, comment je fais ?

Le principe est le même : uploadez le init.c via l'interface du gestionnaire (Web FTP ou explorateur de fichiers du panel). Le chemin est identique : mpmissions/[votre_mission]/init.c.

❓ Besoin d'aide supplémentaire ?

• 📧 Email : contact@dayzaide.fr
• 💬 Discord : https://discord.gg/N4Kste2k62
• 📺 YouTube : @DayZAide
• 🌐 Site : dayzaide.fr