BUEORM Data Base (BDB)

Español

¿Qué es BDB?

BDB (BUEORM Data Base) es un sistema de persistencia de datos diseñado para desarrolladores que buscan simplicidad absoluta. Olvídate de gestionar diccionarios complejos o convertir tipos de datos manualmente. Con BDB, guardas tus variables tal cual existen en tu script y las recuperas de la misma forma.

¿Por qué usar este plugin y no hacerlo a mano?

1. Inyección Directa: El sistema usa self para leer y escribir variables directamente en tus objetos.
2. Auto-Tipado: Si guardas un número, recuperas un número. Si guardas un booleano, recuperas un booleano. Sin to_int() o str_to_var() manuales.
3. Gestión de Errores: Incluye un sistema de valores por defecto (Default values) para que tu juego nunca se rompa si falta un archivo.
4. Formato Ligero: El formato .bdb es texto plano estructurado, fácil de leer y depurar.

Instalación

1. Descarga el plugin desde la Godot Asset Library o copia la carpeta addons/bdb_system en tu proyecto.
2. Ve a Proyecto > Configuración del Proyecto > Plugins y activa BUEORM Data Base.
3. El sistema se registrará automáticamente como un Singleton llamado BDB.

Casos de Uso

1. Guardar y Cargar Ajustes de Juego

Ideal para volumen, sensibilidad o modo de pantalla.

var volumen = 80
var pantalla_completa = false

func aplicar_ajustes():
    # Carga variables y si no existen usa los valores por defecto
    BDB.load_(self, "config.bdb", {"volumen": 100, "pantalla_completa": true})

func guardar_ajustes():
    BDB.save_(self, "config.bdb", ["volumen", "pantalla_completa"])

2. Sistema de Guardado (Savegames)

Puedes guardar el progreso del jugador en una sola línea.

var nivel_actual = 1
var puntos = 0
var nombre_jugador = "Heroe"

func guardar_partida():
    BDB.save_(self, "partida_1.bdb", ["nivel_actual", "puntos", "nombre_jugador"])

English

What is BDB?

BDB (BUEORM Data Base) is a data persistence system designed for developers seeking absolute simplicity. Forget about managing complex dictionaries or manually converting data types. With BDB, you save your variables exactly as they exist in your script and retrieve them the same way.

Why use this plugin instead of doing it manually?

1. Direct Injection: The system uses self to read and write variables directly into your objects.
2. Auto-Typing: If you save a number, you get a number back. If you save a boolean, you get a boolean. No manual to_int() or str_to_var() required.
3. Error Handling: Includes a default values system so your game never crashes if a file is missing.
4. Lightweight Format: The .bdb format is structured plain text, easy to read and debug.

Installation

1. Download the plugin from the Godot Asset Library or copy the addons/bdb_system folder into your project.
2. Go to Project > Project Settings > Plugins and enable BUEORM Data Base.
3. The system will automatically register as a Singleton named BDB.

Use Cases

1. Saving and Loading Game Settings

Perfect for volume, sensitivity, or screen modes.

var volume = 80
var full_screen = false

func apply_settings():
    # Load variables and use defaults if the file doesn't exist
    BDB.load_(self, "settings.bdb", {"volume": 100, "full_screen": true})

func save_settings():
    BDB.save_(self, "settings.bdb", ["volume", "full_screen"])

2. Savegame System

Save player progress in a single line of code.

var current_level = 1
var score = 0
var player_name = "Hero"

func save_game():
    BDB.save_(self, "save_01.bdb", ["current_level", "score", "player_name"])

License

Distributed under the MIT License. See LICENSE for more information.