@btopto/avatar-core
v0.1.0
Published
Framework-agnostic avatar engine: schema, serialization, unlocks, tiers and badges
Maintainers
Readme
@btopto/avatar-core
Motor de avatares personalizables con progresión, agnóstico de framework y de render. Cero dependencias.
- Esquema como datos: slots, opciones, canales de color y tiers los declara el art pack.
- Config serializable: el avatar es un JSON versionado (
AvatarConfig) que tu app persiste. - Progresión por entitlements: tu backend otorga grants (cursos, logros); el motor filtra (
availableOptions), valida (validateConfig) y degrada con gracia (sanitizeConfig). - Tiers visuales por rango, medallas (
earnedBadges) y aleatorio reproducible (randomConfigcon semilla).
import { createDefaultConfig, sanitizeConfig, validateConfig } from '@btopto/avatar-core';
import { basicArtPack } from '@btopto/avatar-art-basic';
const entitlements = ['course.intro']; // viene de tu backend
const config = sanitizeConfig(saved ?? createDefaultConfig(basicArtPack, entitlements), basicArtPack, entitlements);Parte del sistema btopto/avatar. Para renderizar usa @btopto/avatar-renderer-svg; para UI lista usa @btopto/avatar-element.
