Jerarquía de archivos del servidor
Los servidores de MixelNodes se ejecutan dentro del sistema de gestión de Pterodactyl. En el sistema operativo del nodo, cada servidor vive en su propio directorio aislado bajo:
/var/www/pterodactyl/volumes/<UUID-del-servidor>/
Desde SkyPanel no ves esa ruta — el explorador de archivos te muestra directamente el contenido de esa carpeta como si fuera la raíz /. Esta guía documenta qué contiene cada carpeta y archivo relevante.
Raíz del servidor (vista desde SkyPanel)
/ ← raíz de tu servidor en SkyPanel
├── server.jar ← JAR principal del servidor
├── eula.txt ← acuerdo de usuario final de Mojang
├── server.properties ← configuración principal del servidor
├── bukkit.yml ← configuración de Bukkit/CraftBukkit
├── spigot.yml ← configuración de Spigot
├── paper-global.yml ← configuración global de Paper
├── paper-world-defaults.yml ← defaults por mundo (Paper)
├── config/
│ └── paper-world-defaults.yml
├── plugins/ ← todos tus plugins (.jar)
├── world/ ← mundo principal (Overworld)
├── world_nether/ ← Nether
├── world_the_end/ ← The End
├── logs/ ← logs del servidor
├── crash-reports/ ← reportes de crash
├── banned-ips.json
├── banned-players.json
├── ops.json
├── whitelist.json
└── usercache.json
Archivos de configuración principales
server.properties
Configuración base del servidor. Se aplica a cualquier tipo de servidor (Vanilla, Spigot, Paper, Fabric…).
Opciones más importantes:
# Modo de juego por defecto
gamemode=survival
# Dificultad
difficulty=normal
# Número máximo de jugadores
max-players=20
# Puerto del servidor (no cambiar salvo que soporte lo indique)
server-port=25565
# Vista (chunks cargados alrededor de cada jugador)
view-distance=10
# Distancia de simulación de entidades
simulation-distance=8
# Modo online (true = autenticación con Mojang, false = modo offline)
online-mode=true
# Mensajes de MOTD en la lista de servidores
motd=§6Mi Servidor de Minecraft
online-mode sin razónonline-mode=false permite entrar con cualquier nombre sin autenticación. Solo tiene sentido en redes de proxy tipo BungeeCord/Velocity. Si no sabes por qué lo necesitas, déjalo en true.
bukkit.yml
Configuración de Bukkit. En servidores Paper/Spigot, las opciones más relevantes:
settings:
# Cuántos ticks por segundo para las entidades en chunks lejanos
# (reducir mejora el rendimiento)
entity-tracking-range:
players: 48
animals: 48
monsters: 48
misc: 32
other: 64
spawn-limits:
# Número máximo de mobs de cada tipo por mundo
monsters: 70
animals: 10
water-animals: 5
water-ambient: 20
ambient: 15
spigot.yml
Amplía la configuración de Bukkit con opciones de rendimiento:
world-settings:
default:
# Ticks entre cada intento de spawn de mobs (mayor = menos frecuente = más rendimiento)
mob-spawn-range: 6
# Entidades que dejan de simular IA cuando están lejos
entity-activation-range:
animals: 32
monsters: 32
raiders: 48
misc: 16
# Cuántos ticks entre cada merge de items en el suelo
merge-radius:
item: 2.5
exp: 3.0
paper-global.yml y paper-world-defaults.yml
Paper añade opciones avanzadas en estos archivos. Son muy relevantes para el rendimiento — consulta la guía de Optimización de recursos para ver las opciones recomendadas.
La carpeta plugins/
plugins/
├── MiPlugin.jar ← plugin instalado
├── OtroPlugin.jar
├── MiPlugin/ ← datos y configuración del plugin
│ ├── config.yml
│ ├── data.db
│ └── messages.yml
└── .paper-remapped/ ← caché interna de Paper (no tocar)
Sube el archivo .jar directamente a la carpeta plugins/ desde el explorador de archivos de SkyPanel y reinicia el servidor. El plugin generará su carpeta de configuración automáticamente.
Borrar la carpeta MiPlugin/ elimina toda la configuración y los datos del plugin de forma permanente. Si quieres desinstalar un plugin, elimina solo el .jar y guarda la carpeta de datos por si acaso.
Los mundos
Estructura de un mundo (Overworld)
world/
├── level.dat ← datos del nivel (semilla, tiempo, gamerules…)
├── level.dat_old ← backup automático del level.dat
├── session.lock ← bloqueo (evita que dos servidores abran el mismo mundo)
├── uid.dat
├── playerdata/ ← datos de cada jugador (inventario, posición…)
│ └── <UUID>.dat
├── advancements/
│ └── <UUID>.json
├── stats/
│ └── <UUID>.json
├── region/ ← chunks del Overworld (archivos .mca)
│ └── r.0.0.mca
├── entities/ ← datos de entidades por chunk (Paper 1.17+)
├── poi/ ← puntos de interés (camas, fogones…)
└── DIM-1/ ← Nether (si está en el mismo mundo)
Paper (y CraftBukkit) por defecto crea tres carpetas separadas: world/, world_nether/ y world_the_end/. Vanilla guarda Nether y End dentro de world/DIM-1/ y world/DIM1/.
Los logs
logs/
├── latest.log ← log de la sesión actual
├── 2024-01-15-1.log.gz ← logs históricos (comprimidos)
└── 2024-01-14-1.log.gz
Para ver los últimos errores rápidamente, busca ERROR o WARN en latest.log desde el editor de SkyPanel.
Crash reports
crash-reports/
└── crash-2024-01-15_12.30.00-server.txt
Cuando el servidor se cierra inesperadamente por un error, genera un crash report aquí. Este archivo es el primero que debes revisar (y compartir con soporte) cuando el servidor cae sin razón aparente.
Archivos de administración
| Archivo | Contenido |
|---|---|
ops.json | Lista de operadores (OPs) con su UUID y nivel |
whitelist.json | Jugadores en la whitelist |
banned-players.json | Jugadores baneados (UUID + razón) |
banned-ips.json | IPs baneadas |
usercache.json | Caché de nombre de usuario ↔ UUID (no editar manualmente) |
Dónde viven los datos en el nodo (avanzado)
Esta sección describe la estructura interna del nodo. Como usuario de SkyPanel no necesitas acceso SSH para nada de esto — SkyPanel te da acceso a todo a través del panel.
/var/www/pterodactyl/
├── volumes/
│ ├── <UUID-servidor-1>/ ← raíz de tu primer servidor
│ └── <UUID-servidor-2>/ ← raíz de tu segundo servidor
└── ...
/etc/pterodactyl/
└── config.yml ← configuración del Wings daemon
/var/log/pterodactyl/
└── wings.log ← logs del agente Wings
Cada servidor tiene su propio directorio aislado en volumes/. El UUID corresponde al identificador único del servidor que puedes ver en la URL del panel: panel.mixelnodes.com/server/<UUID>.