Usage Guide

This guide explains how to use GOD - Crosshair Generator in-game.

Opening the Menu

To open the crosshair customization menu, use the following command in chat:

/crosshair

The menu will open with a blur effect, allowing you to customize your crosshair in real-time.

Closing the Menu

You can close the menu in several ways:

  1. ESC Key: Press the ESC key

  2. Close Button: Click outside the menu (if available)

  3. Command Again: Type /crosshair again to toggle

The customization menu is divided into four main sections:

1. General Settings

Toggle Crosshair

  • ON: Enables the crosshair display

  • OFF: Disables the crosshair display

Note: The crosshair will only appear when you have a whitelisted weapon equipped, even if this is set to ON.

2. Lines

Configure the crosshair lines (the four lines extending from the center).

Show Lines

  • ON: Display the crosshair lines

  • OFF: Hide the crosshair lines

Line Color

  • Click the color picker or enter a hex code (e.g., #FF0000 for red)

  • Format: #RRGGBB (6 hexadecimal digits)

Line Opacity

  • Range: 0.00 (transparent) to 1.00 (opaque)

  • Use the slider or enter a value manually

Line Length

  • Range: 0 to 3.5

  • Controls how long each line extends from the center

Line Thickness

  • Range: 0 to 0.75

  • Controls the width of the lines

Distance Between Lines

  • Range: 0.0 to 2.5

  • Controls the gap between the center and the start of the lines

3. Outlines

Configure the outline/border around the crosshair elements.

Show Outlines

  • ON: Display outlines around crosshair elements

  • OFF: Hide outlines

Outline Color

  • Click the color picker or enter a hex code

  • Format: #RRGGBB

Outline Opacity

  • Range: 0.00 to 1.00

  • Controls outline transparency

Outline Thickness

  • Range: 0 to 10

  • Controls the thickness of the outline border

Outline Blur

  • Range: 0 to 10

  • Creates a glow effect around the crosshair

  • Higher values create more blur/glow

4. Center Dot

Configure the center dot of the crosshair.

Show Center Dot

  • ON: Display the center dot

  • OFF: Hide the center dot

Center Dot Color

  • Click the color picker or enter a hex code

  • Format: #RRGGBB

Shotgun Crosshair

  • ON: Enables special shotgun mode (hollow dot with outline)

  • OFF: Normal solid center dot

Center Dot Roundness

  • Range: 0.00 to 10.00

  • 0.00 = Square

  • 10.00 = Perfect circle

  • Values in between create rounded squares

Center Dot Opacity

  • Range: 0.00 to 1.00

  • Controls dot transparency

Center Dot Thickness

  • Range: 0 to 2

  • Controls the size of the center dot

Config Sharing

The script includes a feature to share your crosshair configuration with other players.

Copying Your Config

  1. Customize your crosshair to your liking

  2. Click the "Copy Config" button

  3. A config ID will be copied to your clipboard (e.g., 544)

  4. Share this ID with other players

Pasting a Config

  1. Get a config ID from another player

  2. Enter the ID in the "Config Id" field

  3. Click the "Paste Config" button

  4. Your crosshair will update to match the shared configuration

Note: Config IDs are temporary and stored on the server. They may expire after server restarts.

Real-Time Preview

As you adjust settings in the menu, you'll see a live preview of your crosshair in the center of the screen. This allows you to fine-tune your settings before closing the menu.

Saving Settings

Your crosshair settings are automatically saved when you:

  1. Close the menu (press ESC or click outside)

  2. Change any setting (auto-saves in real-time)

Settings are saved per player and will persist across server restarts.

Weapon Requirements

The crosshair will only appear when:

  1. You have a weapon equipped that is in the whitelist

  2. The "Toggle Crosshair" setting is set to "ON"

If the crosshair doesn't appear, check:

  • Do you have a weapon equipped?

  • Is the weapon in the server's whitelist? (see Configuration guide)

  • Is "Toggle Crosshair" enabled?

Tips for Customization

Visibility

  • Use contrasting colors (e.g., white crosshair on dark backgrounds)

  • Adjust opacity to make the crosshair more or less visible

  • Add outlines with contrasting colors for better visibility

Precision

  • Smaller center dot = more precise aiming

  • Longer lines = easier to see but may obstruct view

  • Adjust distance between lines for your preference

Style

  • Match crosshair color to your UI theme

  • Use blur effects for a modern look

  • Experiment with roundness for different dot styles

Performance

  • Lower blur values improve performance

  • Simpler crosshairs (no outlines, basic lines) use less resources

Common Configurations

Minimalist Crosshair

Valorant-Style

Dot Only

Shotgun Crosshair

Troubleshooting

  • Check that the resource is running: /restart god-crosshair (admin only)

  • Try reconnecting to the server

  • Check F8 console for errors

Changes Not Saving

  • Make sure you close the menu properly (ESC key)

  • Check server console for any errors

  • Verify you have proper permissions

Crosshair Not Appearing

  • Ensure you have a whitelisted weapon equipped

  • Check that "Toggle Crosshair" is ON

  • Verify the weapon hash is in the server's whitelist

Config Sharing Not Working

  • Verify the config ID is correct

  • Check that the ID hasn't expired (server restart may clear saved configs)

  • Try copying a new config ID

Keyboard Shortcuts

  • ESC: Close menu

  • Enter: (In some cases) Confirm changes

Advanced Usage

Resetting to Defaults

To reset your crosshair to server defaults:

  1. Delete your entry from shared/database.json (server-side, admin only)

  2. Rejoin the server

  3. Your settings will reset to the server's default configuration

Multiple Profiles

While the script supports profile management in the code, the current UI version may have limited profile switching. Check future updates for enhanced profile features.

Last updated