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.