Skip to content

feat(player-stats): add configurable stamina and strength modifiers by gender#1735

Merged
N0tNvll merged 4 commits intoesx-framework:devfrom
AlexRXWindy:adjust-player-stats
Oct 19, 2025
Merged

feat(player-stats): add configurable stamina and strength modifiers by gender#1735
N0tNvll merged 4 commits intoesx-framework:devfrom
AlexRXWindy:adjust-player-stats

Conversation

@AlexRXWindy
Copy link
Copy Markdown

Description

This PR adds the ability for server owners to configure different stamina and strength multipliers based on player gender/sex. The feature integrates seamlessly into the existing adjustments system and provides flexible configuration options for roleplay servers.


Implementation Details

Added new configuration option Config.PlayerStatsByGender in adjustments config
Implements gender detection through two methods:

Character data from database (ESX.PlayerData.sex)
Visual ped model detection (freemode models)

Uses native multipliers for real-time gameplay effects:

SetRunSprintMultiplierForPlayer() for sprint speed
SetSwimMultiplierForPlayer() for swim speed
SetPlayerMeleeWeaponDamageModifier() for melee damage
SetPedMoveRateOverride() for movement speed

Listens to ESX events for automatic stat updates:

esx:playerLoaded - Initial application
skinchanger:modelLoaded - On skin change
esx:onPlayerSpawn - On respawn

No server-side code required, uses only ESX.PlayerData


Usage Example

-- In shared/config/adjustments.lua
Config.PlayerStatsByGender = {
    enabled = true,                    -- Enable/disable the feature
    useCharacterData = true,            -- true: uses ESX.PlayerData.sex | false: uses ped model/skin
    debugMode = false,                  -- Enable debug prints for testing
    male = {
        stamina = 1.0,                  -- Default multiplier (no change)
        strength = 1.0                  -- Default multiplier (no change)
    },
    female = {
        stamina = 1.15,                 -- 15% more stamina/speed
        strength = 0.85                 -- 15% less melee damage
    }
}

-- Feature is automatically applied when player loads
-- No additional setup required

@N0tNvll N0tNvll merged commit b62f353 into esx-framework:dev Oct 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants