Documentation
EssentielsComplète

Commandes personnalisées

Créez vos propres commandes depuis l'éditeur web, chacune exécutant une liste d'actions comme des messages, des menus, des téléportations, des sons et de l'argent.

Le module Commandes personnalisées vous permet de créer vos propres commandes sans aucun autre plugin : /discord pour partager votre lien Discord, /rules pour afficher le règlement, /event pour téléporter les joueurs à un événement, un /heal payant, etc. Chaque commande exécute une liste d'actions, dans l'ordre, et dispose des mêmes réglages que toutes les autres commandes InglisCore : alias, permission, délai, prix, mondes et règles par grade.

Fonctionnalités

  • Commandes illimitées, créées et modifiées depuis l'éditeur web. Les modifications s'appliquent immédiatement, sans redémarrage.
  • Dix types d'actions : envoyer un message, exécuter une commande en tant que joueur ou en tant que console, ouvrir un menu, téléporter, jouer un son, donner ou prendre de l'argent, attendre, et faire une annonce à tout le serveur.
  • Arguments : réutilisez ce que le joueur a tapé après la commande dans les messages et les commandes.
  • Messages traduits qui suivent la langue de chaque joueur.
  • Règles par grade comme pour toute autre commande InglisCore : qui peut l'utiliser, délai et prix, grade par grade.
  • Exemples prêts à l'emploi : /discord, /rules et /store sont inclus, désactivés. Activez-les et adaptez-les.

Configuration

Ouvrez le module Commandes personnalisées dans l'éditeur web. L'onglet Commandes liste vos commandes. Cliquez sur Nouvelle commande pour en créer une, puis remplissez :

Champ Effet
Commande Nom de la commande, tapé après le /. Lettres minuscules, chiffres et _ uniquement.
Description Courte description de la commande.
Utilisation affichée s'il manque des arguments Message affiché quand le joueur tape moins d'arguments que nécessaire, par exemple /report <player> <reason>.
Arguments minimum Nombre de mots que le joueur doit taper après la commande (de 0 à 20).
Actions Ce que fait la commande, dans l'ordre (jusqu'à 30 actions).

Chaque commande dispose aussi des réglages de commande habituels : nom et alias, permission, mondes où elle est désactivée et, grade par grade, accès, délai et prix. Voir commandes. Par défaut, une nouvelle commande est autorisée pour tout le monde et sa permission est inglis.customcommands.<name>.

Supprimer cette commande la supprime.

Actions

Action Valeur Exemple
Envoyer un message Texte envoyé au joueur. Les codes couleur sont autorisés. &aHello {player}!
Commande du joueur Commande exécutée comme si le joueur l'avait tapée : ses propres permissions et restrictions s'appliquent donc. spawn
Commande de la console Commande exécutée par la console. give {player} diamond 1
Ouvrir un menu Identifiant d'un menu créé avec le module menus. main
Téléporter warp: suivi du nom d'un warp, ou un monde et des coordonnées, éventuellement suivis du yaw et du pitch. warp:spawn ou world 0 64 0
Jouer un son Nom d'un son Minecraft, éventuellement suivi d'un volume (de 0 à 10) et d'une hauteur (de 0.5 à 2). entity.player.levelup
Donner de l'argent Montant, éventuellement suivi de l'identifiant d'une devise. Sans devise, la devise principale est utilisée. 100 ou 100 gems
Prendre de l'argent (s'arrête s'il en manque) Même format. Si le joueur ne peut pas payer, il en est informé et les actions suivantes ne s'exécutent pas. 100
Attendre (ticks) Pause avant l'action suivante, en ticks (20 ticks = 1 seconde, 1200 au maximum). 20
Annoncer au serveur Message envoyé à tous les joueurs connectés. &e{player} &7joined the event!

Téléporter nécessite le module téléportation pour les warps. Donner de l'argent et Prendre de l'argent nécessitent le module économie.

Variables

Variable Remplacée par
{player} Pseudo du joueur qui a utilisé la commande.
{arg1}, {arg2} et ainsi de suite Premier, deuxième et mots suivants tapés après la commande. Vide s'ils manquent.
{args} Tout ce qui a été tapé après la commande.
{lang:key} Un texte de la page Messages, dans la langue du joueur qui le lit, par exemple {lang:customcommands.examples.discord}. Messages et annonces uniquement. Voir langues.

Les placeholders PlaceholderAPI comme %player_world% fonctionnent aussi dans les messages et les commandes.

Remarque

Par sécurité, les mots tapés par le joueur sont nettoyés avant d'être insérés dans une commande : seuls les lettres, les chiffres et quelques signes de ponctuation sont conservés. Les codes couleur tapés par les joueurs sont retirés des messages.

Commandes

Chaque commande personnalisée que vous créez devient une vraie commande. Ses alias, sa permission, son délai, son prix, ses mondes et ses règles par grade peuvent être modifiés dans l'éditeur, voir commandes.

Commande Effet Permission par défaut
/<name> Exécute les actions de votre commande. Joueurs uniquement. inglis.customcommands.<name>
/discord Exemple : affiche votre lien Discord. Désactivée par défaut. inglis.customcommands.discord
/rules Exemple : affiche le règlement du serveur. Désactivée par défaut. inglis.customcommands.rules
/store Exemple : affiche le lien de votre boutique. Désactivée par défaut. inglis.customcommands.store

Conseils

  • Pour faire payer une commande, vous pouvez soit définir un prix dans ses réglages de commande (payé avant l'exécution des actions, avec un délai si vous le souhaitez), soit placer une action Prendre de l'argent au début : les actions suivantes ne s'exécutent que si le joueur peut payer.
  • Utilisez Attendre entre les messages pour créer une petite histoire ou un compte à rebours, par exemple un message, une attente de 2 secondes (40), puis une téléportation.
  • Les commandes d'exemple utilisent {lang:key} : modifiez leur texte pour chaque langue dans la page Messages plutôt que dans l'action.