Servidores de Minecraft con el plugin HolographicDisplays

## 🔌 Acerca de Holographic Displays Holographic Displays es un plugin de Minecraft que proporciona hologramas flotantes persistentes capaces de mostrar texto e ítems. El plugin incluye comandos dentro del juego para crear y editar hologramas y ofrece una API para desarrolladores para integrarlos en otros plugins. ## 🎯 Propósito El plugin resuelve la necesidad de mostrar información flotante, etiquetas, menús y elementos visuales en el mundo sin crear entidades visibles permanentes. Es útil para la administración del servidor, mostradores estéticos, menús dentro del mundo e integraciones en las que los plugins necesitan presentar datos a los jugadores en ubicaciones fijas. ## ⚙️ Funciones - Crear y eliminar hologramas con nombre en ubicaciones específicas. - Añadir, eliminar, establecer e insertar líneas de texto en los hologramas. - Mostrar ítems flotantes como líneas de holograma (compatibilidad con ítems flotantes). - Leer líneas de un archivo de texto dentro de un holograma. - Leer y renderizar imágenes en un holograma desde un archivo o URL (con mapeo de símbolos y anchura máxima configurables). - Alinear, mover, copiar y teletransportarse a hologramas. - Recargar la configuración del plugin y los hologramas guardados sin editar archivos manualmente. - API para desarrolladores disponible para que otros plugins creen y gestionen hologramas de forma programática. ## 🧩 Para quién es - Administradores de servidores que quieren mostradores visuales dentro del mundo (servidores SMP, Survival, Minigame). - Desarrolladores de plugins que necesitan una API para mostrar texto/ítems a los jugadores en el mundo. - Equipos de staff que usan hologramas para señales, menús o paneles informativos. ## 🏗️ Casos de uso de ejemplo - Un minijuego muestra las puntuaciones actuales sobre cada arena usando hologramas. - Un lobby del servidor muestra las reglas y los ítems para teletransportarse al hacer clic como líneas flotantes. - Una integración de plugin publica estadísticas dinámicas de los jugadores en un holograma en una ubicación fija. ## ⌨️ Comandos | **Comando** | **Descripción** | **Permiso** | **Acceso** | |---|---|---:|:---| | `/hd` | Comando principal; muestra información del plugin y la versión. | ninguno (accesible para todos) | Jugador | | `/hd help` | Muestra los comandos disponibles y una ayuda breve. | ninguno (accesible para todos) | Jugador | | `/hd create <hologramName> [text]` | Crea un nuevo holograma en tu ubicación. | `holographicdisplays.create` | Admin | | `/hd delete <hologram>` | Elimina un holograma con nombre. | `holographicdisplays.delete` | Admin | | `/hd list [page]` | Lista los hologramas y ubicaciones existentes. | `holographicdisplays.list` | Admin | | `/hd near <radius>` | Lista hologramas cercanos a ti dentro del radio. | `holographicdisplays.near` | Admin | | `/hd teleport <hologram>` | Teletranspórtate a la ubicación de un holograma. | `holographicdisplays.teleport` | Admin | | `/hd align <axis> <hologram> <reference>` | Alinea un holograma con otro en un eje específico. | `holographicdisplays.align` | Admin | | `/hd movehere <hologram>` | Mueve un holograma a tu posición. | `holographicdisplays.movehere` | Admin | | `/hd edit <hologram>` | Abre las opciones de edición de un holograma. | `holographicdisplays.edit` | Admin | | `/hd addline <hologram> <text>` | Añade una línea de texto a un holograma. | `holographicdisplays.addline` | Admin | | `/hd removeline <hologram> <number>` | Elimina una línea numerada de un holograma. | `holographicdisplays.removeline` | Admin | | `/hd setline <hologram> <number> <newText>` | Cambia el texto de una línea específica. | `holographicdisplays.setline` | Admin | | `/hd insertline <hologram> <number> <text>` | Inserta una línea después del índice indicado. | `holographicdisplays.insertline` | Admin | | `/hd info <hologram>` | Muestra el contenido del holograma con números de línea. | `holographicdisplays.info` | Admin | | `/hd copy <from> <to>` | Copia el contenido de un holograma a otro. | `holographicdisplays.copy` | Admin | | `/hd readtext <hologram> <file>` | Lee líneas de un archivo dentro de un holograma. | `holographicdisplays.readtext` | Admin | | `/hd readimage <hologram> <image> <width> [-a]` | Renderiza una imagen en el holograma desde un archivo o URL. | `holographicdisplays.readimage` | Admin | | `/hd reload` | Recarga la configuración y los hologramas guardados. | `holographicdisplays.reload` | Admin | Nota: la documentación indica que cada subcomando tiene un permiso individual (por ejemplo, `/hd list` requiere `holographicdisplays.list`). El comando principal `/hd` está accesible para todos. ## 🔐 Permisos | **Permiso** | **Descripción** | **Predeterminado** | |---|---|---:| | `holographicdisplays.<subcommand>` | Permiso individual para cada subcomando de `/hd` (ejemplo: `holographicdisplays.list`). | no especificado | | `holographicdisplays.update` | Recibir notificaciones de actualización al entrar si está habilitado en la configuración. | no especificado | | `holographicdisplays.*` | Otorga todos los permisos de holographicdisplays (si lo admite el plugin de permisos). | no especificado | ## ⚙️ Instalación ### 📥 Configuración - Descarga el JAR oficial del plugin desde un catálogo de confianza. - Coloca el JAR en el directorio `plugins/` del servidor para Bukkit/Spigot. - Reinicia el servidor y revisa la consola para confirmar que el plugin se ha cargado. ### 📦 Dependencias - No se indican dependencias obligatorias en el resumen oficial de la documentación; verifica la página de descarga para posibles integraciones opcionales al instalar. ### 🧾 Configuración - El plugin admite archivos de configuración y hologramas guardados; usa el comando de recarga proporcionado para aplicar los cambios después de editar los archivos. - El renderizado de imágenes y el mapeo de símbolos se pueden configurar desde la configuración del plugin. ## 🧠 Notas técnicas - La documentación oficial incluye una guía de actualización para Minecraft 1.13+ sobre cambios en los nombres de materiales y en el manejo de imágenes/iconos. - Se documenta una API para desarrolladores para integraciones con otros plugins. ## 🤝 Cuándo es útil este plugin Si necesitas mostradores persistentes y editables dentro del mundo para información, menús o integraciones de plugins, Holographic Displays ofrece hologramas con nombre, importación de archivos/imágenes y una API para que otros plugins puedan crear y actualizar hologramas de forma fiable.

Plugins