Configuration

Configuration

Référence des clés de worldserver.conf propres à SylvaniaCore et à sa lignée. Les clés héritées de TrinityCore sont documentées dans le fichier .dist lui-même.

Les valeurs de la colonne .dist sont celles du fichier versionné, c'est-à-dire les défauts du code : le .dist ne reflète pas les réglages du royaume. La colonne Prod dit ce que le serveur de La Légion de Sylvania utilise réellement.

Depuis le 31/08/2026, toutes les clés custom sont versionnées : le .dist et la production ne diffèrent plus que par les valeurs.

---

PlayerBots

Le peuplement automatique hérité de l'amont est coupé, mais le système de bots tourne : les modules du royaume le pilotent à la demande. World.cpp initialise le gestionnaire de bots dès que pbotbg ou pbotall vaut 1 — c'est ce qui permet aux modules maison de fonctionner avec le peuplement amont désactivé.

Clé	Défaut amont	Prod royaume	Effet
pbot	1	0	Bots amis / de groupe connectés automatiquement à l'arrivée d'un joueur. Coupé : choix délibéré.
pbotall	1	0	Peuplement automatique du monde et de la file LFG. Coupé.
pbot_hp	1	1	Affichage/gestion des points de vie des bots.
pbotbg	0	1	Module BG BotFill : remplissage des champs de bataille quand de vrais joueurs sont en file (WS / AB / EY / AV / IC). Explicitement indépendant de pbotall.
pbotbg_maxperteam	0	0	Plafond de bots par équipe ; 0 = pas de plafond spécifique.
pbotbg_idlelogout	300	300	Secondes avant déconnexion d'un bot BG inactif.
pbotasl	88	88	Plafond global de bots connectés simultanément.
pbottitle	600	600	Titre imposé à tout bot. Voir Autres customs.
pbotqa	0	0	Harnais d'assurance qualité. À 0, un bot de terrain qui se retrouve sur une carte d'instance est renvoyé chez lui ; à 1, il est autorisé à y rester, pour observer le comportement des bots en donjon. Ne pas activer en production. (BotFieldAI.cpp:274)

Voir Module PlayerBots.

---

Mercenaires

Clé	Défaut .dist	Prod royaume	Effet
pbotmerc	0	1	Active le module : le Portail d'Invocation (créature 1000010) loue des bots.
pbotmerc_cost	100	100	Coût du contrat, en pièces d'or.
pbotmerc_max	4	4	Nombre maximum de mercenaires sous contrat simultané. Plafonné à MERCENARY_HARD_CAP.
pbotmerc_minlevel	10	10	Niveau minimum du joueur pour recruter.
pbotmerc_chat	0	1	Active le volet dialogue LLM.
pbotmerc_chat_cooldown	5	5	Délai anti-spam entre deux répliques, en secondes.
pbotmerc_chat_timeout	30	30	Délai d'expiration d'un appel au fournisseur, en secondes.
pbotmerc_chat_maxtokens	160	160	Longueur maximale d'une réponse, en jetons.
pbotmerc_chat_history	6	6	Échanges gardés en mémoire par mercenaire — chacun est renvoyé au modèle, donc refacturé.
pbotmerc_chat_queue	32	32	Profondeur maximale de la file d'appels en attente.

Ces défauts sont ceux du code (MercenaryMgr.cpp:71-80, MercenaryChat.cpp:232-237) : un serveur neuf se comporte donc à l'identique avec ou sans ces lignes dans son fichier de configuration.

Voir Module Mercenaires.

---

Siège des Capitales

Module écrit et livré, non activé en production (siege_enable = 0).

Général

Clé	Défaut	Effet
siege_enable	0	Interrupteur principal.
siege_hour_min / siege_hour_max	6 / 24	Plage horaire (heure serveur) où un siège peut se déclencher.
siege_botcount	50	Effectif de l'armée d'invasion.
siege_botlevel	110	Niveau des assaillants.
siege_duration	3600	Durée maximale d'un siège, en secondes.
siege_spawn_rate	5	Cadence d'apparition des assaillants.
siege_pvp	1	Flagge les joueurs de la capitale assiégée en PvP.
siege_tank_pct / siege_healer_pct	10 / 20	Composition de l'armée, en pourcentage.
siege_announce	1	Annonces en jeu.

Comportement de combat

Clé	Défaut	Effet
siege_engage_range	10	Distance d'engagement d'un assaillant ordinaire.
siege_boss_engage_range	60	Distance d'engagement du chef de faction.
siege_stall_timeout	20	Secondes sans progression avant de considérer la colonne bloquée.
siege_advance_window	12	Fenêtre d'avancée sur l'itinéraire.
siege_maxdiff	400	Charge serveur (diff) au-delà de laquelle le module se met en retrait.

Cibles par faction

Le même bloc existe en siege_alliance_* et siege_horde_* :

Clé	Alliance	Horde
..._map	0 (Azeroth)	1 (Kalimdor)
..._boss_entry	107574	42283
..._boss_spawn	20555650	110864
..._boss_level	0 (= niveau natif)	110
..._boss_health / ..._boss_faction	0 (= valeurs natives)	0
..._boss_x/y/z	-8363.3 / 232.5 / 157.1	1924.4 / -4144.1 / 40.6
..._staging_x/y/z	-9204.4 / 466.6 / 97.9	1570.0 / -4397.4 / 16.0
..._route_first / ..._route_last	1000 / 1099	2000 / 2099

..._route_first / ..._route_last délimitent la plage de path_id des itinéraires d'approche, posés par sql/sylvania/capital_siege_waypoints_sw.sql.

Voir Module Siege des Capitales.

---

Solocraft

Mise à l'échelle des donjons et raids parcourus en petit effectif.

Clé	Défaut .dist	Prod royaume
Solocraft.Enable	1	1
Solocraft.Announce	1	1
Solocraft.Dungeon	5	5
Solocraft.Heroic	6	6
Solocraft.Raid10 / Raid25 / Raid30 / Raid40	10 / 25 / 30 / 40	idem
Solocraft.Mythic	1.0	1.0
Solocraft.StatsPct	100	100
Solocraft.DamagePct	20	35

DamagePct relevé à 35 en production : réglage assumé, pas un correctif.

Solo LFG

Clé	Prod
SoloLFG.Enable	1
SoloLFG.Announce	1

---

Bond héroïque

Deux multiplicateurs appliqués au saut du Bond héroïque, rechargeables à chaud via .reload config, sans redémarrage.

Clé	Blizzlike	Défaut .dist	Prod royaume	Effet
HeroicLeap.SpeedMult	1.0	1.7	2.8	Facteur de vitesse horizontale (blizzlike ≈ 21 yd/s)
HeroicLeap.HeightMult	1.0	2.5	4.0	Facteur de hauteur d'arc (blizzlike 2,5 → 10 yd)

⚠️ Ce sont des réglages de ressenti, pas des correctifs — et le défaut du code n'est déjà pas blizzlike : SpellEffects.cpp:985-986 livre 1.7 / 2.5. C'est l'une des rares entorses assumées au « blizz adaptatif », et le royaume va plus loin encore. Pour un serveur réellement blizzlike sur ce sort, posez 1.0 / 1.0.

Détail d'implémentation utile si vous touchez à ce sort : le saut effectif est porté par SPELL_EFFECT_DASH du sort 6544 en phase HIT, qui écrase le JUMP_DEST du sort 94954 en phase LAUNCH. Les deux identifiants sont donc traités ensemble — ne modifier que 94954 ne produirait aucun effet visible.

---

Autres clés notables

Clé	Remarque
Updates.EnableDatabases	31 = auth + characters + world + hotfixes + shop
Updates.AutoSetup	1 au premier démarrage
DBC.Locale	0 (enUS). Le serveur ne sert que enUS — conséquence majeure sur la traduction.
DataDir	Doit pointer sur le dossier contenant dbc/ maps/ vmaps/ mmaps/ cameras/ gt/
HotfixCacheVersion	À incrémenter à chaque ajout d'enregistrement DB2 custom, sinon le client sert son cache. Voir Hotfixes DB2.