HZ Scripts

Sources d'evenements

Chaque source alimente le meme coeur serveur (creer → regler) derriere une abstraction generique fixtures. Le coeur ne sait jamais si un evenement provient d'une vraie API ou de votre imagination — les cotes sont toujours generees par HZ-Bets, jamais importees.


ESPN — tous sports, sans cle

Config.Sources.espn recupere le scoreboard public d'ESPN pour chaque championnat configure : NBA, WNBA, MLB, NHL, NFL, UFC, et le football mondial (Premier League, La Liga, Ligue 1, Bundesliga, Serie A, MLS, Bresil, Mexique…). Le football devient un marche 1/X/2 ; tout autre sport un Vainqueur a 2 issues.

Il cree automatiquement les matchs a venir, diffuse le score en direct, et regle automatiquement sur le vrai resultat. Chaque championnat est une ligne de config :

Leagues = {
    { sport = 'basketball', league = 'nba' },
    { sport = 'baseball',   league = 'mlb' },
    { sport = 'hockey',     league = 'nhl' },
    { sport = 'football',   league = 'nfl' },     -- American football
    { sport = 'mma',        league = 'ufc' },     -- per-fight on a card
    { sport = 'soccer',     league = 'eng.1' },   -- Premier League
    -- … add / remove freely
}

Les championnats hors saison ne renvoient simplement rien ; ceux en saison remplissent le tableau automatiquement.

Endpoint non officiel. Le scoreboard d'ESPN est public et sans cle mais non documente — ESPN ne donne aucune garantie et pourrait le changer. HZ-Bets se degrade gracieusement : une reponse mauvaise / vide / inattendue ne fait rien (il continue de servir le dernier tableau connu et ne regle jamais sur de mauvaises donnees). Si ESPN change un jour son format, les mises a jour en direct se mettent en pause jusqu'a une mise a jour du script — les paris ne sont jamais corrompus. C'est opt-in par conception (Config.Sources.espn.Enabled).

Comment il regle : le score est la source de verite (le drapeau du vainqueur ne sert qu'a opposer un veto a un desaccord), et un evenement ne se regle que sur un final propre et joue — jamais sur un match reporte / abandonne.


OpenLigaDB — football, ODbL

Config.Sources.openligadb est un flux de football sans cle, sans auth, ouvert (https://api.openligadb.de). Listez les championnats sous forme shortcut ou shortcut/season (wm26/2026 pour la Coupe du Monde, bl1/2025, dfb…). Il cree automatiquement les marches configures avec de vrais blasons d'equipes, regle automatiquement sur le score final, et publie les meilleurs buteurs du championnat ("Top des Buteurs").
Attribution (ODbL). Quand OpenLigaDB est active, l'interface affiche un credit "Données de match : OpenLigaDB · ODbL 1.0". Conservez-le — il est requis par l'Open Database License.

Les matchs en cours sont sondes a une cadence plus rapide pour les scores en direct et un reglement rapide.


RP — evenements crees par l'admin

La source RP n'a aucune dependance externe : vous creez les evenements a la main depuis l'ecran admin en jeu — courses, combats, matchs fictifs, n'importe quoi — pour n'importe quel sport, avec vos propres issues et cotes. C'est aussi ainsi que vous creez un marche buteur (Buteur) pariable (l'admin choisit qui a marque). Voir Marches et cotes.


Degradation gracieuse

Tout le travail API est cote serveur uniquement et mis en cache ; le client n'appelle jamais une API. Une source qui renvoie n'importe quoi ou qui tombe ne peut jamais faire planter la ressource, creer un evenement malforme, ou mal regler un pari — elle cesse simplement de se mettre a jour jusqu'a ce qu'elle se retablisse. Les evenements deja crees restent visibles (dernier tableau connu) pendant tout ce temps.