server.properties de Minecraft explicado

server.properties es el archivo de configuración principal de un servidor de Java Edition. Está en la carpeta del servidor, se crea la primera vez que lo inicias y controla el puerto, el mundo, la dificultad, la seguridad y el rendimiento. Esta guía explica las claves que importan, con valores razonables y lo que sale mal cuando las cambias.

Cómo funciona el archivo

• Cada línea es clave=valor, sin espacios alrededor del signo igual.
• Detén el servidor antes de editarlo. La mayoría de los cambios solo se aplican tras reiniciar, y el servidor puede sobrescribir el archivo al apagarse.
• Las líneas que empiezan por # son comentarios.
• Si borras el archivo, el servidor crea uno nuevo con los valores por defecto la próxima vez que arranque.
• Paper, Spigot y Purpur también leen este archivo, y añaden sus propios ajustes en otros archivos como spigot.yml y la carpeta de configuración de Paper.

Los valores de abajo son para Java 1.20 y 1.21. Desde la 1.21.9, pvp, allow-nether, spawn-monsters y enable-command-block ya no son propiedades del servidor: se convirtieron en reglas del juego que se cambian dentro del juego con /gamerule. En versiones anteriores siguen estando en este archivo.

Ajustes de conexión

server-port: si lo cambias, los jugadores tienen que añadir el puerto a la dirección (play.example.com:25570), salvo que configures un registro SRV. También tienes que abrir el nuevo puerto. Consulta IP y puerto de un servidor de Minecraft.

max-players: ponerlo muy alto no hace que el servidor sea más rápido ni más popular. Pon un número que tu hardware pueda aguantar de verdad, para que el servidor rechace jugadores en lugar de ir con lag para todos.

motd: admite códigos de color escritos como \u00A7 seguido de un código, por ejemplo \u00A7a para verde, y \n para la segunda línea. Escribirlo a mano es engorroso; nuestro generador de MOTD te crea la línea.

enable-status: si lo pones en false, el servidor aparece como desconectado en la lista de Multijugador y en las listas de servidores, aunque los jugadores puedan seguir entrando. Déjalo activado en un servidor público.

network-compression-threshold: déjalo en 256 en la mayoría de los servidores. -1 desactiva la compresión, lo que solo tiene sentido cuando el servidor y los jugadores (o un proxy) están en la misma red local rápida. Los valores muy bajos consumen más CPU sin ninguna ventaja real.

Ajustes del mundo

• level-name (por defecto world): el nombre de la carpeta del mundo. Cámbialo para cargar otra carpeta de mundo.
• level-seed: la semilla para un mundo nuevo. No hace nada en un mundo que ya existe.
• level-type (por defecto minecraft:normal): otros valores son minecraft:flat, minecraft:large_biomes, minecraft:amplified y minecraft:single_biome_surface. Igual que la semilla, solo se aplica cuando se crea el mundo. Los mundos amplificados exigen mucho más a la CPU.
• generator-settings: JSON para mundos planos personalizados. Déjalo vacío salvo que sepas que lo necesitas.
• generate-structures (por defecto true): aldeas, templos y otras estructuras.
• max-world-size: el radio del borde del mundo en bloques. En servidores públicos, un borde más pequeño con un mundo pregenerado mantiene bajo control el uso de disco y el lag.
• allow-nether (1.21.8 y anteriores): desactiva el Nether cuando está en false. En servidores basados en Bukkit, el End se controla con allow-end en bukkit.yml.

Para empezar un mundo nuevo con otra semilla u otro tipo, detén el servidor, cambia el valor y renombra o elimina las carpetas del mundo antiguo. Antes, haz una copia de seguridad.

Ajustes de juego

difficulty: la mayoría de los servidores de supervivencia usan normal o hard. Pacífico elimina los mobs hostiles y el daño por hambre, lo que estropea las granjas de mobs y muchos objetivos de supervivencia.

allow-flight: ponlo en true si usas plugins de vuelo, juego con mucha élitra cuando hay lag o ciertas monturas. Si no, puede que se expulse a jugadores por "volar" cuando el servidor simplemente va con lag. Los plugins anticheat detectan los hacks de vuelo reales mucho mejor que este ajuste.

spawn-protection: la zona protegida es un cuadrado alrededor del spawn del mundo, y los operadores la ignoran. Solo funciona cuando al menos un jugador es operador. Muchos servidores lo ponen en 0 y protegen el spawn con WorldGuard, que da un control más fino sobre lo que pueden hacer allí los jugadores.

Ajustes de rendimiento

view-distance frente a simulation-distance: la distancia de visión es cuántos chunks alrededor de cada jugador se envían a su cliente para que pueda verlos. La distancia de simulación es cuántos chunks alrededor de cada jugador funcionan de verdad: los mobs se mueven, los cultivos crecen, la redstone y los hornos trabajan. La simulación es la parte cara, así que una configuración habitual es una distancia de visión moderada con una distancia de simulación más baja. Los jugadores siguen viendo lejos, pero el servidor solo trabaja cerca de ellos. Poner la distancia de simulación muy baja estropea las granjas que necesitan al jugador cerca, así que no bajes de 4 en un servidor de supervivencia.

entity-broadcast-range-percentage: a qué distancia pueden ver los jugadores las entidades, como porcentaje del alcance por defecto (de 10 a 1000). Bajarlo reduce el tráfico de red en servidores con mucha gente, pero los jugadores ven aparecer los mobs y a otros jugadores más tarde, lo que importa en PvP.

sync-chunk-writes: cuando es true, los chunks se guardan de forma síncrona, lo que es más seguro si el servidor se cuelga. Ponerlo en false puede hacer que el guardado sea más rápido, pero te arriesgas a perder los cambios recientes si hay un cuelgue. Déjalo activado salvo que sepas por qué lo cambias.

max-tick-time: si un tick tarda más de este número de milisegundos, el watchdog detiene el servidor, porque probablemente está congelado. -1 desactiva el watchdog. No lo desactives para ocultar cuelgues; busca la causa con un profiler. Cómo reducir el lag en un servidor de Minecraft explica cómo hacerlo.

En la 1.21.2 y posteriores, pause-when-empty-seconds pausa el servidor cuando lleva vacío ese número de segundos. Eso ahorra recursos en un servidor privado, pero en un servidor público algunos plugins y temporizadores esperan que el mundo siga funcionando.

Ajustes de seguridad

online-mode

online-mode=true (el valor por defecto) hace que el servidor verifique con Mojang la cuenta de cada jugador. Déjalo activado.

Con online-mode=false (modo offline), el servidor se fía de cualquier nombre que envíe el cliente. Cualquiera puede entrar como cualquier jugador, incluido tú o tu staff, y quedarse con su inventario, sus protecciones y sus permisos. Además, los plugins que usan UUID ven UUID distintos que en modo online, así que cambiar más adelante revuelve los datos de los jugadores.

La única excepción normal es un servidor detrás de un proxy como Velocity: ahí el proxy funciona en modo online y los servidores de backend en modo offline con reenvío de información de los jugadores, y los backends solo deben aceptar conexiones del proxy. Consulta cómo montar una red con Velocity.

enforce-secure-profile

Por defecto true. Los jugadores necesitan una clave de perfil firmada por Mojang para entrar, que se usa para el chat firmado. Si algunos jugadores no pueden entrar y les sale un mensaje sobre una clave pública que falta, o usas ciertas configuraciones de chat o de proxy, a veces los dueños lo ponen en false. Déjalo en true salvo que tengas un motivo concreto.

Whitelist

• white-list (por defecto false): solo pueden entrar los jugadores que están en la whitelist.
• enforce-whitelist (por defecto false): cuando es true, los jugadores conectados que no están en la lista son expulsados en cuanto se recarga la whitelist.

También puedes activarla dentro del juego con /whitelist on. Tienes todos los pasos en cómo poner whitelist en un servidor de Minecraft.

Query y RCON

enable-query (por defecto false) activa el protocolo de consulta GameSpy4 en query.port (UDP, 25565 por defecto). Algunas herramientas y listas lo usan para leer los plugins y los nombres de los jugadores. Es opcional; los pings de estado funcionan sin él.

enable-rcon (por defecto false) permite el acceso remoto a la consola en rcon.port (TCP, 25575 por defecto) con rcon.password. RCON envía comandos con todo el poder de la consola y la contraseña no va cifrada. Si lo usas:

• Usa una contraseña larga y aleatoria.
• Nunca abras ni expongas el puerto de RCON a internet. Permítelo solo desde la misma máquina o desde una red privada.
• Si no lo necesitas, déjalo desactivado.

Otras claves de seguridad

• op-permission-level (por defecto 4): lo que pueden hacer los operadores. 4 lo permite todo, incluso detener el servidor.
• prevent-proxy-connections (por defecto false): expulsa a los jugadores cuya conexión parece pasar por una VPN o un proxy, comparando direcciones con Mojang. Puede bloquear a jugadores legítimos.
• rate-limit (por defecto 0): expulsa a los clientes que envían demasiados paquetes por segundo. 0 lo desactiva.
• log-ips (por defecto true, 1.20.2+): si las direcciones IP de los jugadores se escriben en el registro.
• accepts-transfers (por defecto false, 1.20.5+): si el servidor acepta jugadores enviados desde otro servidor con el paquete de transferencia.

Ajustes del paquete de recursos

• resource-pack: una URL de descarga directa a un archivo zip. Los enlaces a páginas de descarga no funcionan; la URL tiene que devolver el propio archivo.
• resource-pack-sha1: el hash SHA-1 del zip. Permite a los clientes guardar el paquete en caché y saber cuándo ha cambiado. Actualízalo cada vez que cambies el archivo.
• require-resource-pack: si es true, los jugadores que rechazan el paquete son desconectados.
• resource-pack-prompt: un mensaje personalizado que aparece en el aviso de descarga.

Haz obligatorio un paquete solo si tu servidor lo necesita de verdad, y que sea ligero. Un paquete obligatorio grande es un motivo más para que un jugador nuevo se rinda. Los jugadores de Bedrock que entran a través de Geyser necesitan un paquete convertido.

Un punto de partida razonable

Para un servidor de supervivencia público y pequeño en Paper:

server-port=25565
online-mode=true
enforce-secure-profile=true
max-players=50
difficulty=normal
view-distance=8
simulation-distance=6
spawn-protection=0
white-list=false
enable-status=true
enable-query=false
enable-rcon=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=true

Ajusta max-players, view-distance y simulation-distance a tu hardware y observa cómo se comporta el servidor con jugadores conectados. Después de cambiar ajustes, reinicia y comprueba que el servidor sigue apareciendo correctamente con el comprobador de estado de servidores.