> For the complete documentation index, see [llms.txt](https://bluesidenl.gitbook.io/wiki-staff-blueside/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bluesidenl.gitbook.io/wiki-staff-blueside/documents/parrainage.md).

# Parrainage

Le parrainage côté staff : règles anti double compte (dont celles cachées aux joueurs), suivi dans le F4, annulation et réglages.

Les joueurs parrainent leurs amis avec `/parrainage` : le filleul reçoit **5 000 €** et le parrain **2 500 €** quand le filleul atteint **2 h de jeu** (5 filleuls maximum par parrain). La page joueur est sur le wiki public : [Parrainage](https://bluesidenl.gitbook.io/wiki/boutique/parrainage). Cette page explique ce que le staff voit et fait.

## 🔒 <mark style="color:blue;">Les contrôles anti double compte</mark>

Un code est refusé à la saisie (et un parrainage en attente est annulé au moment du versement si un contrôle échoue) dans ces cas. Le joueur voit seulement « Ce code de parrainage ne peut pas être utilisé avec votre compte » : le **motif réel** n'apparaît que dans le F4 staff et dans **logs-parrainage**.

| Motif (tel qu'affiché au staff)                     | Ce qui est vérifié                                                                     |
| --------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Son propre code / Même compte Steam                 | Le filleul utilise le code de son propre compte                                        |
| Adresse IP commune avec le parrain                  | Les deux comptes Steam ont déjà joué, un jour, depuis une même adresse IP              |
| Adresse IP commune avec un autre filleul du parrain | Le filleul partage une IP avec un autre filleul (en attente ou validé) du même parrain |
| Connexion par VPN / proxy                           | L'IP du filleul est classée VPN / proxy au moment de la saisie                         |
| Parrainage croisé                                   | Le filleul est déjà le parrain de son parrain                                          |
| Compte Steam créé le … (moins de 3 jours)           | Compte Steam trop récent (date de création Steam publique)                             |
| Arrivé depuis trop longtemps                        | Code saisi plus de 7 jours après la première connexion au serveur                      |
| Parrain sans le temps de jeu requis                 | Le parrain a moins de 5 h de jeu                                                       |
| Parrain complet                                     | Le parrain a déjà 5 filleuls en attente ou validés                                     |

{% hint style="danger" %}
**Ne jamais révéler au joueur la condition sur l'âge du compte Steam**, ni le détail d'un refus : on répond seulement que le parrainage ne peut pas être accepté. Les autres règles (même connexion internet, VPN, 7 jours, 5 h de jeu du parrain) sont publiques.
{% endhint %}

Autres protections : un seul code par compte et à vie (même s'il est refusé ensuite ou expire), 5 refus maximum par heure (anti essai de codes au hasard), parrainage expiré si le filleul n'atteint pas 2 h de jeu en 14 jours (la place du parrain est libérée).

## 🖥️ <mark style="color:purple;">Suivre les parrainages (F4)</mark>

`F4` › Administration › Récompenses › **Parrainages** (permission `parrainage.gerer`, Administrateur) :

* **Tous les parrainages** / **En attente uniquement** : bascule du filtre, avec le nombre de validés et d'en attente ;
* **Codes refusés** : les 60 dernières tentatives refusées, avec le joueur, son Steam ID, le code tenté et le motif réel ;
* une ligne par parrainage (« Filleul ← Parrain », date, statut) : la fiche donne les Steam ID, le code, les gains, le temps de jeu du filleul et le motif d'une annulation.

Sur un parrainage **en attente**, le bouton **Annuler** l'arrête : aucun gain ne sera versé et la place du parrain est libérée. L'action est journalisée (logs staff et logs-parrainage).

## 🚨 <mark style="color:orange;">En cas d'abus</mark>

{% stepper %}
{% step %}

### Vérifier

Comparer les comptes dans **logs-parrainage**, l'Intranet staff (liaisons Steam / IP) et le temps de jeu. Plusieurs filleuls créés le même jour, jamais connectés en même temps que le parrain, ou qui ne jouent que jusqu'à 2 h sont des signaux forts.
{% endstep %}

{% step %}

### Arrêter

Parrainage encore en attente : **Annuler** depuis le F4. Déjà validé : retirer l'argent versé (ligne « Parrainage » dans la banque du joueur), voir [Remboursement](/wiki-staff-blueside/documents/remboursement.md) pour les outils.
{% endstep %}

{% step %}

### Sanctionner

Le double compte pour toucher des récompenses est une triche : sanction selon le [tableau des sanctions](/wiki-staff-blueside/documents/tableau-des-sanctions.md).
{% endstep %}
{% endstepper %}

## ⚙️ <mark style="color:green;">Réglages</mark>

`F4` › Administration › Configuration › Récompenses › **Parrainage** (permission `parrainage.gerer`) :

| Réglage                                         | Valeur actuelle                                          |
| ----------------------------------------------- | -------------------------------------------------------- |
| Parrainage (activé / désactivé)                 | Activé                                                   |
| Gain du parrain (par filleul validé)            | 2 500 €                                                  |
| Gain du filleul                                 | 5 000 €                                                  |
| Filleuls maximum par parrain                    | 5                                                        |
| Temps de jeu de validation (filleul)            | 120 min                                                  |
| Délai de validation avant expiration            | 14 jours                                                 |
| Fenêtre de saisie après l'arrivée               | 7 jours                                                  |
| Temps de jeu du parrain pour activer son code   | 300 min                                                  |
| Âge minimum du compte Steam (caché aux joueurs) | 3 jours                                                  |
| Clé API Steam                                   | Configurée (sert à lire la date de création des comptes) |

{% hint style="info" %}
Un profil Steam privé ne donne pas sa date de création : le contrôle d'âge est alors ignoré, les autres contrôles s'appliquent toujours. Les gains apparaissent dans la banque avec le libellé « Parrainage ».
{% endhint %}

Journal Discord : salon **logs-parrainage** (catégorie Logs Administration) : nouveaux parrainages, refus avec leur motif, validations et versements, expirations, annulations.