BSensei GYM

🏋️ BSENSEI GYM

Transforme la salle de sport de ton serveur en véritable système de progression physique, avec compétences persistantes, exercices immersifs et bonus réels en jeu.

🌆 Présentation

BSensei Gym est un système complet de sport et de compétences physiques conçu pour FiveM sous ESX Legacy.

Les joueurs peuvent s’entraîner dans différentes salles, améliorer leurs statistiques et obtenir des avantages réels, modérés et équilibrés pour préserver la cohérence du roleplay.

Le script fonctionne automatiquement et ne nécessite aucun métier, aucun patron et aucune gestion d’entreprise.

💪 Cinq compétences persistantes

• Endurance : améliore la récupération d’énergie pendant la course
• 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 vitesse de course et de nage
• Maîtrise du tir : réduit progressivement le recul des armes sans modifier leurs dégâts

Chaque compétence possède :

• Son propre niveau
• Sa propre barre d’expérience
• Une progression sauvegardée en SQL
• Un bonus physique réel et configurable
• Une limite maximale pour éviter les avantages excessifs

🏃 Neuf exercices immersifs

Le script contient 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 augmenter une compétence principale ainsi qu’une compétence secondaire.

La durée, l’expérience obtenue, la fatigue et les animations sont entièrement configurables.

🖥️ Interface NUI personnalisée

Les joueurs disposent d’une interface moderne aux couleurs 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 de la protéine
• Les objectifs quotidiens
• L’état de l’abonnement à la salle

Le menu est accessible avec :

• /stats
• Une touche configurable dans les paramètres FiveM

🎯 Objectifs quotidiens

Les joueurs disposent d’objectifs quotidiens liés à leur activité sportive.

Le système peut suivre notamment :

• Le nombre d’exercices réalisés
• L’expérience gagnée naturellement
• La progression quotidienne du joueur

Les objectifs sont automatiquement renouvelés et leur configuration peut être adaptée dans le fichier principal.

🥤 Protéine avec bonus d’expérience

Un item protein_shake est fourni pour ox_inventory.

Par défaut, la protéine offre :

• 30 minutes de bonus
• Un multiplicateur d’expérience de x1,50
• Une durée restante sauvegardée en SQL
• La possibilité d’ajouter du temps en consommant une nouvelle protéine

L’objet est vérifié et retiré directement côté serveur afin d’empêcher l’utilisation frauduleuse de l’événement client.

🌿 Progression naturelle

Les joueurs peuvent également progresser en dehors de la salle.

• Courir augmente progressivement l’endurance et l’agilité
• Plonger augmente progressivement le souffle et l’endurance
• Utiliser une arme augmente progressivement la maîtrise du tir

La progression naturelle rapporte volontairement moins d’expérience que les exercices effectués dans une salle.

Les combats entre joueurs ne donnent aucun point d’expérience.

😮‍💨 Fatigue progressive

Chaque exercice augmente la fatigue du personnage.

Lorsque le joueur devient trop fatigué, il doit attendre avant de reprendre son entraînement.

• Fatigue maximale configurable
• Seuil de blocage configurable
• Récupération automatique hors entraînement
• Avertissement lorsque la fatigue devient élevée

Ce système évite les entraînements en boucle et améliore l’équilibrage du serveur.

📉 Perte configurable des compétences

La progression peut diminuer lorsqu’un joueur reste trop longtemps sans effectuer d’activité physique.

Par défaut :

• Aucune perte pendant les trois premiers jours d’inactivité
• Perte de 0,50 % toutes les 24 heures ensuite
• Course, plongée et tir peuvent remettre le compteur d’inactivité à zéro

Ce système peut être entièrement désactivé ou ajusté dans le fichier de configuration.

🧩 Mini-jeu facultatif

Un mini-jeu basé sur ox_lib peut être lancé avant chaque exercice.

• Activation ou désactivation dans la configuration
• Difficultés personnalisables
• Touches configurables
• Fatigue réduite en cas d’échec
• Annulation immédiate de l’exercice si le défi est raté

Le mini-jeu est désactivé par défaut et reste entièrement facultatif.

🎯 ox_target ou marqueur avec la touche E

Deux modes d’interaction sont disponibles pour les appareils :

• ox_target : une interaction indépendante pour chaque exercice
• Marker : un petit marqueur au sol avec la touche E

Si ox_target n’est pas disponible, le script peut automatiquement utiliser le mode marker.

Le PNJ coach reste exclusivement accessible avec ox_target.

🧍 PNJ coach et abonnements

Chaque salle peut disposer de son propre coach.

Le système d’abonnement peut être activé ou désactivé.

Exemples de formules incluses :

• Pass journée
• Pass 7 jours
• Pass 30 jours

Les prix, les durées et le compte utilisé pour le paiement sont configurables.

🔒 Verrouillage des appareils

Un appareil déjà utilisé est automatiquement verrouillé pour les autres joueurs.

Ce système empêche deux personnes de lancer simultanément une animation sur la même machine.

Le verrouillage est automatiquement libéré à la fin, lors d’une annulation ou lorsque le joueur quitte la séance.

📍 Placement précis des exercices

Plusieurs outils sont intégrés pour faciliter l’installation dans n’importe quel mapping ou MLO.

Commande de coordonnées

/gymcoords affiche directement une ligne vec4 complète dans la console F8.

Placement avec mannequin fantôme

/gymplace [identifiant] crée un clone semi-transparent du personnage dans la pose correspondant à l’exercice.

La position de l’interaction et celle de l’animation peuvent être configurées séparément.

🏢 Plusieurs salles configurables

Le script permet d’ajouter autant de salles que nécessaire.

Chaque salle peut posséder :

• Un identifiant unique
• Un nom personnalisé
• Un blip
• Un PNJ coach
• Ses propres appareils
• Ses propres positions d’animation
• Plusieurs tapis roulants

Une configuration pour Muscle Sands est fournie comme exemple prêt à l’emploi.

🏆 Fais de l’entraînement une véritable progression RP

Avec BSensei Gym, la salle de sport ne sert plus uniquement de décor.

Les joueurs s’entraînent, progressent, se fatiguent et développent durablement les capacités physiques de leur personnage.