About RecoilPatternUI – Recoil trainer HUD with spray scoring & admin spectate
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
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 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
- /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).
