Cómo usar ImageOnMap en un server de Minecraft

Descripción general

Las builds de Minecraft ya tienen pinturas, letreros, banners, plantas y muchas otras opciones de decoración. ImageOnMap agrega una opción más directa: convertir una imagen en línea en un mapa dentro del juego y luego colocarla en item frames. Puede ser arte personalizado, el logo de un server, un diagrama para el lobby de un minigame o una imagen que definitivamente no debió ocupar doce item frames, pero de algún modo lo hizo.

ImageOnMap funciona en software de server basado en plugin, como Spigot, Paper, Purpur y forks similares. Después de instalarlo, los jugadores pueden ejecutar comandos que toman una URL de imagen y la convierten en uno o más mapas. Las imágenes más grandes se pueden dividir en varios mapas, lo que te permite crear exhibiciones del tamaño de una pared cuando un solo mapa es demasiado pequeño.

Esta guía cubre cómo descargar ImageOnMap, instalarlo mediante el panel de tu server, crear mapas desde URLs de imágenes, administrar mapas guardados, ajustar permisos, cambiar settings de configuración y solucionar problemas comunes.

Descargar ImageOnMap

1. Abre la página del plugin ImageOnMap en Spigot.
2. Haz clic en Download Now cerca de la parte superior derecha de la página.

1. Guarda el `.jar` del plugin en un lugar fácil de encontrar, como tu escritorio o carpeta de descargas.

Usa una build del plugin que coincida con tu versión de Minecraft. Los servers en Minecraft 1.17 y versiones más recientes generalmente deben usar la release más reciente disponible de ImageOnMap. Los servers de Minecraft 1.14 a 1.16 necesitan la build 4.1, Minecraft 1.13 necesita 4.0-pre1 y los servers más antiguos pueden requerir 3.1 para tener soporte adecuado. Para encontrar esos archivos anteriores, usa la sección Version History en la página del plugin y descarga la release correspondiente.

Instalar el plugin

Antes de subir ImageOnMap, asegúrate de que tu server esté usando Spigot, Paper, Purpur u otro tipo de server compatible con plugin. Vanilla Minecraft no carga plugins estilo Bukkit. En el panel de tu server, elige el tipo de server y la versión de Minecraft que quieres, luego reinicia una vez para que el server pueda generar sus carpetas.

Después de que existan los archivos del server, instala ImageOnMap con estos pasos:

1. Abre tu panel de server y ve al administrador de archivos o FTP.

1. Ingresa tu contraseña y luego inicia sesión.

1. Abre la carpeta `plugins`.
2. Haz clic en Upload y arrastra el archivo `.jar` de ImageOnMap al área de carga.

1. Espera hasta que la carga llegue al 100 por ciento.
2. Regresa a la página principal del server y reinicia el server.

Cuando termine el reinicio, ImageOnMap debería crear su propia carpeta de plugin y cargar sus settings predeterminados.

Primer uso

De forma predeterminada, ImageOnMap está diseñado para que los jugadores puedan empezar a crear mapas con imágenes rápidamente. En muchas configuraciones, los jugadores estándar pueden usar los comandos principales de inmediato. Si tu server necesita un control más estricto, como permitir que solo el staff cree o elimine mapas, configura permisos con un plugin como LuckPerms.

Antes de ejecutar comandos, prepara una URL directa de imagen. ImageOnMap necesita un enlace al archivo de imagen en sí, no a una página web que contenga la imagen. Los buenos enlaces normalmente terminan en `.png`, `.jpg` o `.jpeg`. Evita formatos no compatibles como `.webp` y evita enlaces extremadamente largos con cadenas de seguimiento adicionales siempre que sea posible.

Elegir una URL de imagen válida

Encuentra la imagen que quieres colocar en un mapa y luego copia su URL directa de archivo. Si creaste la imagen tú mismo, súbela a un servicio que proporcione enlaces directos de imagen. Imgur y hosts de imágenes similares son opciones comunes, aunque cualquier host confiable puede funcionar si la URL apunta directamente a un archivo de imagen compatible.

Si un comando falla, la URL es una de las primeras cosas que debes revisar. Un enlace que termina en una extensión de archivo válida es un candidato mucho mejor que una URL larga de página llena de símbolos, redirecciones y parámetros misteriosos.

Crear mapas con imágenes

ImageOnMap ofrece dos estilos de comando comunes:

• `/tomap [URL] [resize]`
• `/maptool new [URL] [resize]`

Para Minecraft 1.17 y versiones más recientes, `/maptool new` suele ser la mejor opción. Ambos comandos usan la misma idea básica: proporcionar la URL de la imagen y luego definir qué tan grande debe ser la exhibición del mapa.

Por ejemplo:

`/maptool new https://example.com/image.png resize 1 1`

Eso crea una versión de la imagen en un solo mapa. La parte `resize 1 1` significa que el resultado debe caber en un solo mapa. Para exhibiciones más grandes, aumenta los números:

`/maptool new https://example.com/image.png resize 4 4`

Eso crea una exhibición de mapas de 4 por 4, que requiere 16 item frames. Las exhibiciones más grandes pueden verse más nítidas, pero también usan más item frames y más datos de mapas. Usa tamaños grandes con cuidado en servers concurridos, ya que una pared gigante de mapas puede afectar el rendimiento en zonas llenas.

ImageOnMap también admite modos de cambio de tamaño como `resize-stretched` y `resize-covered`. Estos pueden ayudar con ciertas formas de imagen, pero la opción normal `resize` suele ser más fácil de predecir.

Colocar y quitar exhibiciones

Después de generar un conjunto de mapas, coloca item frames con el mismo diseño que el tamaño de mapa que creaste. Para una exhibición de 3 por 3, coloca 9 item frames. Para una exhibición de 4 por 4, coloca 16 item frames.

Para aplicar la imagen, haz clic derecho en el item frame inferior izquierdo con el mapa generado. ImageOnMap debería llenar los item frames conectados con las piezas correctas de la imagen. Para quitar la exhibición, usa shift + clic izquierdo en el área del mapa.

Administrar mapas guardados

Usa `/maps` para abrir el menú de administración de ImageOnMap. Desde ahí, los jugadores pueden ver mapas guardados y seleccionar el que necesitan. Hacer clic derecho en una entrada de mapa muestra acciones adicionales, como renombrar, eliminar o tomar partes individuales de una imagen más grande.

Este menú es práctico, pero también es una razón para pensar en permisos. Si todos los jugadores pueden administrar todos los mapas, alguien podría quitar o renombrar exhibiciones que no debería controlar. No es un desastre técnico, pero puede convertirse en un dolor de cabeza administrativo con mejores gráficos.

Permisos y control de acceso

Los dueños de servers a menudo limitan ImageOnMap cuando los jugadores crean demasiadas exhibiciones o cuando los mapas se usan en builds protegidas. LuckPerms es una buena forma de controlar quién puede crear, administrar o eliminar mapas con imágenes.

Revisa la documentación de ImageOnMap o la página del plugin para conocer los nodos de permisos actuales de tu versión instalada. Luego asigna los permisos a grupos como owner, admin, builder o jugadores de confianza. Si quieres quitar el acceso predeterminado, deniega los nodos relevantes para jugadores regulares y concédelos solo a los grupos que deben usar el plugin.

Editar la configuración

Los settings de ImageOnMap se almacenan en su carpeta de plugin. Usa el archivo de configuración para ajustar límites como el tamaño de mapa, el comportamiento permitido y otras opciones del plugin. Sigue de cerca el formato YAML existente del archivo. YAML es delicado y se quejará del espaciado como si tuviera una tabla de seguimiento y mucho rencor.

1. Abre el administrador de archivos o FTP en el panel de server e inicia sesión.
2. Ve a `plugins/ImageOnMap`.

1. Busca `config.yml` y haz clic en Edit.

1. Haz tus cambios y luego haz clic en Save.

1. Reinicia el server para que se carguen los nuevos settings.

Problemas comunes

Si ImageOnMap no carga, primero confirma que el server esté usando Spigot, Paper, Purpur u otro tipo de server compatible con plugin. También revisa que la build del plugin coincida con tu versión de Minecraft. Un plugin hecho para versiones más recientes puede no funcionar correctamente en un server antiguo, y las builds antiguas pueden fallar en releases más nuevas.

Si el archivo del plugin se subió incorrectamente, elimina la carga fallida de la carpeta `plugins`, sube el `.jar` de nuevo, espera a que termine la transferencia y luego reinicia el server.

Si la generación de imágenes falla en el chat, revisa la URL. Debe apuntar directamente a un archivo de imagen compatible, como PNG o JPG. Elimina cadenas de consulta innecesarias cuando sea posible y confirma que el enlace pueda abrirse en un navegador sin iniciar sesión.

Si solo fallan las imágenes grandes, prueba primero con un valor de resize más pequeño. Una prueba de 1 por 1 o 2 por 2 puede confirmar si el plugin y la URL funcionan antes de crear una exhibición de pared mucho más grande. Para errores específicos de versión, cambia a la build de ImageOnMap recomendada para tu versión de Minecraft: 4.1 para 1.14 a 1.16, 4.0-pre1 para 1.13, 3.1 para versiones más antiguas o la release más reciente para servers modernos.

Enlaces útiles

• ImageOnMap en Spigot
• Cómo agregar plugins a un server de Minecraft
• Guía de configuración de LuckPerms
• Guía de operador de server de Minecraft