Présentation
🏋️ BSensei Gym — Sport & progression physique
Transformez les salles de sport de votre serveur en véritable système de progression RP avec exercices immersifs, compétences persistantes et bonus physiques réels.
🌆 Présentation
BSensei Gym est un système complet de sport et de compétences physiques conçu pour FiveM sous ESX Legacy.
Le script permet aux joueurs de s’entraîner dans différentes salles, de gagner de l’expérience et d’améliorer progressivement les capacités physiques de leur personnage.
Il fonctionne automatiquement et ne nécessite :
Aucun métier
Aucun patron
Aucune entreprise
Aucune gestion administrative quotidienne
La progression est enregistrée dans la base de données et conservée après les redémarrages du serveur.
💪 Cinq compétences persistantes
Chaque joueur possède cinq compétences indépendantes :
| Compétence | Effet principal |
|---|---|
| Endurance | Améliore la récupération d’endurance |
| Force | Augmente légèrement les dégâts au corps-à-corps |
| Souffle | Permet de rester plus longtemps sous l’eau |
| Agilité | Améliore légèrement la course et la nage |
| Maîtrise du tir | Réduit progressivement le recul ajouté par le script |
Les bonus sont volontairement modérés afin de préserver l’équilibrage RP du serveur.
La maîtrise du tir ne modifie jamais les dégâts des armes.
🏃 Exercices immersifs
Le script propose plusieurs exercices avec des animations différentes :
Développé couché
Haltères
Pompes
Abdominaux
Tractions
Cardio
Tapis roulant
Boxe
Yoga et respiration
Chaque exercice peut contenir :
- une compétence principale ;
- une compétence secondaire ;
- une durée personnalisée ;
- une quantité d’expérience ;
- une animation propre ;
- un niveau de fatigue ;
- un mini-jeu facultatif.
🖥️ Interface NUI personnalisée
Les joueurs disposent d’un menu NUI moderne noir, violet et or.
Le menu affiche notamment :
- les cinq compétences ;
- le niveau actuel ;
- l’expérience obtenue ;
- l’expérience nécessaire au prochain niveau ;
- les bonus physiques actifs ;
- la fatigue du personnage ;
- la durée restante du bonus protéine ;
- les objectifs quotidiens ;
- l’état de l’abonnement.
Le menu est accessible avec :
/stats
La touche par défaut est :
I
Chaque joueur peut modifier cette touche dans les paramètres FiveM.
🎯 Objectifs quotidiens
Le script propose des objectifs renouvelés quotidiennement.
Par défaut, le joueur doit notamment :
Effectuer plusieurs entraînements
Gagner de l’expérience naturellement
Maintenir une activité sportive régulière
Les valeurs peuvent être modifiées dans config.lua.
🥤 Protéine XP
Un objet protein_shake est fourni pour ox_inventory.
Par défaut, il offre :
Durée : 30 minutes
Multiplicateur : x1,50 XP
Durée cumulable : oui
Sauvegarde SQL : oui
L’objet est contrôlé et retiré directement côté serveur.
Un joueur ne peut donc pas activer gratuitement le bonus en déclenchant uniquement un événement client.
🌿 Progression naturelle
Les joueurs peuvent également progresser en dehors de la salle.
La progression naturelle comprend :
Course → Endurance et agilité
Plongée → Souffle et endurance
Tir → Maîtrise du tir
Cette progression rapporte volontairement moins d’expérience qu’un exercice réalisé dans une salle.
Les combats entre joueurs ne donnent aucun XP.
😮💨 Fatigue progressive
Chaque exercice augmente la fatigue du personnage.
Lorsque le seuil maximal est presque atteint, le joueur doit attendre avant de reprendre son entraînement.
Le système comprend :
- une fatigue maximale configurable ;
- un seuil de blocage ;
- un avertissement ;
- une récupération automatique hors entraînement ;
- une fatigue réduite en cas d’échec au mini-jeu.
📉 Perte des compétences
La progression peut diminuer lorsqu’un joueur reste trop longtemps sans activité.
Configuration par défaut :
Aucune perte pendant 3 jours
Perte de 0,50 % toutes les 24 heures ensuite
Course, plongée et tir réinitialisent le compteur
La perte des compétences peut être modifiée ou entièrement désactivée.
🧩 Mini-jeu facultatif
Un mini-jeu basé sur ox_lib peut être lancé avant un exercice.
Il est possible de configurer :
- son activation ;
- sa difficulté ;
- les touches utilisées ;
- la fatigue reçue après un échec.
Lorsqu’un joueur échoue, l’exercice est immédiatement annulé.
🎯 Deux modes d’interaction
Les appareils peuvent fonctionner avec :
ox_target
ou :
Marker avec la touche E
Le mode est sélectionné dans config.lua.
Si ox_target n’est pas démarré, le script peut automatiquement utiliser les marqueurs pour les appareils.
Le PNJ coach reste uniquement accessible avec ox_target.
🧍 Coach et abonnements
Chaque salle peut posséder son propre PNJ coach.
Un système d’abonnement facultatif est intégré.
Formules proposées par défaut :
| Abonnement | Durée |
|---|---|
| Pass journée | 1 jour |
| Pass semaine | 7 jours |
| Pass mensuel | 30 jours |
Les prix, les durées et le compte de paiement sont configurables.
Le système d’abonnement peut également être entièrement désactivé.
🔒 Verrouillage des appareils
Lorsqu’un joueur utilise une machine, celle-ci est temporairement verrouillée.
Cela évite que plusieurs joueurs lancent simultanément une animation au même endroit.
Le verrouillage est supprimé automatiquement :
- à la fin de l’exercice ;
- après une annulation ;
- en cas d’interruption ;
- lorsque le joueur quitte la séance.
📍 Placement précis avec mannequin fantôme
La commande suivante permet de placer précisément une animation :
/gymplace [identifiant]
Un clone semi-transparent du joueur apparaît avec la pose correspondant à l’exercice.
Le véritable personnage n’est pas déplacé.
Commandes disponibles :
Flèches directionnelles → Déplacer
+ du pavé numérique → Monter
- du pavé numérique → Descendre
Molette → Rotation
SHIFT → Déplacement rapide
ENTRÉE → Valider
RETOUR → Annuler
Après validation, la ligne animationCoords complète est affichée dans la console F8.
🧭 Outils de placement
Récupérer les coordonnées
/gymcoords
Affiche une ligne vec4(...) directement dans la console F8.
Afficher les points
/gymdebug
Affiche l’état d’ox_target et dessine les différents points d’exercice.
Placer une animation
/gymplace [identifiant]
Permet de séparer précisément :
La position de l’interaction
La position du personnage
La rotation de l’animation
🏢 Plusieurs salles configurables
Il est possible d’ajouter autant de salles que nécessaire.
Chaque salle peut posséder :
- un identifiant unique ;
- un nom ;
- un centre ;
- un blip ;
- un coach ;
- ses propres appareils ;
- ses propres tapis roulants ;
- ses propres coordonnées d’animation.
Une configuration d’exemple pour Muscle Sands est déjà incluse.
🛡️ Sécurité côté serveur
Les principales actions sont vérifiées côté serveur :
Distance avec l’appareil
Durée réelle de l’exercice
Cooldowns
Abonnement
Plafond d’expérience
Utilisation de la protéine
Progression naturelle
Sauvegarde des statistiques
Les gains naturels et les entraînements sont également limités afin d’éviter les abus.
🧩 Informations techniques
| Élément | Compatibilité |
|---|---|
| Framework | ESX Legacy |
| Menus secondaires | ox_lib |
| Base de données | oxmysql |
| Inventaire | ox_inventory |
| Interactions | ox_target ou marker |
| Notifications et progression | 17mov_Hud |
| Interface | NUI personnalisée |
| Langue incluse | Français |
| Version | 1.7.4 |
| Protection | FiveM Asset Escrow |
📦 Contenu du pack
Le téléchargement comprend :
BSensei Gym
Interface NUI personnalisée
Configuration complète
Fichier SQL
Item ox_inventory
Image PNG de la protéine
Image SVG de la protéine
Configuration Muscle Sands
Documentation d’installation
🎮 Commandes principales
/stats
Ouvre l’interface des statistiques sportives.
/gymcoords
Affiche les coordonnées actuelles.
/gymplace [id]
Lance le placement précis avec mannequin fantôme.
/gymdebug
Affiche les points et l’état des interactions.
/addgymxp
Ajoute de l’expérience à un joueur.
/resetgymstats
Réinitialise les statistiques sportives d’un joueur.