GroupeZ Docs
Modules

Module Téléportation

Système de téléportation complet avec TPA, RTP, délais et fonctionnalités de sécurité

Fichier : modules/teleportation/config.yml

Le module Téléportation est un système de téléportation complet prenant en charge les téléportations directes, les demandes de téléportation (TPA), la téléportation aléatoire (RTP), les délais et sons configurables, les vérifications de sécurité, les minuteries de protection, les listes noires de biomes et les paramètres par monde. Il inclut un système de délais et de protection basé sur les permissions, permettant un comportement différent pour différents groupes de joueurs.


Configuration Source

enable: true
teleport-safety: true
teleport-to-center: true
teleport-delay: 5
teleport-delay-permissions:
  - permission: "essentials.teleport.delay.vip"
    delay: 4
  - permission: "essentials.teleport.delay.staff"
    delay: 2
teleport-delay-bypass: false

# Sound played every second during the teleport countdown
countdown-sound:
  enabled: false
  sound: BLOCK_NOTE_BLOCK_HAT
  volume: 1.0
  pitch: 1.0

# Sound played when the teleportation is completed
complete-sound:
  enabled: false
  sound: ENTITY_ENDERMAN_TELEPORT
  volume: 1.0
  pitch: 1.0

teleport-tpa-expire: 60
open-confirm-inventory-for-tpa: false
open-confirm-inventory-for-tpa-here: false
rtp-worlds:
  - world: "world"
    center-x: 0
    center-z: 0
    radius-x: 5000
    radius-z: 5000
  - world: "survivalspawn"
    center-x: 0
    center-z: 0
    radius-x: 5000
    radius-z: 5000
max-rtp-attempts: 10
blacklist-biomes:
  - cold_ocean
  - deep_cold_ocean
  - deep_frozen_ocean
  - deep_lukewarm_ocean
  - deep_ocean
  - deep_warm_ocean
  - frozen_ocean
  - frozen_river
  - lukewarm_ocean
  - ocean
  - river
  - warm_ocean
teleport-protection: 1000
teleport-protections:
  - permission: "essentials.teleport.protection.vip"
    delay: 2000
  - permission: "essentials.teleport.protection.staff"
    delay: 3000
enable-random-teleport-search-log-message: true
enable-rtp-queue: false
rtp-queue-delay: 2000
enable-first-join-rtp: false
first-join-rtp-world: "world"
rtp-world-overrides:
  - from: "world_nether"
    to: "world"
  - from: "world_the_end"
    to: "world"

Options

Options Générales

OptionTypePar DéfautDescription
enableBooleantrueActiver ou désactiver le module Téléportation
teleport-safetyBooleantrueSi true, un joueur se téléportant vers un emplacement dangereux est déplacé vers l'emplacement sûr le plus proche sur les mêmes X/Z (seul Y change). Si false, les téléportations vers un emplacement dangereux sont annulées avec un avertissement
teleport-to-centerBooleantrueSi true, les joueurs sont téléportés au centre du bloc (X.5, Z.5) pour un positionnement plus précis

Délai de Téléportation

OptionTypePar DéfautDescription
teleport-delayInteger5Délai par défaut en secondes avant l'exécution d'une téléportation. Si le joueur bouge ou subit des dégâts pendant ce temps, la téléportation est annulée
teleport-delay-permissionsList(voir ci-dessus)Surcharges basées sur les permissions pour le délai de téléportation
teleport-delay-permissions[].permissionString-Le noeud de permission que le joueur doit posséder pour que cette surcharge de délai s'applique
teleport-delay-permissions[].delayInteger-Le délai en secondes à utiliser pour les joueurs ayant cette permission
teleport-delay-bypassBooleanfalseSi true, les joueurs possédant la permission essentials.teleport.bypass ne subissent pas le délai de téléportation

Si un joueur possède plusieurs permissions de teleport-delay-permissions, c'est le délai le plus bas qui est utilisé. Les joueurs sans permission correspondante utilisent teleport-delay.

Sons de Téléportation

OptionTypePar DéfautDescription
countdown-sound.enabledBooleanfalseJoue un son chaque seconde pendant le compte à rebours de téléportation
countdown-sound.soundStringBLOCK_NOTE_BLOCK_HATSon à jouer
countdown-sound.volumeDecimal1.0Volume du son
countdown-sound.pitchDecimal1.0Tonalité du son
complete-sound.enabledBooleanfalseJoue un son lorsque la téléportation est terminée
complete-sound.soundStringENTITY_ENDERMAN_TELEPORTSon à jouer
complete-sound.volumeDecimal1.0Volume du son
complete-sound.pitchDecimal1.0Tonalité du son

Les sons sont résolus via l'API XSound de zMenu, ils fonctionnent donc sur toutes les versions de Minecraft supportées. Si le nom ne correspond à aucun son vanilla connu, il est joué comme un son personnalisé (par exemple un son de resource pack comme myserver:teleport).

Options TPA (Demande de Téléportation)

OptionTypePar DéfautDescription
teleport-tpa-expireInteger60Durée en secondes avant qu'une demande TPA en attente n'expire automatiquement
open-confirm-inventory-for-tpaBooleanfalseSi true, ouvre un inventaire de confirmation zMenu à l'expéditeur avant l'envoi d'une demande /tpa
open-confirm-inventory-for-tpa-hereBooleanfalseSi true, ouvre un inventaire de confirmation zMenu à l'expéditeur avant l'envoi d'une demande /tpahere

Lorsque les options d'inventaire de confirmation sont activées, le joueur qui exécute /tpa ou /tpahere doit confirmer la demande dans une interface graphique avant qu'elle ne soit envoyée à la cible.

Options de Téléportation Aléatoire (RTP)

OptionTypePar DéfautDescription
rtp-worldsList(voir ci-dessus)Définit quels mondes autorisent la téléportation aléatoire et la zone de recherche pour chaque monde
rtp-worlds[].worldString-Le nom du monde où le RTP est autorisé
rtp-worlds[].center-xInteger0La coordonnée X du point central de la zone de recherche RTP
rtp-worlds[].center-zInteger0La coordonnée Z du point central de la zone de recherche RTP
rtp-worlds[].radius-xInteger5000La distance maximale depuis center-x sur l'axe X pour la sélection d'un emplacement aléatoire
rtp-worlds[].radius-zInteger5000La distance maximale depuis center-z sur l'axe Z pour la sélection d'un emplacement aléatoire
max-rtp-attemptsInteger10Nombre maximum de tentatives pour trouver un emplacement aléatoire sûr avant d'abandonner
enable-random-teleport-search-log-messageBooleantrueSi true, enregistre un message dans la console à chaque fois que le plugin recherche un emplacement de téléportation aléatoire

Liste Noire de Biomes

OptionTypePar DéfautDescription
blacklist-biomesList of Strings(voir ci-dessus)Une liste d'identifiants de biomes où la téléportation aléatoire ne placera pas les joueurs. Si un emplacement sélectionné se trouve dans un biome de la liste noire, le plugin réessaye jusqu'à max-rtp-attempts fois

Si trop de biomes sont dans la liste noire et que la zone RTP est petite, le plugin peut épuiser toutes les tentatives sans trouver un emplacement valide. Augmentez max-rtp-attempts ou agrandissez le rayon RTP si les joueurs échouent fréquemment à trouver un emplacement.

Protection de Téléportation

OptionTypePar DéfautDescription
teleport-protectionInteger1000Durée de protection par défaut en millisecondes après la téléportation. Pendant ce temps, le joueur est immunisé aux dégâts
teleport-protectionsList(voir ci-dessus)Surcharges basées sur les permissions pour la durée de protection de téléportation
teleport-protections[].permissionString-Le noeud de permission que le joueur doit posséder pour que cette surcharge de protection s'applique
teleport-protections[].delayInteger-La durée de protection en millisecondes pour les joueurs ayant cette permission

La protection de téléportation empêche les joueurs de subir des dégâts immédiatement après la téléportation. C'est particulièrement utile pour le RTP où les joueurs peuvent atterrir dans des environnements hostiles. La valeur est en millisecondes (par ex., 1000 = 1 seconde, 3000 = 3 secondes). Comme pour le délai, si un joueur correspond à plusieurs entrées, la valeur la plus basse est utilisée.

File d'Attente RTP

OptionTypePar DéfautDescription
enable-rtp-queueBooleanfalseSi true, active un système de file d'attente pour les demandes RTP afin d'éviter les lags serveur causés par des recherches de téléportation aléatoire simultanées
rtp-queue-delayInteger2000Délai en millisecondes entre le traitement de chaque demande RTP en file d'attente

RTP à la Première Connexion

OptionTypePar DéfautDescription
enable-first-join-rtpBooleanfalseSi true, les nouveaux joueurs sont automatiquement téléportés aléatoirement lors de leur première connexion au serveur
first-join-rtp-worldString"world"Le monde dans lequel la téléportation aléatoire de première connexion a lieu. Doit être défini dans rtp-worlds. Laissez vide pour utiliser le monde d'apparition du joueur

Le RTP à la première connexion est utile pour les serveurs survie qui souhaitent disperser les joueurs sur la carte dès le départ, plutôt que de faire apparaître tout le monde au même emplacement.

Paramètres par Monde

OptionTypePar DéfautDescription
rtp-world-overridesList(voir ci-dessus)Redirige les demandes RTP d'un monde vers un autre. Si un joueur utilise /tpr dans un monde listé comme from, il est téléporté à un emplacement aléatoire dans le monde to à la place
rtp-world-overrides[].fromString-Le monde où le joueur se trouve actuellement
rtp-world-overrides[].toString-Le monde cible où le joueur sera téléporté aléatoirement

Les paramètres par monde sont utiles pour empêcher le RTP dans des dimensions comme le Nether ou l'End, redirigeant ces demandes vers l'overworld à la place.


Fonctionnement

  1. Téléportations Directes (/tp, /tphere, /tpall) : Téléporte instantanément les joueurs vers un emplacement ou un joueur cible.
  2. Demandes de Téléportation (/tpa, /tpahere) : Envoie une demande à un autre joueur. La cible peut accepter (/tpaccept) ou refuser (/tpdeny) dans le délai d'expiration. Le demandeur peut annuler avec /tpacancel <joueur>, ce qui retire la demande des demandes en attente de la cible.
  3. Téléportation Aléatoire (/tpr) : Sélectionne un emplacement aléatoire dans les limites RTP configurées pour le monde actuel du joueur (ou le monde de redirection), en évitant les biomes de la liste noire, et y téléporte le joueur après les vérifications de sécurité.
  4. Retour (/back) : Ramène le joueur à son emplacement précédent avant la dernière téléportation.
  5. Téléportations Verticales (/top, /bottom) : Téléporte le joueur au bloc sûr le plus haut ou le plus bas à ses coordonnées X/Z actuelles.
  6. Téléportation de Monde (/worldtp) : Téléporte un joueur vers un monde spécifique.

Utilisation de /tp

SyntaxeEffet
/tp <joueur>Vous téléporte vers un joueur
/tp <joueur1> <joueur2>Téléporte joueur1 vers joueur2
/tp <x> <y> <z> [yaw] [pitch]Vous téléporte à des coordonnées. Les coordonnées relatives (~, ~5) sont supportées
/tp <joueur> <x> <y> <z> [yaw] [pitch]Téléporte un joueur à des coordonnées (@s vous cible vous-même)

File de Demandes

Un joueur peut recevoir plusieurs demandes de téléportation en même temps :

  • /tpaccept ou /tpdeny sans argument traite la demande la plus récente
  • /tpaccept <joueur> ou /tpdeny <joueur> traite la demande d'un joueur précis
  • /tpaccept * ou /tpdeny * accepte ou refuse toutes les demandes en attente d'un coup

Bloquer les Demandes

  • /tptoggle désactive (ou réactive) toutes les demandes de téléportation entrantes (/tpa et /tpahere). Le staff possédant essentials.tp.toggle.other peut utiliser /tptoggle <joueur>.
  • /tpaheretoggle désactive uniquement les demandes /tpahere entrantes. Le staff possédant essentials.tpa.here.toggle.other peut utiliser /tpaheretoggle <joueur>.
  • Un joueur ignoré avec /ignore ne peut plus envoyer de demande /tpa ou /tpahere au joueur qui l'ignore. Voir le Module Messages.

/tptoggle et les commandes d'ignore appartiennent au Module Messages : ce module doit être activé pour qu'elles fonctionnent.

Messages de Téléportation

Les messages de compte à rebours et de réussite (teleport-message, teleport-success, teleport-message-home, teleport-message-warp, ...) sont définis dans le fichier de messages. Leurs placeholders internes (%seconds%, %name%, ...) sont remplacés pour tous les types de message, y compris TITLE et BOSSBAR.


Commandes Associées

CommandeAliasPermissionDescription
/tp-essentials.tpSe téléporter vers un joueur, téléporter un joueur vers un autre, ou se téléporter à des coordonnées
/tpall-essentials.tp.allTéléporter tous les joueurs connectés vers vous
/tphere <joueur>sessentials.tp.hereTéléporter un joueur à votre emplacement
/tpa <joueur>-essentials.tpaEnvoyer une demande de téléportation à un joueur
/tpahere <joueur>-essentials.tpa.hereDemander à un joueur de se téléporter vers vous
/tpaccept [joueur|*]tpyesessentials.tpa.acceptAccepter la dernière demande, celle d'un joueur ou toutes les demandes en attente
/tpdeny [joueur|*]tpnoessentials.tpa.denyRefuser la dernière demande, celle d'un joueur ou toutes les demandes en attente
/tpacancel <joueur>-essentials.tpa.cancelAnnuler votre demande de téléportation sortante
/tptoggle [joueur]-essentials.tp.toggleActiver ou désactiver la réception des demandes de téléportation
/tpaheretoggle [joueur]-essentials.tpa.here.toggleActiver ou désactiver la réception des demandes /tpahere
/back-essentials.backSe téléporter à votre emplacement précédent
/tprrtpessentials.tp.randomSe téléporter à un emplacement aléatoire
/tpr other <joueur> <monde>rtp otheressentials.tp.random.otherTéléporter aléatoirement un autre joueur dans un monde
/top-essentials.topSe téléporter au bloc le plus haut à votre position
/bottom-essentials.bottomSe téléporter au bloc sûr le plus bas à votre position
/worldtp <monde> [joueur]wtpessentials.tp.worldSe téléporter vers un monde spécifique

Pour la liste complète des commandes, consultez Commandes & Permissions.


Permissions Associées

PermissionDescription
essentials.teleport.bypassIgnore le délai de téléportation (nécessite teleport-delay-bypass: true)
essentials.tp.toggle.otherActiver ou désactiver les demandes de téléportation d'un autre joueur
essentials.tpa.here.toggle.otherActiver ou désactiver les demandes /tpahere d'un autre joueur
essentials.tp.world.otherTéléporter un autre joueur dans un monde avec /worldtp
essentials.teleport.delay.vipAccorde le délai de téléportation VIP (4 secondes dans la configuration par défaut)
essentials.teleport.delay.staffAccorde le délai de téléportation staff (2 secondes dans la configuration par défaut)
essentials.teleport.protection.vipAccorde la protection de téléportation VIP (2000ms dans la configuration par défaut)
essentials.teleport.protection.staffAccorde la protection de téléportation staff (3000ms dans la configuration par défaut)

Les noeuds de permission de délai et de protection et leurs valeurs associées sont entièrement configurables. Les permissions listées ci-dessus proviennent de la configuration par défaut et peuvent être modifiées pour correspondre à la structure de permissions de votre serveur.


Exemple : Configuration Serveur Survie

Une configuration typique de serveur survie avec des limites RTP généreuses et l'exclusion des biomes océaniques :

enable: true
teleport-safety: true
teleport-to-center: true
teleport-delay: 5
teleport-delay-permissions:
  - permission: "essentials.teleport.delay.donor"
    delay: 2
  - permission: "essentials.teleport.delay.staff"
    delay: 0
teleport-delay-bypass: false
countdown-sound:
  enabled: true
  sound: BLOCK_NOTE_BLOCK_HAT
  volume: 1.0
  pitch: 1.0
complete-sound:
  enabled: true
  sound: ENTITY_ENDERMAN_TELEPORT
  volume: 1.0
  pitch: 1.0
teleport-tpa-expire: 120
rtp-worlds:
  - world: "world"
    center-x: 0
    center-z: 0
    radius-x: 10000
    radius-z: 10000
max-rtp-attempts: 20
blacklist-biomes:
  - ocean
  - deep_ocean
teleport-protection: 3000
enable-first-join-rtp: true
first-join-rtp-world: "world"

Sur cette page

GroupeZ MCP

La documentation dans ton IA

Le MCP permet à ton IA de chercher dans la documentation GroupeZ et de lire les exemples à jour pour t’aider à configurer tes plugins.

Lecture seule · Sans clé API côté documentation

1. Copie l’adresse du serveur

Transport : HTTP (Streamable HTTP). Authentification : aucune. Ton outil utilise son propre modèle et ses propres limites d’abonnement.

  1. Ouvre Plugins dans ChatGPT sur le web, puis + → Ajouter un serveur MCP personnalisé.
  2. Nomme-le « GroupeZ Documentation », colle l’URL ci-dessus et choisis « Aucune authentification ». Crée puis installe le plugin.
  3. Dans une conversation, tape @ et sélectionne ce plugin avant d’envoyer ta question. Si nécessaire, active search, get_page et list_pages dans ses paramètres.
Guide officiel de cet outil

3. Pose une question

Utilise le MCP GroupeZ pour m’aider à créer un inventaire zMenu. Recherche les pages pertinentes, lis les exemples et cite tes sources.
Autres clients et dépannage

Pour les clients utilisant mcpServers, adapte cet exemple à leur format :

{
  "mcpServers": {
    "groupez-docs": {
      "url": ""
    }
  }
}

Les outils disponibles sont search, get_page et list_pages. Après une mise à jour, actualise les outils du connecteur. Si ton IA n’y accède pas, vérifie que le connecteur est activé dans la conversation et que ton compte autorise les MCP personnalisés. Ouvrir l’URL dans un navigateur n’est pas un test MCP.