🌀Warp

📝 Introduction

La commande /warp permet de créer, gérer et utiliser des points de téléportation (warps) sur le serveur. Le système propose différents types de warps avec diverses options de configuration, coûts et restrictions.

🔑 Permissions

• horizons.warp.create - Permet de créer des warps

• horizons.warp.delete - Permet de supprimer des warps

• horizons.warp.link - Permet de lier des warps staff et joueur

• horizons.warp.list - Permet d'afficher la liste des warps

• horizons.warp.setperm - Permet de définir la permission d'accès à un warp

• horizons.warp.setteam - Permet d'associer un warp à une équipe

• horizons.warp.settings - Permet de configurer les options avancées d'un warp

• horizons.warp.info - Permet d'afficher les informations détaillées d'un warp

• horizons.staff - Permet d'accéder aux warps de type staff et de se téléporter sans délai

📋 Sous-commandes

🚪 Téléportation simple

Syntaxe: /warp <nom>

Description: Se téléporte au warp spécifié si le joueur a les permissions nécessaires et peut en payer le coût.

🆕 create

Syntaxe: /warp create <staff/player> <nom> [permission] [team]

Description: Crée un nouveau warp à la position actuelle.

Paramètres:

• staff/player - Type de warp (réservé au staff ou accessible aux joueurs)

• nom - Nom du warp

• permission - Permission optionnelle requise pour utiliser ce warp

• team - Équipe optionnelle associée à ce warp

🗑️ delete

Syntaxe: /warp delete <staff/player> <nom>

Description: Supprime un warp existant.

🔗 link

Syntaxe: /warp link <staff_warp> <player_warp>

Description: Lie un warp staff à un warp joueur, permettant des téléportations conditionnelles.

📋 list

Syntaxe: /warp list [page]

Description: Affiche la liste de tous les warps accessibles, paginée si nécessaire.

🔑 setperm

Syntaxe: /warp setperm <warp> <permission>

Description: Définit la permission requise pour utiliser un warp.

🏆 setteam

Syntaxe: /warp setteam <warp> <team>

Description: Associe un warp à une équipe spécifique.

⚙️ settings

Syntaxe: /warp settings <warp> <option> [valeur]

Description: Configure les options avancées d'un warp.

Options disponibles:

• teleport-delay <secondes> - Délai de téléportation spécifique au warp

• require-stand-still <true/false> - Nécessite que le joueur reste immobile pendant le délai

• cancel-on-damage <true/false> - Annule la téléportation si le joueur subit des dégâts

• cost-points <montant> - Coût en points d'équipe pour utiliser ce warp

• item-cost <matériel> <quantité> - Objet et quantité requis pour utiliser ce warp

ℹ️ info

Syntaxe: /warp info <warp>

Description: Affiche les informations détaillées sur un warp, y compris son type, ses coûts, ses paramètres de téléportation et ses restrictions d'accès.

🧩 Types de warps

👑 Warps Staff

Les warps de type "staff" sont:

• Visibles et accessibles uniquement aux joueurs avec la permission horizons.staff

• Peuvent être liés à des warps joueur

• Affichés en rouge dans la liste des warps

• Généralement utilisés pour des zones administratives ou de modération

👤 Warps Joueur

Les warps de type "player" sont:

• Accessibles par les joueurs selon les permissions et équipes configurées

• Peuvent être associés à des coûts en points d'équipe ou en objets

• Affichés en vert dans la liste des warps

• Utilisés pour les téléportations courantes dans le jeu

💰 Système de coûts

Les warps peuvent être configurés pour exiger différents types de paiement:

📊 Points d'équipe

Un montant prélevé sur le score de l'équipe du joueur. Configurable via:

• /warp settings <warp> cost-points <montant>

🧰 Objets requis

Des objets spécifiques requis et consommés lors de la téléportation. Configurables via:

• /warp settings <warp> item-cost <matériel> <quantité>

Si un joueur ne possède pas les ressources nécessaires, un message détaillant ce qui manque sera affiché.

⏱️ Paramètres de téléportation

Chaque warp peut être configuré avec des paramètres spécifiques:

⏳ Délai de téléportation

• Délai global: Applicable à tous les warps, défini dans la configuration

• Délai spécifique: Configurable par warp via /warp settings <warp> teleport-delay <secondes>

• Exemption: Les joueurs avec la permission horizons.staff sont téléportés instantanément

🚫 Restrictions de mouvement

• Immobilité requise: Option configurable via /warp settings <warp> require-stand-still <true/false>

• Annulation sur dégâts: Option configurable via /warp settings <warp> cancel-on-damage <true/false>

Les ressources ne sont consommées qu'une fois la téléportation effectuée avec succès.

🔐 Restrictions d'accès

L'accès aux warps peut être restreint par:

• Type de warp: Les warps staff nécessitent la permission horizons.staff

• Permission spécifique: Configurable via /warp setperm <warp> <permission>

• Équipe: Configurable via /warp setteam <warp> <team>

💡 Exemples d'utilisation

Création de warps

# Warp public
/warp create player spawn

# Warp réservé au staff
/warp create staff admin_zone

# Warp avec permission spécifique
/warp create player vip_mine vip.access

# Warp d'équipe
/warp create player base_rouge custom.permission Rouge

Configuration de warps

# Définir un délai de téléportation de 5 secondes
/warp settings spawn teleport-delay 5

# Exiger que le joueur reste immobile pendant la téléportation
/warp settings mine require-stand-still true

# Définir un coût en points d'équipe
/warp settings resource_mine cost-points 50

# Exiger des diamants pour la téléportation
/warp settings diamond_mine item-cost DIAMOND 3

Téléportation

# Téléportation simple
/warp spawn

# Téléportation avec coût
/warp resource_mine
# (Si le joueur n'a pas assez de points)
→ Il vous manque: 20 points

# Téléportation avec délai
/warp mine
→ Téléportation dans 5 secondes...

⚙️ Configuration

Les warps individuels sont stockés dans le fichier warps.yml avec la structure suivante:

warps:
  staff:
    admin_zone:
      location:
        world: world
        x: 100.5
        y: 64.0
        z: 200.5
        yaw: 90.0
        pitch: 0.0
      permission: horizons.admin
      linked_player_warp: prison

  player:
    spawn:
      location:
        world: world
        x: 0.5
        y: 70.0
        z: 0.5
        yaw: 0.0
        pitch: 0.0
      settings:
        teleport-delay: 0
        require-stand-still: false
        cancel-on-damage: false
    
    mine:
      location:
        world: world
        x: 500.5
        y: 40.0
        z: 500.5
        yaw: 0.0
        pitch: 0.0
      settings:
        teleport-delay: 5
        require-stand-still: true
        cancel-on-damage: true
      costs:
        team-points: 10
        items:
          material: IRON_INGOT
          amount: 2
      team: Mineurs
      permission: horizons.mine