Contenido generado con IA — puede contener errores.

ExyliaSandBox/ReferenciareferenciaActualizada en v1.2.0

Base de datos

Las tablas que ExyliaSandBox añade a tu base de datos, sus columnas, lo que se mantiene en memoria y cómo las comparten los servidores.

Página 16 de 245 min de lectura

Todo lo que posee el plugin vive en la base de datos: no hay lista de mundos, ni archivo de kits, ni archivo de plataformas en disco. La conexión, el motor (H2 por defecto) y compartir entre servidores son de ExyliaLib; configúralos en Base de datos. Esta página lista solo las tablas que añade ExyliaSandBox.

Antes de empezar#

No hay nada que crear: las tablas se hacen en el primer arranque. Inclúyelas en la copia de seguridad del resto de tu base de datos.

Pasos#

Apunta todos los servidores a la misma base de datos

Así los mundos, kits, plantillas y plataformas son los mismos en todos.

Elige cómo se comparten los mundos

Pon worlds-scope en config.yml (mira Configuración) y reinicia.

Comprueba que funciona#

Crea un mundo en un servidor y reinicia o recarga el otro: aparece allí. Nada se sincroniza en vivo, así que un mundo creado en un servidor lo recoge otro la próxima vez que lea, y los kits se leen al conectarse.

Ir más lejos#

Las tablas#

sandbox_worlds: una fila por mundo configurado
ColumnaTipoNotas
idclaveEl id del mundo tal como se escribió
display_nametexto
biometextoUn id de bioma, minecraft:plains
border_sizeintEl diámetro
icontextoNombre de material, cadena de cabeza o un objeto serializado
generation_jsontextoEl preset: altura base, la pila de capas y la lista de features
typetextoMANAGED o IMPORTED
folder_nametextoSolo mundos importados
settings_jsontextoLa dificultad y doce de los trece interruptores
created_at, updated_atlong

disable_powder_snow se activa en la pantalla de admin y se lee en vivo, pero no se escribe en settings_json: vuelve a su valor por defecto en la siguiente carga.

sandbox_player_kits: una fila por kit
ColumnaTipoNotas
idclave<uuid>:<ranura>
player_uuidindexada
slotintEmpieza en 1
name, icontexto
contents, armor, offhandtextoStacks de objetos serializados
favoritebooleanoComo mucho una fila verdadera por jugador
created_at, updated_atlong
sandbox_predefined_kits: las plantillas de admin
ColumnaTipoNotas
idclaveUn slug del nombre al crearla. Renombrar no lo cambia
name, description, icontexto
contents, armor, offhandtexto
practice_kittextoEl kit de PracticeCore vinculado, si hay
created_at, updated_atlong
sandbox_kitroom_categories y sandbox_kitroom_items: la antigua sala de kits

Son las tablas antiguas de la sala de kits (una categoría tiene display_name, material y priority; un objeto tiene category_id, slot e item_stack). La sala de kits vive ahora en exylia_kitroom de ExyliaLib (mira Sala de kits); estas dos solo se leen, una vez, para sembrarla, y no se vuelven a escribir.

sandbox_player_stats
ColumnaTipoNotas
uuidclave
kills, deathsintSolo se cuentan dentro de mundos sandbox
playtime_millislongTiempo de sandbox, no del servidor
created_at, updated_atlong

Una baja cuenta cuando el asesino y la víctima están en un mundo sandbox y no son el mismo jugador. El KDR sin muertes es el número de bajas.

sandbox_tp_regions: las plataformas de teletransporte
ColumnaTipoNotas
idclaveDoce caracteres hexadecimales
display_nametexto
interval_secondsintMínimo cinco
target_world_idtextoVacío significa un mundo READY al azar
spread_radiusint
world_nametextoEl mundo donde está la caja
min_x ... max_zdoubleLas seis esquinas
created_at, updated_atlong
sandbox_settings: el lobby y la sala del creador

Exactamente una fila, con la ubicación del lobby y la de la sala del creador de kits. Un data.yml antiguo en la carpeta del plugin se lee una vez al arrancar y se importa a esa fila, para las ubicaciones que la base de datos aún no tenga. El archivo nunca se reescribe ni se borra.

Qué no está en la base de datos#

Solo en memoriaSe pierde con
El kit que lleva puesto un jugadorUn reinicio, o al salir
El punto de /backUn reinicio, o una desconexión
Estar en colaUn reinicio, o una desconexión
Peticiones de /tpa pendientesSu caducidad, una desconexión o un reinicio
La sesión del creador de kitsUna desconexión, que además devuelve el inventario
Quién está sobre una plataformaSe recalcula cuando el plugin carga

Los kits y las estadísticas se cachean por jugador y se escriben al desconectarse.

Compartir entre servidores#

La lista de mundos y las plataformas se guardan por grupo de red: worlds-scope en config.yml (default sigue el grupo de red del config.yml de ExyliaLib, server da a cada servidor los suyos, global comparte con todos, cualquier otro valor es el nombre de un grupo), leído al arrancar.

¿Falta algo en esta página? Dínoslo en Discord