FAQ

Common questions and solutions for GOD - Crosshair Generator.

General Questions

Q: What is GOD - Crosshair Generator?

A: GOD - Crosshair Generator is an advanced crosshair customization system for FiveM servers. It allows players to fully customize their crosshair appearance, including colors, size, opacity, and style, similar to Valorant's crosshair system.

Q: Do I need any additional dependencies?

A: No, the script works standalone. It doesn't require any framework (ESX, QBCore, etc.) or additional resources.

Q: Is this script performance-heavy?

A: No, the script is optimized for performance. The crosshair is rendered using lightweight CSS/HTML, and weapon checks are done efficiently. However, using high blur values may slightly impact performance.

Q: Can I use this with other crosshair scripts?

A: It's not recommended. Multiple crosshair scripts can conflict with each other. Disable other crosshair resources before using this one.

Installation

Q: The resource won't start. What should I do?

A: Check the following:

1. Verify the folder name is exactly god-crosshair

2. Ensure fxmanifest.lua is in the root folder

3. Check that ensure god-crosshair is in your server.cfg

4. Look at the server console for specific error messages

5. Verify all files are present (check file structure)

Q: I get an error about missing files. What's wrong?

A: Make sure all files from the resource package are present:

• client/ folder with .lua files

• server/ folder with .lua files

• shared/ folder with config.lua

• ui/ folder with HTML, CSS, JS, and image files

• fxmanifest.lua in the root

Q: The menu opens but looks broken. Why?

A: This is usually a UI file issue:

1. Check that all files in ui/ folder are present

2. Verify ui/index.html exists and is not corrupted

3. Check F8 console for JavaScript errors

4. Ensure CSS files are loading correctly

5. Try restarting the resource: restart god-crosshair

Configuration

Q: How do I add more weapons to the whitelist?

A: Edit shared/config.lua and add weapon hashes to the WhitelistedWeapons array:

WhitelistedWeapons = {
    "weapon_pistol",
    "weapon_assaultrifle",
    "weapon_customweapon"  -- Add your weapon here
}

Then restart the resource.

Q: Can I change the default crosshair settings?

A: Yes, edit the DefaultSettings section in shared/config.lua. New players will get these defaults, but existing players keep their saved settings.

Q: How do I reset all player crosshair settings?

A: Delete or clear the shared/database.json file, then restart the resource. All players will get the default settings on next spawn.

Q: Can I disable the crosshair for specific weapons?

A: Yes, remove those weapons from the WhitelistedWeapons array in config.lua. The crosshair will only appear for weapons in the whitelist.

Usage

Q: The crosshair doesn't appear when I have a weapon. Why?

A: Check these:

1. Is the weapon in the whitelist? (see Configuration)

2. Is "Toggle Crosshair" set to ON in the menu?

3. Do you have the weapon equipped (not just in inventory)?

4. Try restarting the resource

Q: How do I share my crosshair config with friends?

A:

1. Customize your crosshair

2. Click "Copy Config" button

3. Share the config ID (number) with your friend

4. They enter the ID and click "Paste Config"

Q: My config ID doesn't work when I paste it. Why?

A: Config IDs are temporary and stored on the server. They may be cleared if:

• The server restarts

• The resource is restarted

• The server clears old configs

Try getting a fresh config ID from the person who created it.

Q: Can I have different crosshairs for different weapons?

A: Currently, the script uses one crosshair configuration per player. All whitelisted weapons will show the same crosshair. This feature may be added in future updates.

Q: The menu won't close. What do I do?

A: Try:

1. Press ESC key

2. Type /crosshair again to toggle

3. Reconnect to the server if stuck

4. Check F8 console for errors

Customization

Q: What color format should I use?

A: Use hexadecimal color codes in the format #RRGGBB:

• #FFFFFF = White

• #000000 = Black

• #FF0000 = Red

• #00FF00 = Green

• #0000FF = Blue

You can use online color pickers to find hex codes.

Q: How do I make the crosshair more visible?

A: Try:

• Use contrasting colors (white on dark backgrounds)

• Increase opacity to maximum (1.00)

• Add outlines with contrasting colors

• Increase line thickness

• Adjust blur for a glow effect

Q: Can I make the crosshair smaller/larger?

A: Yes, adjust these settings:

• Line Length: Controls line size

• Center Dot Thickness: Controls dot size

• Line Thickness: Controls line width

• Distance Between Lines: Affects overall crosshair size

Q: What does "Shotgun Crosshair" mode do?

A: When enabled, it creates a hollow center dot with an outline instead of a solid dot. This is useful for shotgun-type weapons where you want to see more of the target area.

Localization

Q: How do I change the language?

A: Edit ui/js/settings.js and change the Locale.Lang value:

Locale = {
    Lang: "tr",  // Change to your language code
    // ...
}

Then restart the resource.

Q: Can I add my own language?

A: Yes, see the Localization Guide for detailed instructions on adding new languages.

Q: Some text is still in English after changing language. Why?

A: Make sure you:

1. Translated all labels in the language object

2. Saved the file correctly

3. Restarted the resource

4. Checked that the language code is correct

Technical Issues

Q: I get JavaScript errors in F8 console. What's wrong?

A: Common causes:

1. Missing UI files (check ui/ folder)

2. Corrupted settings.js or script.js

3. Browser cache issues (try clearing cache)

4. Conflicting scripts

Q: The crosshair flickers or disappears randomly. Why?

A: This could be:

1. Weapon whitelist issue (weapon not properly detected)

2. Script conflict with other resources

3. Performance issue (lower blur values)

4. Check server console for errors

Q: Settings don't save. What's the problem?

A: Check:

1. Server has write permissions for shared/database.json

2. No file permission errors in server console

3. Resource has proper access to save files

4. Database file isn't corrupted (check JSON syntax)

Q: Can I use this script in an escrow/protected resource?

A: The script already has escrow protection. The fxmanifest.lua includes:

escrow_ignore {
    "shared/*.lua"
}

This means only shared/ files are unprotected (for configuration). All other files are protected.

Performance

Q: Does this script impact server performance?

A: Minimal impact:

• Client-side rendering (no server load)

• Efficient weapon checking (1 second intervals)

• Lightweight UI rendering

• Only active when players have whitelisted weapons

Q: Will it cause FPS drops?

A: Generally no, but:

• High blur values may cause slight FPS impact

• Very complex crosshairs (multiple outlines, high opacity) may affect performance on lower-end PCs

• Most players report no noticeable FPS impact

Q: How many players can use this simultaneously?

A: There's no limit. The script is designed to handle all players on your server simultaneously. Each player's settings are stored individually.

Compatibility

Q: Is this compatible with ESX/QBCore?

A: Yes, it's framework-agnostic and works with any FiveM server setup.

Q: Does it work with weapon mods?

A: Yes, as long as the weapon hash is added to the whitelist. You may need to find the correct weapon hash for custom weapons.

Q: Can I use this with other UI mods?

A: Generally yes, but conflicts can occur if:

• Another script modifies the same UI elements

• Another script uses the same NUI callbacks

• There are CSS conflicts

Test thoroughly if using multiple UI mods.

Advanced

Q: Can I modify the UI design?

A: Yes, you can edit:

• ui/css/menu.css - Menu styling

• ui/css/crosshair.css - Crosshair styling

• ui/css/global.css - Global styles

• ui/index.html - HTML structure

Note: If the resource is escrowed, you may have limited access to some files.

Q: How do I add custom features?

A: You would need to modify the source code:

• client/main.lua - Client-side logic

• server/main.lua - Server-side logic

• ui/js/script.js - UI functionality

Note: This requires access to non-escrowed files.

Q: Can I integrate this with my framework's weapon system?

A: Yes, you can modify the weapon checking logic in client/functions.lua to integrate with your framework's weapon system. You'll need to adapt the IsWeaponWhitelisted() function.

Support

Q: Where can I get help?

A:

• Check this documentation first

• Review server console for error messages

• Check F8 console (client-side) for JavaScript errors

• Contact the development team through official channels

Q: How do I report a bug?

A: When reporting bugs, include:

1. Server console errors

2. F8 console errors (if any)

3. Steps to reproduce the issue

4. Your server setup (framework, other scripts)

5. Screenshots if applicable

Q: Will there be updates?

A: Check with the development team for update schedules and new features.

Still Have Questions?

If you can't find the answer to your question here:

1. Check the other documentation sections:

   • Overview

   • Installation

   • Configuration

   • Localization

   • Usage

2. Review the code comments in the source files

3. Contact support through official channels