RDE_SKILLS DOCS
RED DRAGON ELITE // PLAYER SYSTEMS

Skills That Sync Instantly.
Not Skills That Poll.

rde_skills is a production-grade skill progression system for ox_core: 11 customizable skills with native GTA V stat integration, 5 faction reputations, a prestige layer, achievements, and real-time StateBag sync — benchmarked up to 256 concurrent players.

01 / Start Here

Overview

RDE Skills provides automatic XP gain through player activities, native GTA V stat integration, faction reputation, an achievement system, and a prestige layer — all statebag-synced in real time, with a cache system cutting database queries by roughly 70%.

Core Principle Skill state lives on the player statebag (player.state.skills) — any resource can read it directly with zero callback roundtrip.

Why this over generic skill scripts

FeatureGeneric Skill Scriptsrde_skills
Real-time syncPolling / delayedStateBag — instant
Native GTA integrationNone6 native stat hooks
Faction reputationNone5 factions
Prestige systemNonePermanent bonuses
Triple admin verificationNoneACE + ox_core + Steam
02 / Start Here

Quick Start

server.cfg
ensure oxmysql
ensure ox_core
ensure ox_lib
ensure ox_target      -- optional
ensure ox_inventory   -- optional
ensure rde_skills

Four tables auto-create on first run: rde_player_skills, rde_player_reputation, rde_player_achievements, rde_player_perks. Test with /skills in-game.

03 / Reference

Skills System

SkillAuto XP SourceNative Stat
DrivingDriving vehiclesMP0_DRIVING_ABILITY
ShootingUsing firearmsMP0_SHOOTING_ABILITY
FitnessRunning / sprintingMP0_STAMINA
FlyingPlanes / helicoptersMP0_FLYING_ABILITY
StealthCrouching / sneakingMP0_STEALTH_ABILITY
Hacking / Mechanics / Cooking / Charisma / FishingManual trigger

100 XP = 1 level, max level 100 by default (per-skill adjustable). Perks unlock at levels 25, 50, 75, and 100.

Manual XP from another resource
-- Server-side
TriggerEvent('rde_skills:addSkillXP', playerId, 'driving', 10)
04 / Reference

Reputation System

FactionEffect
PoliceWanted level interactions, police cooldowns
GangsTerritory access, black market pricing
MedicsHospital costs, priority treatment
MechanicsRepair costs, upgrade access
CiviliansJob availability, general store pricing

Scale: -1000 to -500 Hostile · -499 to -100 Unfriendly · -99 to 99 Neutral · 100 to 499 Friendly · 500 to 1000 Allied.

05 / Reference

Exports & API

ExportSideNotes
getPlayerSkills(source)ServerAll skills for a player
getSkillLevel(source, skill)ServerSpecific skill level
addSkillXP(source, skill, amt)ServerAdd XP programmatically
hasSkillLevel(source, skill, n)ServerSkill requirement check
openSkillsMenu()ClientOpens the skills menu
06 / Reference

Performance

PlayersRAMCPUSQL Queries/min
32~15 MB<1%~20
128~52 MB~2%~65
256~95 MB~3%~120

Keep Config.CacheEnabled = true — cuts DB queries by roughly 70%.

07 / More

Common Pitfalls

Skills not syncing to other resources

Reading the statebag before the player has actually loaded returns stale or empty data.

Fix: access via Player(source).state.skills only after ox:playerLoaded fires.

Native GTA stats not applying

Applying native stats before the ped is fully streamed in silently fails.

Fix: confirm Config.NativeSkillsEnabled = true and that the ped is fully loaded before sync fires — check console for native stat errors.

08 / More

FAQ

Do I need ox_inventory or ox_target?

No — both are optional, used only for item-based skill boosts and interaction menus respectively.

What does prestige actually do?

Resets all skills in exchange for permanent stat bonuses and an elite status marker.

09 / More

Changelog

v3.0.0

Real-time statebag sync, native GTA V stat integration, prestige system, achievement tracking, triple admin verification.

v2.0.0

Reputation system, skill perks & milestones, HUD display, EN/DE localization.