SimpleAlias

SimpleAlias

Plugin
Catégorie	Utilitaire [edit]
Développeur(s)	DarkBladee12
Bukkit	xsimplealias
Nefald
Status	installé [edit]
Grade requis	Pérégrin
Article
Dernière révision	9/01/2016

SimpleAlias est un petit utilitaire permettant de créer des alias de commandes pour l'ensemble des plugsn du serveur, y compris avec des arguments.

Description

Une infinité d'aliases possibles pour toutes vos commandes
Ajouter des arguments à vos alias
Renommer vos alias
Raccourcir vos commandes
Afficher la liste des aliases
Une Master Permission SimpleAlias.*
Make aliases for console commands
Possibilité de définir une permission pour chaque alias
Possibilité d'utiliser l'argument dynamique %player%

Commandes et permissions

Information: Dans le tableau ci-dessous nous indiquons comme racine de commande /sa mais il existe un autre raccourci à savoir /alias. La commande longue étant /SimpleAlias

commande	description	permission
Générale
/sa single <alias> <commande>	Créer un alias simple	`SimpleAlias.create.single`
/sa multiple <alias> <commande1#commande2...>	Créer un alias multiple	`SimpleAlias.create.multiple`
/sa message <alias> <ligne1#ligne2...>	Créer un alias de texte	`SimpleAlias.create.message`
/sa remove <alias>	Supprimer un alias	`SimpleAlias.remove`
/sa rename <alias> <nouvel alias>	Renommer un alias préexistant	`SimpleAlias.rename`
/sa set <alias> <config> <valeur>	Changer la configuration d'un alias	`SimpleAlias.set`
/sa add <alias> <config> <valeur>	Ajouter une valeur à un alias	`SimpleAlias.add`
/sa list	Afficher la liste des aliases	`SimpleAlias.list`
/sa details <alias>	Afficher les détails d'un alias	`SimpleAlias.details`
/sa help [page]	Accéder à la page d'aide
Actions
/sa createaction <alias> <action> <type>	Créer une nouvelle action avec la configuration donnée	`SimpleAlias.action.create`
/sa removeaction <alias> <action>	Supprimée une action pré-existante	`SimpleAlias.action.remove`
/sa setaction <alias> <action> <config> <valeur>	Définir une valeur pour une action donnée	`SimpleAlias.action.set`
/sa addaction <alias> <action> <config> <valeur>	Ajouter une valeur à une action donnée	`SimpleAlias.action.add`
Bypass
	Permission de bypasser les aliases restreints à certains mondes	`SimpleAlias.bypass.enabledworlds`
	Permission de bypasser le délai entre des aliases	`SimpleAlias.bypass.delay`
	Permission de bypasser le cooldown des aliases	`SimpleAlias.bypass.cooldown`
	Permission de bypasser le coût de l'exécution d'un alias	`SimpleAlias.bypass.cost`
Permissions globales
	Permet d'utiliser l'alias défini dans la permission	`SimpleAlias.alias.<alias>`
	Permet d'utiliser tous les aliases nécessitant une permission	`SimpleAlias.use.*`
	Utiliser toutes les commandes de SimpleAlias	`SimpleAlias.*`
	Permet d'utiliser toutes les commandes de créations	`SimpleAlias.create`
	Permet de bypasser toutes les restrictions	`SimpleAlias.bypass.*`
Administration
/sa reload	Reload de la configuration	`SimpleAlias.reload`

Arguments dynamiques

<valeur> - Tous les arguments après la commande.
<valeur:NOMBRE> - Utiliser l'arguments selon sa position dans la configuration de la commande.
- exemple: /sa single s say <valeur:1> si /s Simple est exécuté, seul Simple sera broadcasté.
<monde> - Nom du monde où se tient l'envoyeur.
<groupe> - Nom du groupe de l'envoyeur.
<compte> - Montant du compte en banque de l'envoyeur (requiert Vault).
<faction> - Nom de la faction de l'envoyeur (requiert Factions).
<pseudonyme> - Nom de l'envoyeur de la commande.

Exemples

Alias simple

/sa single rd region define <valeur> - Si vous tapez /rd <argument> <valeur> sera remplacé par l'argument que vous indiquerez derrière l'alias.
Utilisation: /rd test donne /region define test

Alias multiple

Un alias multiple est conçu pour exécuter au moins deux commandes en même temps. Son fonctionnement est identique à celui d'un alias simple. /sa multiple <alias> <commande1#commande2>

- /sa multiple saveme /spawn#/gamemode 1 <pseudonyme>
Utilisation: tapez /saveme et vous serez téléporté au spawn et vous switchez en gamemode1.

Alias de texte

/sa text <alias> <ligne1#ligne2> - Vous pouvez utilises les codes de formatages et les arguments dynamiques sauf <monde>, <groupe>, <compte>, <faction> et <pseudonyme>.

Actions

Type

Nom: Type
Valeur acceptée: COMMAND ou MESSAGE (Type)
Effet: Détermine le type d'action
Note: Ce paramètre ne peut être modifié que manuellement, pas avec une commande.

Mondes actifs

Nom: Enabled_Worlds ou EnabledWorlds
Abréviation: enwo
Valeur acceptée: Noms de mondes valides séparés par une virgule , (Chaîne)
Effet: Détermine le monde dans lequel l'action prend effet.

Nœuds de permission

Nom: Enabled_Permission_Nodes ou EnabledPermissionNodes
Abréviation: enpermno
Valeur acceptée: Nœuds de permission séparés par une virgule , (Chaîne)
Effet: Détermine la liste de nœuds de permissions dont l'exécuteur de la commande doit en posséder au moins une.

Permission de groupes

Name: Enabled_Permission_Groups ou EnabledPermissionGroups
Abréviation: enpermgr
Valeur acceptée: Noms de groupes valides séparés par une virgule , (Chaîne)
Effet : Détermine la liste de groupes de permissions dont l'exécuteur de la commande doit en posséder au moins une.

Paramètres actifs

Nom: ''Enabled_Params ou EnabledParams
Abréviation: enpa
Valeur acceptée: Paramètres correspondants à <PARAM@INDEX> séparés par une virgule , (Chaîne)
Effet: Détermine la liste de paramètres que l'exécuteur de la commande doit posséder.

Priorité

Nom: Priority
Abréviation: prio
Valeur acceptée: N'importe quel nombre (Intégrateur)
Effet: Détermine la priorité d'un action.

Code couleur

Nom: Translate_Color_Codes ou TranslateColorCodes
Abréviation: trcc
Valeur acceptée: true ou false (Booléen)
Effet: Détermine si les codes de couleurs dans les paramètres seront traduits pour l'action.

Commande

Nom: Command
Abréviation: comm
Valeur acceptée: Commande (Chaîne)
Effet: Détermine la commande l'action.
Note: Ce paramètre n'est disponible que pour les actions de type COMMAND

Executeur

Nom: Executor
Abréviation: exec
Valeur acceptée: SENDER ou CONSOLE (Executeur)
Effet: Détermine l'exécuteur d'une action.
Note: Ce paramètre n'est disponible que pour les actions de type COMMAND

Promotion de permissions

Nom: Grant_Permission ou GrantPermission
Abréviation: gperm
Valeur acceptée: true ou false (Booléen)
Effet: Détermine si l'exécuteur reçoit l'autorisation accordée pour la commande.
Note: Ce paramètre n'est disponible que pour les actions de type COMMAND

Texte

Nom: Text
Abréviation: txt
Valeur acceptée: Message seul ou sur plusieurs lignes (Chaîne ou Liste)
Effet: Déterminer le texte d'une action
Note: Ce paramètre n'est disponible que pour les actions de type MESSAGE

Broadcast

Nom: Broadcast
Abréviation: bcast
Valeur acceptée: true ou false (Booléen)
Effet: Détermine si le message est diffusé.
Note: Ce paramètre n'est disponible que pour les actions de type MESSAGE

Configuration

Par alias

Information: Depuis la version 1.5.0 de SimpleAlias, chaque alias possède son fichier de configuration. Il est possible de définir un modèle qui sera appliqué à tous les fichiers de configuration avec template.yml
Voici en exemple le dit fichier ainsi qu'une configuration potentielle d'un alias.

Documentation originale

General_Information
- Type - Type d'alias, Single, Multiple ou Texte
Execution_Settings
- Execute_As_Console - Si "true", exécutera la commande à partir de la console
- Command - La commande exécutée lors de l'utilisation de l'alias
- Disable_Command - Si "true", la commande originelle ne sera pas indiquée ainsi que l'affichage de message
- Disable_Message - Si DisableOrigin est sur true, vous pouvez indiquer ici le message a afficher en remplacement. Les couleurs sont supportées. (voir tableau ci-contre)
Cooldown_Settings
- Enable - Activer ou non le cooldown
- Cooldown - Temps entre chaque utilisation de l'alias en secondes
Permission_Settings
- Enable - Activer ou non l'utilisation d'une permission sur cet alias
- Permission - Définir la permission de l'alias (permission: SimpleAlias.command.<alias>)

template.yml

# This section contains all general settings for the alias
# Remove the '#' before a setting (for example 'Enabled_Worlds') to enable it
General_Settings:

 # This is the description of this alias
 Description: No description set
  
 # Determines whether this alias can be executed as console
 Executable_As_Console: true
 
 # This is the list of worlds where this alias is enabled
 # This check can be bypassed with SimpleAlias.bypass.enabledworlds
 # Format: <world_name>(, <world_name>...)
 # Enabled_Worlds: world
 
 # This section contains settings for the usage check of this alias
 Usage_Check:
 
  # Determines whether the usage check is enabled
  Enabled: false
  
  # This is the minimum amount of parameters the player has to type
  Min_Params: 0
  
  # This is the maximum amount of parameters the player can type
  # If you want a command with infinite parameters just fill in a high number like 100
  Max_Params: 0
  
  Message: '&cUtilisation incorrecte!\n&6/example'
 
 # This section contains actions which can be utilized in the order
 Actions:
 
  # This is an example message action called "Example"
  Example:
  
   # This is the type of the action
   Type: MESSAGE
   
   # This is the list of worlds where this action is enabled
   # Format: <world_name>(, <world_name>...)
   # Enabled_Worlds: world
   
   # This is the list of permission nodes of which the execution player has to have at least one in order to enable this action
   # If this and 'Enabled_Permission_Groups' are not empty, both conditions have to be fullfilled
   # Format: <permission_node>(, <permission_node>...)
   # Enabled_Permission_Nodes: Example.node
   
   # This is the list of permission groups of which the execution player has to be in at least one in order to enable this action
   # If this and 'Enabled_Permission_Nodes' are not empty, both conditions have to be fullfilled
   # Format: <group_name>(, <group_name>...)
   # Enabled_Permission_Groups: ExampleGroup
   
   # This is the list of params which have to match in order to enable this action
   # Please note that you can't add more than one param with the same index
   # Format: <param@index>(, <param@index>...)
   # With this example the sender has to type '/<alias> example' in order to enable this action
   # Enabled_Params: example@0
   
   # This is the priority of this action
   # If this action is triggered along with other actions and it has a higher priority only this and actions with the same priority will be executed
   Priority: 0
   
   # Determines whether the color codes in the parameters will be translated for this action
   # Color codes have to start with '&'
   Translate_Color_Codes: false
   
   # This is an action specific setting called "Text"
   # This text will be sent to the sender or broadcasted when this action is executed
   Text: "&cCet alias n‘a pas été configuré pour le moment!"
   
   # This is an action specific setting called "Broadcast"
   # Determines whether the text will be broadcasted or just sent to the player
   Broadcast: false
   
  # This is an example command action called "Example2"
  Example2:
  
   # This is the type of the action
   Type: COMMAND
   
   # This is the list of worlds where this action is enabled
   # Format: <world_name>(, <world_name>...)
   # Enabled_Worlds: world
   
   # This is the list of permission nodes of which the execution player has to have at least one in order to enable this action
   # If this and 'Enabled_Permission_Groups' are not empty, both conditions have to be fullfilled
   # Format: <permission_node>(, <permission_node>...)
   # Enabled_Permission_Nodes: Example.node
   
   # This is the list of permission groups of which the execution player has to be in at least one in order to enable this action
   # If this and 'Enabled_Permission_Nodes' are not empty, both conditions have to be fullfilled
   # Format: <group_name>(, <group_name>...)
   # Enabled_Permission_Groups: ExampleGroup
   
   # This is the list of params which have to match in order to enable this action
   # Please note that you can't add more than one param with the same index
   # Format: <param@index>(, <param@index>...)
   # Enabled_Params: example@0
   
   # This is the priority of this action
   # If this action is triggered along with other actions and it has a higher priority only this and actions with the same priority will be executed
   Priority: 0
   
   # Determines whether the color codes in the parameters will be translated for this action
   # Color codes have to start with '&'
   Translate_Color_Codes: false
   
   # This is an action specific setting called "Command"
   # This is the command that is bound to this action
   # It isn't necessary to add a '/'
   Command: "msg <sender_name> Salut, voici un exemple!"
   
   # This is an action specific setting called "Executor"
   # This is the executor of the command
   Executor: CONSOLE
   
   # This is an action specific setting called "Grant_Permission"
   # Determines whether the sender gets the permission for the particular command granted to be able to execute it
   # The permission grant is only temporary
   Grant_Permission: false
  
 # This is the execution order of the actions
 # Actions can be used more than one times
 # If this is empty, the alias won't do anything
 # Format: <action_name>(, <action_name>...)
 Execution_Order: Example, Example2
 
 # This section contains settings for the permission
 Permission:
 
  # Determines whether the permission is enabled
  # If this is set to true, players have to have the permission node in order to be able to execute this alias
  Enabled: true
  
  # This is the name of the permission node
  # Please note that this doesn't have to start with 'SimpleAlias.use...', you can fill in whatever you want
  Node: SimpleAlias.use.example
  
  # This is a list of groups that are permitted to use this alias no matter if they have the permission node
  # Format: <group_name>(, <group_name>...)
  # Groups: ExampleGroup
  
  # This is the message that will be displayed if the sender doesn't have permission
  Message: "&cVous n'avez pas la permission d‘exécuter cet alias!"
  
 # This section contains settings for the execution delay of the actions
 Delay:
 
  # Determines whether the delay is enabled
  # The cooldown can be bypassed with SimpleAlias.bypass.delay
  Enabled: false

  # Determines whether the alias execution is cancelled if you change your position  
  Cancel_On_Move: false
  
  # This is the duration of the delay in seconds
  Duration: 10
  
  # This is the message that will be displayed if the delay is enabled
  Message: '&6L‘exécution de l‘alias débutera dans &e<remaining_time>&6.'
  
  # This is the message that will be displayed if the delay gets cancelled
  Cancel_Message: '&4La demande d‘exécution de l‘alias a été annulée!'
 
 # This section contains settings for the cooldown
 Cooldown:
 
  # Determines whether the cooldown is enabled
  # The cooldown can be bypassed with SimpleAlias.bypass.cooldown
  Enabled: false
  
  # This is the duration of the cooldown in seconds
  Duration: 180
  
  # This is the message that will be displayed if someone tries to execute this alias while his cooldown is not over
  Message: '&cVous devez patienter <remaining_time> avant de pouvoir exécuter cette commande à nouveau!'
  
 # This section contains settings for the cost
 Cost:
 
  # Determines whether a cost for this alias is enabled
  # The cost can be bypassed with SimpleAlias.bypass.cost
  Enabled: false
  
  # This is the amount of the cost for this alias
  # This value can either be a normal or a point number
  Amount: 40.0
  
  # This is the message that will be displayed if the sender doesn't have enough money
  Message: "&cVous n‘avez pas suffisamment d‘argent pour exécuter cette commande! &8(&6<cost_amount>&8)"

 # This section contains settings for logging the execution of this alias
 # The execution will only be logged for players
 Logging:

  # Determines whether logging is enabled
  Enabled: false
 
  # This is the message that will be logged
  # Please note that '<player_name> issued command: <command>' will automatically be logged
  Message: '<alias> a été exécuté par <player_name>'

alias.yml

General_Information:
  Type: Single
Execution_Settings:
  Executor: Sender
  Executable_As_Console: false
  Command: fchat jrmod
  Disable_Command: false
  Disable_Message: Unknown Command. Type "/help" for help.
Cooldown_Settings:
  Enabled: false
  Cooldown: 0
Permission_Settings:
  Enabled: true
  Permission: SimpleAlias.alias.agora
Permitted_Groups:
  Enabled: false

SimpleAlias

Sommaire

Description

Commandes et permissions

Arguments dynamiques

Exemples

Actions

Configuration

Par alias

template.yml

alias.yml

Menu de navigation

SimpleAlias

Description

Commandes et permissions

Arguments dynamiques

Exemples

Actions

Configuration

Par alias

template.yml

alias.yml

Menu de navigation

Rechercher