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.
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
| Columna | Tipo | Notas |
|---|---|---|
id | clave | El id del mundo tal como se escribió |
display_name | texto | |
biome | texto | Un id de bioma, minecraft:plains |
border_size | int | El diámetro |
icon | texto | Nombre de material, cadena de cabeza o un objeto serializado |
generation_json | texto | El preset: altura base, la pila de capas y la lista de features |
type | texto | MANAGED o IMPORTED |
folder_name | texto | Solo mundos importados |
settings_json | texto | La dificultad y doce de los trece interruptores |
created_at, updated_at | long |
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
| Columna | Tipo | Notas |
|---|---|---|
id | clave | <uuid>:<ranura> |
player_uuid | indexada | |
slot | int | Empieza en 1 |
name, icon | texto | |
contents, armor, offhand | texto | Stacks de objetos serializados |
favorite | booleano | Como mucho una fila verdadera por jugador |
created_at, updated_at | long |
sandbox_predefined_kits: las plantillas de admin
| Columna | Tipo | Notas |
|---|---|---|
id | clave | Un slug del nombre al crearla. Renombrar no lo cambia |
name, description, icon | texto | |
contents, armor, offhand | texto | |
practice_kit | texto | El kit de PracticeCore vinculado, si hay |
created_at, updated_at | long |
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
| Columna | Tipo | Notas |
|---|---|---|
uuid | clave | |
kills, deaths | int | Solo se cuentan dentro de mundos sandbox |
playtime_millis | long | Tiempo de sandbox, no del servidor |
created_at, updated_at | long |
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
| Columna | Tipo | Notas |
|---|---|---|
id | clave | Doce caracteres hexadecimales |
display_name | texto | |
interval_seconds | int | Mínimo cinco |
target_world_id | texto | Vacío significa un mundo READY al azar |
spread_radius | int | |
world_name | texto | El mundo donde está la caja |
min_x ... max_z | double | Las seis esquinas |
created_at, updated_at | long |
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 memoria | Se pierde con |
|---|---|
| El kit que lleva puesto un jugador | Un reinicio, o al salir |
El punto de /back | Un reinicio, o una desconexión |
| Estar en cola | Un reinicio, o una desconexión |
Peticiones de /tpa pendientes | Su caducidad, una desconexión o un reinicio |
| La sesión del creador de kits | Una desconexión, que además devuelve el inventario |
| Quién está sobre una plataforma | Se 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