commandes

🔐 Configuration des Permissions

Ajouter des Licenses Admin

Pour autoriser un administrateur à utiliser les commandes, vous devez ajouter sa license dans le fichier config.lua :

Config.AdminCommands = {
    enabled = true,
    allowedLicenses = {
        "license:1234567890abcdef1234567890abcdef12345678",
        "license:abcdef1234567890abcdef1234567890abcdef12",
        -- Ajoutez d'autres licenses ici
    },
}

Format de la license : license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Comment obtenir la license d'un joueur :

Utilisez la commande /license <id> si disponible sur votre serveur
Ou consultez les logs du serveur lors de la connexion d'un joueur

📚 Liste des Commandes

🗺️ Gestion des Territoires

/addterritorypoints <territoire> <gangId> <points>

Ajoute des points d'influence à un territoire pour un gang spécifique.

Paramètres :

territoire : Nom du territoire (ex: "Los Santos")
gangId : ID du gang (ex: "gang_1234567890_1234")
points : Nombre de points à ajouter (doit être > 0)

Exemple :

/addterritorypoints "Los Santos" gang_1234567890_1234 50

Résultat : Ajoute 50 points d'influence au territoire "Los Santos" pour le gang spécifié.

/removeterritorypoints <territoire> <gangId> <points>

Retire des points d'influence d'un territoire pour un gang spécifique.

Paramètres :

territoire : Nom du territoire
gangId : ID du gang
points : Nombre de points à retirer (doit être > 0)

Exemple :

/removeterritorypoints "Los Santos" gang_1234567890_1234 25

Résultat : Retire 25 points d'influence du territoire "Los Santos" pour le gang spécifié.

/setterritorypoints <territoire> <gangId> <points>

Définit exactement le nombre de points d'influence d'un territoire pour un gang.

Paramètres :

territoire : Nom du territoire
gangId : ID du gang
points : Nombre de points à définir (doit être >= 0)

Exemple :

/setterritorypoints "Los Santos" gang_1234567890_1234 100

Résultat : Définit l'influence du territoire "Los Santos" à exactement 100 points pour le gang spécifié.

/viewterritory <territoire>

Affiche toutes les influences d'un territoire (tous les gangs).

Paramètres :

territoire : Nom du territoire

Exemple :

/viewterritory "Los Santos"

Résultat : Affiche dans la console serveur la liste de tous les gangs ayant de l'influence sur ce territoire, triés par ordre décroissant d'influence.

👥 Gestion des Gangs

/creategang <nom> <couleur> <ownerId>

Crée un nouveau gang avec un propriétaire spécifié.

Paramètres :

nom : Nom du gang (3-20 caractères)
couleur : Couleur du gang (ex: "red", "blue", "green")
ownerId : ID source du joueur qui sera le propriétaire

Exemple :

/creategang "Les Voleurs" red 1

Résultat : Crée un gang nommé "Les Voleurs" avec la couleur rouge, et le joueur avec l'ID 1 devient le propriétaire.

Note : Le joueur propriétaire doit être en ligne et ne pas être déjà dans un gang.

/deletegang <gangId>

Supprime complètement un gang et retire tous ses membres.

Paramètres :

gangId : ID du gang à supprimer

Exemple :

/deletegang gang_1234567890_1234

Résultat :

Supprime le gang
Retire tous les membres du gang
Nettoie toutes les influences de territoire du gang
Notifie tous les membres qu'ils ont été expulsés

⚠️ Attention : Cette action est irréversible !

/listgangs

Affiche la liste de tous les gangs existants.

Exemple :

/listgangs

Résultat : Affiche dans la console serveur :

Le nom de chaque gang
L'ID du gang
Le nombre de membres
Le nombre de territoires contrôlés

/ganginfo <gangId>

Affiche des informations détaillées sur un gang spécifique.

Paramètres :

gangId : ID du gang

Exemple :

/ganginfo gang_1234567890_1234

Résultat : Affiche dans la console serveur :

Nom du gang
ID du gang
Couleur
Nombre de membres
Nombre de territoires
Pourcentage d'influence
Date de création
Liste de tous les membres avec leurs rangs

👤 Gestion des Membres

/addmember <gangId> <targetId>

Ajoute un joueur à un gang existant.

Paramètres :

gangId : ID du gang
targetId : ID source du joueur à ajouter

Exemple :

/addmember gang_1234567890_1234 5

Résultat :

Ajoute le joueur avec l'ID 5 au gang spécifié
Le joueur reçoit le rang le plus bas disponible
Le joueur est notifié de son ajout

Note : Le joueur ne doit pas être déjà dans un gang.

/removemember <gangId> <targetId>

Retire un joueur d'un gang.

Paramètres :

gangId : ID du gang
targetId : ID source du joueur à retirer

Exemple :

/removemember gang_1234567890_1234 5

Résultat :

Retire le joueur du gang
Le joueur est notifié de son expulsion
Les données du joueur sont synchronisées

/setmemberrank <gangId> <targetId> <rankId>

Change le rang d'un membre dans un gang.

Paramètres :

gangId : ID du gang
targetId : ID source du joueur
rankId : ID du rang à attribuer

Exemple :

/setmemberrank gang_1234567890_1234 5 rank_1234567890_1234_1234567890_5678

Résultat :

Change le rang du joueur pour le rang spécifié
Le joueur est notifié du changement
Les permissions du joueur sont mises à jour selon le nouveau rang

Note : Le rang doit exister dans le gang. Utilisez /ganginfo pour voir les rangs disponibles.

✅ Gestion de la Whitelist

/addwhitelist <targetId>

Ajoute un joueur à la whitelist de création de gang.

Paramètres :

targetId : ID source du joueur

Exemple :

/addwhitelist 5

Résultat : Le joueur peut maintenant créer un gang (si Config.AllowEveryoneCreateGang est à false).

/removewhitelist <targetId>

Retire un joueur de la whitelist de création de gang.

Paramètres :

targetId : ID source du joueur

Exemple :

/removewhitelist 5

Résultat : Le joueur ne peut plus créer de gang (si Config.AllowEveryoneCreateGang est à false).

❓ Commande d'Aide

/gangadminhelp

Affiche l'aide complète de toutes les commandes admin.

Exemple :

/gangadminhelp

Résultat : Affiche dans la console serveur la liste complète de toutes les commandes avec leurs descriptions.

🔍 Comment Trouver les IDs

Trouver l'ID d'un Gang

Utilisez /listgangs pour voir tous les gangs et leurs IDs
Ou utilisez /ganginfo avec le nom du gang si vous le connaissez

Trouver l'ID d'un Territoire

Regardez dans le fichier config.lua dans la section Config.Area
Ou utilisez la commande /zonecreator pour voir les zones disponibles
Les noms des territoires sont généralement définis dans la configuration

Trouver l'ID d'un Rang

Utilisez /ganginfo <gangId> pour voir tous les rangs d'un gang
Les IDs de rangs sont affichés dans les informations du gang

⚠️ Notes Importantes

Permissions : Toutes ces commandes nécessitent une license autorisée dans Config.AdminCommands.allowedLicenses
Sauvegarde : Toutes les modifications sont automatiquement sauvegardées dans les fichiers JSON
Synchronisation : Les données sont automatiquement synchronisées avec tous les clients connectés
Logs : Toutes les actions admin sont loggées dans la console serveur avec le format ^2[GW-GANG ADMIN]^0
Notifications : Les joueurs concernés reçoivent des notifications pour les actions qui les affectent

🛠️ Dépannage

La commande ne fonctionne pas

Vérifiez que votre license est dans Config.AdminCommands.allowedLicenses
Vérifiez que Config.AdminCommands.enabled est à true
Vérifiez que vous utilisez la bonne syntaxe (voir les exemples ci-dessus)
Consultez la console serveur pour les messages d'erreur

Le gang n'apparaît pas après création

Vérifiez que le joueur propriétaire était bien en ligne
Vérifiez que le nom du gang n'existe pas déjà
Vérifiez les logs serveur pour les erreurs

Les points de territoire ne s'appliquent pas

Vérifiez que le nom du territoire est correct (sensible à la casse)
Vérifiez que le gangId est correct
Utilisez /viewterritory pour vérifier les influences actuelles

📝 Exemples de Cas d'Usage

Scénario 1 : Créer un gang et lui donner un territoire

1. /creategang "Les Voleurs" red 1
2. /addterritorypoints "Los Santos" gang_1234567890_1234 100

Scénario 2 : Transférer un territoire d'un gang à un autre

1. /viewterritory "Los Santos"  (pour voir les influences actuelles)
2. /removeterritorypoints "Los Santos" gang_ancien_1234 50
3. /addterritorypoints "Los Santos" gang_nouveau_5678 50

Scénario 3 : Promouvoir un membre

1. /ganginfo gang_1234567890_1234  (pour voir les rangs disponibles)
2. /setmemberrank gang_1234567890_1234 5 rank_1234567890_1234_1234567890_5678

🔗 Commandes Liées

Ces commandes admin fonctionnent en complément de :

/zonecreator - Création de zones de territoire (nécessite Config.ZoneCreator.allowedLicenses)
/cancreate <id> - Ajout à la whitelist de création (commande console existante)

Previousinstallations NextEvent

Last updated 4 months ago

hashtag🔐 Configuration des Permissions

hashtagAjouter des Licenses Admin

hashtag📚 Liste des Commandes

hashtag🗺️ Gestion des Territoires

hashtag👥 Gestion des Gangs

hashtag👤 Gestion des Membres

hashtag✅ Gestion de la Whitelist

hashtag❓ Commande d'Aide

hashtag🔍 Comment Trouver les IDs

hashtagTrouver l'ID d'un Gang

hashtagTrouver l'ID d'un Territoire

hashtagTrouver l'ID d'un Rang

hashtag⚠️ Notes Importantes

hashtag🛠️ Dépannage

hashtagLa commande ne fonctionne pas

hashtagLe gang n'apparaît pas après création

hashtagLes points de territoire ne s'appliquent pas

hashtag📝 Exemples de Cas d'Usage

hashtagScénario 1 : Créer un gang et lui donner un territoire

hashtagScénario 2 : Transférer un territoire d'un gang à un autre

hashtagScénario 3 : Promouvoir un membre

hashtag🔗 Commandes Liées

🔐 Configuration des Permissions

Ajouter des Licenses Admin

📚 Liste des Commandes

🗺️ Gestion des Territoires

👥 Gestion des Gangs

👤 Gestion des Membres

✅ Gestion de la Whitelist

❓ Commande d'Aide

🔍 Comment Trouver les IDs

Trouver l'ID d'un Gang

Trouver l'ID d'un Territoire

Trouver l'ID d'un Rang

⚠️ Notes Importantes

🛠️ Dépannage

La commande ne fonctionne pas

Le gang n'apparaît pas après création

Les points de territoire ne s'appliquent pas

📝 Exemples de Cas d'Usage

Scénario 1 : Créer un gang et lui donner un territoire

Scénario 2 : Transférer un territoire d'un gang à un autre

Scénario 3 : Promouvoir un membre

🔗 Commandes Liées