Introducción
Un servidor Paper Ubuntu es una instancia de Minecraft Java que utiliza Paper (PaperMC), una implementación compatible con Spigot/Bukkit optimizada para rendimiento y extensibilidad mediante plugins. En esta guía aprenderás qué requisitos necesitas (Java y hardware), cómo instalar Paper en Ubuntu, ejecutar y gestionar el servicio con systemd, abrir el puerto 25565 en el firewall, y buenas prácticas de rendimiento, backups y seguridad.
Requisitos previos
- Máquina con Ubuntu (preferible LTS) con al menos 2–4 GB RAM para pruebas; 6–12+ GB recomendado para servidores públicos.
- Acceso sudo/administrador al sistema.
- Conocimiento básico de la terminal y edición de archivos (nano/vi).
Compatibilidad Java según la versión de Paper
Paper exige una versión mínima de Java distinta según la rama: las líneas 1.20–1.21 requieren Java 21, mientras que las ramas 26.x (Paper 26.1+) ya requieren Java 25. Antes de instalar Java verifica la versión de Paper que vas a ejecutar para elegir el JDK adecuado. (docs.papermc.io
Elegir la versión de Paper
En la página de descargas de Paper elige la versión/versión de Minecraft que quieras (ej. 1.21.x vs 1.26.x). Si actualizas a Paper 26.x necesitarás Java 25; si usas la línea 1.20–1.21 necesitas Java 21. Elige la build «stable» o la última recomendada para tu mundo.
Instalar Java en Ubuntu (opciones verificadas)
Recomiendo usar una distribución LTS del JDK compatible con la versión requerida. Aquí tienes comandos verificados para Amazon Corretto 25; para Eclipse Temurin (Adoptium) la ruta habitual es instalar el paquete temurin-25-jdk si está disponible en tus repositorios.
Amazon Corretto 25 (ejemplo apt)
wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor -o /usr/share/keyrings/corretto-keyring.gpg && \
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt-get update
sudo apt-get install -y java-25-amazon-corretto-jdk
java -version
Con estos pasos añades el repositorio oficial de Corretto e instalas el paquete java-25-amazon-corretto-jdk. Verifica la salida con java -version para confirmar la instalación. (docs.aws.amazon.com
Eclipse Temurin (Adoptium)
Si prefieres Temurin, en sistemas con el repositorio configurado suele bastar con:
sudo apt update
sudo apt install -y temurin-25-jdk
java -version
Si el paquete no existe en tu sistema, sigue las instrucciones de instalación de Adoptium para añadir su repositorio antes de ejecutar apt install. (adoptium.net
Crear usuario y directorio del servidor (buena práctica)
Para reducir riesgos, crea un usuario sin privilegios y usa un directorio dedicado:
sudo useradd -r -m -U -d /srv/minecraft -s /bin/bash minecraft
sudo mkdir -p /srv/minecraft/server
sudo chown -R minecraft:minecraft /srv/minecraft
cd /srv/minecraft/server
Así el proceso del servidor no corre como root y los permisos quedan aislados.
Descargar paper.jar y primeros arranques
Descarga la JAR apropiada desde la página de descargas de Paper (elige la versión y build). Coloca el archivo en /srv/minecraft/server y nómbralo paper.jar (o usa el nombre original). Para generar los archivos iniciales ejecuta:
sudo -u minecraft java -jar paper.jar --nogui
En el primer arranque Paper creará varios archivos, incluida eula.txt. Tras este primer intento el servidor se detendrá hasta que aceptes la EULA.
Aceptar EULA
Edita eula.txt y cambia la línea:
eula=false
a
eula=true
Advertencia: aceptar la EULA significa que comprendes y aceptas los Términos de Mojang; no lo automatices en servidores públicos sin revisarlo.
Comando de inicio y flags JVM recomendados
Un arranque mínimo es:
sudo -u minecraft java -Xms1G -Xmx4G -jar paper.jar --nogui
Para mejorar rendimiento existen las llamadas Aikar flags. Paper ofrece un generador de scripts y una explicación de Aikar flags; para JVM modernas (Java 17/21/25) Paper recomienda probar sin flags primero y añadir Aikar sólo si tienes problemas de GC o pausas. Usa el generador de inicio de Paper para obtener la línea optimizada según memoria. (docs.papermc.io
Configurar systemd para ejecutar el servidor como servicio
Crea un fichero de unidad para que el servidor arranque automáticamente y se reinicie si falla:
[Unit]
Description=Paper Minecraft Server
After=network.target
[Service]
User=minecraft
Group=minecraft
WorkingDirectory=/srv/minecraft/server
ExecStart=/usr/bin/java -Xms1G -Xmx4G -jar /srv/minecraft/server/paper.jar --nogui
Restart=on-failure
RestartSec=10
SuccessExitStatus=0 143
LimitNOFILE=4096
[Install]
WantedBy=multi-user.target
Después guarda como /etc/systemd/system/minecraft.service, recarga systemd y habilita el servicio:
sudo systemctl daemon-reload
sudo systemctl enable --now minecraft.service
sudo journalctl -u minecraft -f
Configurar UFW y red (puerto 25565)
Por defecto Minecraft usa el puerto TCP 25565. En Ubuntu con UFW:
sudo ufw allow 25565/tcp
sudo ufw status
Si el servidor está detrás de un router doméstico, abre/NATea el puerto 25565 al IP local del servidor. Para administración remota asegura SSH (usa claves y bloquea por IP si es posible); consulta guías de hardening de SSH para producción.
Instalación y gestión de plugins y backups
Paper es compatible con plugins de Spigot/Bukkit (no mezcles mods tipo Forge/Fabric con plugins sin soluciones específicas). Para instalar plugins coloca los .jar en la carpeta plugins/ y reinicia o usa /reload con precaución (reload puede romper algunos plugins).
Backups consistentes: antes de copiar carpetas de mundo, ejecuta los comandos en la consola del servidor para asegurar consistencia:
save-off
save-all
# copiar carpetas world/ region/ etc. (ej: rsync o tar)
save-on
Automatiza con un script que use screen o la API de RCON, o detén el servicio momentáneamente si puedes permitir el downtime. Transfiere los backups fuera del host (stack remoto, S3, rclone) y conserva varias versiones.
Consejos de rendimiento y memoria
- No asignes toda la RAM de la máquina al heap Java; deja 1–2 GB para el SO y procesos auxiliares.
- Para 4–12 GB RAM empieza con
-Xms1G -Xmx4Gy ajusta según uso. - Usa las Aikar flags sólo si observas pausas por GC; prueba sin flags primero en JVM modernas. Monitoriza con herramientas como
timingsde Paper y perfiles de heap si hace falta. (docs.papermc.io
Solución de problemas comunes
- Servidor no arranca y muestra error de Java: comprueba
java -versiony que la versión cumple lo que requiere tu build de Paper. (docs.papermc.io - Puerto ocupado: usa
ss -tulpn | grep 25565para ver qué lo usa. - Permisos: asegúrate de ejecutar con el usuario
minecrafty que los archivos pertenezcan a ese usuario. - Errores al usar flags JVM: elimina flags no reconocidos por tu Java (opción
--helpy logs de arranque muestran flags no reconocidas).
Buenas prácticas de seguridad y mantenimiento
- Mantén el sistema y Java actualizados (aplica parches de seguridad) y revisa las notas de Paper antes de actualizar la versión del servidor.
- Realiza backups automáticos y prueba restauraciones periódicamente.
- Restringe acceso SSH (claves, desactivar contraseña) y, si procede, permite solo IPs de administración. (Ver guía sobre cambiar puerto SSH en Ubuntu para pasos detallados.)
- Monitoriza el servidor (uso CPU, RAM, latencia de GC) y los logs para detectar plugins problemáticos o ataques DDoS/IPs sospechosas.
Enlaces internos de referencia: Servidor de Minecraft en Linux: Guía Completa, Servidor Minecraft Spigot: Crea tu propio mundo, Cómo cambiar el puerto SSH en Ubuntu y ajustar UFW.
Verificación de que ha funcionado
- Comprobar que el servicio está activo:
sudo systemctl status minecraft. - Comprobar logs:
sudo journalctl -u minecraft -n 200para errores de arranque o GC. - Desde un cliente Minecraft, conecta a la IP:25565 y comprueba que entras al mundo y que los plugins listados aparecen en
/plugins.
Preguntas frecuentes (breve)
- ¿Puedo usar mods (Forge/Fabric) con Paper?
- No directamente: Paper es para plugins (Bukkit/Spigot API). Para mods necesitas un servidor modded (Forge/Fabric). Consulta guías específicas antes de intentar mezclar ambos; intentar forzarlo puede corromper mundos o producir incompatibilidades.
- ¿Cuánta RAM debo asignar?
- Depende de jugadores y plugins. Para pruebas 2–4 GB puede bastar; para público con plugins y ~50 jugadores considera 8–12 GB. Nunca arranques con Xmx igual a la RAM total de la máquina.
Conclusión
Configurar un servidor Paper en Ubuntu implica elegir el JDK correcto (Java 21 o Java 25 según la rama), instalarlo desde una distribución fiable (Corretto o Temurin), crear un usuario dedicado, descargar y arrancar paper.jar, aceptar la EULA, y optimizar arranques con flags solo cuando sea necesario. Gestionarlo con systemd y automatizar backups y actualizaciones te dará robustez y menor tiempo de inactividad. Revisa la documentación de Paper para detalles de builds y usa herramientas de monitorización y backups para mantenimiento continuo. (docs.papermc.io
Fuentes consultadas (documentación verificada)
Las recomendaciones y comandos relacionados con requisitos Java, instalación de Corretto y opciones de flags se han verificado contra la documentación oficial de PaperMC, Amazon Corretto y Adoptium/Temurin.
