DesarrolladoresBases de datos MySQL

Usar una base de datos MySQL con tu servidor

Muchos plugins y mods pueden guardar sus datos en una base de datos MySQL en lugar de en archivos locales: permisos (LuckPerms), registros de bloques (CoreProtect), economía, baneos y estadísticas. Cada servidor de Hostwolf incluye hasta 5 bases de datos compatibles con MySQL (MariaDB) sin coste adicional.

Tus bases de datos funcionan en la máquina de tu propio servidor, no en un servidor de bases de datos compartido, así que son rápidas y la carga de otros no las frena. También significa que al eliminar el servidor se eliminan sus bases de datos. Descarga antes una copia si quieres conservarlas.

Crear una base de datos#

  1. Abre tu servidor en el panel de control y ve a la pestaña Bases de datos.
  2. Pulsa Nueva base de datos y ponle un nombre corto, por ejemplo luckperms.
  3. Pulsa Crear base de datos.

La primera base de datos de un servidor también inicia el servicio de bases de datos, lo que tarda alrededor de un minuto. La pestaña muestra un aviso de progreso y la base de datos aparece sola. Las siguientes se crean al instante.

Pulsa el icono del ojo junto a una base de datos para ver sus datos de conexión. Cada valor tiene un botón para copiarlo y la contraseña queda oculta hasta que pulses Mostrar.

CampoValor
Host172.18.0.1 (la dirección que usa tu servidor de juego para llegar a la base de datos)
Puerto3306
Base de datosel nombre que muestra la pestaña, por ejemplo s12_luckperms
Usuario y contraseñaaparecen en los datos de conexión

Usa 172.18.0.1 como host en la configuración de los plugins, no localhost ni 127.0.0.1. Tu servidor de juego funciona en su propio contenedor, así que localhost apunta al propio contenedor.

LuckPerms#

Detén el servidor y edita plugins/LuckPerms/config.yml en la pestaña Archivos:

storage-method: MySQL

data:
  address: 172.18.0.1:3306
  database: s12_luckperms
  username: u12_AbCdEfGhIj
  password: 'your-password'

Inicia el servidor. La consola muestra Loading storage provider... [MYSQL] y LuckPerms crea sus tablas. Para compartir rangos en una red BungeeCord o Velocity, haz que todos los servidores usen la misma base de datos (consulta Compartir una base de datos con tus otros servidores) y dale a cada uno un nombre server: distinto si usas permisos por servidor.

CoreProtect#

Edita plugins/CoreProtect/config.yml:

use-mysql: true
table-prefix: co_
mysql-host: 172.18.0.1
mysql-port: 3306
mysql-database: s12_coreprotect
mysql-username: u12_KlMnOpQrSt
mysql-password: your-password

Reinicia el servidor. CoreProtect registra muchos datos, así que dale su propia base de datos en lugar de compartirla con otros plugins.

Otros plugins y mods#

La mayoría de los plugins piden los mismos cinco valores: host, puerto, base de datos, usuario y contraseña. Los plugins de Java que piden una sola URL JDBC pueden usar la cadena de conexión JDBC de los datos de conexión, por ejemplo jdbc:mysql://172.18.0.1:3306/s12_luckperms, con el usuario y la contraseña aparte.

Compartir una base de datos con tus otros servidores#

El acceso remoto está desactivado por defecto: solo pueden conectarse los servidores de juego de la misma máquina. Para que tus otros servidores de Hostwolf o una web usen una base de datos:

  1. Abre los datos de conexión de la base de datos.
  2. En Acceso remoto, pulsa tus otros servidores en la lista o escribe la dirección IPv4 pública de otro servidor o de una web.
  3. Pulsa Guardar acceso remoto.

El cortafuegos abre entonces el puerto de la base de datos exactamente a esas direcciones. Se conectan con la dirección Host (desde fuera) de los datos de conexión, el puerto 3306 y el mismo usuario y contraseña.

Conectar con HeidiSQL, DBeaver o MySQL Workbench#

Las apps de escritorio son útiles para ver tablas, ejecutar consultas e importar archivos grandes.

  1. Averigua la IP pública de tu ordenador (busca «cuál es mi IP»). En los datos de conexión de la base de datos, añádela en Acceso remoto, o marca Permitir conexiones desde cualquier lugar si la IP de tu casa cambia a menudo.
  2. En tu app, crea una nueva conexión MySQL o MariaDB.
  3. Introduce la dirección Host (desde fuera), el puerto 3306 y el usuario y la contraseña de los datos de conexión.

En HeidiSQL elige MariaDB or MySQL (TCP/IP) como tipo de red. En DBeaver elige MariaDB (o MySQL) y deja que descargue el controlador cuando lo pida.

Permitir conexiones desde cualquier lugar deja que cualquiera en internet intente iniciar sesión, así que solo la contraseña larga y aleatoria protege tus datos. Mantenla en privado, pulsa Rotar contraseña si puede haberse filtrado y desactiva la opción cuando termines.

Exportar, importar y copias de seguridad#

  • Descargar: los datos de conexión tienen un botón Descargar que guarda la base de datos como archivo .sql.gz.
  • Importar: Importar un archivo carga un archivo .sql o .sql.gz de hasta 50 MB. Para archivos más grandes, usa una app de escritorio.
  • Copias de seguridad: tus bases de datos se incluyen automáticamente en las copias de seguridad del servidor. Al restaurar una copia en la pestaña Copias de seguridad, las bases de datos vuelven al mismo momento. Los volcados se guardan en la carpeta hostwolf-databases de los archivos del servidor.

Desde código o con un asistente de IA#

El SDK, el servidor MCP y la API REST pueden crear bases de datos, cambiar el acceso remoto, renovar contraseñas y exportarlas o importarlas. Pídele a tu asistente, por ejemplo: «Crea una base de datos llamada luckperms en mi servidor survival y configura LuckPerms para usarla».

Solución de problemas#

  • Communications link failure o conexión rechazada: comprueba que el host es 172.18.0.1 y el puerto 3306. Desde fuera, usa la dirección Host (desde fuera) y asegúrate de que tu IP está permitida en Acceso remoto.
  • Acceso denegado: vuelve a copiar la contraseña de los datos de conexión. Después de Rotar contraseña, actualiza cada plugin que use la base de datos.
  • La pestaña dice que el servicio de bases de datos no responde: tus datos están a salvo. Comprueba que la máquina del servidor está en línea y vuelve a intentarlo en unos minutos, o contacta con soporte.
  • Necesitas más de 5 bases de datos: contacta con soporte.
¿Atascado, o te falta un endpoint? Escríbenos en game.hostwolf.net/contact o a support@hostwolf.net.