zTPA

zTPA 2.5 — DOCUMENTACIÓN Y COMANDOS

Desarrollador: SandungaMX
Plugin: zTPA
Versión: 2.5
Minecraft: Paper / Purpur 1.21.11
Java: 21
Compatibilidad: Java Edition y Bedrock Edition
Dependencias para Bedrock: Geyser y Floodgate

DESCRIPCIÓN

zTPA es un plugin de teletransportación para servidores Minecraft Java y Bedrock que permite enviar, aceptar y rechazar solicitudes de teletransporte mediante comandos, interfaces gráficas y formularios interactivos.

Incluye un selector de jugadores conectados, menús configurables, protección contra teletransportaciones inseguras, tiempos de espera y herramientas administrativas.

CARACTERÍSTICAS

- Compatible con Minecraft Java y Bedrock.
- Menús de inventario para jugadores Java.
- Formularios interactivos para jugadores Bedrock.
- Selector de jugadores conectados.
- Confirmación antes de enviar solicitudes desde el selector Bedrock.
- Activación y desactivación individual del menú automático.
- Preferencias de GUI guardadas por jugador.
- Solicitudes con tiempo de expiración configurable.
- Cooldown configurable entre solicitudes.
- Teletransportación con comprobaciones de seguridad.
- Comandos administrativos de teletransporte.
- Sistema de permisos compatible con LuckPerms.
- Mensajes personalizables mediante config.yml.
- Recarga de configuración sin reiniciar el servidor.

COMANDOS PARA JUGADORES

/tpa <jugador>
Envía una solicitud para teletransportarte hacia otro jugador.

/tpaccept
Acepta una solicitud de teletransportación pendiente.

/tpdeny
Rechaza una solicitud de teletransportación pendiente.

/tpauser
Abre un menú que muestra los jugadores conectados. Permite seleccionar un usuario y enviarle una solicitud TPA.

/tpagui
Abre manualmente el menú de solicitudes pendientes.

/tpagui on
Activa la apertura automática del menú cuando recibes una solicitud TPA.

/tpagui off
Desactiva la apertura automática del menú. Las solicitudes siguen llegando por chat y pueden aceptarse mediante comandos.

COMANDOS ADMINISTRATIVOS

/tp <jugador>
Teletransporta al administrador directamente hacia el jugador indicado.

/tphere <jugador>
Teletransporta al jugador indicado hacia la ubicación del administrador.

/tpall
Teletransporta a todos los jugadores conectados hacia la ubicación del administrador.

/ztpa reload
Recarga la configuración y los mensajes del plugin.

PERMISOS

ztpa.use
Permite utilizar el sistema de solicitudes TPA y el selector de jugadores.

ztpa.respond
Permite responder a solicitudes de teletransportación.

ztpa.tp
Permite utilizar /tp.

ztpa.tphere
Permite utilizar /tphere.

ztpa.tpall
Permite utilizar /tpall.

ztpa.reload
Permite recargar la configuración del plugin.

CONFIGURACIÓN CON LUCKPERMS

Dar permiso TPA al grupo default:

/lp group default permission set ztpa.use true
/lp group default permission set ztpa.respond true

Dar permisos administrativos al grupo moderador:

/lp group moderador permission set ztpa.tp true
/lp group moderador permission set ztpa.tphere true

Dar permisos de teletransporte masivo al grupo administrador:

/lp group administrador permission set ztpa.tpall true
/lp group administrador permission set ztpa.reload true

SISTEMA DE MENÚS

JAVA EDITION

Los jugadores pueden utilizar /tpauser para visualizar una interfaz de inventario con las cabezas de los jugadores conectados.

Al seleccionar un jugador, se envía una solicitud de teletransportación.

BEDROCK EDITION

Los jugadores Bedrock disponen de formularios interactivos para seleccionar usuarios y confirmar el envío de solicitudes.

Las solicitudes entrantes pueden gestionarse mediante botones para aceptar o rechazar.

ACTIVACIÓN DEL MENÚ

Cada jugador puede controlar la apertura automática de su interfaz:

/tpagui on — Activar.
/tpagui off — Desactivar.

La preferencia se conserva después de desconectarse o reiniciar el servidor.

SISTEMA DE COOLDOWN

El plugin permite configurar un tiempo de espera entre solicitudes TPA.

Ejemplo: 60 segundos.

El cooldown ayuda a evitar solicitudes repetitivas y el abuso del sistema.

EXPIRACIÓN DE SOLICITUDES

Las solicitudes pendientes pueden expirar automáticamente después de un tiempo configurable.

Cuando una solicitud expira, deja de estar disponible para aceptarse.

TELETRANSPORTE SEGURO

El plugin incorpora comprobaciones para buscar ubicaciones adecuadas antes de realizar determinados teletransportes.

Esto ayuda a reducir problemas relacionados con bloques sólidos y posiciones peligrosas.

ARCHIVOS DE CONFIGURACIÓN

plugin.yml
Define los comandos, permisos e información principal del plugin.

config.yml
Permite personalizar mensajes, cooldowns, expiración y opciones de las interfaces.

gui-preferences.yml
Almacena las preferencias individuales de activación o desactivación de la GUI automática.

INSTALACIÓN

1. Descarga el archivo
2. Copia el archivo JAR generado en la carpeta plugins del servidor.
3. Instala Geyser y Floodgate si deseas utilizar los formularios Bedrock.
4. Reinicia el servidor.
5. Configura los permisos utilizando LuckPerms.
6. Personaliza config.yml según las necesidades del servidor.

COMPATIBILIDAD

Servidor: Paper / Purpur 1.21.11
Java: Java 21
Minecraft Java Edition: Compatible
Minecraft Bedrock Edition: Mediante Geyser y Floodgate
LuckPerms: Compatible mediante permisos Bukkit

NOTAS IMPORTANTES

Los comandos administrativos deben asignarse únicamente a personal autorizado.

El comando /tp puede entrar en conflicto con otros plugins. En ese caso, utiliza /ztpa:tp para identificar el comando registrado por zTPA.

Los formularios Bedrock requieren que Floodgate esté correctamente instalado y configurado.

La versión 2.5 corresponde al proyecto de código fuente preparado. Su compilación y funcionamiento completo dentro del servidor todavía deben verificarse.

DESARROLLADO POR SANDUNGAMX

zTPA — Sistema de teletransportación para Minecraft Java y Bedrock.

Eternals Saga | SandungaMX