TPHistory: Tu Rastreador de Teletransportes Definitivo

Descripción General

TPHistory es un plugin esencial diseñado para servidores de Minecraft que buscan mantener un control exhaustivo y un seguimiento detallado de todas las teletransportaciones de sus jugadores. Ya sea para fines administrativos, de seguridad, para investigar movimientos sospechosos o simplemente para que los jugadores puedan revisar sus propios viajes, TPHistory ofrece una solución robusta y fácil de usar. Registra automáticamente cada teletransporte, guardando información clave como la hora, la ubicación de origen y destino (incluyendo mundo y coordenadas), y permite consultarlas de forma organizada y paginada.

Requisitos:

• Spigot/Paper/Purpur 1.13.x o superior (dado que el api-version en tu plugin.yml es 1.21, asumo que es para versiones modernas de Minecraft).
  
  
• Java 17 o superior

Características Principales

• Registro Automático de Teletransportes: Captura de forma transparente todos los teletransportes de los jugadores, ya sean por comandos (/tp, /tpa), plugins de terceros (Essentials, CMI), o eventos internos del juego (teletransportes de camas, ender pearls, etc.).
  
  
• Base de Datos Eficiente (SQLite): Almacena todo el historial de teletransportes en un archivo SQLite local (tphistory.db), garantizando un rendimiento óptimo y una fácil gestión.
  
  
• Historial Paginado: Visualiza el historial de teletransportes de cualquier jugador de manera organizada en páginas, lo que facilita la navegación a través de grandes volúmenes de datos.
  
  
• Configuración Flexible de Comandos: Define qué comando se ejecutará al hacer clic en una entrada del historial para teletransportarte directamente a esa ubicación, compatible con plugins de teletransporte existentes.
  
  
• Límite de Historial Configurable: Controla el número máximo de entradas de historial que se guardan por jugador para evitar bases de datos excesivamente grandes. Las entradas más antiguas se eliminan automáticamente al alcanzar el límite.
  
  
• Integración con Spigot Chat: Interfaz de usuario interactiva con mensajes clickeables y hover-text para una experiencia intuitiva.
  
  
• Permisos Granulares: Control total sobre quién puede ver el historial propio, el de otros jugadores, recargar el plugin o navegar entre páginas.

Comandos

• /tphist [player] [page]
  • Alias: /tph
    
    
  • Descripción: Muestra el historial de teletransportaciones personales.
    • Si se usa sin argumentos (/tphist), muestra tu propio historial de teletransportes.
      
      
    • Si se usa con <player> (/tphist playerTwentyHeavens), muestra el historial de teletransportes de ese jugador específico (requiere permiso).
      
      
    • Si se usa con <page> (/tphist player TwentyHeavens 2 o /tphist playerTwentyHeavens 3), navega a una página específica del historial.
  • Permisos Requeridos:
    • tphistory.command.use (general)
      
      
    • tphistory.command.listplayers (para ver el historial de otros)
      
      
    • tphistory.command.playerpages (para especificar página al ver historial de otros)
• /tphist reload
  • Alias: /tph reload
    
    
  • Descripción: Recarga la configuración del plugin (config.yml y lang.yml). Útil para aplicar cambios sin reiniciar el servidor.
    
    
  • Permisos Requeridos:
    • tphistory.command.use (general)
      
      
    • tphistory.command.reload

Configuración (config.yml)

--------------------------------------------------------------------------------------------------
# Configuración del Plugin TPHistory
# verion: v1.0
# Creador: @tewentyheavens (Discord)

# Configuración de la base de datos
database:
# El nombre del archivo de la base de datos SQLite que se generará.
# Se guardará dentro de la carpeta del plugin (plugins/TPHistory/)
filename: "tphistory.db" # No cambies el ".db"

# Configuración del comando de teletransporte para el click en el historial
teleport-command:
# Define el comando que se usará para teletransportarse al hacer clic en una entrada de historial.
# Puedes usar los siguientes placeholders:
# %world% : El nombre del mundo de destino.
# %x% : La coordenada X de destino (entero).
# %y% : La coordenada Y de destino (entero).
# %z% : La coordenada Z de destino (entero).
#
# Ejemplo: "/tpopos %x% %y% %z% %world%" (Este es el valor por defecto)
# Ejemplo: "/minecraft:tp %x% %y% %z% %world%"
# Ejemplo: "/essentials:tppos %x% %y% %z%" (si no necesitas el mundo en caso de usar otro plugin)
teleport-command-format: "/tpopos %x% %y% %z% %world%" #Puedes editar esto!

# Configuración de las funcionalidades principales
settings:
# Número máximo de teletransportes a guardar por jugador.
# Si se añade un nuevo teleport y se supera este límite,
# se eliminará el registro más antiguo para ese jugador.
max-teleport-history-per-player: 100

# Permisos
permissions:
tphistory.command.use:
description: Permite usar el comando tphist y sus aliases.
default: true # O 'op' si prefieres que solo los OPs puedan usarlo por defecto.

tphistory.command.reload:
description: Permite recargar la configuración del plugin.
default: op # Solo operadores deberían poder recargar la configuración.

tphistory.command.listplayers:
description: Permite ver el historial de teletransportaciones de otros jugadores.
default: op # Solo operadores deberían poder ver el historial de otros por defecto.
# Si quieres que se pueda delegar a usuarios no-OP, pon 'false'.

tphistory.command.playerpages:
description: Permite especificar una página al ver el historial de otros jugadores.
default: op # Recomendado 'op'. Si un usuario tiene 'tphistory.command.listplayers'
# pero no este, solo podrá ver la primera página del historial de otros.
-------------------------------------------------------------------------------------------