================================================================================
  AUTO DELIMB  -  Farming Simulator 25
  Version 1.0.0.0  -  par Cylouch
================================================================================


CE QUE FAIT LE MOD
--------------------------------------------------------------------------------

Tu abats un arbre a la tronconneuse : le tronc touche le sol deja debarrasse de
ses branches et de son feuillage. Il ne reste plus qu'a le decouper en billes.

Plus besoin de longer chaque tronc a la main pour l'ebrancher avant de pouvoir le
charger et le vendre correctement.

Le mod appelle la fonction d'ebranchage native du jeu
(removeSplitShapeAttachments). Rien n'est simule, rien n'est supprime en douce :
le volume de bois et sa qualite restent exactement ce qu'ils seraient si tu avais
ebranche a la main. Le prix de vente n'est pas modifie.


INSTALLATION
--------------------------------------------------------------------------------

1. Copie FS25_AutoDelimb.zip dans :

     Documents\My Games\FarmingSimulator2025\mods\

2. Lance le jeu et active "Auto Delimb" dans la liste des mods de ta partie.

Ne decompresse pas le zip.

Sur serveur dedie : depose le zip dans le dossier mods du serveur et active-le
dans la configuration de la partie, comme n'importe quel autre mod.

Il n'y a rien d'autre a faire. Pas de touche a configurer, pas de menu, pas de
fichier a editer : des que le mod est actif, les arbres que tu abats tombent
ebranches.


REGLAGES PAR DEFAUT
--------------------------------------------------------------------------------

     Declenchement ... Coupe manuelle uniquement
     Taille .......... 20 m
     Rayon ........... 16 m
     Densite ......... 0.25 m
     Portee .......... 60 m
     Axes ............ 3

Ces valeurs nettoient integralement les arbres de taille courante. Tu n'as
normalement rien a changer.


MODIFIER LES REGLAGES
--------------------------------------------------------------------------------

Tout se regle en jeu, par la console.

Pour ouvrir la console il faut d'abord l'activer une fois pour toutes :

  1. Ferme le jeu.
  2. Ouvre ce fichier avec le Bloc-notes :
       Documents\My Games\FarmingSimulator2025\game.xml
  3. Cherche la ligne :
       <controls>false</controls>
     et remplace false par true :
       <controls>true</controls>
  4. Enregistre et relance le jeu.

La console s'ouvre ensuite avec la touche  ~  (a gauche du 1, sur clavier AZERTY
c'est la touche des accolades / du caractere carre selon les claviers).


  adParam <taille> <rayon> <densite> <portee> <axes> [appelsParImage]

      La commande principale. Elle change tout d'un coup, immediatement, sans
      relancer le jeu.

      Valeurs par defaut :          adParam 20 16 0.25 60 3
      Plus complet, plus lourd :    adParam 28 22 0.15 80 3
      Plus leger :                  adParam 12 10 0.6 40 1
      Maximum absolu :              adParam 34 28 0.10 80 3 600

      Ce que fait chaque valeur :

        taille   Cote de la zone traitee a chaque passe. De 4 a 34.

        rayon    Portee sur les branches. De 2 a 28.
                 A MONTER si ce sont les branches les plus longues, les plus
                 ecartees du tronc, qui survivent.

        densite  Ecart en metres entre deux passes le long du tronc.
                 De 1.5 (grossier) a 0.1 (tres fin).
                 A BAISSER si des branches survivent par paquets espaces
                 regulierement le long du tronc.
                 C'est le reglage le plus efficace, et le plus couteux.

        portee   Longueur balayee le long du tronc, en metres. De 20 a 80.
                 A MONTER si de longs troncs gardent des branches a leur
                 extremite.

        axes     Nombre d'axes balayes : 1 (leger) ou 3 (complet).
                 Laisse sur 3.

        appelsParImage
                 Facultatif. Nombre d'operations traitees par image.
                 A monter si tu utilises une densite tres fine et que tu sens
                 une saccade au moment de l'abattage.


  adHere

      Force le balayage du tronc que tu vises avec la tronconneuse, meme s'il a
      deja ete traite.

      C'est le moyen le plus rapide de tester un reglage : vise un tronc encore
      branchu deja au sol, lance adParam avec les nouvelles valeurs, puis adHere,
      et tu vois immediatement le resultat.


  adToggle

      Active ou desactive le mod sans le desinstaller.


  adMode

      Bascule entre :
        - Coupe manuelle uniquement : seuls les arbres que TU abats a la
          tronconneuse sont ebranches. (par defaut)
        - Tout arbre qui tombe : n'importe quel tronc qui passe au sol l'est
          aussi (abatteuse, engin qui pousse, chute).


  adStatus

      Affiche les reglages courants et les compteurs (arbres traites, nombre
      d'operations).


  adDebug

      Active les logs detailles dans log.txt. A utiliser uniquement pour
      signaler un probleme.


ATTENTION : les reglages faits en console ne sont pas conserves quand tu quittes
le jeu. Pour les rendre permanents, voir la section suivante.


RENDRE UN REGLAGE PERMANENT
--------------------------------------------------------------------------------

Si tu as trouve des valeurs qui te conviennent mieux que celles d'origine :

  1. Ouvre FS25_AutoDelimb.zip (clic droit, ouvrir - pas besoin d'extraire).
  2. Va dans le dossier scripts et ouvre AutoDelimb.lua avec le Bloc-notes.
  3. Tout en haut du fichier, modifie ces lignes :

       AutoDelimb.SIZE   = 20.0
       AutoDelimb.RADIUS = 16.0
       AutoDelimb.STEP   = 0.25
       AutoDelimb.RANGE  = 60.0
       AutoDelimb.AXES   = 3

     SIZE = taille, RADIUS = rayon, STEP = densite, RANGE = portee.

  4. Enregistre, laisse le fichier se remettre dans le zip, relance le jeu.


SI CA NE NETTOIE PAS TOUT
--------------------------------------------------------------------------------

Diagnostique dans cet ordre :

  Des branches restent au BOUT d'un long tronc
      -> monte la portee        adParam 20 16 0.25 80 3

  Des branches restent par PAQUETS REGULIERS le long du tronc
      -> baisse la densite      adParam 20 16 0.15 60 3

  Ce sont les branches les PLUS LONGUES qui restent
      -> monte le rayon         adParam 20 22 0.25 60 3

  Rien ne se passe du tout
      -> verifie que le mod est bien actif dans la liste des mods de ta partie
      -> tape adStatus en console
      -> tape adToggle au cas ou le mod aurait ete desactive


PERFORMANCE
--------------------------------------------------------------------------------

Le balayage represente (portee x 2 / densite x axes) operations par arbre,
etalees sur plusieurs images pour ne pas provoquer de saccade.

Avec les valeurs par defaut : environ 1440 operations par arbre abattu, reparties
sur quelques images. Invisible a l'oeil.

En densite 0.10 avec une portee de 80 m tu montes a 4800 operations par arbre. Si
tu sens un micro-freeze a l'abattage, remonte la densite d'un cran ou augmente le
budget par image :  adParam 34 28 0.10 80 3 600


MULTIJOUEUR
--------------------------------------------------------------------------------

Supporte, teste sur serveur dedie.


COMPATIBILITE
--------------------------------------------------------------------------------

Le mod n'ecrase aucune fonction du jeu, il ne fait que s'y ajouter. Il ne touche
ni aux vehicules, ni aux cartes, ni a l'economie. Il est compatible avec les
autres mods forestiers.


CREDITS
--------------------------------------------------------------------------------

Auteur : Cylouch

Merci de ne pas repartager le mod ailleurs sans lien vers la page d'origine, et
de ne pas le republier sous un autre nom.
