Give your players a real crosshair they can own — and give your staff the tools to build new ones without touching code. RK Crosshair ships with 50+ ready-made presets, per-player customization saved to the database, and a full admin creator to design, publish, and manage custom reticles from a modern NUI. Perfect for RP immersion and PvP servers that want a polished, branded HUD layer.
KEY FEATURES — PLAYER PANEL
Clean Crosshair Menu: Open with /crosshair or F7 (both configurable) and pick from every preset you have access to in one premium glass panel.
50+ Built-in Presets: Dots, crosses, circles, chevrons, targets, sniper reticles, stars, and more — scroll the grid or open the full preset library with search.
Full Customization: Change color (spectrum + swatches), size, and dynamic spread (crosshair expands while shooting) — all with live preview.
Display Modes: Turn the crosshair off, show it only while aiming, or keep it always on — one click, no reconnect.
Live Preview Panel: Toggle an on-screen preview while editing so players see exactly what they’re building before hitting Apply.
Persists Per Character: Preferences save to the database (preset, color, scale, dynamic spread, enabled state, mode) — players keep their setup across sessions.
29 Color Themes: The player menu inherits your server’s theme from admin settings — polished UI that matches your brand.
KEY FEATURES — ADMIN PANEL
Full Admin Creator: Open with /crosshairadmin (configurable) — Editor, Library, and Settings in one interface.
Layer-Based Editor: Build crosshairs from scratch with 9 element types — cross, dot, line, circle, diamond, hexagon, triangle, plus, and rectangle. Stack layers, reorder, hide, delete, and tweak position, rotation, stroke, gap, radius, fill, and more.
Base Preset Loader: Start from any built-in preset or append presets as new layers — fast prototyping without redrawing from zero.
Real-Time Preview: In-game preview updates as you edit — see the reticle on screen while you design.
Publish to Server: One-click publish pushes custom crosshairs live for all players — stored in the database, no file drops.
Library Management: Browse all presets (built-in + published). Filter by source, status (live/draft), and search. Edit or delete custom entries anytime.
Live Theme Editor: Pick from 29 color templates (blue, violet, gold, emerald, crimson, and more) with a live preview of the player menu — saves instantly for everyone.
Server Logo Branding: Set your server logo via image URL, adjust opacity and scale — header branding without editing files.
KEY FEATURES — BACKEND & STORAGE
MySQL Storage: Single sql/install.sql — player prefs, published presets, and server settings (theme + logo) in three clean tables.
Validated Server Saves: Player preferences are validated server-side (color, scale, mode, crosshair ID) before writing to the database.
Admin Permission Gated: Creator access locked to ESX admin groups or QBCore permission — configurable in shared/config.lua.
Built-in + Custom Presets: Built-in shapes render natively; published customs are stored as SVG and served to all players automatically.
Italian & English: Full UI, notifications, and locale files — add more languages easily in locales/.
WHAT PLAYERS EXPERIENCE
- Press F7 or type
/crosshair→ browse 50+ presets → pick color, size, and dynamic spread - Set Aim Only for RP → switch to Always On for PvP → or disable entirely
- Toggle live preview → hit Apply → crosshair saves and shows in-game immediately
- Server admin opens
/crosshairadmin→ builds a custom reticle in the layer editor → hits Publish - Players see the new crosshair in the preset library on next menu open
- Admin picks a gold theme + uploads server logo URL → every player sees the branded panel
COMPATIBILITY
Framework
- ESX (es_extended)
- QBCore (qb-core)
- Qbox (qbx_core)
- Custom framework (open adapter)
- Auto-detect supported
Notifications
- ox_lib
- ESX / QBCore / Qbox native notify
- Custom notify (open adapter)
- Auto-detect supported
Other
- oxmysql required
- Commands:
crosshair,crosshairadmin(configurable) - Keybind: F7 (configurable)
- Per-player prefs stored by framework identifier
- Open config, locales, SQL path, and integration adapters (escrow-friendly)
Plug-and-play on most stacks: set framework and notify to auto and RK Crosshair detects your environment. Custom adapters are included if you run something different.