Projet

Projet🎮 de Refonte duAdmin Menu Adminv2.1 - Arma 3 Altis Life

Auteur: ProtoMehka Version: 2.0

📋 Vue d'ensemble

Modernisation complète du menu admin accessible depuis le menu inventaire (Y), avec ajout de fonctionnalités avancées et système de logging en base de données.

🏗️ Structure Actuelle

Fichiers Principaux

• Interface: admin_menu.Altis/dialog/admin_menu.hpp (IDD 2900)
• Contrôleur: admin_menu.Altis/core/admin/fn_adminMenu.sqf
• Ouverture: admin_menu.Altis/core/pmenu/fn_p_openMenu.sqf
• Inventaire: admin_menu.Altis/dialog/player_inv.hpp
• Configuration: admin_menu.Altis/Functions.hpp (déclarations fonctions)
• Remote Exec: admin_menu.Altis/CfgRemoteExec.hpp (whitelist sécurité)

Fonctionnalités Existantes (Framework 5.0 de base)

Nouvelles Fonctionnalités Ajoutées v2.0

Niveaux d'Administration

0 = Joueur normal
1 = Support (GetID + Query uniquement)
2 = Modérateur (+ Compensate)
3 = Admin (+ Spectate + Teleport)
4 = Super Admin (+ TpHere, GodMode, Freeze, Markers)
5 = Owner (+ Debug, accès total)

Note: Les niveaux dans le code diffèrent légèrement de la documentation initiale.

🎨 Modifications Planifiées

1. Interface Modernisée ✅ TERMINÉ

•  Design moderne avec dégradés et transparence
•  Organisation en onglets (Joueurs / Actions / Objets / Serveur)
•  Zone de recherche de joueurs avec bouton "RECHERCHER"
•  Affichage amélioré des informations joueur (Steam ID, faction, véhicule, position, distance, cash, banque)
•  Mini-map interactive avec mise à jour en temps réel
•  Marqueurs sur la map pour le joueur sélectionné
•  Responsive design avec SafeZone
•  Système de requête financière via remoteExec
•  Suppression des boutons "Get ID" et "Query Player" (infos déjà affichées automatiquement)

2. Nouvelles Fonctionnalités

Gestion Joueurs

•  Kick Player - Expulser un joueur
•  Ban Player - Bannir un joueur (temporaire/permanent)
•  Heal Player - Soigner un joueur
•  Revive Player - Réanimer un joueur
•  Strip Weapons - Retirer les armes
•  Give Money - Donner de l'argent
•  Set Admin Level - Modifier le niveau admin
•  Teleport To Player - Se téléporter vers un joueur
•  Spectate Camera - Amélioration de la caméra spectateur

Gestion Objets/Véhicules

•  Repair Object - Réparer objet ciblé (cursorObject)
•  Delete Object - Supprimer objet ciblé (cursorObject)
•  Refuel Vehicle - Ravitailler véhicule
•  Flip Vehicle - Retourner véhicule
•  List Player Vehicles - Voir véhicules d'un joueur
•  Spawn Vehicle - Faire apparaître un véhicule

Serveur

•  Server Messages - Messages serveur personnalisés
•  Restart Warnings - Avertissements de restart
•  Admin Chat - Chat entre admins
•  View Admin Logs - Consulter les logs in-game
•  Server Statistics - Stats serveur en temps réel

Utilitaires

•  Weather Control - Contrôle météo
•  Time Control - Contrôle heure
•  Cleanup Dead - Nettoyer les corps/véhicules
•  Toggle Invisibility - Invisibilité admin
•  No Recoil - Désactiver le recul

3. Système de Logging

Base de Données

Table admin_logs avec:

• ID de log (auto-increment)
• Timestamp
• Admin (Steam ID + nom)
• Action effectuée
• Cible (joueur/véhicule)
• Détails (JSON pour données supplémentaires)
• IP admin
• Serveur

Actions Loggées

• Toutes les actions admin (kick, ban, tp, godmode, etc.)
• Modifications de base de données
• Compensations données
• Changements de niveau admin
• Messages serveur envoyés

🗄️ Base de Données

Nouvelle Table: admin_logs

CREATE TABLE IF NOT EXISTS `admin_logs` (
    `id`          INT NOT NULL AUTO_INCREMENT,
    `timestamp`   TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `admin_pid`   VARCHAR(17) NOT NULL,
    `admin_name`  VARCHAR(32) NOT NULL,
    `action`      VARCHAR(64) NOT NULL,
    `target_pid`  VARCHAR(17) DEFAULT NULL,
    `target_name` VARCHAR(32) DEFAULT NULL,
    `details`     TEXT,
    `admin_ip`    VARCHAR(45) DEFAULT NULL,
    `server_id`   VARCHAR(32) DEFAULT NULL,

    PRIMARY KEY (`id`),
    INDEX `index_admin` (`admin_pid`),
    INDEX `index_action` (`action`),
    INDEX `index_timestamp` (`timestamp`),
    CONSTRAINT `FK_admin_logs_admin` FOREIGN KEY (`admin_pid`)
      REFERENCES `players` (`pid`)
      ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Table Bans (optionnel)

CREATE TABLE IF NOT EXISTS `admin_bans` (
    `id`          INT NOT NULL AUTO_INCREMENT,
    `pid`         VARCHAR(17) NOT NULL,
    `player_name` VARCHAR(32) NOT NULL,
    `banned_by`   VARCHAR(17) NOT NULL,
    `reason`      TEXT NOT NULL,
    `ban_time`    TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    `expire_time` TIMESTAMP NULL DEFAULT NULL,
    `active`      TINYINT NOT NULL DEFAULT 1,

    PRIMARY KEY (`id`),
    INDEX `index_pid` (`pid`),
    INDEX `index_active` (`active`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

📝 Nouveaux Fichiers Créés v2.0

Core Functions ✅ CRÉÉS

• ✅ admin_menu/core/admin/fn_adminMenuNew.sqf - Contrôleur principal
• ✅ admin_menu/core/admin/fn_adminMenuTabChange.sqf - Gestion des onglets
• ✅ admin_menu/core/admin/fn_adminRefreshList.sqf - Rafraîchir liste joueurs
• ✅ admin_menu/core/admin/fn_adminSearchPlayer.sqf - Recherche de joueur
• ✅ admin_menu/core/admin/fn_adminPlayerSelected.sqf - Sélection joueur + infos
• ✅ admin_menu/core/admin/fn_adminRepairObject.sqf - Réparer objet ciblé
• ✅ admin_menu/core/admin/fn_adminDeleteObject.sqf - Supprimer objet ciblé
• ✅ admin_menu/core/admin/fn_adminQueryFinances.sqf - Requête infos financières
• ✅ admin_menu/core/admin/fn_adminReceiveFinances.sqf - Réception infos financières

Dialogs ✅ CRÉÉ

• ✅ admin_menu/dialog/admin_menu_new.hpp - Interface moderne avec onglets

Fichiers à Créer (Phases Futures)

•  admin_menu/core/admin/fn_adminKick.sqf
•  admin_menu/core/admin/fn_adminBan.sqf
•  admin_menu/core/admin/fn_adminHeal.sqf
•  admin_menu/core/admin/fn_adminRevive.sqf
•  admin_menu/core/admin/fn_adminLog.sqf (fonction générique de logging)
•  admin_menu/core/admin/fn_adminViewLogs.sqf
•  admin_menu/dialog/admin_ban.hpp
•  admin_menu/dialog/admin_logs_viewer.hpp

Server Functions

• life_server/Functions/Admin/fn_logAdminAction.sqf
• life_server/Functions/Admin/fn_kickPlayer.sqf
• life_server/Functions/Admin/fn_banPlayer.sqf
• life_server/Functions/Admin/fn_getAdminLogs.sqf

🔧 Fichiers à Modifier

Configuration

• admin_menu/Functions.hpp - Déclarer nouvelles fonctions
• admin_menu/CfgRemoteExec.hpp - Autoriser nouvelles remote executions
• admin_menu/description.ext - Inclure nouveaux dialogs
• life_server/functions.sqf - Déclarer fonctions serveur

Existants

• admin_menu/dialog/admin_menu.hpp - Remplacer par nouvelle interface
• admin_menu/core/admin/fn_adminMenu.sqf - Adapter au nouveau système
• admin_menu/core/pmenu/fn_p_openMenu.sqf - Maintenir compatibilité

🚀 Commandes Utiles

Base de Données

-- Créer la table de logs
SOURCE admin_logs_table.sql;

-- Voir les dernières actions admin
SELECT * FROM admin_logs ORDER BY timestamp DESC LIMIT 50;

-- Actions d'un admin spécifique
SELECT * FROM admin_logs WHERE admin_pid = '76561198XXXXXXXX' ORDER BY timestamp DESC;

-- Actions par type
SELECT action, COUNT(*) as count FROM admin_logs GROUP BY action ORDER BY count DESC;

-- Rechercher dans les logs
SELECT * FROM admin_logs WHERE details LIKE '%recherche%';

SQF Testing

// Tester le niveau admin
hint format["Admin Level: %1", life_adminlevel];

// Forcer ouverture menu admin
createDialog "life_admin_menu_new";

// Logger une action (test)
["test_action", player, "Test de logging"] call life_fnc_adminLog;

// Voir variables globales admin
hint str [life_god, life_markers, life_adminlevel];

Compilation

# Créer le PBO
armake build admin_menu admin_menu.pbo

# Extraire le PBO
armake unpack admin_menu.pbo admin_menu_extracted/

🔍 Analyse de l'Existant (Complétée)

Architecture Actuelle

Structure Client (admin_menu.Altis/):

core/admin/               # 10 fonctions admin
├── fn_adminCompensate.sqf
├── fn_adminDebugCon.sqf
├── fn_adminFreeze.sqf
├── fn_adminGetID.sqf
├── fn_adminGodMode.sqf
├── fn_adminID.sqf
├── fn_adminInfo.sqf
├── fn_adminMarkers.sqf
├── fn_adminMenu.sqf      # Contrôleur principal
├── fn_adminQuery.sqf
├── fn_adminSpectate.sqf
├── fn_adminTeleport.sqf
└── fn_adminTpHere.sqf

dialog/
└── admin_menu.hpp        # Interface IDD 2900

Structure Serveur (life_server/):

Functions/
├── Actions/
├── Gangs/
├── Housing/
├── Jail/
├── MySQL/               # Fonctions DB importantes
├── PlayTime/
├── Systems/
└── WantedSystem/

functions.sqf            # Définitions fonctions publiques

⚠️ PROBLÈME MAJEUR IDENTIFIÉ: Aucun système de logging actuellement en place!

Points Critiques

1. Aucun Logging: Toutes les commandes admin sont NON LOGGÉES

   • fn_adminCompensate.sqf: Donne de l'argent sans trace
   • fn_adminFreeze.sqf: Freeze joueur sans log
   • fn_adminGodMode.sqf: Active godmode localement uniquement
   • fn_adminTeleport.sqf: Téléportation non tracée

2. Architecture Client-Side: La majorité des fonctions sont côté client uniquement

   • Pas de validation serveur
   • Risque de manipulation
   • Pas de centralisation des logs

3. Communication Client↔Server:

   • Utilise remoteExecCall pour les fonctions critiques
   • Sécurisé via CfgRemoteExec.hpp (whitelist)
   • Fonctions serveur limitées (TON_fnc_getID, TON_fnc_player_query)

4. Base de Données:

   • Table admin_logs créée dans altislife.sql ✅
   • MAIS: Aucune fonction serveur pour y écrire ❌
   • Aucune fonction côté client pour déclencher le logging ❌

📊 Progression

Phase 1: Analyse & Infrastructure ✅

•  Analyse structure existante
•  Identification de toutes les commandes admin (10 fonctions)
•  Audit système de logging (résultat: aucun logging)
•  Documentation architecture actuelle
•  Création fonction de logging générique serveur
•  Création fonction wrapper logging client
•  Configuration CfgRemoteExec pour nouvelles fonctions

Phase 2: Implémentation Logging Prioritaire 🔥

•  Fonction serveur: TON_fnc_logAdminAction (life_server)
•  Fonction client: life_fnc_adminLog (wrapper)
•  Modifier toutes les 10 fonctions existantes pour logger
•  Tester logging en DB pour chaque commande

Phase 3: Interface Modernisée ✅

•  Design nouveau dialog admin_menu_new.hpp
•  Création fn_adminMenuNew.sqf (contrôleur principal)
•  Système d'onglets (Joueurs / Actions / Véhicules / Serveur)
•  Recherche joueurs avec filtres (Cop/Civ/EMS/All)
•  Affichage position joueur sur mini-map en temps réel
•  Configuration centralisée des permissions (Config_Admin.hpp)
•  Interface responsive avec SafeZone
•  Design moderne avec couleurs par faction
•  Boutons dynamiques selon admin_level

Phase 4: Nouvelles Fonctionnalités ⏳

•  Gestion joueurs (kick, ban, heal, revive, etc.)
•  Gestion véhicules (repair, delete, spawn)
•  Contrôles serveur (messages, restart warnings)
•  Utilitaires admin (invisibility, weather, time)

Phase 5: Visualisation Logs ⏳

•  Interface visualisation logs in-game
•  Filtres par admin/action/date
•  Export logs
•  Dashboard stats

Phase 6: Tests & Déploiement ⏳

•  Tests unitaires
•  Tests en condition réelle
•  Documentation utilisateur
•  Formation admins

⚠️ Notes Importantes

Sécurité

• ✅ Toujours vérifier life_adminlevel avant exécution
• ✅ Utiliser CfgRemoteExec pour whitelist les fonctions
• ✅ Logger TOUTES les actions admin sensibles
• ✅ Valider inputs utilisateur (SQL injection, etc.)
• ✅ Chiffrer les IDs dans les logs si nécessaire

Performance

• ⚡ Limiter fréquence refresh liste joueurs
• ⚡ Pagination pour les logs (max 100 par page)
• ⚡ Cache pour requêtes fréquentes
• ⚡ Async pour requêtes DB lourdes

Compatibilité

• 🔄 Maintenir compatibilité ascendante
• 🔄 Tester avec versions Arma 3 différentes
• 🔄 Vérifier compatibilité extDB3
• 🔄 Documenter breaking changes

📚 Ressources

Documentation

• Arma 3 Dialogs
• SQF Commands
• extDB3 Documentation
• Altis Life Framework

Outils

• Arma 3 Tools (Publisher, Font Config, etc.)
• GUI Editor in-game
• extDB3 Latest version
• MySQL Workbench

🔄 Changelog

Version 1.0.0 - En développement

• ✨ Nouvelle interface moderne
• ✨ 15+ nouvelles fonctionnalités admin
• ✨ Système de logging complet en BDD
• ✨ Viewer de logs in-game
• ✨ Organisation en onglets
• 🐛 Corrections bugs existants

📋 Résumé Exécutif

État Actuel

• ✅ Framework Altis Life 5.0 (AsYetUntitled) installé
• ✅ 10 fonctions admin de base fonctionnelles
• ✅ Table admin_logs créée en base de données
• ✅ NOUVELLE INTERFACE ADMIN v2.0 créée - Moderne, onglets, mini-map, recherche
• ✅ Système de configuration des permissions centralisé
• ❌ Logging non implémenté - prochaine étape prioritaire

Priorités

1. 🔥 URGENT: Implémenter le système de logging pour surveiller les modos
2. ✅ TERMINÉ: Interface modernisée avec onglets, recherche, mini-map ✨
3. ✨ EN COURS: Ajouter nouvelles fonctionnalités (kick, ban, heal, etc.)

Prochaines Étapes Recommandées

1. Créer fonction serveur de logging (TON_fnc_logAdminAction)
2. Créer wrapper client (life_fnc_adminLog)
3. Modifier les 10 fonctions existantes pour appeler le logger
4. Tester le système de logging
5. Designer nouvelle interface moderne

Dernière mise à jourDate: 2025-10-04 Développeur: ProtoMehka10 Framework: Altis Life 5.0 (AsYetUntitled) Statut: Phase 3 (Interface) ✅ Complétée | Phase 2 (Logging) ⏳ À faire0+

🎉📖 NOUVEAUTÉSDescription

Interface admin moderne et épurée pour serveurs Altis Life, avec système d'onglets, mini-map interactive, recherche de joueurs et permissions configurables via fichier de configuration centralisé.

✨ Fonctionnalités

🎨 Interface Admin v2.0

✨ Fonctionnalités ImplémentéesModerne

Interface Moderne:

• Design épuré avec thème sombre et accents bleus
• Interface responsive avec SafeZone
• Bouton4 de fermeture (X) rouge intuitif
• Couleurs par faction (Bleu=Cop, Vert=Civ, Orange=EMS)

✅ config/Config_Admin.hpp
✅ dialog/admin_menu.hpp
✅ dialog/server_message.hpp
✅ dialog/object_manager.hpp
✅ core/admin/fn_admin*.sqf (28 fichiers)

✅ Functions/Admin/fn_getPlayerFinances.sqf
✅ Functions/Admin/fn_logAdminAction.sqf

class Commands {
    list[] = {
        {"HealMa Player"Commande", "life_fnc_adminHeal"life_fnc_maFonction", 3, "players"}
        // Nom affiché | Fonction à appeler | Niveau min (1-5) | Onglet
    };
};

class DropdownSettings {
    maxButtonsBeforeDropdown = 0;  // 0 = Toujours dropdown, 999 = Toujours boutons
};