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é.
- exemple: /sa single s say <valeur:1> si
<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
Voici en exemple le dit fichier ainsi qu'une configuration potentielle d'un alias.
template.yml
Voici en exemple le dit fichier ainsi qu'une configuration potentielle d'un alias.
- 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