en-skills

en-skills adds skills that improve as you use them:

Each skill level adds small bonuses, such as more stamina, more carry weight, faster searches or better lockpicking, which other resources read.

Your character's en-core level also earns perk points, which you spend in a perk tree (press K). A perk can require a skill level, a character level or other perks, and gives a bigger bonus. You can reset your perks for cash, on a cooldown.

#At a glance

#How it works

#Levels

Skills go from level 1 to Config.maxLevel. Reaching level 2 takes curve.base XP, and each later level takes curve.growth times the XP of the previous level. With the defaults, the total XP needed is:

To stop farming, the same skill can't gain XP for the same player more often than every Config.awardCooldown seconds. Hitting players never grants XP.

#Bonuses

Each skill's bonuses are added once for every level above 1. The totals from skills and perks are summed and published to the player's skillBonuses state bag.

Who reads each bonus key:

The client applies GTA stats (MP0_STAMINA, MP0_LUNG_CAPACITY, MP0_STRENGTH, MP0_SHOOTING_ABILITY) and weapon and melee damage modifiers whenever bonuses change, and again every 30 s.

#XP en-skills awards itself

Other XP comes from the resources that use the skill, such as crafting, lockpicking and repairs.

#Perk points

Points are calculated, not stored:

points = Config.startingPoints + (characterLevel - 1) * Config.pointsPerLevel - pointsSpent

If a character loses XP and drops a level, they can briefly have spent more points than they have. See XP and levels.

Default perks: marathon, second_wind, pack_mule, brawler, steady_hands, marksman, quick_hands, keen_eye, field_medic, iron_gut (character level 8), thick_skin, light_fingers, hot_start, tinkerer, thrifty, grease_monkey.

#Configuration

#Adding a skill and a perk chain

Config.skills.survival = {
    label = 'Survival', icon = 'temperature',
    description = 'Hardier in the cold and on bad food. Improves by surviving.',
    bonuses = { foodRisk = 0.03, infectionResist = 0.01 },
}
Config.order[#Config.order + 1] = 'survival'

Config.perks[#Config.perks + 1] = { id = 'forager', label = 'Forager', skill = 'survival', level = 3, cost = 1,
    description = 'Bad water rarely makes you sick.', bonuses = { foodRisk = 0.3 } }
Config.perks[#Config.perks + 1] = { id = 'deep_pockets', label = 'Deep Pockets', coreLevel = 10, cost = 2,
    requires = { 'pack_mule', 'forager' }, description = 'Carry 8 kg more.', bonuses = { carryWeight = 8 } }

Skills or perks you remove from config are dropped from characters when they load.

#Library

Other resources should use encore.skills from the EndCore library rather than the exports. It returns safe defaults if en-skills isn't running. See Skills and party.

#Exports

#Server

#Client

#Commands

#Events

Emitted, server-local:

en-skills listens to weaponDamageEvent, en-zombies:server:corpseLooted, en-consumables:server:consumed, encore:server:onPlayerLoaded, encore:server:onPlayerUnload and encore:server:levelChanged.

#State bags

Character metadata holds skills = { xp = { [skill] = number }, perks = { [perkId] = true }, respecAt = unixTime }. See Player data.

#Examples

Award Survival XP from a campfire-cooking script and scale a result by a bonus:

-- server
AddEventHandler('mycooking:server:cooked', function(source)
    encore.skills.addXP(source, 'survival', 5)
end)

local function searchTime(source, base)
    local bonus = encore.skills.getBonus(source, 'searchSpeed')
    return math.floor(base * (1 - math.min(0.5, bonus)))
end

Lock an action behind a perk:

if not encore.skills.hasPerk(source, 'field_medic') then
    return false, 'You need the Field Medic perk.'
end

Celebrate level-ups:

AddEventHandler('en-skills:server:levelUp', function(source, skill, newLevel)
    if newLevel == 10 then
        print(('%s mastered %s'):format(GetPlayerName(source), skill))
    end
end)

#Related

• Skills and party
• XP and levels
• en-crafting
• en-consumables