[FR] Installer AdminCore sur un serveur Arma 3

1. Préparer les informations du serveur

Rassemblez les informations nécessaires avant de créer la licence.

Connectez-vous à AdminCore avec le compte propriétaire de l’abonnement, puis préparez le nom du serveur, son adresse IP publique, son port de jeu et la valeur serverCommandPassword présente dans server.cfg. Le mot de passe serverCommand n’est pas le mot de passe administrateur classique.

server.cfg

serverCommandPassword = "VOTRE_MOT_DE_PASSE_LONG_ET_UNIQUE";

L’offre Core permet de créer une licence serveur et installe AdminCore RCON ainsi que l’anticheat. L’offre Pro permet jusqu’à trois licences et ajoute le panel administrateur en jeu ainsi que la console développeur.

2. Préparer le fichier ban.txt

AdminCore synchronise les bannissements avec le fichier local du serveur.

Le chemin doit pointer vers le ban.txt utilisé par le profil Arma 3. Sur OxygenServ, le chemin habituel est celui indiqué ci-dessous. S’il n’existe pas, créez un fichier vide avant de générer le package.

OxygenServ / Linux

mkdir -p /home/container/serverprofile/home/Player
touch /home/container/serverprofile/home/Player/ban.txt

Sur un autre hébergeur Linux, recherchez le dossier de profil défini dans les paramètres de lancement et adaptez le chemin. Sous Windows, indiquez le chemin absolu du fichier, par exemple C:\arma3server\profiles\ban.txt.

3. Créer la licence dans AdminCore

Le package est généré spécialement pour cette instance.

Dans le panel AdminCore, ouvrez « Mes serveurs », puis « Créer une licence ». Renseignez le nom, l’IP publique, le port de jeu, le chemin absolu de ban.txt et le mot de passe serverCommand. Cliquez ensuite sur « Créer et compiler le package ».

Attendez la fin de la compilation Docker, puis cliquez sur « Télécharger le ZIP ». Ne partagez pas ce ZIP : il contient des extensions liées à la clé, à l’adresse IP et au port de cette licence. Un package généré pour un serveur ne doit pas être réutilisé sur une autre instance.

4. Installer le dossier @admincore

Le même ZIP contient les binaires Windows, Linux et les PBO nécessaires.

Décompressez l’archive. Envoyez le dossier @admincore complet à la racine du serveur Arma 3, à côté de arma3server_x64.exe sous Windows ou arma3server_x64 sous Linux. Conservez les DLL et SO à la racine de @admincore et les PBO dans @admincore/addons.

Structure attendue

@admincore/
├── admincore_rcon.dll
├── admincore_rcon_x64.dll
├── admincore_rcon.so
├── admincore_rcon_x64.so
├── admincore_anticheat.dll
├── admincore_anticheat_x64.dll
├── admincore_anticheat.so
├── admincore_anticheat_x64.so
└── addons/
    ├── admincore_rcon.pbo
    ├── admincore_anticheat.pbo
    └── admincore_ingame.pbo  (offre Pro)

Sous Linux, respectez exactement les minuscules et majuscules des noms de fichiers et de dossiers.

5. Ajouter AdminCore aux paramètres de lancement

AdminCore doit être chargé comme mod serveur.

Ajoutez @admincore à l’option -serverMod de votre hébergeur ou de votre script de démarrage. Si d’autres mods serveur sont déjà présents, séparez-les avec un point-virgule et ne supprimez pas les valeurs existantes.

Paramètre de lancement

-serverMod=@admincore

Avec d’autres mods serveur

-serverMod=@extension;@admincore

6. Intégrer le panel en jeu (offre Pro)

Cette étape concerne uniquement le package Pro.

Le ZIP Pro contient un dossier AdminCore_InGame_MISSION placé avant @admincore. Copiez AdminCore_AdminMenu.hpp dans le dossier de votre mission, puis ajoutez l’inclusion suivante dans description.ext.

description.ext

#include "AdminCore_AdminMenu.hpp"

Ouvrez ensuite CfgRemoteExec.hpp fourni et fusionnez ses classes dans CfgRemoteExec > class Functions de votre mission. Si CfgRemoteExec ou class Functions existe déjà, ne créez pas une deuxième classe : ajoutez uniquement les lignes AdminCore à l’intérieur.

CfgRemoteExec.hpp

class admincore_ingame_acfn_adminRequest { allowedTargets = 2; };
class admincore_ingame_acfn_initClient { allowedTargets = 1; jip = 1; };
class admincore_ingame_acfn_open { allowedTargets = 1; };
class admincore_ingame_acfn_notify { allowedTargets = 1; };
class admincore_ingame_acfn_clientAction { allowedTargets = 1; };
class admincore_ingame_acfn_revive { allowedTargets = 1; };
class admincore_ingame_acfn_giveVItem { allowedTargets = 1; };
class admincore_ingame_acfn_giveGear { allowedTargets = 1; };
class admincore_ingame_acfn_displayInventory { allowedTargets = 1; };
class admincore_ingame_acfn_collectInventory { allowedTargets = 1; };

Aucun dossier de fonctions et aucun execVM ne doivent être ajoutés : les fonctions sont enregistrées automatiquement par le preInit du PBO. F2 ouvre le panel administrateur en jeu. F3 ouvre la console développeur pour les administrateurs autorisés.

7. Démarrer et vérifier la connexion

Contrôlez les journaux avant d’utiliser les fonctions d’administration.

Redémarrez complètement le serveur Arma 3. Dans le fichier RPT, recherchez les préfixes [ADMINCORE RCON] et [ADMINCORE ANTICHEAT]. Le RCON doit indiquer que sa boucle serveur est initialisée.

Résultat attendu dans le RPT

[ADMINCORE RCON] Boucle serveur initialisée

Retournez dans AdminCore. La licence doit afficher « Agent connecté » ou « Serveur actif ». Ouvrez la vue d’ensemble et cliquez sur « Actualiser » dans la section Joueurs pour confirmer que le serveur répond.

8. Résoudre les problèmes courants

Les erreurs de connexion sont généralement liées à la configuration de la licence.

Si l’agent reste hors ligne, vérifiez que -serverMod contient @admincore, que les DLL ou SO sont à la racine du mod, que les PBO sont dans addons et que l’IP publique ainsi que le port correspondent exactement à la licence.

Si le RPT affiche « CONNEXION REFUSÉE », contrôlez l’IP, le port et l’abonnement. Si les commandes de bannissement échouent, vérifiez serverCommandPassword et le chemin absolu de ban.txt. Consultez aussi « Logs Docker » dans Mes serveurs en cas d’échec de génération.

Après une modification d’IP, de port, de chemin ban.txt ou de mot de passe serverCommand, utilisez « Régénérer DLL / SO », téléchargez le nouveau ZIP, remplacez entièrement @admincore puis redémarrez le serveur. L’ancien package reste actif jusqu’à la réussite de la nouvelle compilation.