﻿INSTALLER UN SERVEUR nitmod_custom 1.0.0
========================================

Ce guide explique comment installer un serveur dedie nitmod_custom, etape par etape.
Les fichiers se trouvent dans la Release v1.0.0 du depot GitHub nitmod_custom.


0. CE QU'IL FAUT AVANT DE COMMENCER
-----------------------------------
- Un serveur dedie ET: Legacy deja installe (programme etlded, dossier etmain present)
  et qui demarre sans le mod.
- Les fichiers de la Release v1.0.0 :
    nitmod_custom.1.0.0.pk3   le pack client (menus, images, modules client)
    nitmod_custom.zip         le dossier de configuration du serveur
    et UN seul fichier qagame, selon ton systeme :
        qagame.mp.x86_64.so   Linux 64 bits
        qagame.mp.i386.so     Linux 32 bits
        qagame_mp_x86.dll     Windows
        qagame_mac            macOS


1. CREER LE DOSSIER DU MOD
--------------------------
Dans le dossier d'ET: Legacy (celui qui contient etmain), le dossier du mod doit
s'appeler exactement :

    nitmod_custom

Decompresse nitmod_custom.zip dans le dossier d'ET: Legacy. Il cree le dossier
nitmod_custom avec dedans :
    nitmod_custom.cfg            la configuration du mod
    CCxAC/                       les regles de l'anti-cheat
    mapscripts/
    levels.db, commands.db, votes.db   les niveaux, commandes et votes d'administration
    GeoIP.dat
    le changelog

IMPORTANT : le nom du dossier doit contenir "nitmod". C'est ce qui fait apparaitre
l'icone Nit dans le navigateur de serveurs.


2. COPIER LES FICHIERS DU MOD
-----------------------------
Dans le dossier nitmod_custom, copie :
- nitmod_custom.1.0.0.pk3
- le fichier qagame de ta plateforme, SANS le renommer.

Redemarre toujours le serveur apres avoir remplace un fichier qagame.


3. CONFIGURER
-------------
a) Ouvre nitmod_custom/nitmod_custom.cfg avec un editeur de texte et regle au minimum :
   - le mot de passe rcon et les autres mots de passe (ils sont vides dans le fichier fourni)
   - le nom du serveur, le message du jour, etc.
   Chaque reglage est commente dans le fichier.

b) Ouvre etmain/server.cfg (ou etserver.cfg / etlserver.cfg selon ton installation)
   et ajoute cette ligne :

       exec nitmod_custom.cfg


4. LANCER LE SERVEUR
--------------------
Le serveur doit etre lance avec le dossier du mod :

    +set fs_game nitmod_custom

Exemple (a adapter a ton script de lancement) :

    ./etlded +set fs_game nitmod_custom +exec server.cfg

Sous Windows, ajoute la meme option dans le raccourci ou le fichier .bat de lancement.


5. VERIFIER QUE CA MARCHE
-------------------------
Dans la console du serveur, au demarrage, tu dois voir des lignes qui commencent par
"CCxAC:" (par exemple "CCxAC: Loaded ... cheat signatures"). Ensuite :
- connecte-toi au serveur avec le jeu
- tape !help en jeu : la liste des commandes s'affiche par categories
- dans le navigateur de serveurs, l'icone Nit doit apparaitre

Au premier lancement, le serveur cree un second dossier CCxAC dans ton dossier de
donnees personnel du moteur (sous Linux : ~/.etlegacy/nitmod_custom/CCxAC). Il contient
les captures d'ecran des joueurs et le journal CCxAC_Violations.log.


6. CREER LE PREMIER ADMINISTRATEUR
----------------------------------
Connecte-toi au serveur, identifie-toi avec le mot de passe rcon, puis donne-toi un
niveau avec la commande !setlevel. Les niveaux sont ceux du fichier levels.db.


7. L'ANTI-CHEAT CCxAC
---------------------
Les regles sont dans nitmod_custom/CCxAC/ :
    ccxac_cvars.cfg       variables interdites
    ccxac_cheats.cfg      base de cheats connus (nom, SHA1, action)
    ccxac_md5.cfg         liste noire de modules par empreinte MD5
    ccxac_forcecvar.cfg   variables imposees aux joueurs
Apres une modification, recharge sans redemarrer avec la commande !ccxac_reload
(en jeu, avec la permission ccxac_reload, ou dans la console du serveur).

Regle de ccxac_cheats.cfg : le nom du module doit etre EXACT. Une regle sans SHA1 (*)
est seulement ecrite dans le journal, elle ne kick ni ne bannit jamais. Pour
sanctionner, mets le vrai SHA1 de la DLL dans la regle.


8. LE BLOQUEUR DE VPN vpnGuard (OPTIONNEL)
------------------------------------------
Reglages en bas de nitmod_custom.cfg :
    g_vpnGuardEnabled              1 pour activer
    g_vpnGuardApiKey1, ...ApiKey2  cles API des verifications en ligne (sans cle, seules
                                   tes listes locales servent)
    g_vpnGuardMaxLevel             niveau d'admin au-dessus duquel on n'est jamais bloque
    g_vpnGuardBanMessageVPN        message affiche en cas de VPN ou proxy
    g_vpnGuardBanMessageBlacklist  message affiche pour une IP en liste noire

Commandes (en jeu, voir aussi !help) :
    !vpn [status|on|off|reload|check]
    !vpn-check [ip]
    !whitelist   IP jamais bloquees
    !blacklist   IP toujours bloquees
    !nguidlist   NGUID jamais bloques
Tes listes sont enregistrees dans le fichier vpnguard.sqlite du dossier du mod.


9. LES BOTS Omni-bot (OPTIONNEL)
--------------------------------
Si tu utilises des bots, installe Omni-bot dans un dossier de ton choix et indique son
chemin avec la variable omnibot_path (exemple : "./legacy/omni-bot"). Sous Linux 64 bits,
le fichier attendu est omnibot_et.x86_64.so dans ce dossier. Les commandes de bots
(!maxbots, !minbots, !botwar, !botsveryeasy ... !botsultra) sont dans !help.


10. EN CAS DE PROBLEME
----------------------
- Le serveur ne trouve pas le mod : verifie que le dossier s'appelle bien nitmod_custom
  et que +set fs_game nitmod_custom est dans la commande de lancement.
- Le qagame ne se charge pas : verifie que c'est le bon fichier pour ta plateforme.
- Aucune ligne "CCxAC:" au demarrage : verifie que le dossier nitmod_custom/CCxAC existe
  et que le serveur a le droit d'ecrire dans ton dossier de donnees personnel.
- Un joueur banni a tort : regarde CCxAC_Violations.log pour voir quelle regle a declenche.
- Apres chaque mise a jour du mod : remplace le qagame ET le .pk3, puis redemarre.
