Estructura de archivos de tu servidor Minecraft

Saber qué hay en cada carpeta te ahorra mucho tiempo. Esto es lo que verás en el gestor de archivos de un servidor Minecraft con Paper o Spigot.

La raíz de tu servidor

/
├── server.jar                  JAR principal del servidor
├── eula.txt                    aceptación del EULA de Mojang
├── server.properties           configuración principal
├── bukkit.yml                  configuración de Bukkit
├── spigot.yml                  configuración de Spigot
├── config/
│   ├── paper-global.yml        configuración global de Paper
│   └── paper-world-defaults.yml  valores por defecto de cada mundo (Paper)
├── plugins/                    tus plugins (.jar) y sus carpetas de datos
├── world/                      mundo principal (Overworld)
├── world_nether/               Nether
├── world_the_end/              The End
├── logs/                       registros del servidor
├── crash-reports/              informes de cuelgues
├── ops.json                    operadores
├── whitelist.json              lista blanca
├── banned-players.json         jugadores baneados
├── banned-ips.json             IPs baneadas
└── usercache.json              caché nombre ↔ UUID (no editar)

Según el software que uses, algunos archivos no existirán (por ejemplo, Vanilla no tiene spigot.yml ni paper-global.yml) y otros aparecerán al arrancar por primera vez.

Los archivos de configuración

ArchivoPara qué sirve
server.propertiesModo de juego, dificultad, jugadores máximos, distancias, modo online, MOTD…
bukkit.ymlLímites de aparición de mobs y otras opciones de Bukkit
spigot.ymlRangos de activación de entidades y opciones de rendimiento
config/paper-*.ymlOpciones avanzadas de Paper (rendimiento y correcciones)

Las opciones de rendimiento más útiles están explicadas en Optimizar un servidor Java.

La carpeta plugins/

plugins/
├── MiPlugin.jar            el plugin
├── MiPlugin/               sus datos y configuración
│   ├── config.yml
│   └── messages.yml
└── OtroPlugin.jar
  • Instalar un plugin: sube el .jar a plugins/ y reinicia. Se creará su carpeta de datos.
  • Desinstalarlo: borra el .jar, pero guarda la carpeta de datos por si quieres volver a usarlo.

Borrar la carpeta de datos de un plugin elimina su configuración y sus datos de forma permanente.

Los mundos

Paper y Spigot crean tres carpetas separadas (world, world_nether, world_the_end). Vanilla guarda el Nether y el End dentro de world. Dentro de un mundo:

Carpeta o archivoContiene
level.datDatos del mundo: semilla, hora, reglas de juego
region/Los chunks (archivos .mca)
playerdata/Inventario y posición de cada jugador (un archivo por UUID)
advancements/, stats/Logros y estadísticas por jugador
entities/, poi/Entidades y puntos de interés por chunk (camas, aldeanos…)

Logs y crash reports

  • logs/latest.log es el registro de la sesión actual; los anteriores se guardan comprimidos (.log.gz).
  • crash-reports/ guarda un informe cada vez que el servidor se cierra por un error grave. Es lo primero que hay que mirar (y compartir con soporte) cuando se cae sin motivo. Más en por dónde empezar cuando algo falla.