📊 Frienda Tracker : Market

English description below / Description en français plus bas.

🇬🇧 English

Frienda Tracker: Market is the marketplace module of the Frienda Tracker: a server-side Fabric addon that bridges a virtual marketplace mod (auction-house style, /sell, etc.) with the server's web dashboard. It watches the marketplace mod's data file and automatically detects new listings, completed sales, and cancellations — without ever depending on that mod's internal code, only reading its JSON output.

Every detected event is pushed to the Tracker's Supabase database, powering the site with live price history, active listings, seller/buyer/item leaderboards, and a recent-sales feed.

Features

• Near-instant change detection (file watching, with a polling fallback)
• Zero modification required to the marketplace mod — fully independent addon
• Full sale history backfilled on first launch, then tracked incrementally with no duplicates across restarts
• Fully externalized configuration (Supabase URL, service key, data file path, watch mode, target tables)

Compatibility: Minecraft 1.21.11, Fabric.

 🇫🇷 Français

Frienda Tracker: Market est le module marché du Frienda Tracker : un addon serveur pour Fabric qui relie un mod de marché virtuel (hôtel des ventes, /sell, etc.) au tableau de bord web du serveur. Il surveille le fichier de données du mod de marché et détecte automatiquement les nouvelles annonces, les ventes et les annulations, sans jamais dépendre du code interne de ce mod — seule sa sortie JSON est lue.

Chaque événement détecté est envoyé vers la base Supabase du Tracker, permettant d'afficher en direct sur le site : les cours des objets dans le temps, les annonces actives, les classements des vendeurs/acheteurs/objets les plus actifs, et un flux des dernières ventes.

Fonctionnalités

• Détection instantanée des changements (surveillance du fichier, avec repli en interrogation périodique)
• Aucune modification du mod de marché requise — addon totalement indépendant
• Historique de ventes rejoué au premier lancement (backfill), puis suivi en continu sans doublons après un redémarrage
• Configuration entièrement externalisée (URL Supabase, clé d'accès, chemin du fichier, mode de surveillance, tables ciblées)

Compatibilité : Minecraft 1.21.11, Fabric.