FFTOPS - Speedgot

FFTOPS -----

FFTopPlugin is an advanced plugin designed for Minecraft servers that want to keep a detailed and vi

Download Now
36 KB .jar

version 1.0

FFTopPlugin - Wiki Oficial
Tabla de contenidos
1. Introducción
  FFTopPlugin es un complemento avanzado diseñado para servidores de Minecraft que desean mantener un registro detallado y visualmente atractivo de las estadísticas de sus jugadores. Este complemento permite la recopilación y presentación de datos de asesinatos, muertes y bloques minados, lo que garantiza una competencia sana y emocionante entre los jugadores.
  
  ¿Qué hace FFTopPlugin?
  FFTopPlugin gestiona y muestra las estadísticas de los jugadores en tiempo real, utilizando NPCs y hologramas para representar el ranking de los mejores jugadores de cada categoría. Con una interfaz sencilla y comandos intuitivos, los administradores pueden configurar y personalizar la forma en que se presentan estos datos en el servidor.
  
  Características principales
  - Registro automático de estadísticas como **muertes, muertes y bloques minados**.
  - Creación de **NPCs interactivos** con el apoyo de Citizens, mostrando a los mejores jugadores en el servidor.
  - Integración con **PlaceholderAPI**, permitiéndote utilizar los datos del plugin en otras partes del servidor.
  - Comandos amigables para el jugador y herramientas avanzadas de administración de moderadores.
  - Configuración totalmente personalizable mediante , que le permite modificar mensajes, formato de holograma y más.config.yml
  - Compatibilidad con las versiones **Spigot y Paper** de 1.16 a 1.20+.
  ¿Por qué usar FFTopPlugin?
  Los servidores competitivos de Minecraft basados en estadísticas se benefician enormemente de un sistema de clasificación automatizado. FFTopPlugin no solo proporciona una forma eficiente de realizar un seguimiento de las estadísticas, sino que también mejora la experiencia visual y competitiva del servidor, motivando a los jugadores a mejorar su rendimiento y llegar a la cima de las tablas de clasificación.
2. Instalación
  1. Descargue el archivo FFTopPlugin.jar y colóquelo en la carpeta de su servidor.Complementos
  2. Asegúrate de tener **Citizens** y **PlaceholderAPI** (opcional para marcadores de posición) instalados.
  3. Reinicie el servidor para generar los archivos de configuración.
  4. Edita el archivo según tus preferencias.config.yml
  5. ¡Listo! Úsalo para empezar./fftop
3. Comandos
  FFTopPlugin proporciona una serie de comandos útiles tanto para los jugadores como para los administradores del servidor. A continuación se muestran los comandos disponibles junto con ejemplos de uso detallados:
  
  Permiso de descripción del comando
  /create top <tipo> <posición> Crea un NPC con un holograma que muestra a un jugador en la tabla de clasificación. fftop.create
  /fftop kills Muestra el ranking de asesinatos. fftop.use
  /fftop muertes Muestra el ranking de muertes. fftop.use
  /fftop blocks Muestra la clasificación de los bloques minados. fftop.use
  /fftop tabla de clasificación Muestra la parte superior general. fftop.use
  /fftop reset <jugador> Restablece las estadísticas de un jugador. fftop.admin
  /fftop selecciona Selecciona un NPC cercano para editar. fftop.admin
  /fftop remove Elimina el NPC seleccionado y su holograma. fftop.admin
  /fftop selecciona Selecciona un NPC cercano para editar. fftop.admin
  /fftop reload Vuelve a cargar la configuración y los datos del plugin. fftop.admin
  Ejemplos de uso
  1. Mostrar ranking de asesinatos
    /fftop mata
    Muestra los mejores jugadores con más muertes.
  2. Mostrar clasificación de muertes
    /fftop muertes
    Muestra los mejores jugadores con más muertes.
  3. Mostrar el ranking de bloques minados
    Bloques /fftop
    Muestra el top de jugadores con más bloques minados.
  4. Restablecer las estadísticas de un jugador
    /fftop reiniciar Steve
    Restablece las estadísticas del jugador llamado Steve.
  5. Seleccionar un NPC cercano
    /fftop seleccionar
    Selecciona un NPC cercano para editarlo o eliminarlo.
  6. Eliminar un NPC seleccionado y su holograma
    /fftop eliminar
    Elimina el NPC seleccionado junto con su holograma.
  7. Recargar la configuración del plugin
    /fftop reload
    Recarga los archivos de configuración y datos del plugin.
  8. Crear un NPC con el jugador en el primer lugar del ranking de asesinatos
    /create top kills 1
    Genera un NPC en la ubicación actual del jugador que muestra al jugador número 1 en asesinatos.
  9. Crear un NPC con el jugador en la tercera posición del ranking de bloques minados
    /create top blocks 3
    Genera un NPC mostrando al jugador que ocupa la tercera posición en el ranking de bloques minados.
  10. Ver la tabla de clasificación general
    /fftop leaderboard
    Muestra la clasificación combinada de los mejores jugadores en todas las estadísticas.
4. NPCs con Hologramas
  FFTopPlugin permite la creación de NPCs que representan a los jugadores más destacados en diferentes categorías (asesinatos, muertes y bloques minados). Estos NPCs se generan con el soporte del plugin Citizens y pueden incluir hologramas personalizados sobre sus cabezas para mostrar información relevante.
  
  ¿Cómo crear un NPC con holograma?
  Para crear un NPC con un holograma que muestre el ranking de los jugadores, usa el siguiente comando:
  
  /create top <tipo> <posición>
  Ejemplo:
  
  /create top kills 1
  Este comando generará un NPC en tu ubicación que representa al jugador con más asesinatos en el servidor.
  
  Características de los NPCs generados
  - Apariencia: Se pueden personalizar con skins basadas en los jugadores reales del top.
  - Actualización Automática: El plugin actualiza la información periódicamente para reflejar cambios en el ranking.
  - Compatibilidad con Hologramas: Se pueden agregar líneas de texto personalizadas sobre el NPC para mostrar estadísticas.
  Configuración de Hologramas
  Los hologramas pueden ser configurados desde el archivo . Permiten mostrar información en capas flotantes sobre los NPCs. Aquí tienes un ejemplo de cómo modificar las líneas que aparecen sobre los NPCs:config.yml
  
  hologram:
  initial-height: 1.5
  lines:
  - "&6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
  - "&e&l%player%"
  - "&7➟ &6Position: &f#%position%"
  - "&7➟ &aScore: &f%value%"
  - "&b✧･ﾟ: *✧ Top &c%type% &bPlayer ✧*:･ﾟ✧"
  - "&6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
  
  Ejemplos de Configuración de Hologramas
  Mostrar un mensaje personalizado en los hologramas:
  
  hologram:
  lines:
  - "&5✧･ﾟ: *✧ &d%type% &5TOP &dPlayer &5✧*:･ﾟ✧"
  - "&b✦ %player% ✦"
  - "&5| &fRank: &d#%position%"
  - "&5| &fPuntos: &b%value%"
  - "&5♡･ﾟ: *✧ &d#%position% &5en el ranking &dMístico &5✧*:･ﾟ♡"
  
  Este formato resalta al mejor jugador con un diseño llamativo.
  
  Añadir bordes decorativos en los hologramas:
  
  hologram:
  lines:
  - "&8█▓▒░ &cTOP &6%type% &8░▒▓█"
  - "&e⬛ &f%player% &e⬛"
  - "&a◼ &7Posición: &f#%position%"
  - "&c◼ &7Puntaje: &f%value%"
  - "&8█▓▒░ &6#%position% &een el ranking &8░▒▓█"
  
  Usar líneas de separación mejora la visibilidad del holograma.
  
  Reducir la cantidad de información mostrada:
  
  hologram:
  lines:
  - "&eTop %type%"
  - "&a%player%"
  
  Útil para servidores que prefieren menos texto en pantalla.
  
  Ajustar la altura del holograma para mayor visibilidad:
  
  hologram:
  initial-height: 2.0 # Aumenta la altura para evitar que se solape con el NPC
  
  Si los hologramas aparecen demasiado bajos, puedes ajustar esta configuración.
  
  Desactivar hologramas en NPCs específicos:
  
  hologram:
  enabled: false
  
  Si prefieres no usar hologramas en ciertos NPCs, esta opción los desactiva.
  
  Ejemplos de Uso
  Crear un NPC para el primer puesto de asesinatos:
  
  /create top kills 1
  Crea un NPC con un holograma mostrando el jugador con más asesinatos.
  
  Crear un NPC para el tercer puesto de bloques minados:
  
  /create top blocks 3
  Muestra al jugador en la tercera posición del ranking de bloques minados.
  
  Eliminar un NPC y su holograma correctamente:
  
  /fftop remove
  Este comando borra el NPC y su holograma. No uses comandos normales de Citizens, ya que dejarán hologramas flotando.
  
  Seleccionar un NPC para edición:
  
  /fftop select
  Te permite seleccionar un NPC cercano para administrarlo.
  
  Actualizar manualmente los NPCs del top:
  
  /fftop reload
  Recarga la configuración y actualiza los datos mostrados en los NPCs.
  
  ❗ Importante sobre la eliminación de NPCs
  Si eliminas los NPCs con los comandos normales de Citizens, los hologramas NO se eliminarán correctamente y quedarán flotando en el aire. Para eliminarlos de forma segura, usa el comando:
  
  /fftop remove
  Este comando se asegura de borrar tanto el NPC como su holograma, evitando errores visuales en el servidor.
  
  Los NPCs y hologramas son una forma efectiva de resaltar a los mejores jugadores del servidor, agregando un aspecto visual atractivo y competitivo.
5. Configuración (config.yml)
  El archivo de configuración permite personalizar todos los aspectos del plugin, desde los mensajes que aparecen en el chat hasta la apariencia de los hologramas y la funcionalidad de los menús. A continuación, te mostramos algunos ejemplos detallados de configuración y sus efectos en el servidor.config.yml
  
  Ejemplos de configuración y ajustes
  Modificar los mensajes del plugin
  
  # ============================================
  # FFTopPlugin - Official Configuration
  # Developed by: ElAntiguo
  # Version: 1.0.0
  # Compatible with: Spigot/Paper 1.16 - 1.20+
  # Description:
  # This plugin allows managing player rankings based on statistics
  # such as kills, deaths, and mined blocks.
  # Also enables creating NPCs with holograms displaying top positions.
  #
  # IMPORTANT:
  # - Edit this file carefully.
  # - Do not delete entire sections, only change values.
  # - Use "&" for color codes in messages.
  # ============================================
  
  # Plugin messages that will appear in server chat
  messages:
  # ⛔ Commands and errors
  command-player-only: "&cThis command can only be executed by players."
  invalid-subcommand: "&cInvalid subcommand. Use: /fftop "
  
  # NPC Creation
  create-command-usage: "&eUsage: /create top "
  create-command-example: "&eExample: /create top kills 1"
  invalid-position-number: "&cPosition must be a valid number."
  invalid-top-type: "&cInvalid top type. Use kills, deaths or blocks."
  no-stats-available: "&cNo data available for this top."
  position-unavailable: "&cSpecified position is out of range."
  npc-spawn-failed: "&cFailed to spawn NPC."
  npc-created: "&aNPC created successfully: %s"
  
  # Statistics Commands
  fftop-usage: "&eUsage: /fftop "
  reset-usage: "&eUsage: /fftop reset "
  stats-reset: "&aStatistics reset for %s."
  stats-invalid-player: "&cInvalid player name."
  stats-invalid-uuid: "&cCould not get UUID for: %player%"
  stats-increment: " %statType% incremented for: %player% (Total: %value%)"
  # NPC and Hologram Management
  npc-selected: "&aYou have selected NPC: %s"
  no-npc-nearby: "&cNo nearby NPC found."
  no-npc-selected: "&cNo NPC selected."
  selected-npc-not-found: "&cSelected NPC not found or has been removed."
  npc-and-hologram-removed: "&aNPC and hologram removed successfully."
  no-npc-skin: "&cNo skin available for NPC."
  error-setting-npc: "Error setting up NPC:"
  hologram-updated: "&aHologram updated successfully."
  no-data-available: "&cNo data available to update."
  
  # ️ System Configuration
  config-reloaded: "&aConfiguration reloaded."
  data-reloaded: "&aData reloaded."
  plugin-enabled: "&aFFTop has been enabled successfully."
  plugin-error: "&cError enabling FFTop."
  data-saved-automatically: "&aData saved automatically."
  stats-file-not-found: "&cStatistics file not found."
  stats-loaded: "&aStatistics loaded successfully."
  stats-saved: "&aStatistics saved successfully."
  stats-save-error: "&cError saving statistics: %error%"
  
  # Leaderboard Messages
  leaderboard-title: "&6=== General Ranking ==="
  leaderboard-entry: "&e%player%: &f%value%"
  
  # Location and World Errors
  invalid-serialized-location: "&cInvalid serialized location: null or empty."
  invalid-location-format: "&cInvalid serialized location format: %location%"
  invalid-world: "&cWorld not found: %world%"
  
  # ============================================
  # Hologram Configuration
  # ============================================
  hologram:
  initial-height: 0 # Optimal height adjustment for better visibility
  lines:
  - "&6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
  - "&e&l%player%"
  - "&7➟ &6Position: &f#%position%"
  - "&7➟ &aScore: &f%value%"
  - "&b✧･ﾟ: *✧ Top &c%type% &bPlayer ✧*:･ﾟ✧"
  - "&6▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬"
  
  # ============================================
  # Menu Configuration
  # ============================================
  menu:
  titles:
  kills: "&cTop Killers"
  deaths: "&4Top Deaths"
  blocks: "&6Top Miners"
  item-statistic: "&eStatistic "
  next-page: "&aNext Page"
  filler:
  material: "GRAY_STAINED_GLASS_PANE" # Do not change if you want to keep the gray background
  name: " "
  
  # ============================================
  # Log Configuration
  # ============================================
  logs:
  enabled: true # Enable (true) or disable (false) plugin logs
  
  Cambia los mensajes que el plugin envía al chat para mayor personalización.
  
  Ajustar la altura de los hologramas sobre los NPCs
  
  hologram:
  initial-height: 1.5 # Ajusta la altura del holograma sobre el NPC
  
  Si los hologramas aparecen muy altos o bajos, este ajuste te ayudará.
  
  Modificar el contenido de los hologramas
  
  hologram:
  lines:
  - "&6=== Estadísticas ==="
  - "&eJugador: %player%"
  - "&aRanking: %position%"
  - "&bPuntos: %valor%"
  
  Personaliza los textos de los hologramas que aparecen sobre los NPCs.
  
  Configurar los títulos de los menús de clasificación
  
  menú:
  Títulos:
  mata: "&cTop Asesinos"
  muertes: "&4Top Muertes"
  bloques: "&6Top Mineros"
  
  Define el título que verán los jugadores cuando abran un menú de estadísticas.
  
  Personalizar el relleno de los menús
  
  menú:
  relleno:
  Material: "GRAY_STAINED_GLASS_PANE"
  Nombre: " "
  
  Cambia el material de los espacios vacíos en los menús.
  
  Ajustar el intervalo de actualización automática de datos
  
  intervalo de actualización: 10
  
  Controla cada cuántos segundos se actualizan los datos de los NPCs.
  
  Configurar el formato del leaderboard
  
  Mensajes:
  title-leaderboard: "&6=== Clasificación General ==="
  entrada en la tabla de clasificación: "&e%jugador%: &f%valor%"
  
  Personaliza el formato en que se muestra la tabla de clasificación en el chat.
  
  Eliminar registros innecesarios en consola
  
  trozas:
  Habilitado: falso
  
  Si no quieres ver mensajes del plugin en la consola, puedes desactivarlos