Documentación

    InicioProductoFuncionalidadesLogrosLore & Vocabulario

    Enlaces Rápidos

    • Preguntas Frecuentes
    • Roadmap
    • Inicio

    Sistema de Logros de Questy

    Última actualización: 4 de noviembre, 2025

    Inventario de Logros

    Questy cuenta con 19 logros distribuidos en 6 familias, cada una rastreando diferentes aspectos de tu progreso heroico.

    Familias de Logros & Objetivos

    FamiliaNombreObjetivosRecompensas
    MISMisiones1, 25, 100 quests completadas50/125/250 XP + Monedas; badge_missions_gold
    STRKRachas3, 7, 30 días consecutivos50/125/250 XP + Monedas; badge_streak_gold
    CMPCampañas1, 5, 20 campañas completas50/125/250 XP + Monedas; badge_campaigns_gold
    STATAtributos25, 100, 300 puntos de atributos50/125/250 XP + Monedas; badge_attributes_gold
    GAMEMinijuegos1, 10, 50 sesiones completas50/125/250 XP + Monedas; badge_minigames_gold
    SECSecretosEaster eggs (4 secretos)Solo badge cosmético, sin XP/Monedas

    Event Triggers

    Los logros se desbloquean automáticamente cuando se disparan ciertos eventos del juego:

    • Quest completada: achievementApiService.processGameEvent('mission_completed', { count }) → Desbloquea MIS_*
    • Campaña terminada: processGameEvent('campaign_finished', { count }) → Desbloquea CMP_*
    • Streak actualizado: processGameEvent('streak_updated', { days }) → Desbloquea STRK_*
    • Ganancia de atributos: useAchievements().triggerAttributeGain(totalPoints) → Desbloquea STAT_*
    • Minijuego completado: useAchievements().triggerMinigameCompleted(count) → Desbloquea GAME_*
    • Easter egg: processGameEvent('easter_egg', { code }) → Desbloquea SEC_* (códigos: dragon_secret, lady_secret, crypt_secret, royal_seal)

    Sistema de Recompensas

    Los logros deben ser "reclamados" activamente para recibir las recompensas:

    • Tier 1 (Bronce): 50 XP + 50 Monedas de Oro
    • Tier 2 (Plata): 125 XP + 125 Monedas de Oro
    • Tier 3 (Oro): 250 XP + 250 Monedas de Oro + Badge cosmético exclusivo
    • Secretos (Tier 0): Solo badge cosmético, sin XP ni monedas

    API de Logros

    Interactúa con el sistema de logros mediante los siguientes servicios:

    • achievementApiService.getAchievements() - Retorna todos los logros con progreso del usuario
    • userAchievementApiService.getAchievementStats() - Estadísticas por familia y progreso general
    • userAchievementApiService.claimAchievement(achievementId) - Reclama XP/Monedas del logro desbloqueado
    • useAchievements() - Hook React con triggers optimistas

    Consejos para Jugadores

    • • Completa tu primera quest para desbloquear MIS_01 - Primera Misión (+50 XP, +50 Monedas)
    • • Mantén rachas de 3, 7 y 30 días para obtener todos los logros de familia STRK
    • • Los logros secretos están ocultos hasta que los desbloqueas; explora el reino para encontrarlos
    • • Los badges cosméticos de tier oro son símbolos de prestigio que muestran tu dedicación
    • • Reclamar logros actualiza tu HUD inmediatamente con las recompensas de XP y Monedas