Hello! La V2 de Pronobot est là, au menu:
- commandes / hyper complètes
- 100% configurable
- canvas et images personnalisées
- plusieurs types de matchs
- sauvegarder en base de données
- classements et stats

Et bien plus encore, venez découvrir  :)

Pronobot V2 est là!

This game contains methods or game modes to play together with your friends

Cooperative Play

This game allows you to trade items or currency with other players

This game allows you to trade any item to any user

This game allows for trading, but limits it to certain items

Trading Allowed

This game contains the ability for players to obtains achievements

Achievements

This project has leaderboards highlighting the top players within either the server or globally

Leaderboards

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

# 🎲 PronoBot — Bot Discord de Bookmaker (Pronostics en tout genre) 100% configurable

**[🇫🇷 Français](#-pronobot--bot-discord-de-bookmaker-pronostics-en-tout-genre-100-configurable) | [🇬🇧 English](#-pronobot--customizable-discord-bookmaker-bot)**

![Discord](https://img.shields.io/badge/Discord-Bot-7289da?style=for-the-badge&logo=discord)
![Node.js](https://img.shields.io/badge/Node.js-v18+-339933?style=for-the-badge&logo=node.js)
![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)

PronoBot est un bot Discord pensé pour gérer des paris sportifs sur votre serveur avec une économie virtuelle, des classements, des grades, un système de certification et un système de **niveaux et XP**. Simple à utiliser et complétement configurable, il permet de créer des matchs, placer des paris, suivre les statistiques et organiser des compétitions entre membres.

Il y a 2 types de match disponibles:

- Le match sport, on rentre le nom de l'équipe A, sa côte, le nom de l'équipe B, sa côte ainsi que la côte du Match Nul.
- Le match libre, question personnalisée et jusqu'à 9 choix possibles (avec côte pour chaques choix) à la manière des sondages twitch ou encore des paris avec comme réponse "Oui/Non"

---

Le code du bot n'est **pas open source** mais il est **certifié** par discord _(+ de 100 serveurs l'ont déjà adopté)_.

Si vous êtes propriétaire d'un serveur et que vous souhaitez **visualiser le code du bot** c'est avec plaisir, ouvrez un ticket sur le [discord officiel](https://discord.gg/rbrPpWbEnV) puis si vous décidez de nous faire confiance, pourquoi pas devenir partenaire 😁

| Application Vérifiée ☺️ |
| :---: |
| ![Statistiques](https://i.imgur.com/3uAEI0s.png) |

---

## Ajouter le bot à votre serveur

Pour ajouter le bot à votre serveur il vous suffit de vous rendre sur ce [lien](https://discord.com/oauth2/authorize?client_id=835256483356737546&permissions=8&integration_type=0&scope=bot+applications.commands)

Ensuite, suivez les étapes indiquée dans la partie "**Configuration initiale**"

---

## Aperçu

Les visuels présentés sont des versions beta et sont susceptibles d’évoluer 😏.
À noter : la génération de visuels personnalisés (canvas customisés) est réservé aux serveurs premium/partenaires.

| Pari | Configuration |
| :---: | :---: |
| ![Pari](https://i.imgur.com/mNPSkra.png) | ![Configuration](https://i.imgur.com/fl4Gztl.png) |

| Gain | Match Libre |
| :---: | :---: |
| ![Gain](https://i.imgur.com/NeeEMtr.png) | ![Match Libre](https://i.imgur.com/zI6aDQZ.png) |

| Match Sport | Match Terminé |
| :---: | :---: |
| ![Match Sport](https://i.imgur.com/W7Ary4P.png) | ![Match Terminé](https://i.imgur.com/XFypLC6.png) |

| Statistiques |
| :---: |
| ![Statistiques](https://i.imgur.com/dhJKZqT.png) |
| *Stats d'un utilisateur sur un serveur anglophone!* |

---

## Sommaire

- Présentation
- Fonctionnalités principales
- Commandes (pour tous, gestionnaires, admins)
- Grades & Certifications
- Classements
- Configuration initiale (rapide)
- Premium et partenariats
- Support & Aide
- Crédits
- Roadmap

---

## Présentation

PronoBot transforme votre serveur Discord en plateforme de paris amicaux :
- Créez des matchs (sportifs ou personnalisés).
- Les membres peuvent parier des pièces virtuelles.
- Résolution automatique des matchs et mise à jour des statistiques.
- Classements et grades pour encourager la compétition.

Tout est pensé pour être accessible au grand public — pas besoin de connaissances techniques.

---

## Fonctionnalités principales

### 🎮 Système de Progression
- **⭐ Niveaux et XP** : Gagnez de l'expérience à chaque action (récompense quotidienne, paris gagnés ou perdus) et montez en niveau ! Chaque serveur possède son propre système de progression indépendant.
- **🏆 Classements dynamiques** : 5 catégories de classement (niveau, victoires, taux de réussite, défaites, ratio gains/pertes) pour une compétition saine entre membres.
- **🎖️ Grades globaux** : Grades visibles sur tous les serveurs (Joueur, VIP, Champion, Partenaire, Staff, Owner) avec badges de certification.

### 💰 Économie Virtuelle
- **Pièces virtuelles** : Montant de départ configurable, récompenses quotidiennes et gestion complète des gains/pertes.
- **💳 Affichage en temps réel** : Votre solde actuel et mise maximale sont affichés directement dans la modal de pari pour plus de clarté.
- **📊 Notifications de solde** : Recevez un message privé après chaque pari avec votre nouveau solde mis à jour.

### 🎲 Gestion des Matchs
- **Deux types de matchs** : Matchs sportifs (2 équipes + match nul) ou matchs libres (jusqu'à 9 choix personnalisables).
- **Paris simples et rapides** : Interface intuitive pour choisir et miser en quelques clics.
- **Résolution automatique** : Distribution instantanée des gains lors de la clôture d'un match.

### 🛡️ Administration & Modération
- **🚫 Système de restriction** : Les managers peuvent restreindre des utilisateurs pour les empêcher de parier via un rôle configurable.
- **🔐 Permissions par rôles** : Gestion fine des permissions (Admin, Manager, Restreint) pour un contrôle total.
- **⚙️ Commandes activables/désactivables** : Possibilité d'activer ou désactiver des commandes spécifiques par serveur.

### ✨ Interface Moderne
- **Commandes slash (/)** : Toutes les commandes utilisent le système moderne de Discord.
- **Menu contextuel** : Accès rapide aux statistiques via clic droit sur un utilisateur.
- **Emojis visuels** : Statuts de matchs clairs (🟢 ouvert, 🔴 fermé, 🏁 terminé).
- **🌍 Descriptions bilingues** : Les descriptions des commandes s'affichent automatiquement en français ou en anglais selon la langue du client Discord.

---

## Commandes principales

Toutes les commandes sont en Slash Commands **{/}**. Il y a aussi des commandes dans le menu contextuel d'un utilisateur _(clic droit sur un utilisateur > Applications)_

### Commandes utilisateurs

Les commandes ci‑dessous sont destinées aux utilisateurs lambda.

- /pb open
    Créer un compte PronoBot sur le serveur et recevoir les pièces de bienvenue.

- /pb close
    Supprimer définitivement votre compte sur ce serveur (confirmation requise).

- /pb balance
    Voir votre solde actuel.

- /pb daily
    Récupérer la récompense quotidienne (cooldown et gain configurable).

- /pb coinflip <choix>
    Lancer une pièce pour tenter le pile ou face.

- /pb stats [utilisateur]
    Voir les statistiques détaillées d'un joueur (classements, gains, etc.).

- /pb mybets
    Voir vos paris en cours.

- /pb top [catégorie]
    Voir les classements (par défaut Top 5, sinon Top 10 pour une catégorie donnée).
    Catégories : level, wins, winrate, losses, profitratio

- /vote
    Voter pour PronoBot sur Top.gg et soutenir le projet. L'embed explique pourquoi voter est important pour nous aider à grandir.

- /pbpremium
    Afficher des informations sur l'abonnement premium.

- /bet
    Placer un pari sur un match disponible. Naviguez entre les matchs avec ◀ ▶, consultez la liste complète des matchs actifs avec 📋, puis choisissez votre option et misez.

- /removebet
    Annuler un pari tant que le match n'est pas clos.

- Menu contextuel (clic droit > Apps)
    Voir rapidement les stats ou informations d’un utilisateur.


### Commandes de gestion (Rôle "Manager" configurable)

Ces commandes sont réservés aux utilisateurs qui possèdent le rôle assigné comme Manager (configurable)

- /match create
    Créer un match sport (_2 equipes, et un match nul_) ou un match libre (_plusieurs choix possible comme un sondage twitch_). Titre, choix, et date/heure pour terminer les paris configurable

- /match edit
    Modifier un match existant.

- /match delete
    Supprimer un match et rembourser les paris.

- /match close
    Clôturer un match et définir le résultat — distribution automatique des gains/pertes.

- /match deadline
    Modifier la date limite pour parier sur un match.

- /listmatches
    Lister tous les matchs actifs (possibilité de voir les match terminés également).

- /listallmatches
    Afficher TOUS les matchs (ouverts, fermés, terminés) sans filtre pour une vue d'ensemble rapide.

- /restrict <utilisateur>
    Restreindre un utilisateur en lui appliquant le rôle restreint configuré, l'empêchant de parier.

- /unrestrict <utilisateur>
    Retirer la restriction d'un utilisateur pour qu'il puisse à nouveau parier normalement.

- /serverinfo, /botinfo
    Informations sur le serveur et sa configuration ainsi que l'état technique du bot.

### Commandes administrateur (Rôle "Admin" configurable)

Ces commandes sont réservés aux utilisateurs qui ont la permission administrateur ou qui possèdent le rôle assigné comme Admin (configurable)

- /pb config [option] [valeur]
    Configurer le serveur (rôles, canaux, montants, etc.). Exemple: /pb config initialcoins 500

    Conseil: Configurer en 1er le role administrateur avec /pb config adminrole <role admin de votre serveur> ainsi que le role manager avec /pb config managerrole <role qui permettra de gérer les matchs>

- /pb viewconfig
    Afficher la configuration actuelle du serveur.

- /togglecommand <action> <commande>
    Activer/désactiver une commande sur le serveur (ainsi qu'une liste pour voir celles désactivées).

- /pb userinfo <utilisateur>
    Informations complètes sur un utilisateur (infos Discord + infos PronoBot).
    (disponible aussi dans le menu contextuel)

- /wipeuserdata
    **⚠️ COMMANDE DANGEREUSE** - Réinitialise toutes les données utilisateurs du serveur (pièces, statistiques, paris).
    Nécessite de taper "CONFIRMER" dans une modal pour valider. Les paramètres du serveur sont conservés.
    _par exemple pour faire un système de saisons?_
    **Cette action est irréversible !**

- /coins [add/remove/set/giveall] <utilisateur> <montant>
    Gérer les pièces des joueurs.
    _Exemple : /coins add @user 100_

---

## Grades & Certifications

Les grades sont globaux et visibles sur tous les serveurs où PronoBot est présent :

- Joueur — grade par défaut.
- VIP — accès premium.
- Champion — joueurs d'élite.
- Partenaire — partenaires officiels.
- Staff — équipe de modération du bot.
- Owner — propriétaire du bot.

Certification : badge visible indiquant que le joueur est vérifié

Les grades servent surtout à reconnaitre les meilleurs joueurs et différencier les membres de confiance (staff).

---

## Classements et Système de Niveaux

### 🏆 Classements

Cinq catégories principales :

1. **Niveau** — progression basée sur l'XP gagnée (propre à chaque serveur).
2. Victoires — nombre total de paris gagnés.
3. Taux de victoire — pourcentage de paris gagnés (minimum requis : 5 paris).
4. Défaites — nombre total de paris perdus.
5. Ratio Gains/Pertes — pièces gagnées / pièces perdues (minimum : au moins 1 perte).

### ⭐ Système d'Expérience et Niveaux

Le système d'XP et de niveaux est **entièrement propre à chaque serveur** — vos niveaux et XP sont indépendants d'un serveur à l'autre.

**Comment gagner de l'XP :**
- **Récompense quotidienne (/pb daily)** : +10 XP fixe
- **Paris gagnés** : 20 XP de base + 5% des pièces gagnées (min 20 XP, max 200 XP par pari)
- **Paris perdus** : +5 XP (récompense de participation)

**Progression de niveau :**
- La formule d'XP requise est : `(Niveau - 1)² × 100`
  - Niveau 1 : 0 XP (départ)
  - Niveau 2 : 100 XP
  - Niveau 3 : 400 XP
  - Niveau 4 : 900 XP
  - Niveau 5 : 1,600 XP
  - Niveau 10 : 8,100 XP

**Affichage :**
- Votre niveau et XP sont visibles dans `/pb stats`
- Barre de progression indiquant l'avancement vers le prochain niveau
- Classement par niveau disponible dans `/pb top level`

Affichage clair avec position : exemple "#2 sur 25". Les joueurs qui n'ont pas assez de données n'apparaissent pas dans certaines catégories.

---

## Configuration initiale (rapide)

1. Invitez le bot sur votre serveur.
2. Définissez les rôles via /pb config (adminrole, managerrole, restrictedrole).
3. Définissez les canaux via /pb config : annonces, salon réservés aux paris, salon d'annonces des matchs.
4. Définissez les paramètres économiques : initialcoins (montant donné à la création d'un compte pronobot sur votre serveur), dailyamount (montant donné par le /pb daily, 1 fois par jour).
5. Créez un premier match avec /match create et testez les paris en tant qu'utilisateur.

Conseil : commencez avec de petites valeurs (pièces de départ et récompense quotidienne) pour tester le système avant d’augmenter.

---

## Premium et Partenariats

La version premium permet de faire passer votre serveur à un niveau supérieur, le bot aura des fonctionnalités uniques telles que la génération d'**images personnalisées** qui remplaceront les embeds classiques de discord !

Pour devenir un **partenaire officiel** de PronoBot et ainsi avoir accès à un support direct avec le staff et l'abonnement **Premium gratuitement**, veuillez ouvrir un ticket sur le [discord officiel](https://discord.gg/rbrPpWbEnV) _(https://discord.gg/rbrPpWbEnV)_

## Support & Aide

- Rejoignez le serveur Discord (https://discord.gg/rbrPpWbEnV) pour demander de l'aide.
- Ouvrez un ticket sur le discord si vous rencontrez un bug ou que vous souhaitez faire une suggestion
- FAQ rapide :
    - "Le bot ne répond pas" → vérifier que le bot est en ligne et a les permissions nécessaires.
    - "Je ne peux créer des matchs" → vérifier que vous avez bien configurer les rôles admins et manager ainsi que les salons dans le /pb config
    - "Vous n'avez pas de compte" → utilisez /pb open.
    - "Commande désactivée" → un administrateur l’a peut‑être désactivée (/togglecommand list).

---

## Crédits

Développé par Zyksa et Hokanosekai ❤️

Utilise Node.js et une base de données (supabase) pour stocker les comptes et statistiques.

---

## Roadmap (idées futures)

- Ligues et divisions
- Matchs dynamiques (côte qui fluctuent en fonction du nombres de paris posés dessus)
- Paris combinés
- Événements saisonniers
- Boutique de récompenses
- Quêtes journalières et achievements
- Dashboard web et API pour les statistiques

---

Merci d'utiliser PronoBot ! Transformez votre serveur en arène de paris conviviale et compétitive. 🎲🏆

PronoBot

🎲 PronoBot — Bot Discord de Bookmaker (Pronostics en tout genre) 100% configurable


Votando por PronoBot

¿Quieres apoyarnos?