F.A.Q
Setup
Yes, through oxmysql. It stores the weapon profiles, settings and skill rules saved from the admin panel.
Set Config.Language in shared/config.lua:
1Config.Language = 'en'The language files are in locales/.
Only weapons with a profile get recoil. Add the weapon from the admin panel, or add a block to Config.Weapons.
Admin Panel
Players with one of the groups in Config.AdminPermissions, read through ml_bridge. The command is /recoil.
No. A saved profile reaches every player at once and stays in the database. Reset a weapon from the panel to go back to the values in shared/config.lua.
Open the test range from the panel. It puts you in a private routing bucket with a target, a dummy and tracers, at the distances in Config.TestRange.Distances.
Recoil and Damage
Raise VerticalRecoil, HorizontalRecoil, ShakeIntensity or ClassicRecoilAmt for that weapon. Growth during sustained fire comes from Config.ProgressiveRecoil.
It divides the profile Damage by the value in shared/vanilla_damage.lua and applies it as the weapon damage modifier, so weapons.meta stays untouched.
Yes. Config.PvP.DisableHeadshotKills = true makes headshots deal normal damage.
Integration
Each rule in Config.SkillRules counts the unlocked ranks of a skill type in an ml_skills category and applies the matching multiplier from Ranks. The default rule uses betterAccuracy in personal for every weapon.
Yes. Call RequestXp from OnShotFired in client/main_open.lua. See the Developer page.
Updates
- Download the latest version from CFX Portal
- Back up
shared/config.lua,shared/vanilla_damage.lua,server/config_server.luaand the two open files - Replace everything else
- Restart the resource
Profiles and settings saved from the panel stay in the database.