Plugin Hytale
Le plugin HytalePay connecte votre serveur de jeu à votre boutique, permettant la livraison automatique des articles quand les clients font des achats.
Prérequis
- Un serveur Hytale en fonctionnement
- Une boutique HytalePay avec clé API
- Accès administrateur au serveur
Installation
Étape 1 : Télécharger le plugin
Téléchargez le plugin HytalePay depuis CurseForge.
Étape 2 : Installer sur le serveur
- Arrêtez votre serveur
- Copiez le fichier du plugin dans votre dossier
plugins/ - Démarrez votre serveur
- Le plugin créera ses fichiers de configuration
Étape 3 : Configurer le plugin
Éditez plugins/HytalePay/config.yml :
# Configuration HytalePay
api-key: "votre-cle-api-ici"
store-id: "votre-id-boutique-ici"
check-interval: 30
debug: false
Étape 4 : Recharger
Exécutez /hytalepay reload ou redémarrez votre serveur.
Interface de configuration
Le plugin inclut une interface de configuration intégrée pour les administrateurs. Accédez-y avec la commande /obconfig.
L'interface affiche :
- Statut - État de la connexion API
- Handlers actifs - Nombre de handlers de commandes enregistrés
- Configuration API - Paramètres actuels (valeurs sensibles masquées)
- Intervalle de polling - Fréquence de vérification des commandes
Actions disponibles :
- Rafraîchir manuellement - Déclencher une vérification immédiate
- Recharger la config - Recharger la configuration sans redémarrer
Commandes
| Commande | Permission | Description |
|---|---|---|
/orders | - | Récupérer les commandes en attente (cooldown 30s) |
/obconfig | hytalepay.admin | Ouvrir l'interface de configuration |
/obitems | hytalepay.admin | Ouvrir l'interface des commandes d'articles |
Interface des commandes d'articles
La commande /obitems ouvre une interface pour configurer les commandes exécutées lors de l'achat de chaque article.
Fonctionnalités :
- Menu déroulant catégories - Parcourir les articles par catégorie
- Recherche - Filtrer les articles par nom
- Éditeur de commandes - Ajouter, supprimer et réorganiser les commandes
- Boutons de variables - Insertion rapide de
{player},{item_name} - Statut visuel - Voir quels articles ont des commandes configurées
Les articles configurés s'affichent en vert, les non-configurés en gris.
Comment fonctionne la livraison
- Le client complète l'achat sur votre boutique
- La commande est marquée comme terminée
- Le plugin interroge les livraisons en attente
- Les articles sont donnés au joueur
- La livraison est marquée comme complète
Joueurs en ligne
Les articles sont livrés immédiatement quand le joueur est en ligne.
Joueurs hors ligne
Les articles sont mis en file et livrés quand le joueur se connecte.
Configurer les produits
Lors de la création de produits dans votre tableau de bord, configurez ce que le joueur reçoit :
Produits de grade
commands:
- "lp user {player} parent set vip"
- "broadcast &6{player} &7vient d'acheter &6VIP&7!"
Produits d'articles
commands:
- "give {player} diamond_sword 1"
- "give {player} diamond_pickaxe 1"
- "give {player} diamond 64"
Variables
| Variable | Description |
|---|---|
{player} | Nom d'utilisateur du joueur |
{uuid} | UUID du joueur |
{product} | Nom du produit |
{price} | Prix d'achat |
{order_id} | ID de commande |
Dépannage
Erreur "Connection failed"
- Vérifiez que votre clé API est correcte
- Vérifiez que votre serveur peut atteindre
api.hytalepay.com - Vérifiez les paramètres du pare-feu
Articles non livrés
- Assurez-vous que le nom d'utilisateur du joueur correspond exactement
- Vérifiez que le plugin a la permission d'exécuter les commandes