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
| Archivo | Para qué sirve |
|---|---|
server.properties | Modo de juego, dificultad, jugadores máximos, distancias, modo online, MOTD… |
bukkit.yml | Límites de aparición de mobs y otras opciones de Bukkit |
spigot.yml | Rangos de activación de entidades y opciones de rendimiento |
config/paper-*.yml | Opciones 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
.jaraplugins/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 archivo | Contiene |
|---|---|
level.dat | Datos 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.loges 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.