🏋️ BSENSEI GYM

Transform your server’s gym into a complete physical progression system with persistent skills, immersive exercises and real in-game bonuses.

🌆 Overview

BSensei Gym is a complete sports and physical skills system designed for FiveM using ESX Legacy.

Players can train in different gyms, improve their statistics and gain real, moderate and balanced advantages while preserving roleplay consistency.

The script works automatically and requires no job, no boss and no business management.

💪 Five persistent skills

• Stamina: improves energy recovery while running
• Strength: slightly increases melee damage
• Lung capacity: allows players to remain underwater for longer
• Agility: slightly improves running and swimming speed
• Shooting proficiency: progressively reduces weapon recoil without changing weapon damage

Each skill has:

• Its own level
• Its own experience bar
• Progression saved in SQL
• A real and configurable physical bonus
• A maximum limit to prevent excessive advantages

🏃 Nine immersive exercises

The script includes several exercises with different animations:

• Bench press
• Dumbbells
• Push-ups
• Sit-ups
• Pull-ups
• Cardio
• Treadmill
• Boxing
• Yoga and breathing exercises

Each exercise can increase one primary skill as well as one secondary skill.

The duration, experience gained, fatigue and animations are fully configurable.

🖥️ Custom NUI interface

Players have access to a modern interface featuring black, purple and gold colors.

The menu displays:

• The five skills
• The current level
• The experience gained
• The experience required for the next level
• Active physical bonuses
• The character’s fatigue
• The remaining protein bonus duration
• Daily objectives
• Gym membership status

The menu can be accessed with:

• /stats
• A configurable key inside the FiveM settings

🎯 Daily objectives

Players have daily objectives linked to their sporting activity.

The system can track:

• The number of completed exercises
• Experience gained naturally
• The player’s daily progression

Objectives are automatically renewed and their configuration can be adjusted inside the main file.

🥤 Protein experience bonus

A protein_shake item is included for ox_inventory.

By default, the protein shake provides:

• 30 minutes of bonus time
• An experience multiplier of x1.50
• Remaining duration saved in SQL
• The ability to add more time by consuming another protein shake

The item is checked and removed directly server-side to prevent fraudulent use of the client event.

🌿 Natural progression

Players can also progress outside the gym.

• Running progressively increases stamina and agility
• Diving progressively increases lung capacity and stamina
• Using a weapon progressively increases shooting proficiency

Natural progression intentionally provides less experience than exercises completed inside a gym.

Combat between players does not provide any experience points.

😮‍💨 Progressive fatigue

Each exercise increases the character’s fatigue.

When the player becomes too tired, they must wait before training again.

• Configurable maximum fatigue
• Configurable blocking threshold
• Automatic recovery outside training sessions
• Warning when fatigue becomes high

This system prevents repetitive training loops and improves server balance.

📉 Configurable skill decay

Progression can decrease when a player remains physically inactive for too long.

By default:

• No skill loss during the first three days of inactivity
• A loss of 0.50% every 24 hours afterward
• Running, diving and shooting can reset the inactivity timer

This system can be fully disabled or adjusted inside the configuration file.

🧩 Optional mini-game

A mini-game based on ox_lib can be launched before each exercise.

• Enable or disable it inside the configuration
• Customizable difficulty levels
• Configurable keys
• Reduced fatigue in case of failure
• Immediate cancellation of the exercise if the challenge is failed

The mini-game is disabled by default and remains completely optional.

🎯 ox_target or marker with the E key

Two interaction modes are available for the equipment:

• ox_target: an independent interaction for each exercise
• Marker: a small ground marker using the E key

If ox_target is unavailable, the script can automatically use marker mode.

The coach NPC remains exclusively accessible through ox_target.

🧍 Coach NPC and memberships

Each gym can have its own coach.

The membership system can be enabled or disabled.

Examples of included membership options:

• Day pass
• 7-day pass
• 30-day pass

Prices, durations and the account used for payment are configurable.

🔒 Equipment locking

Equipment already being used is automatically locked for other players.

This system prevents two people from starting an animation on the same machine at the same time.

The lock is automatically released at the end of the exercise, when it is cancelled or when the player leaves the session.

📍 Precise exercise placement

Several tools are included to simplify installation inside any mapping or MLO.

Coordinates command

/gymcoords directly displays a complete vec4 line inside the F8 console.

Placement with a ghost mannequin

/gymplace [identifier] creates a semi-transparent clone of the character using the pose corresponding to the exercise.

The interaction position and animation position can be configured separately.

🏢 Multiple configurable gyms

The script allows you to add as many gyms as required.

Each gym can have:

• A unique identifier
• A custom name
• A blip
• A coach NPC
• Its own equipment
• Its own animation positions
• Multiple treadmills

A ready-to-use Muscle Sands configuration is included as an example.

🏆 Turn training into real RP progression

With BSensei Gym, the gym is no longer just decoration.

Players train, progress, become tired and permanently develop their character’s physical abilities.