ArmA3Sync Wiki Francais

De Wiki SoE

ArmA3Sync.png

Par la team [S.o.E] - Sons of Exiled

A Propos

ArmA3Sync est une application permettant le lancement et la synchronisation des addons pour ArmA 3. Le logiciel est destiné aux joueurs, aux administrateurs de serveurs ainsi qu'aux organisations évoluant sur le jeu. Son développement a été inspiré des logiciels ArmA 2 Game Launcher (SpiritedMachine) et AddonSync 2009 (Yoma) dont ArmA3Sync en réalise la synthèse.


Les fonctionnalités principales en sont:

- La configuration et le lancement du jeu avec addons.

- La configuration et le lancement de serveurs de jeu avec addons sur les plateformes Windows voir et Linux voir.

- La construction et la gestion de dépôts d'addons personnalisés sur serveurs FTP ou HTTP (Web).

- La synchronisation fiable des mises à jour avec vérification d'intégrité des fichiers (SHA1).

- La minimisation des quantités de données téléchargées. Les dépôts d'addons sur serveur Web bénéficient ainsi de mises à jour différentielles (ZSYNC).

- La diffusion d'évènements permettant de faciliter l'organisation de parties multijoueurs employant des addons voir.

- Supporte nativement les addons @AllInArmA, @ACRE, @ACRE2 and @TFAR.

Crédits

Auteurs

[S.o.E] Major_Shepard: conception logiciel

[S.o.E] Matt2507: conception graphique & développement web

[S.o.E] & [BWF] & [F27] membres: test


[S.o.E] team, http://www.sonsofexiled.fr

[BWF] team, http://www.blackwater.fr

[F27] team, http://www.force27.com


Conditions d'utilisation

ArmA3Sync est un logiciel libre distribué sous la licence GNU Global Public Licence (GPL) en version 3. Les auteurs et la team [S.o.E] rejettent toute responsabilité dans l'utilisation faite du logiciel. A but non commercial uniquement.

Développeurs

Le code source de l'application est disponible sur notre serveur SVN à l’adresse: svn://www.sonsofexiled.fr/repository/ArmA3Sync/releases

ArmA3 inclus:

- les libraries Commons.Net, Commons.io de la Apache Free Software Foundation. voir (GPL).

- la librairie Dom4j. voir (GPL).

- la librairie org-netbeans-swing-outline du projet NetBeans voir (GPL).

- le code source de l'application Jazsync par Tomáš Hlavnička voir (GPL).

Installation

Prérequis

L’environnement d'exécution Java (JRE) Oracle 7 ou 8 doit être installé sur la machine (télécharger). Pour les utilisateurs Linux, il conviendra peut être de le substituer à l’environnement d'éxecution openJDK (voir ici).


Téléchargement:

- Installateur automatique pour Windows: http://www.armaholic.com/page.php?id=22199

- Archive pour installation manuelle: ftp://www.sonsofexiled.fr/ArmA3/ArmA3Sync/download/


Procédure d'installation:

- Installateur automatique pour Windows: lancer ArmA3Sync-installer.exe.

- Installation manuelle: décompresser l'archive et la copier dans le dossier destination de votre choix. Créer un raccourci vers ArmA3Sync.exe ou ArmA3Sync.sh suivant le système d'exploitation.


Lancement:

- Windows: lancer ArmA3Sync.exe (droits d'administrateur nécessaires)

- Linux: lancer ArmA3Sync.sh.


Configuration

Au lancement de l'application, renseigner le chemin d'accès vers l’exécutable ArmA3 selon le cas d'utilisation:

- Joueur: arma3.exe

- Administrateur Windows: arma3server.exe

- Administrateur Linux: à venir

Mise à jour

La disponibilité d'une mise à jour est indiquée au démarrage de l'application. Il est également possible de vérifier que son application est à jour en sélectionnant le menu Help puis Check for Updates. L'application sera mise automatiquement à jour par ArmA3Sync Updater voir.

Utilisation joueur

Lancer des addons avec le jeu

1. Placer les addons à la racine d'ArmA3 ou dans tout autre répertoire spécifié dans la section Addon Search Directories du panneau Addon Options voir. Des dossiers contenant des addons peuvent également y être placés.

2. Dans la section Available addons du panneau Addons cliquer sur le bouton refresh.

3. Faire un clic droit dans la section Addon Groups et sélectionner la commande Add Group voir. Glisser-déposer ensuite les addons voulus dans le nouveau groupe créé. Les dossiers visibles dans la section Available addons peuvent quand à eux être directement glissés-déposés voir.

4. Cocher les addons voulus dans la section Addon Groups puis sélectionner Start Game.


Créer des profils

Il est possible de créer un nombre illimité de profils de lancement. Ces profils sauvegardent le contenu de la section Addon Groups ainsi que les paramètres de lancement éventuellement ajoutés dans la section Additional Parameters du panneau Launcher Options.

1. Sélectionner menu Profiles puis Edit.

2. Faire New, attribuer un nom puis OK.


Joindre un serveur multijoueurs

1. Dans le panneau Online sélectionner le bouton Add a new favorite server et renseigner les informations de connexion voir.

2. Dans le menu déroulant Join Server sélectionner le nom du serveur créé puis sélectionner Start Game.


Lancer des applications externes

1. Dans le panneau External Apps sélectionner le bouton Add a new application.

2. Sélectionner la nouvelle entrée et cliquer sur le bouton Edit.

3. Activer ou désactiver le lancement de l'application avec le jeu à l'aide du bouton Set the selected application to run at game launch. voir


Lancer en mode AiA

1. Installer le mod @AllinArmA

2. Sélectionner le menu Tools puis AiA Tweaker. Vérifier l'exactitude des chemins pointés voir.

3. Sélectionner Game version ArmA 3 - AiA puis Start Game voir.


Ajouter un dépôt d'addons

1. Dans le panneau Repositories sélectionner le bouton Add a new repository voir.

2. Renseigner les informations de connexion. Sinon copier-coller le lien de l'url d'auto configuration puis sélectionner le bouton Import. Le message connetion success! doit alors apparaître voir.

3. Sélectionner le bouton OK. Une nouvelle entrée apparaît alors dans la table Addons Repositories voir.

4. Cocher l'option Notify si vous souhaitez être alerté d'une mise à jour du dépôt au lancement d'ArmA3Sync.


Synchroniser les addons avec un dépôt

1. Sélectionner une entrée dans la table Addons Repositories puis sélectionner le bouton Connect to repositorty voir. L'interface de gestion du dépôt s'ouvre alors voir.

2. Sélectionner le bouton Check For Addons voir. La section Repository Content affiche alors le contenu du dépôt voir. En bleu sont indiqués les fichiers devant être supprimés, en rouge les fichiers nouveaux ou ayant reçus une mise à jour.

3. Sélectionner le bouton Advanced Configuration si vous souhaiter modifier le chemin du dossier de destination d'un addon see.

4. Il est possible de cacher les fichiers locaux supplémentaires devant être exclus de la synchronisation voir.

5. Cocher les addons voulus puis sélectionner le bouton Start voir.

6. Une fois le téléchargement terminé, sélectionner le panneau Addons puis le bouton Modsets.

7. Sélectionner le dépôt désiré puis le bouton OK. Un nouveau groupe est créé contenant les addons du déôt voir. La liste d'addons affiché dans le panneau Addons sera ainsi mise à jour à chaque que l'action check for addons sera réalisée dans le panneau téléchargement.


Obtenir les informations de changements d'un dépôt

1. Une fois connecté au dépôt, sélectionner le bouton Repository voir.

2. Dans la section Infos sélectionner le bouton View voir.


Synchroniser et lancer les addons avec un évènement

1. Dans le panneau Repositories sélectionner l'évènement voulu puis sélectionner le bouton Check Event voir.

2. La section Repository Content affiche l'ensemble des addons nécessaires pour la partie. Ceux marqués optional sont facultatifs voir. Sélectionner le bouton Start pour commencer le téléchargement.

3. Une fois le téléchargement terminé, sélectionner le panneau Addons puis le bouton Modsets.

4. Sélectionner l'évènement désiré puis le bouton OK. Un nouveau groupe est créé contenant les addons nécessaires pour la partie voir.

Utilisation administrateur serveur

Lancer un serveur ArmA 3

1. Dans l'onglet Launcher Options renseigner le chemin vers arma3server.exe sur les plateformes Windows ou (à venir) sur les plateformes Linux.

2. Dans la section Additional Parameters, passer les chemins vers les fichiers de configuration voir. Liste des paramètres serveurs ici.

3. Cliquer sur Start Game. La console apparaît. Plusieurs clics sur le bouton Start Game lancera autant de serveurs ArmA 3. Vous pouvez utiliser les profils pour créer plusieurs configurations serveurs (les Additonal Parameters sont sauvegardés dans le profil courant).


Mise à jour des addons du serveur ArmA 3

Réaliser une synchronisation de la même manière que pour une utilisation en tant que joueur.


Construire un dépôt d'addons

1. Dans le panneau Repositories, sélectionner le bouton Add New Repository. Renseigner les informations de connexion. L'url doit pointer sur le dossier destiné à contenir les addons voir.

2. Sélectionner la nouvelle entrée dans la table puis cliquer sur le bouton Connect to Repository voir.

3. Sur le nouvel onglet qui apparaît, sélectionner le bouton Repository voir.

4. Renseigner le chemin vers le dossier partagé du dépôt pointé par l'url renseignée à l'étape 1. Ajouter des addons dans le dossier partagé. Ceux-ci peuvent être placés dans des dossiers voir.

5. Sélectionner le bouton Options de la section Build repository:

- Clients connections: défini le nombre maximum de fichiers pouvant être téléchargés simultanément. S'assurer de la configuration du serveur si ce nombre est choisi supérieur à 1.

- Favorite server set to autoconfig: les informations de connexion relatifs aux serveurs définis dans le panneau Online peuvent être associées au fichier d'autoconfig. Ainsi lorsque l'utilisateur se connectera au dépôt ou lorsqu'il importera l'autoconfig url, la liste des serveurs sera automatiquement importée.

- Repository files excluded from build: cette option est typiquement utile aux administrateurs de serveur Web voulant placer un fichier index.html vide à la racine du dépôt voir.

- Repository folders with excluded extra local when sync: cette option est typiquement utile pour le dossier userconfig. Ainsi lors de la synchronisation d'un utilisateur avec le dépôt, les fichiers supplémentaires locaux ne seront pas indiqués comme devant être supprimés voir.

6. Cliquer ensuite sur le bouton Build. Le système va alors créer un dossier .a3s dans le dépot contenant les données de synchronisation. voir.

7. Distribuer l'auto-config url aux utilisateurs (accès public uniquement).

8. L'option Check repository synchronization permet de vérifier à tout moment la cohérence entre les données de synchronisation et les fichiers contenus dans le dépôt voir.


Mise à jour du dépôt d'addons

1. Dans dossier partagé, ajouter ou supprimer des addons.

2. Reconstruire le dépôt.


Administrer un dépôt d'addons en ligne de commande

1. Sur le terminal, lancer le script ArmA3Sync-console.bat (Windows) ou ArmA3Sync-console.sh (Linux).

2. Entrer ensuite l'une des commandes désirée voir.


Administrer un dépôt d'addons à partir d'un script

Les commandes suivantes peuvent être utilisées dans un script shell pour automatiser certaines tâches. Pour cela créer un script .bat (Windows) ou .sh (Linux) à la racine du dossier d'installation d'ArmA3Sync:

- Construction du dépôt: Java -jar ArmA3Sync.jar -BUILD "NomDuDépot"

- Vérification de l'intégrité du dépôt: Java -jar ArmA3Sync.jar -CHECK "NomDuDépot"

- Synchronisation du contenu d'un dossier cible avec un dépôt : Java -jar ArmA3Sync.jar -SYNC "NomDuDépot" "CheminDossierDeDestination" True/False (avec/sans réplication exacte du contenu)

Utilisation mission-maker

Création d'un évènement

1. Sélectionner un dépôt dans la table Addons Repositories puis sélectionner le bouton Edit voir.

2. Renseigner un identifiant utilisateur et éventuellement un mot de passe permettant d'obtenir les droits en écriture et en lecture sur le dépôt.

3. Sélectionner le bouton Connect to repositorty voir. L'interface de gestion du dépôt s'ouvre alors.

4. Sélectionner le bouton Events voir.

5. Sélectionner le bouton Add a new event et renseigner un nom et une description voir.

6. Sélectionner les addons du dépôt nécessaires pour la partie. Il est possible d'indiquer si un addon est optionnel. Pour cela faire un clic droit sur l'addon en question voir.

7. Sélectionner le bouton Upload Events informations voir.

8. Sélectionner le panneau Repositories. Une nouvelle entrée figurant le nom et la description de la mission doit apparaitre voir.

Divers

ACRE installer

Cet utilitaire permet d"effectuer l'installation de l'addon @ACRE de manière à le rendre opérationnel avec ArmA 3 et TS3. L'installateur détecte la version du système d'exploitation, celle de TS3 et réalise en fonction l'installation du dossier userconfig et du plugin ACRE pour TS3.

1. Placer les addons @ACRE et @JArmAXlib dans l'installation d'ArmA 3.

2. Éteindre l'application TS3 si celle-ci est en fonctionnement.

3. Sélectionner le menu Tools puis ACRE Installer.

4. Vérifier l'exactitude des chemins pointés puis sélectionner le bouton Proceed voir.

5. L'installation s'est déroulée avec succès voir.


TFAR installer

Cet utilitaire permet d"effectuer l'installation de l'addon @task_force_radio de manière à le rendre opérationnel avec ArmA 3 et TS3. L'installateur détecte la version du système d'exploitation, celle de TS3 et réalise en fonction l'installation du dossier userconfig et du plugin task force radio pour TS3.

1. Placer l'addon @task_force_radio dans l'installation d'ArmA 3.

2. Éteindre l'application TS3 si celle-ci est en fonctionnement.

3. Sélectionner le menu Tools puis TFAR Installer.

4. Vérifier l'exactitude des chemins pointés puis sélectionner le bouton Proceed voir.

5. L'installation s'est déroulée avec succès voir.


AiA Tweaker

Cet utilitaire permet de configurer les chemins d'accès vers les répertoires d'installations de ArmA 2, ArmA 1 et TOH dans une utilisation conjointe avec l'addon @AllinArmA.

1. Installer l'addon @AllinArmA.

2. Sélectionner le menu Tools puis AiA Tweaker. Vérifier l'exactitude des chemins pointés puis sélectionner le bouton OK. voir.

3. Dans le panneau Addons section Game Version sélectionner ArmA 3 - AiA puis Start Game voir.

4. Dans l'éditeur de mission, les cartes des précédentes versions d'ArmA doivent alors apparaître voir.


RPT Viewer

Cet utilitaire permet d'afficher dans une console le contenu du fichier RPT au fur et à mesure que des lignes y sont ajoutés par le jeu.

1. Sélectionner le menu Tools puis RPT Viewer.

2. Sélectionner File puis Select RPT.

3. Le contenu du fichier RPT s'affiche. voir.