Boutons
Toutes les informations sur les boutons
Informations
Les boutons vous permettent de personnaliser les actions de votre inventaire. Vous devez spécifier le type du bouton à chaque fois et configurer les éléments spécifiques au type de bouton. Ici vous trouvez les boutons qui sont intégrés par défaut dans le plugin, d’autres plugins peuvent également ajouter de nouveaux types de boutons.
Pour chaque bouton vous devrez spécifier un ItemStack, pour savoir comment configurer un itemstack go ici.
Par défaut:
Voici les éléments de configuration communs à tous les types de boutons. Vous pouvez les utiliser partout.
example:
# Sélectionnez le type de bouton, NONE par défaut
type: <type du bouton>
# Définir la fente du bouton, 0 par défaut
slot: <slot>
# Mettre des emplacements pour le bouton, vide par défaut
slots: <liste de slot>
# Définir la page du bouton, 1 par défaut
page: <page>
# Définir si le bouton doit apparaître sur toutes les pages
isPermanent: <true ou false>
# Article qui sera affiché, veuillez consulter la documentation des articles
item: <itemstack>
# Joué un son en cliquant
sound: <son de XSound>
# Volume du son
volume: <volume du son>
# Pitch du son
pitch: <pitch du son>
# Messages envoyés pendant les clics
messages: <liste de messages>
# Affiche un lien dans la liste des messages
openLink:
link: <lien>
message: <message>
replace: <placeholder Ă remplacer>
hover: <liste de message>
# Fermer l'inventaire en cliquant
closeInventory: <true ou false>
# Rafraîchir le nom et l'histoire de l'objet au clic
refreshOnClick: <true ou false>
# Afficher la tĂŞte du joueur, besoin d'un placeholder ou d'un nom de joueur
playerHead: <placeholder>
# Vous pouvez définir une ou plusieurs permissions pour l'affichage de l'élément
permission: <permission>
# Afficher un autre bouton s'il n'est pas coché (contrôle du placeholder, permissions ou autres)
else: <else button>
# Placeholder
placeholder: <placeholder>
# Valeur du placeholder
value: <value for placeholder>
# Action du placeholder
action: <action for placeholder>
# Liste de placeholders
placeholders: <liste de placeholders>
# Bouton de mise Ă jour au clic (tout mettre Ă jour)
update: <true ou false>
# Commande envoyée par les joueurs
commands: <list of text>
# Commande envoyée par la console lors d'un clic
consoleCommands: <list of text>
# Commande envoyée par la console lors d'un clic droit
consoleRightCommands: <list of text>
# Commande envoyée par la console lors d'un clic gauche
consoleLeftCommands: <list of text>
consolePermissionCommands: <list of text>
consolePermission: <permissions>
# Actions spécifiques au clic
actions: <actions>
# Mise Ă jour du nom et de l'histoire de l'objet lorsque le joueur clique sur l'inventaire
updateOnClick: <true ou false>
# Définit les requirements que le joueur doit avoir pour voir le bouton.
view_requirement: <requirement>
# Définit les requirements que le joueur doit avoir pour cliquer sur le bouton.
click_requirement: <requirement>
Type
type: <type du bouton>
Le type du bouton, par défaut le type sera NONE.
Slot
slot: <nombre compris entre 0 et la limite de la taille de l'inventairet>
slot: <page>-<slot>
Positionnez le slot sur laquelle votre bouton sera affiché.
Pour afficher un bouton sur plusieurs emplacements, vous pouvez procéder comme suit :
slots:
- 0
- 1
- 2
- 3
- 4
...
Vous pouvez également créer des plages de créneaux de cette manière: <début du slot>-<fin du slot>
slots:
- 0-9 # Du slot 0 au sot 9
- 18
- 17
- 26
- 27
- 35
- 36
- 44-53 # Du slot 44 au slot 53
Page
page: <numéro de la page>
Permet de spécifier la page où le bouton sera affiché. Par défaut, la page sera la page 1.
IsPermanent
isPermanent: <true ou false>
Vous permet de spécifier si le bouton doit être affiché sur toutes les pages de l'inventaire. Si votre inventaire ne comporte qu'une seule page, vous n'avez pas besoin de l'utiliser.
Item
item: <itemstack>
Permet de spécifier l'élément qui sera affiché, plus d'informations ici.
Sound
sound: ENTITY_COW_HURT
pitch: 1.5
volume: 0.5
Permet d'envoyer un son au lecteur lorsqu'il clique. Vous devez utiliser les sons présents dans XSound. Vous pouvez ensuite régler le pitch et le volume du son.
Messages
messages:
- <line 1>
- <line 2>
...
Allows you to send a list of messages to the player when clicking.
Openlink
link: <link>
message: <message>
replace: <replace string>
hover:
- <line 1>
- <line 2>
...
Permet d'envoyer un message cliquable au joueur. Vous devez mettre dans votre liste de messages un texte qui sera remplacé par le lien cliquable. Vous avez un exemple ci-dessous.
Exemple:
messages:
- "&8(&6zMenu&8) &fAjouter votre serveur au site &3Serveur Minecraft Vote"
- "&8(&6zMenu&8) %link% &d!"
openLink:
link: "https://serveur-minecraft-vote.fr/utiliser/un/code/cadeau?code=ZMENU"
message: "&b&lClic ici"
replace: "%link%"
hover:
- "&bClick sur moi !"
CloseInventory
closeInventory: <true ou false>
Permet de fermer l'inventaire après avoir cliqué.
RefreshOnClick
refreshOnClick: <true ou false>
Permet de rafraîchir le bouton après un clic. Vous pouvez par exemple l'utiliser pour créer une boutique. Un exemple est fourni dans la configuration par défaut of zShop.
PlayerHead
playerHead: <placeholder>
Permet d'afficher la tĂŞte d'un joueur en fonction d'un placeholder. Vous pouvez mettre le placeholder %player%
pour obtenir le joueur qui ouvre l'inventaire. Un système de cache permet d'afficher directement le skin des têtes.
Permission
permission: <permission>
Permet de définir une permission que le joueur doit avoir pour afficher le bouton. Vous pouvez inverser la permission en ajoutant !
devant la permission. Le plugin vérifiera alors que le joueur n'a pas la permission. Vous pouvez également définir une liste de permissions que le joueur doit avoir :
permission:
- "first.permission"
- "!second.permission"
Or Permission
Permet de définir une liste de permissions, mais le joueur ne doit avoir qu'une seule de ses permissions.
orPermission:
- "first.permission"
- "!second.permission"
Else
else: <else button>
Permet d'afficher un autre bouton si le joueur n'en a pas la permission (ou autre élément qui va activer le else button). Vous pouvez mettre plusieurs else button à la suite sans problème. Vous avez un exemple d'utilisation dans la configuration par défaut.
Placeholder
placeholder: <placeholder>
value: <valeur du placeholder>
action: <action du placeholder>
Permet de définir une autorisation à l'aide d'un placeholder. Vous devez spécifier le placeholder, l'action à effectuer avec la valeur et la valeur qui sera vérifiée.
Action:
BOOLEAN
: Vérifier si une valeur est vraie ou fausseEQUALS_STRING
: Permet de vérifier si le texte est strictement égal au texteEQUALSIGNORECASE_STRING
: Permet de vérifier si le texte est égal en ignorant la casse du texteCONTAINS_STRING
: Permet de vérifier si le texte est contenu dans la valeurSUPERIOR
: Permet de vérifier si un nombre est strictement supérieur à la valeurLOWER
: Permet de vérifier si un nombre est strictement inférieur à la valeurSUPERIOR_OR_EQUAL
: Permet de vérifier si un nombre est supérieur ou égal à la valeurLOWER_OR_EQUAL
: Permet de vérifier si un nombre est inférieur ou égal à la valeurEQUAL_TO
: Permet de vérifier que deux nombres sont identiques
Vous pouvez également définir une liste de placeholder comme ceci:
placeholders:
- placeholder: <votre placeholder>
value: <votre valeur>
action: <votre action>
- placeholder: <votre placeholder>
value: <votre valeur>
action: <votre action>
Update
update: <true ou false>
Permet de mettre à jour automatiquement le nom et le lore de l'ItemStack automatiquement. Pour définir l'intervalle, vous devez le faire à partir de ici.
updateOnClick
updateOnClick: <true ou false>
Permet de mettre Ă jour le bouton lorsqu'un joueur clique sur un autre bouton de l'inventaire.
Commands
commands: <liste de commandes>
Permet au joueur d'exécuter une liste de commandes.
Console Commands
consoleCommands: <liste de commandes>
consoleRightCommands: <liste de commandes>
consoleLeftCommands: <liste de commandes>
consolePermissionCommands: <liste de commandes>
consolePermission: <permissions>
Vous pouvez exécuter des commandes depuis la console en fonction du clic du joueur. Egalement des commandes si le joueur a les permissions.
View Requirement
Définit les exigences que le joueur doit avoir pour voir le bouton. Plus d’informations ici.
Click Requirement
Définit les exigences que le joueur doit avoir pour cliquer sur le bouton. Plus d’informations ici.
Actions
Vous pouvez définir une liste d’actions à effectuer en cliquant. Plus d’informations ici.
actions:
- type: message
messages:
- "exemple"
NONE
Le type NONE
est le type par défaut, il permet d'afficher un bouton. Il n'est pas nécessaire de le spécifier, il sera automatiquement choisi si le plugin ne trouve pas de type.
Inventory
Le type INVENTORY
permet au joueur d'ouvrir un nouvel inventaire.
inventory: <nom du fichier d'inventaire>
plugin: <nom du plugin>
Vous devez spécifier le nom de l'inventaire. Le nom de l'inventaire sera le nom du fichier où se trouve l'inventaire. Nous vous conseillons également de préciser le nom du plugin d'où provient l'inventaire afin d'éviter toute confusion si deux inventaires portent le même nom.
Back
Le type BACK
permet de revenir à l'inventaire précédent.
HOME
Le type HOME
permet de revenir à l'inventaire principal, celui qui a été ouvert en premier.
NEXT
Le type NEXT
permet de passer à la page suivante si elle existe. Vous pouvez utiliser l'élément else pour afficher un autre bouton s'il n'y a pas de page suivante.
Exemple :
next:
type: NEXT
isPermanent: true
slot: 50
item:
material: ARROW
name: "&fNext"
else: # Affiche un autre bouton s'il n'y a pas de page suivante.
slot: 50
type: NONE
isPermanent: true
item:
material: BLACK_STAINED_GLASS_PANE
PREVIOUS
Le type PREVIOUS
permet d'aller à la page précédente si elle existe. Vous pouvez utiliser l'élément else pour afficher un autre bouton s'il n'y a pas de page précédente.
next:
type: PREVIOUS
isPermanent: true
slot: 50
item:
material: ARROW
name: "&fNext"
else: # Affiche un autre bouton s'il n'y a pas de page suivante.
slot: 50
type: NONE
isPermanent: true
item:
material: BLACK_STAINED_GLASS_PANE
MAINMENU
Le MAINMENU
vous permet de retourner Ă l'inventaire principal que vous avez choisi dans le fichier config.json.
Dernière mise à jour