Santafe Scripts
🎯 SF Crosshair
Sharing System

Sharing System

SF Crosshair features an advanced PIN-based sharing system that allows players to easily share their custom crosshairs with friends and other players.

How Sharing Works

PIN System Overview

Every player gets a unique 6-digit PIN when they first join the server. This PIN serves as their crosshair sharing identifier.

PIN Features:

  • Unique: Each player has a different PIN
  • Persistent: PIN stays the same across sessions
  • Visible: Always displayed in the menu header and Share tab
  • Copyable: Click the copy button to copy your PIN

Sharing Requirements

To share a crosshair, it must be:

  • ✅ Saved in Favorites - Only favorites can be shared
  • ✅ Named - Must have a descriptive name
  • ✅ Complete - Fully configured crosshair

You cannot share:

  • ❌ Unsaved crosshair configurations
  • ❌ Default/temporary crosshairs
  • ❌ Partially configured crosshairs

Sharing Methods

Method 1: Nearby Players

Share with players who are physically close to you.

How to Use:

  1. Go to Share tab
  2. Click "Refresh Nearby Players"
  3. Select player from the list
  4. Choose which favorite to share
  5. Click "Send to [Player Name]"

Requirements:

  • Target player must be within configured distance (default: 10 meters)
  • Both players must be online
  • Uses character names from ESX/QBCore

Best For:

  • Sharing with friends standing nearby
  • Spontaneous crosshair sharing
  • Roleplay scenarios

Method 2: Send by PIN

Share with any online player using their PIN.

How to Use:

  1. Get the recipient's 6-digit PIN
  2. Go to Share tab
  3. Enter PIN in "Send by PIN" section
  4. Choose which favorite to share
  5. Click "Send"

Requirements:

  • Recipient must be online on the server
  • Must have correct 6-digit PIN
  • PIN must belong to an active player

Best For:

  • Sharing across long distances
  • Sharing with specific players
  • Organized crosshair exchanges

Receiving Crosshairs

Notification System

When someone sends you a crosshair:

  1. Chat Notification: You receive a message like:

    [Crosshair] PlayerName wants to share a crosshair with you!

  2. Auto-Open Menu: The crosshair menu opens automatically

  3. Preview Modal: A modal shows:

    • Sender's name
    • Crosshair preview
    • Crosshair name
    • Accept/Reject buttons

Accept or Reject

To Accept:

  • Click "Accept" button
  • Crosshair is automatically saved to your favorites
  • Sender receives confirmation notification
  • You can immediately use the crosshair

To Reject:

  • Click "Reject" button
  • Crosshair is not saved
  • Sender receives rejection notification
  • No changes to your crosshairs

Auto-Save Feature

Accepted crosshairs are automatically:

  • ✅ Saved to Favorites with original name
  • ✅ Given unique code for identification
  • ✅ Ready to use immediately
  • ✅ Editable (you can rename or modify)

PIN Management

Finding Your PIN

Your PIN is displayed in multiple places:

  • Menu Header: Top-right corner when menu is open
  • Share Tab: Prominently displayed at the top
  • Copy Button: Click to copy PIN to clipboard

Sharing Your PIN

Methods to share your PIN:

  • Copy and paste in Discord/chat
  • Tell someone verbally (6 digits)
  • Add to your Discord status
  • Share in community forums

PIN Format: Always 6 digits (e.g., 157825)

PIN Security

PINs are safe because:

  • Only used for crosshair sharing
  • Cannot access other player data
  • No sensitive information attached
  • Easily changeable by server restart

Sharing Workflow Examples

Example 1: Nearby Sharing

Scenario: You want to share your crosshair with a friend standing next to you.

  1. Both players stand close together (within 10m)
  2. You open crosshair menu (/crosshair)
  3. Go to Share tab
  4. Click "Refresh Nearby Players"
  5. Select your friend from the list
  6. Choose crosshair from your favorites
  7. Click "Send to [Friend's Name]"
  8. Friend receives notification and preview
  9. Friend accepts the crosshair
  10. Both get confirmation messages

Example 2: PIN Sharing

Scenario: You want to share with someone across the map.

  1. Get their PIN: Ask in Discord/chat for their 6-digit PIN
  2. Open crosshair menu
  3. Go to Share tab
  4. Enter their PIN in "Send by PIN" section
  5. Choose crosshair from favorites
  6. Click "Send"
  7. They receive notification wherever they are
  8. They accept/reject the crosshair
  9. You get confirmation of their choice

Example 3: Community Sharing

Scenario: Organizing a crosshair sharing event.

  1. Create event in Discord/community
  2. Players share PINs in event channel
  3. Create themed crosshairs (e.g., "Neon Collection")
  4. Save to favorites with descriptive names
  5. Share with multiple players using their PINs
  6. Build crosshair library through community sharing

Advanced Sharing Features

Character Name Integration

The system uses character names from your framework:

  • ESX: Uses character firstname + lastname
  • QBCore: Uses character name from database
  • Fallback: Uses Steam name if no framework

This makes sharing more immersive and roleplay-friendly.

Distance Configuration

Server owners can configure sharing distance:

Config.ShareDistance = 10.0  -- Default: 10 meters

Common Settings:

  • 5.0 - Close proximity only
  • 10.0 - Default balanced setting
  • 20.0 - Larger area for busy servers
  • 50.0 - Very large detection range

Sharing Notifications

Sender Notifications:

  • "PlayerName accepted your crosshair!" (green)
  • "PlayerName rejected your crosshair." (red)

Recipient Notifications:

  • "PlayerName wants to share a crosshair with you!" (green)

Sharing Etiquette

Best Practices

Before Sharing:

  • ✅ Ask permission before sending
  • ✅ Describe what you're sharing
  • ✅ Use descriptive names for crosshairs
  • ✅ Test crosshair before sharing

When Receiving:

  • ✅ Respond promptly to sharing requests
  • ✅ Thank the sender if you accept
  • ✅ Provide feedback if requested
  • ✅ Respect others' crosshair designs

Community Guidelines:

  • ✅ Share appropriate crosshairs only
  • ✅ Don't spam sharing requests
  • ✅ Respect rejection decisions
  • ✅ Credit original creators when resharing

Troubleshooting Sharing

Common Issues

"Player not found":

  • Verify PIN is correct (6 digits)
  • Ensure player is online
  • Check for typos in PIN

"No nearby players":

  • Move closer to other players
  • Check if others have crosshair menu open
  • Verify server distance configuration

"Cannot share crosshair":

  • Ensure crosshair is saved in Favorites
  • Check that favorite has a name
  • Verify you're not trying to share unsaved config

Sharing not working:

  • Restart crosshair menu
  • Check server console for errors
  • Verify both players have latest version

Debug Steps

  1. Check PIN: Verify PIN is 6 digits
  2. Test Nearby: Try nearby sharing first
  3. Check Favorites: Ensure crosshair is in favorites
  4. Restart Menu: Close and reopen menu
  5. Check Distance: Move closer for nearby sharing

Sharing Statistics

Track your sharing activity:

  • Sent: Crosshairs you've shared with others
  • Received: Crosshairs others have shared with you
  • Accepted: How many of your shares were accepted
  • Popular: Which of your crosshairs get shared most

Note: Statistics tracking may be added in future updates

Community Features

Crosshair Collections

Create themed collections to share:

  • Neon Series: Bright, colorful crosshairs
  • Minimal Pack: Simple, clean designs
  • Gaming Legends: Crosshairs inspired by famous games
  • Roleplay Set: Realistic, immersive crosshairs

Sharing Events

Organize community events:

  • Crosshair Contests: Best design competitions
  • Theme Weeks: Weekly crosshair themes
  • Sharing Parties: Mass crosshair exchange events
  • Tutorial Sessions: Teaching crosshair design

Next Steps

  • Customization: Learn advanced customization techniques
  • Troubleshooting: Solutions for common issues
  • Configuration: Server-side sharing configuration

Sharing system guide by SantaFe Team 🇲🇦

Usage GuideCustomization