Version 2.6.0
221 downloads
See your spray, not just your kills. RecoilPatternUI draws the recoil pattern of the weapon you're holding on your HUD and overlays your real mouse path on top of it, one dot per shot. If the white dots sit on the orange ones, your control is clean. If they drift, you see exactly which shot you lost it on. Great for aim-train and minigame servers, and for admins checking suspicious players.
Version 2.0 merges the old Version A and Version B into one plugin: /pattern trains yourself, /suspect watches someone else
FEATURES
Live spray overlay: your mouse path drawn over the pattern, shot by shot, latest shot highlighted in red
Spray scoring: live percentage for every spray, personal bests saved per weapon
/pattern stats for your bests, /pattern top for the server leaderboard
Admin spectate: /suspect PlayerName shows that player's sprays on your HUD in real time. Several admins can watch the same player
In-game pattern recorder: hold any gun, type /pattern record, empty the mag. The pattern is saved to the config and live instantly. Add new weapons or re-record after Facepunch changes recoil
Auto-fit: 30-round and 100-round patterns both fit the panel
Movable, resizable, recolorable HUD that stays the same size on every resolution
Numbered pattern dots, origin crosshair, shot counter and score footer
Auto reset after a pause, full mag, weapon switch or death (each configurable)
Optional auto-enable on connect, optional score announcement in chat
Configurable command names and chat prefix, all messages translatable via Oxide lang
Works on Oxide and Carbon
Crouch and attachment aware: the pattern shrinks to the recoil you really have, and the HUD shows why (e.g. "Muzzle Brake x0.5, Crouched x0.5"). Attachment values come straight from the game
Accuracy breakdown: see your accuracy for every 5 shots and find where in the spray you lose control
Left or right: /pattern left moves the HUD to the top-left corner, remembered per player
SUPPORTED WEAPONS
AK-47
LR-300
MP5A4
Thompson
Custom SMG
M249
HMLMG
Any other weapon can be added with the in-game recorder in under a minute.
COMMANDS
/pattern - toggle the HUD
/pattern left - open the HUD in the top-left corner
/pattern right - back to the default position
/pattern stats - your best score per weapon
/pattern top [weapon] - server leaderboard
/pattern weapons - list supported weapons
/pattern record - (admin) record a pattern for the gun you're holding
/pattern record crouch - (admin) measure the crouch recoil reduction for your server
/pattern record cancel - (admin) abort a recording
/suspect PlayerName - (admin) watch another player's spray
/suspect off - stop watching
PERMISSIONS
recoilpatternui.use - HUD, stats and leaderboard
recoilpatternui.admin - spectate and record
FOR DEVELOPERS
Aim-train plugins can control the HUD without any player command:
Interface.CallHook("AddPatternUI", player);
Interface.CallHook("RemovePatternUI", player);
Interface.CallHook("TogglePatternUI", player);
Interface.CallHook("IsPatternUIEnabled", player);
Interface.CallHook("GetBestScore", player, "rifle.ak");
UPGRADING FROM 1.x
Overwrite the .cs file and delete RecoilPatternShower.cs. The old config is backed up automatically and replaced with the new format; pattern data is unchanged. The permission is now recoilpatternui.use (was recoilpatternui.command).