Prerrequisitos
- Cuenta de Google
- Acceso al proyecto Firebase
Paso 1: Crear Proyecto Firebase
Configuración Inicial
- Ve a Firebase Console
- Haz clic en "Crear un proyecto" o "Agregar proyecto"
-
Ingresa el nombre del proyecto:
classicgame-dk
(o tu nombre preferido) - Habilita Google Analytics (opcional)
- Haz clic en "Crear proyecto"
Paso 2: Habilitar Autenticación
Configurar Métodos de Autenticación
- En tu proyecto Firebase, ve a Authentication
- Haz clic en "Comenzar"
- Ve a la pestaña Método de inicio de sesión
- Habilita los siguientes proveedores:
- Correo/Contraseña: Habilitar
- Google: Habilitar y configurar pantalla de consentimiento OAuth
Configuración OAuth de Google
Configurar Proveedor Google
- Haz clic en el proveedor Google
- Habilita el interruptor
- Agrega tu correo de soporte del proyecto
- Guarda la configuración
- Anota el ID de cliente web y secreto de cliente web
Paso 3: Configurar Realtime Database
Crear Base de Datos
- Ve a Realtime Database en Firebase Console
- Haz clic en "Crear base de datos"
- Elige ubicación (preferiblemente la más cercana a tus usuarios)
- Comienza en modo de prueba (puedes asegurarlo después)
-
Tu URL de base de datos será:
https://tu-project-id-default-rtdb.firebaseio.com/
Paso 4: Obtener Credenciales de Configuración
Clave API Web
Obtener Clave API
- Ve a Configuración del proyecto (ícono de engranaje)
- En la pestaña General, desplázate a "Tus aplicaciones"
- Si no existe una aplicación web, haz clic en "Agregar aplicación" y selecciona el ícono web (</>)
- Registra tu aplicación con un apodo
- Copia la Clave API del objeto de configuración
Paso 5: Configurar Variables de Entorno
Configurar Archivo .env
Copia el archivo de ejemplo de entorno:
cp .env.example .env
Edita el archivo .env
con tus credenciales:
# Configuración Firebase FIREBASE_API_KEY=tu_api_key_aqui FIREBASE_AUTH_DOMAIN=tu-project-id.firebaseapp.com FIREBASE_DATABASE_URL=https://tu-project-id-default-rtdb.firebaseio.com/ FIREBASE_PROJECT_ID=tu-project-id FIREBASE_STORAGE_BUCKET=tu-project-id.appspot.com FIREBASE_MESSAGING_SENDER_ID=tu_sender_id FIREBASE_APP_ID=tu_app_id # OAuth de Google GOOGLE_CLIENT_ID=tu_google_client_id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=tu_google_client_secret
Solución de Problemas
Problemas Comunes
1. "Clave API no válida"
-
Verifica tu clave API en
.env
- Comprueba si la clave API está habilitada para tu proyecto
2. "Permiso denegado"
- Verifica las reglas de seguridad de tu base de datos
- Asegúrate de que el usuario esté autenticado
Funcionalidades Habilitadas
Leaderboards Globales
Una vez configurado Firebase, el juego automáticamente:
- Guarda las mejores puntuaciones en la nube
- Muestra rankings globales
- Sincroniza datos entre dispositivos
Guardado en la Nube
Los jugadores pueden:
- Guardar progreso automáticamente
- Sincronizar entre múltiples dispositivos
- Recuperar progreso perdido
Conclusión
Con Firebase configurado correctamente, tu juego Donkey Kong Classic tendrá capacidades completas en la nube, incluyendo:
- 🏆 Leaderboards globales para competencia entre jugadores
- ☁️ Guardado automático en la nube para nunca perder progreso
- 👤 Gestión de usuarios con múltiples métodos de autenticación
- 📊 Analytics en tiempo real para entender el comportamiento del jugador
- 🔒 Seguridad robusta para proteger datos de usuarios
Esta configuración transforma tu juego local en una experiencia conectada y social, manteniendo la simplicidad del gameplay clásico mientras agrega características modernas que los jugadores esperan.