🚀 Guide d’installation — Vantage RP

Ce guide s’adresse aux propriétaires de serveur. Il te fait passer d’un Discord vide à un serveur RP jouable. Compte une dizaine de minutes.

Aucune compétence technique n’est requise : pas d’hébergement à louer, pas de code à écrire. Le bot est hébergé chez nous.

Étape 1 — Ajouter le bot

1. Va sur https://vantagerp.fr/ajouter-le-bot et clique sur Ajouter le bot.
2. Choisis ton serveur Discord dans la liste.
3. Laisse les permissions cochées et valide.

Le bot apparaît immédiatement dans ta liste de membres.

Pourquoi ces permissions ? Le bot crée les salons, attribue les rôles métier et envoie les messages de jeu. S’il lui en manque une, la commande concernée échouera en te disant laquelle.

Étape 2 — Créer ton identité

Avant toute autre commande, tape /identite et remplis le formulaire, comme le feront tes joueurs. Sans carte d’identité, le bot refuse les autres commandes, /setup compris (« 🔒 Tu dois d’abord créer ton identité »).

En tant que propriétaire du serveur, tu reçois automatiquement le rôle fondateur : c’est lui qui t’ouvre le panel staff.

Étape 3 — Lancer /setup

Tape /setup dans n’importe quel salon. Seul le propriétaire du serveur peut l’utiliser. Un menu s’ouvre (visible par toi seul) : il n’y a rien à retenir, tout se fait au clic.

L’écran montre les neuf salons du bot et quatre boutons.

🎮 Discord

Associe chaque fonction à un salon existant de ton serveur : Menu, Téléphone, Métier, Inventaire, Actions, FAQ, Dashboard, Sessions et Création d’identité. Les salons défilent deux par deux (Suivant ▶). Sur la page Sessions, choisis aussi le rôle à mentionner quand une session démarre.

Clique sur 💾 Sauvegarder : le bot publie dans chaque salon un message permanent avec un bouton (« Démarrer le Menu », « Créer / Voir ma CNI »…). Le salon FAQ, lui, répond automatiquement aux questions écrites par les joueurs.

🎨 Personnaliser

Le nom, les couleurs et le logo de ton serveur, repris dans les messages du bot et sur le panel de tes joueurs. Les joueurs voient ton identité, pas la nôtre. Gratuit. Le menu propose :

• Identité : nom du serveur, surnom du bot, titre du dashboard ;
• Couleurs & thème : couleurs principale et secondaire (code #rrggbb), mode dark ou light ;
• Logo & images : réponds oui, puis glisse l’image dans le salon dans les 60 secondes (logo, bannière, avatar du bot) ;
• Message d’accueil : le texte affiché en haut du dashboard des joueurs ;
• Serveurs liés : voir ci-dessous.

🔗 Serveurs liés

Ta police, ton hôpital, une entreprise ou un gang ont leur propre Discord ? Relie-les à ton serveur principal (types Police, EMS, Entreprise, Gang, Gouvernement) avec leur lien d’invitation ou leur identifiant. Les données RP sont partagées : les joueurs gardent leur identité, leur argent et leur métier, sans rien recréer. Le bot doit aussi être présent sur le serveur lié ; s’il n’y est pas, un bouton te permet de l’ajouter, puis tu relances la liaison.

Une fois lié, le bot peut déployer une structure complète sur ce serveur (pour la police : 23 salons et 11 rôles). Depuis le bouton 🔗 Serveurs liés de /setup, tu peux aussi vérifier la présence du bot, diffuser une annonce sur tous tes serveurs liés d’un coup, ou délier un serveur.

⚠️ Le déploiement supprime tous les salons et tous les rôles du serveur lié avant de créer la structure. C’est irréversible. Fais-le uniquement sur un serveur neuf, créé pour l’occasion.

🌐 Dashboard

Ouvre ton panel staff dans le navigateur. Si tu n’es pas encore connecté, passe par /dashboard, puis la tuile Staff de ton tableau de bord.

Étape 4 — Tes joueurs jouent

Il n’y a plus rien à faire côté staff. Tes joueurs tapent :

/identite est la première chose à faire. Sans CNI, un joueur n’a ni téléphone, ni inventaire, ni métier : le personnage n’existe pas encore.

Le dashboard s’installe comme une application sur téléphone (PWA) : « Ajouter à l’écran d’accueil » depuis le navigateur.

Configurer les métiers

Depuis le panel staff → Rôles métier, tu déclares tes entreprises (police, EMS, mécano, ou les tiennes).

Pour chacune, tu peux renseigner deux rôles Discord :

• le rôle employé ;
• le rôle directeur.

Le bot fait ensuite le lien tout seul, dans les deux sens : donne le rôle sur Discord, le joueur l’obtient sur le panel ; retire-le sur le panel, il disparaît de Discord.

Un joueur qui a les deux rôles est traité comme directeur (le grade le plus élevé l’emporte).

Les sessions RP

Une session, c’est une partie annoncée à heure fixe. Le staff la lance, les joueurs s’inscrivent avec /sessions, et le bot affiche le PSN de l’hôte au moment de rejoindre.

Tu peux la créer depuis le panel staff → Sessions.

Questions fréquentes

Combien ça coûte ?

Rien. Le bot est gratuit et sans limite de joueurs : toutes les fonctionnalités RP sont accessibles sans payer. Une courte publicité finance le projet (par exemple à l’ouverture du dashboard ou pour rejoindre une session).

Des packs Premium optionnels existent pour soutenir le projet et débloquer du confort — jamais obligatoires :

• Packs serveur (Serveur Sans Pub, Serveur Premium) — plus aucune pub pour tous les joueurs de ton serveur. C’est au propriétaire de les prendre.
• Packs joueur (Confort, Confort+, à vie) — confort personnel sur un compte.

Les tarifs sont sur https://vantagerp.fr/tarifs.

Le bot est-il visible par mes concurrents ?

Non. Le panel de tes joueurs porte ton nom, tes couleurs et ton logo si tu les as configurés dans /setup → 🎨 Personnaliser.

Faut-il un serveur / un hébergement ?

Non. Tout tourne chez nous. Tu n’as qu’un Discord à gérer.

Le bot marche-t-il sur console (PS5 / Xbox) ?

Oui, et c’est précisément sa raison d’être. Les joueurs console n’ont pas de mods : le téléphone, l’inventaire et les métiers passent par le panel web, qui s’ouvre dans un navigateur — donc depuis n’importe quel téléphone, à côté de la console.

J’ai supprimé un salon configuré pour le bot, c’est grave ?

Non. Crée un nouveau salon, relance /setup → 🎮 Discord et choisis-le : le message permanent y est republié. Les données des joueurs (CNI, inventaire, argent) vivent en base, pas dans les salons : elles ne bougent pas.

Je ne vois pas le panel staff

Il faut un rôle staff. Le propriétaire du serveur y a accès d’office ; les autres membres doivent recevoir un rôle staff depuis le panel → Rôles.

Besoin d’aide

• La documentation complète : https://vantagerp.fr/documentation
• Le Discord de support, pour parler à quelqu’un : https://vantagerp.fr/support