Commandes & Permissions

Cette page liste toutes les commandes et permissions disponibles dans zAuctionHouse V4.

Commande principaleCopier le lien vers ce titre

La commande principale est /zauctionhouse avec les alias par défaut suivants :

• /ah - Court et courant
• /hdv - Abréviation française (Hôtel des Ventes)
• /auction - Nom anglais complet
• /zauction - Version préfixée du plugin

Commandes joueurCopier le lien vers ce titre

Détails de la commande SellCopier le lien vers ce titre

/ah sell <prix> [quantité] [économie]

Arguments :

• <prix> - Le prix par objet (requis). Supporte les multiplicateurs : 1K, 2.5M, 1B, etc.
• [quantité] - Nombre d'objets à vendre de votre pile (optionnel, par défaut la pile complète). Avec l'inventaire de vente activé, la quantité s'applique à l'objet en main au moment de la confirmation, plafonnée à la taille de la pile
• [économie] - Quelle économie utiliser (optionnel, par défaut l'économie configurée)

Exemples :

# Vendre l'objet en main pour 1000
/ah sell 1000

# Vendre 32 objets pour 5000 chacun
/ah sell 5000 32

# Vendre en utilisant une économie spécifique
/ah sell 10000 64 vault

Détails de la commande SearchCopier le lien vers ce titre

/ah search <requête>

Rechercher des objets dans l'hôtel des ventes. Sans opérateur, la requête effectue une recherche insensible à la casse sur le nom, le matériau, le lore et le vendeur.

Filtres avancés :

Utilisez le format champ opérateur valeur pour des recherches ciblées. Les espaces autour de l'opérateur sont supportés.

Exemples :

# Recherche simple (correspond au nom, matériau, lore, vendeur)
/ah search diamond

# Trouver les objets vendus par un joueur spécifique
/ah search seller = Notch

# Trouver les objets contenant "Diamond" dans leur nom
/ah search name ~ Diamond

# Trouver les épées (insensible à la casse)
/ah search material ~= sword

Mode vente d'inventaireCopier le lien vers ce titre

Si enable-sell-inventory est défini sur true dans la config, exécuter /ah sell sans arguments ouvre une interface où les joueurs peuvent :

• Sélectionner des objets de leur inventaire
• Définir le prix
• Choisir l'économie

Commandes adminCopier le lien vers ce titre

Types d'ouverture adminCopier le lien vers ce titre

Le paramètre <type> pour /ah admin open accepte :

• listed - Voir les annonces actives du joueur (valeur par défaut si le type n'est pas reconnu)
• expired - Voir les objets expirés du joueur
• purchased - Voir les objets achetés du joueur

Exemple :

/ah admin open Steve listed

Pour voir l'historique d'un joueur, utilisez /ah admin history <joueur> (voir ci-dessous).

Annuaire admin des joueurs et historiqueCopier le lien vers ce titre

/ah admin
/ah admin history [joueur]

• /ah admin (sans argument) et /ah admin history (sans joueur) ouvrent l'annuaire admin des joueurs (admin-main) : une tête par joueur ayant une activité sur l'hôtel des ventes, avec ses annonces en cours, ses ventes et ses achats. Cliquez sur une tête pour ouvrir l'historique admin de ce joueur. Les données sont rechargées à chaque ouverture de l'inventaire.
• /ah admin history <joueur> ouvre directement le menu d'historique admin (admin-history-main) de ce joueur. Si le joueur n'a jamais été vu par le plugin, un message d'erreur est envoyé.

Les deux nécessitent la permission zauctionhouse.admin.items. Sans elle, /ah admin affiche seulement la syntaxe de la commande.

Exemples :

# Parcourir tous les joueurs ayant une activité
/ah admin

# Ouvrir l'historique admin de Steve
/ah admin history Steve

Commande Admin Force OpenCopier le lien vers ce titre

/ah admin forceopen <joueur> <inventaire> [page]

Ouvre n'importe quel inventaire pour un joueur à une page spécifique. Utile pour le débogage ou la navigation directe vers un inventaire et une page précis.

Arguments :

• <joueur> - Nom du joueur cible (requis)
• <inventaire> - Inventaire à ouvrir (requis). Accepte n'importe quel nom de fichier d'inventaire
• [page] - Numéro de page (optionnel, par défaut 1)

Inventaires disponibles :

Exemples :

# Ouvrir la vue admin des annonces actives de Steve
/ah admin forceopen Steve admin-selling-items

# Ouvrir l'hôtel des ventes à la page 3
/ah admin forceopen Steve auction 3

# Ouvrir les logs admin à la page 2
/ah admin forceopen Steve admin-logs 2

MigrationCopier le lien vers ce titre

Migrer des données d'autres plugins d'hôtel des ventes :

/ah admin migrate zauctionhousev3 confirm

Sources supportées :

• zauctionhousev3 (alias : zah, zahv3, v3)

PermissionsCopier le lien vers ce titre

Permissions de baseCopier le lien vers ce titre

Permissions de limite d'objetsCopier le lien vers ce titre

Contrôlez combien d'objets un joueur peut mettre en vente simultanément. Configurez dans config.yml :

permissions:
  auction:
    - permission: zauctionhouse.max.5
      limit: 5
    - permission: zauctionhouse.max.10
      limit: 10
    - permission: zauctionhouse.max.15
      limit: 15

Le plugin utilise la limite de permission la plus élevée que le joueur possède.

Permissions de temps d'expirationCopier le lien vers ce titre

Contrôlez les temps d'expiration personnalisés pour les objets listés. Configurez dans config.yml :

expiration:
  auction:
    default-expiration: 172800  # 2 jours en secondes
    permission:
      enable: true
      permissions:
        - permission: zauctionhouse.expiration.vip
          expiration: 3600      # 1 heure
        - permission: zauctionhouse.expiration.elite
          expiration: 7200      # 2 heures
        - permission: zauctionhouse.expiration.legend
          expiration: 259200    # 3 jours

Permissions de taxeCopier le lien vers ce titre

Contrôlez les taux de taxe pour les joueurs. Configurez dans economies.yml :

Permissions d'économieCopier le lien vers ce titre

Si vous utilisez plusieurs économies, contrôlez l'accès par économie :

Remplacez <nom> par le nom de votre économie (ex: vault, playerpoints).

Configuration des alias de commandesCopier le lien vers ce titre

Configurez les alias de commandes dans config.yml :

commands:
  main-command:
    aliases:
      - ah
      - hdv
      - auction
      - zauction

  sell:
    aliases:
      - sell
      - s
      - vendre

  claim:
    aliases:
      - claim
      - c
      - recuperer

  page:
    aliases:
      - page
      - p

  search:
    aliases:
      - search
      - s
      - rechercher

Multiplicateurs de prixCopier le lien vers ce titre

Les joueurs peuvent utiliser une notation abrégée pour les grands prix :

Exemples :

/ah sell 1K      # = 1 000
/ah sell 2.5M    # = 2 500 000
/ah sell 1.5B    # = 1 500 000 000

Exemples de permissionsCopier le lien vers ce titre

LuckPermsCopier le lien vers ce titre

Donner au groupe VIP 15 emplacements d'objets et l'expiration legend :

/lp group vip permission set zauctionhouse.max.15 true
/lp group vip permission set zauctionhouse.expiration.legend true
/lp group vip permission set zauctionhouse.tax.vip true

Exemple de configuration de groupeCopier le lien vers ce titre

# Groupe VIP
permissions:
  - zauctionhouse.max.15
  - zauctionhouse.expiration.legend
  - zauctionhouse.tax.vip

# Groupe Staff
permissions:
  - zauctionhouse.admin
  - zauctionhouse.reload
  - zauctionhouse.admin.items