RK Crosshair | Advanced Crosshair System & Admin Creator for

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.