Riftbound
Riftbound
Dernière mise à jour : 2026-05-10
TCG Riot Games (univers League of Legends).
Source
- API Riot :
https://riftbound.leagueoflegends.com/en-us/card-gallery(JSON live, pas de bulk download) - Collection Qdrant :
riftbound-cards - Cache local :
/app/data/riftbound-cards/cache.json(post-fetch)
Code
| Fichier | Rôle |
|---|---|
src/services/cards/sources/riftbound.ts |
CardSource (load depuis cache) |
scripts/riftbound-cards/fetch-cards.ts |
Appelle l'API Riot, écrit cache JSON |
scripts/riftbound-cards/normalize.ts |
Nettoyage HTML → domaines, énergie, types, tags |
scripts/riftbound-cards/ingest.ts |
Push Qdrant |
scripts/riftbound-cards/test-retrieve.ts |
Debug retrieval Qdrant |
scripts/riftbound-cards/link-game.ts |
Lie une ligne games |
services/meta/mobalytics-riftbound.ts |
Tier list Mobalytics (scrape) |
services/meta/riftboundstats.ts |
Tournois RiftboundStats (API) |
Payload Qdrant riftbound-cards
{
id: pointId,
name: string,
name_en: string,
set_label: string,
rarity: string,
card_type: 'Unit' | 'Champion Unit' | 'Spell' | 'Gear' | 'Battlefield' | 'Legend' | 'Rune',
card_domains: ('Fury' | 'Calm' | 'Mind' | 'Body' | 'Chaos' | 'Order')[],
energy: number,
might: number, // valeur d'attaque
text: string, // abilities
tags: string[],
image_url: string, // URL officielle Riot
}
Symboles UI
| Token | Symbole | PNG |
|---|---|---|
:rb_might: |
Might (force) | /riftbound-icons/might.png |
[rune_fury] |
Domain Fury | /riftbound-icons/fury.png |
[rune_calm] |
Domain Calm | /riftbound-icons/calm.png |
[rune_mind] |
Domain Mind | /riftbound-icons/mind.png |
[rune_body] |
Domain Body | /riftbound-icons/body.png |
[rune_chaos] |
Domain Chaos | /riftbound-icons/chaos.png |
[rune_order] |
Domain Order | /riftbound-icons/order.png |
PNG officiels Riot press-kit (cf. mémoire project_riftbound_support.md, commit 3de9cdd).
Helper : frontend/src/lib/riftbound-symbols.ts. Activé si game.hasCardDatabase === 'riftbound-cards'.
Méta-game
Deux sources :
Mobalytics (tier list)
META_RIFTBOUND_ENABLED=true- Sync hebdo (fréquence configurable)
- Service
services/meta/mobalytics-riftbound.ts
RiftboundStats (tournois)
META_RIFTBOUND_TOURNAMENT_ENABLED=true- Top placement max :
META_RIFTBOUND_TOURNAMENT_MAX_PLACEMENT=4 - Format ID par défaut :
META_RIFTBOUND_TOURNAMENT_FORMAT_ID=2(Spiritforged) - Rate-limit :
META_RIFTBOUND_RATE_LIMIT_MS=300(1 req/s safe) - Service
services/meta/riftboundstats.ts
Deckbuilding
- Spec par défaut :
40 mainboard + 0 sideboard + 12 runes + 3 battlefields + 3 gear, max 3 par carte - Pas de filtre Qdrant
legal_formats(collection mono-format) - Post-filtre TS :
card_domains ⊆ spec.domains(multi-domain decks) - 7 domaines à combiner : Fury / Calm / Mind / Body / Chaos / Order
Multi-query Riftbound
retrieve/multi-query-riftbound.ts : Haiku décompose la question en JSON {domains, energyMax, types, themes, legend} → filters Qdrant natifs.
Autocomplete @card
Pattern @ (mention-style) choisi 2026-04-13 (cf. mémoire project_riftbound_cards_ux.md). Première implémentation TCG du pattern, ensuite généralisée à MTG/FAB/Lorcana.
Workflow update
Source live API → workflow simple : npm run cards:riftbound:fetch puis npm run cards:riftbound:ingest. Pas de rebuild image Docker nécessaire (sauf si tu changes le code de normalisation).
Détails dans mettre-a-jour-cartes.md.