Documentación oficial / v2026.10

Tu servidor,
paso a paso.

Plugins, server.jar, mapas, Geyser y terminal. Guías oficiales de VinzyCDeveloper con comandos listos para copiar y respuestas que sí resuelven.

  • Acceso libre, sin cuenta
  • Comandos listos para copiar
  • Actualizado el 23 oct 2026
00 Antes de empezar 5 minutos

Requisitos y ruta rápida #

No necesitas una cuenta ni un plan para leer esta documentación. Solo tu servidor, acceso a los archivos y estas cuatro comprobaciones.

Java correcto

Java 21 para Minecraft 1.20.5 o superior. Para 1.18–1.20.4, Java 17. Compruébalo con java -version.

RAM suficiente

2 GB para empezar; 4–8 GB si usarás plugins, Geyser y varios jugadores. Deja margen al sistema operativo.

Archivos a mano

Administrador de archivos de Crafty, SFTP o SSH. Necesitarás subir jars y editar archivos .yml.

Puertos claros

25565/TCP para Java. 19132/UDP para Bedrock con Geyser. Abre solo lo que uses.

Si usas VinzyCHosting, la consola, el administrador de archivos y los backups ya están en tu panel Crafty. Si estás en un VPS, asegúrate de tener acceso SSH y una carpeta dedicada al servidor.

01 Plugins 6 pasos · 10 min Paper · Purpur · Spigot

Cómo instalar plugins #

Los plugins añaden funciones sin modificar el cliente: permisos, economía, protección, minijuegos y mucho más. Esta guía usa Paper y Purpur como referencia.

  1. 01

    Confirma que tu software acepta plugins

    Paper, Purpur, Spigot y Bukkit cargan plugins desde la carpeta /plugins. Vanilla no los admite. Fabric y Forge usan mods en /mods, no plugins.

    Si tu servidor actual es Vanilla y quieres plugins, necesitas cambiar de software antes de seguir. No mezcles jars de softwares distintos.

  2. 02

    Detén el servidor correctamente

    No instales nada con el servidor encendido. Ejecuta este comando en la consola de Minecraft y espera a que termine de guardar.

    Consola de Minecraft
    stop

    No cierres la ventana ni mates el proceso. El servidor necesita guardar el mundo y los plugins; interrumpirlo puede corromper datos.

  3. 03

    Descarga una versión compatible

    Busca el plugin en Modrinth, Hangar o en la página oficial del proyecto. Descarga el .jar, no el código fuente.

    • La versión del plugin debe coincidir con tu versión de Minecraft.
    • Comprueba si pide una versión mínima de Java o de Paper.
    • Lee las dependencias antes de instalarlo: puede necesitar Vault u otro plugin.

    No instales jars de fuentes desconocidas. Un plugin se ejecuta dentro de tu servidor y puede acceder a sus archivos. Usa repositorios con reputación.

  4. 04

    Sube el jar a /plugins

    Desde el administrador de archivos de Crafty, arrastra el .jar a la carpeta /plugins. También puedes hacerlo por SFTP o terminal:

    Terminal local
    scp NombreDelPlugin.jar usuario@tu-servidor:/srv/minecraft/plugins/

    Cambia usuario, tu-servidor y la ruta por los datos reales de tu servidor. El archivo debe quedar directamente en plugins/, no dentro de una subcarpeta.

  5. 05

    Inicia y revisa la consola

    Arranca el servidor y observa los primeros segundos del log. El plugin generará su carpeta de configuración si todo ha ido bien.

    Consola de Minecraft
    plugins

    Si aparece en rojo o con errores como Unsupported API version, la versión no coincide. Revisa logs/latest.log para ver el motivo exacto.

  6. 06

    Configura y reinicia

    La mayoría de plugins crea su configuración en /plugins/NombreDelPlugin/. Edita con cuidado los archivos .yml: la indentación importa.

    Después de cambiar una configuración, detén el servidor y vuelve a arrancarlo. Evita /reload: puede dejar plugins, listeners y tareas en un estado inconsistente.

Checklist final

  • El .jar está en /plugins.
  • La versión es compatible con tu Minecraft.
  • No hay errores nuevos en logs/latest.log.
  • Tienes una copia del mundo y de /plugins.
02 Arranque 6 pasos · 15 min Java 21

Cómo crear server.jar #

Vamos a dejar un servidor funcional con Paper, el software recomendado para empezar. El proceso sirve para cualquier versión moderna de Minecraft.

server.jar no se programa desde cero. Es el ejecutable de tu servidor. Descargas el jar de Paper y lo renombras; el resto de esta guía es preparar Java, aceptar el EULA y crear un script de arranque limpio.

  1. 01

    Instala Java 21

    Comprueba qué versión tienes instalada. Para Minecraft 1.20.5 o superior necesitas Java 21 como mínimo.

    Terminal
    java -version

    Si no aparece Java 21 o superior, instálalo. En Ubuntu o Debian:

    Linux · Ubuntu / Debian
    sudo apt update
    sudo apt install openjdk-21-jre-headless

    En Windows, descarga una distribución de Java 21, como Eclipse Temurin, y verifica que java funciona en una terminal nueva.

  2. 02

    Crea una carpeta para el servidor

    Todo el servidor vivirá en una carpeta propia. No uses el escritorio ni una carpeta compartida con otros archivos.

    Terminal
    mkdir -p ~/minecraft-server
    cd ~/minecraft-server
  3. 03

    Descarga el jar y renómbralo

    Entra en papermc.io/downloads/paper, elige tu versión de Minecraft y descarga la build más reciente. Sube el archivo a la carpeta y renómbralo a server.jar.

    Terminal
    ls -lh
    mv paper-*.jar server.jar

    Si tu archivo tiene otro nombre, ajusta el comando. Lo importante es que dentro de la carpeta exista un archivo llamado exactamente server.jar.

  4. 04

    Primer arranque y EULA

    Ejecuta el servidor una vez. Se generarán los archivos iniciales y el proceso se detendrá pidiéndote aceptar el EULA de Minecraft.

    Terminal
    java -Xms2G -Xmx4G -jar server.jar nogui

    Abre eula.txt, lee el acuerdo en minecraft.net/eula y cambia la línea a:

    eula.txt
    eula=true

    Aceptar el EULA es tu responsabilidad. Hazlo solo si estás de acuerdo con los términos de Minecraft.

  5. 05

    Crea un script de arranque

    Un script evita escribir el comando cada vez y deja claro desde qué carpeta se inicia el servidor. En Linux:

    start.sh
    #!/usr/bin/env bash
    cd "$(dirname "$0")"
    exec java -Xms4G -Xmx4G -jar server.jar nogui
    Terminal
    chmod +x start.sh
    ./start.sh

    En Windows, crea start.bat con este contenido y ejecútalo con doble clic:

    start.bat
    @echo off
    cd /d "%~dp0"
    java -Xms2G -Xmx4G -jar server.jar nogui
    pause

    Ajusta la RAM a tu servidor. -Xms es la memoria inicial y -Xmx la máxima. Deja 1–2 GB libres para el sistema; no asignes el 100 % del host.

  6. 06

    Comprueba que arranca y acepta conexiones

    Busca la línea Done (8.421s)! en la consola. Significa que el servidor está listo. Conéctate a localhost:25565 si juegas en la misma máquina o a IP:25565 desde fuera.

    Si no conecta, revisa server-port en server.properties y que el puerto 25565/TCP esté abierto en tu host o panel.

    ¿Usas Fabric o Forge? El concepto es el mismo, pero el instalador genera otro archivo de arranque. En Fabric suele ser fabric-server-launch.jar; en Forge, el instalador deja sus propios scripts. Usa el jar que corresponda.

Checklist final

  • java -version muestra Java 21 o superior.
  • Existe server.jar en la carpeta del servidor.
  • El EULA está aceptado y el servidor muestra Done.
  • Tienes un script de arranque y un backup inicial.
03 Mapas 6 pasos · 20 min Mundo nuevo · Importado

Cómo crear un mapa #

Puedes generar un mundo nuevo o importar un mapa descargado. La clave está en level-name y en no mover archivos con el servidor encendido.

  1. 01

    Detén el servidor y guarda una copia

    Los mundos se escriben en disco mientras el servidor está encendido. Detenlo con stop desde la consola y espera a que cierre del todo.

    Nunca borres ni reemplaces un mundo en caliente. Haz una copia de world, world_nether y world_the_end antes de tocar nada.

  2. 02

    Opción A: genera un mundo nuevo

    Edita server.properties y ajusta estas claves. El nombre debe ser nuevo para que el servidor no reutilice el mundo anterior.

    server.properties
    level-name=mundo
    level-seed=
    level-type=minecraft\:normal
    generate-structures=true
    gamemode=survival

    Deja level-seed vacío para una semilla aleatoria. Si quieres reproducir un mundo, escribe la semilla numérica. Arranca el servidor y espera a que genere el terreno.

  3. 03

    Opción B: importa un mapa descargado

    Sube la carpeta del mapa al directorio del servidor. Dentro debe estar level.dat directamente, sin una carpeta extra en medio.

    Después apunta level-name al nombre exacto de esa carpeta:

    server.properties
    level-name=mi-mapa

    Comprueba la estructura antes de arrancar:

    Terminal
    ls /srv/minecraft/mi-mapa/level.dat

    Si ese comando devuelve «No such file», mueve el contenido de la carpeta anidada un nivel arriba.

  4. 04

    Pre-genera el terreno (recomendado)

    Instala Chunky como cualquier otro plugin y ejecuta estos comandos desde la consola. Empieza con un radio pequeño.

    Consola de Minecraft · Chunky
    chunky radius 1000
    chunky start
    chunky progress

    Pre-generar consume CPU. Hazlo fuera de horas punta y aumenta el radio poco a poco. Un radio de 1000 cubre 2000 × 2000 bloques alrededor del origen.

  5. 05

    Ajusta el spawn y las reglas del mundo

    Entra como operador y decide dónde aparece la gente. Para un lobby o un hub, estas reglas ayudan a mantenerlo estable:

    En el juego · operador
    /setworldspawn
    /gamerule doDaylightCycle false
    /gamerule doWeatherCycle false
    /gamerule doMobSpawning false

    /setworldspawn usa tu posición actual. En un survival normal, no desactives el ciclo de día ni el spawn de mobs.

  6. 06

    Verifica y reinicia

    Conéctate, revisa el spawn, los chunks y la consola. Si el mundo se ve vacío o el servidor crea otra carpeta, el level-name no coincide con la carpeta real.

    No uses el mismo nombre para resetear. Cambiar level-name a uno nuevo genera otro mundo; el anterior sigue ocupando espacio. Borra solo con una copia de seguridad en mano.

Checklist final

  • level-name coincide con la carpeta del mundo.
  • Existe level.dat dentro de esa carpeta.
  • El spawn y las reglas están configurados.
  • Hay una copia del mundo anterior.
04 Bedrock 7 pasos · 15 min Geyser + Floodgate

Cómo configurar Geyser #

Geyser traduce el protocolo Bedrock a Java para que entren jugadores de móvil, consola y Windows. Necesitas el plugin, un puerto UDP libre y una configuración bien apuntada.

  1. 01

    Comprueba los requisitos

    • Un servidor Java funcionando en Paper, Purpur o Spigot.
    • El puerto UDP 19132 libre y abierto en el firewall.
    • Acceso a /plugins para subir Geyser y editar su configuración.

    Geyser evoluciona con las versiones de Minecraft y Bedrock. Antes de instalarlo, consulta la compatibilidad en geysermc.org/download.

  2. 02

    Instala Geyser-Spigot

    Detén el servidor. Descarga Geyser-Spigot desde la página oficial y sube el .jar a /plugins. Arranca el servidor una vez para que se genere la carpeta de configuración y vuelve a detenerlo.

    La configuración aparece en /plugins/Geyser-Spigot/config.yml. Si usas una versión standalone o de otro software, la ruta puede cambiar; revisa el log al arrancar.

  3. 03

    Edita config.yml

    Abre el archivo y deja estos valores como base. Respeta la indentación de YAML: dos espacios, sin tabulaciones.

    config.yml
    bedrock:
      address: 0.0.0.0
      port: 19132
    
    remote:
      address: 127.0.0.1
      port: 25565
      auth-type: online
    • bedrock.port: el puerto UDP donde escucharán los jugadores de Bedrock.
    • remote.address: 127.0.0.1 si Geyser y Java están en la misma máquina; si no, la IP privada del servidor Java.
    • remote.port: el puerto del servidor Java, normalmente 25565. No pongas 19132 aquí.

    No confundas los puertos. Bedrock entra por UDP 19132; Geyser se conecta internamente al puerto Java 25565.

  4. 04

    Abre UDP 19132 en el firewall

    El puerto TCP de Java no sirve para Bedrock. Abre UDP 19132 en el firewall del sistema y en el panel de tu proveedor si lo hay.

    Linux · ufw
    sudo ufw allow 19132/udp

    En Windows, crea una regla de entrada UDP 19132 en el Firewall de Windows Defender. En un panel de hosting, busca la sección de puertos o firewall adicional.

  5. 05

    Reinicia y revisa el log

    Arranca el servidor y busca el mensaje de Geyser escuchando en 0.0.0.0:19132. Si no aparece, revisa /plugins/Geyser-Spigot/logs/latest.log.

    Los errores de YAML suelen ser problemas de indentación; los de puerto, un firewall o un proceso ocupando 19132.

  6. 06

    Conecta desde Bedrock

    En Minecraft Bedrock, añade un servidor con la IP pública de tu servidor y el puerto 19132. En consola o móvil usa la opción Añadir servidor; no necesitas ningún mod en el cliente.

    Si tu servidor usa un dominio, puedes usar el dominio en lugar de la IP. El puerto sigue siendo 19132 salvo que lo hayas cambiado en bedrock.port.

  7. 07

    Opcional: añade Floodgate

    Sin Floodgate, un jugador de Bedrock necesita vincular una cuenta Java. Floodgate permite que entren usando su cuenta de Bedrock.

    Descarga Floodgate-Spigot, súbelo a /plugins, reinicia y ajusta la autenticación de Geyser:

    config.yml
    remote:
      auth-type: floodgate

    Revisa los permisos. Floodgate identifica a los jugadores de Bedrock con un prefijo (por defecto, un punto). Configura tus permisos y zonas protegidas para ese formato.

No conecta

Revisa UDP 19132

El puerto debe estar abierto en el firewall y en el panel. Prueba desde otra red y confirma la IP pública.

Pide cuenta Java

Falta Floodgate

Instala Floodgate o vincula la cuenta Java del jugador. Después, configura auth-type.

Java no entra

Puerto remoto incorrecto

remote.port debe apuntar al puerto Java (25565), no al de Bedrock.

Error de versión

Actualiza Geyser

Las versiones de Java y Bedrock cambian. Descarga la build compatible más reciente y revisa el log.

Checklist final

  • Geyser carga sin errores en el log.
  • UDP 19132 está abierto.
  • Bedrock entra y el chat funciona.
  • Floodgate está configurado si lo usas.
05 Terminal Linux · Windows Copiar y pegar

Terminal sin miedo #

Los comandos que de verdad se usan, sin rodeos. Los ejemplos asumen Linux y un servidor en ~/minecraft-server; abajo tienes las variantes de Windows.

Dos consolas distintas. Los comandos que empiezan por / se escriben en la consola de Minecraft. Los que empiezan por sudo, cd o java se escriben en la terminal del sistema.

Arranca el servidor y no lo pierdas

Si cierras la terminal, el proceso puede detenerse. Usa screen para dejarlo en segundo plano y volver cuando quieras.

Linux · screen
screen -S minecraft
cd ~/minecraft-server
./start.sh
# Salir sin apagar: Ctrl + A, luego D
screen -r minecraft

También puedes usar tmux o crear un servicio systemd si quieres que el servidor arranque solo con la máquina.

Ver errores en vivo

Linux

Sigue el log mientras ocurre un fallo, sin cerrar la terminal.

Terminal
tail -f logs/latest.log

Comprobar la RAM

Linux

Antes de subir -Xmx, mira cuánta memoria libre tiene el sistema.

Terminal
free -h

Ver quién usa el puerto

Linux

Si el servidor dice que el puerto está ocupado, localiza el proceso.

Terminal
ss -tulpn | grep :25565

Dar permisos al script

Linux

Si ./start.sh responde «Permission denied», marca el archivo como ejecutable.

Terminal
chmod +x start.sh

En Windows, inicia con .\\start.bat, revisa el puerto con netstat -ano | findstr :25565 y sigue el log con Get-Content logs/latest.log -Wait desde PowerShell.

Backup seguro, paso a paso

Copiar el mundo mientras el servidor lo escribe puede dejarlo inconsistente. Primero pausa la escritura y fuerza el guardado desde la consola de Minecraft:

Consola de Minecraft
save-off
save-all flush

Ahora crea el archivo comprimido desde la terminal del sistema:

Terminal
tar -czf backups/mundo-$(date +%F-%H%M).tar.gz world world_nether world_the_end

Por último, vuelve a activar el guardado desde la consola:

Consola de Minecraft
save-on
06 Respuestas Filtra por tema

Preguntas frecuentes #

Las dudas que aparecen una y otra vez, incluidas las que empiezan con un error en la terminal. Si algo no está aquí, busca arriba por palabra clave.

24 respuestas

Minecraft 1.20.5 y posteriores necesitan Java 21. Las versiones 1.18–1.20.4 funcionan con Java 17. Comprueba con java -version; si aparece una versión anterior, actualiza antes de arrancar.

Para Paper con pocos plugins, 2–4 GB suele ser suficiente. Para 10–20 jugadores, plugins y Geyser, apunta a 6–8 GB. Deja 1–2 GB libres para el sistema operativo y no pongas en -Xmx toda la RAM del host.

Empieza con Paper: es rápido, estable y compatible con la mayoría de plugins. Purpur añade opciones extra de configuración; Spigot es la base clásica. Para mods, usa Fabric, Forge o NeoForge. Elige uno y no mezcles jars de softwares distintos.

Sí, pero no suele valer la pena para empezar. Paper publica jars listos para usar. Si quieres compilar Spigot, necesitas BuildTools y Java; para casi todos los casos, descargar Paper y renombrarlo a server.jar es la opción correcta.

No. Vanilla no tiene una API de plugins; Fabric y Forge cargan mods desde /mods. Si necesitas plugins, usa Paper, Purpur o Spigot.

Verifica que sea un .jar, que esté directamente en /plugins, que sea compatible con tu versión y que hayas reiniciado el servidor. Busca el nombre del plugin en logs/latest.log: ahí aparece el error exacto.

Detén el servidor, guarda una copia de /plugins y del mundo, reemplaza el .jar por la nueva versión compatible y arranca. Revisa el log por si el plugin migra su configuración. Si algo falla, vuelve al jar anterior.

Evita /reload. Recarga plugins en caliente y puede dejar listeners, tareas y configuraciones en un estado inconsistente. Para cambios de configuración, detén y arranca el servidor; para permisos, usa los comandos de tu plugin.

Son plugins que otro plugin necesita para funcionar, como Vault o una librería de economía. Deben estar en /plugins y ser compatibles con tu versión. Si falta una, el log lo indica al arrancar.

Detén el servidor, sube la carpeta del nuevo mundo y cambia level-name en server.properties al nombre exacto de esa carpeta. Dentro debe existir level.dat. Haz una copia del mundo anterior antes de tocar nada.

Normalmente la carpeta tiene un nivel de más (por ejemplo, mi-mapa/mi-mapa/level.dat). Mueve el contenido para que level.dat quede directamente dentro de la carpeta que indica level-name, y reinicia.

Instala Chunky, ejecuta chunky radius 1000 y después chunky start desde la consola. Revisa el progreso con chunky progress. Hazlo fuera de horas punta: consume CPU.

UDP 19132 por defecto. El 25565/TCP es el puerto Java; Geyser escucha en 19132 y se conecta internamente al servidor Java.

Comprueba que Geyser arrancó, que UDP 19132 está abierto en el firewall, que tus amigos usan la IP y el puerto correctos y que no hay un error de versión en el log. Si pide cuenta Java, instala Floodgate.

No. Sin Floodgate, un jugador de Bedrock necesita una cuenta Java vinculada. Con Floodgate puede entrar usando su cuenta de Bedrock. Instálalo en el servidor Java y configura auth-type: floodgate en Geyser.

Usa screen o tmux, o configura un servicio systemd. En screen: inicia con screen -S minecraft, arranca el servidor y sal con Ctrl+A y D. Vuelve con screen -r minecraft.

Java no está instalado o no está en el PATH. Instala Java 21, cierra y abre de nuevo la terminal y comprueba con java -version. En Windows, revisa que la carpeta bin de tu JDK esté en las variables de entorno.

Otro proceso está usando el puerto. En Linux ejecuta ss -tulpn | grep :25565; en Windows, netstat -ano | findstr :25565. Detén el proceso que lo ocupa o cambia server-port en server.properties y reinicia.

El servidor se compiló para una versión de Java más nueva que la que estás usando. Actualiza a Java 21 (o la versión que pida tu servidor) y arranca con esa versión; java -version debe coincidir.

El servidor no completa los ticks a tiempo. Revisa CPU y RAM, reduce view-distance, pre-genera el mundo, limita entidades y granjas y usa Paper. Más RAM no arregla una CPU saturada.

En la consola, ejecuta save-off y save-all flush; luego copia world, world_nether y world_the_end con tar; al terminar, ejecuta save-on. No copies el mundo en caliente sin hacer flush.

La terminal no encuentra server.jar: estás en otra carpeta o el archivo tiene otro nombre. Entra en la carpeta del servidor con cd, comprueba con ls -lh y usa el nombre exacto en el comando.

El primer arranque crea eula.txt y se detiene. Abre el archivo, cambia eula=false por eula=true y arranca de nuevo. Hazlo solo si aceptas el EULA de Minecraft.

Ejecuta tail -f logs/latest.log desde otra terminal. En Crafty, abre la consola del servidor. Para filtrar errores: grep -i error logs/latest.log | tail -n 50.