❓Faq

General Questions

What is the Traffic Lights Hacking System?

The Traffic Lights Hacking System allows players to hack traffic lights in the game world using a hacking device. When successful, the traffic light rapidly cycles through colors, and players receive random rewards including electronic components, cryptocurrency, and reputation. Failed attempts can result in electrocution and police being alerted.

Can players hack the same traffic light multiple times?

No, once a traffic light has been successfully hacked, it's marked as "already hacked" and cannot be hacked again during that server session. This prevents farming the same location repeatedly and encourages players to move around the map.

Does hacking traffic lights actually affect traffic flow?

The hack creates a visual effect (rapid color cycling) but doesn't functionally change NPC traffic behavior. The primary purpose is visual feedback and player rewards rather than traffic simulation.

Installation Questions

The minigame doesn't appear, what's wrong?

Common causes:

1. Missing tmc_minigames - Ensure the minigames resource is installed and running

2. Wrong Minigame Name - The script requires the 'Bruteforce' minigame specifically

3. Resource Not Started - Check that tmc_minigames starts before trafficlights

4. Outdated Version - Ensure your minigames resource supports the Bruteforce game

Radial menu option isn't showing up

Troubleshooting steps:

1. Check Distance - Stand very close to the traffic light (within 2.75 units)

2. Verify Item - Ensure you have jammer in inventory

3. Not in Vehicle - Exit any vehicle

4. Resource Running - Confirm radialmenu resource is started

Rewards aren't being given

Check these common issues:

1. Reward Items Missing - Add all reward items to your inventory system

2. Chance Too Low - Increase reward chances in config for testing

3. Inventory Full - Ensure player has inventory space

4. Console Errors - Check server console for specific errorse

Configuration Questions

How do I change the hacking difficulty?

Edit the difficulty and timer values in config:

Config.Hacking = {
    timer = 25,  -- Seconds per round (lower = harder)
    difficulty = 5,  -- 1-10 scale (higher = harder)
    -- ...
}

Difficulty affects the minigame complexity, while timer gives players more or less time to complete it.

Can I add more reward items?

Yes! Add new items to any reward tier:

Config.Rewards.Item.Rewards.mediumtier = {
    [1] = {item = 'inverter', amount = 1, chance = 10},
    [2] = {item = 'electronicwiring', amount = 1, chance = 10},
    [3] = {  -- New item
        item = 'circuit_board',
        amount = 1,
        chance = 15
    }
}

Don't forget to add the item to your inventory system!

How do I disable certain reward types?

Set enabled or Enabled to false:

Config.Rewards = {
    Item = {
        enabled = false,  -- Disable item rewards
        -- ...
    },
    Crypto = {
        Enabled = false,  -- Disable crypto rewards
        -- ...
    },
    Rep = {
        Enabled = true,  -- Keep reputation rewards
        -- ...
    }
}

How does the luck system work?

The luck system requires the statuseffects resource:

1. Players consume items that give them "luck" status effect

2. When hacking, script checks player's current luck value

3. Based on luck level, different reward tier chances apply

4. Higher luck = better chance at high-tier rewards

To disable luck, set LuckEnabled = false in reward chances config.

How do I change which traffic light models can be hacked?

Edit the model hashes in config:

Config.LightModels = {
    [1] = -655644382,
    [2] = 862871082,
    [3] = 123456789,  -- Add new model hash
}

Find model hashes using developer tools or prop lists for GTA V.

Can I change the required hacking item?

Yes, change the item name in config:

Config.Hacking = {
    requireditem = "laptop",  -- Use a different item
    -- ...
}

Make sure the new item exists in your inventory system.

What happens if I fail the hacking minigame?

When you fail:

• You're immediately electrocuted (stunned briefly)

• Police are automatically dispatched to your location

• You don't receive any rewards

• The traffic light is not marked as hacked (can try again)

• Your hacking device might be lost (based on takeitemchance)

Can I be electrocuted even if I succeed?

Currently, electrocution primarily occurs on minigame failure. Electrocution serves as a penalty for failing the hack.

What's the point of the "hackedtrafficlights" reputation?

This reputation value:

• Tracks how many traffic lights you've successfully hacked

• Can be used by other scripts to check player's hacking experience

• Could be used for leveling systems or unlocking new hacking opportunities

• Provides progression tracking separate from rewards

Do I need police online to hack?

Only if Config.PoliceSettings.enabled = true. When enabled:

• Server counts online police from specified jobs

• Must have minimum reqAmount of police online

• If not enough police, you'll get an error notification

• This prevents spamming hacks when police aren't available to respond

How long does the traffic light effect last?

The traffic light rapidly cycles through colors for approximately 6 seconds, creating a sparking visual effect. After this, the light returns to normal behavior but remains marked as "hacked" and cannot be hacked again that session.

Can other players see when I hack a traffic light?

Yes! The hack is synchronized to all nearby players:

• Traffic light color cycling is visible to everyone

• Sparking particle effects show to players close by

• Sound effects play for players close by

• This creates an immersive experience and alerts nearby players/police

What are the different reward tiers?

The three tiers are:

• Low Tier - Common rewards, obtained most frequently (basic components)

• Medium Tier - Uncommon rewards, moderate chance (better components)

• High Tier - Rare rewards, obtained least frequently (valuable items/higher amounts)

Your chance of getting each tier is determined by random roll and optionally your luck level.

Troubleshooting

"Not near traffic light" error

Solutions:

1. Get Closer - Stand directly next to the traffic light pole

2. Right Model - Ensure it's one of the hackable models in config

3. Check Models - Some modded maps may use different traffic light models

Traffic light isn't cycling colors

Possible causes:

1. Already Hacked - This light was already hacked this session

2. Sync Failed - Check console for sync errors

3. Too Far - Visual effect only works within range

4. Entity Despawned - Traffic light entity may have despawned (rare)

Try with a different traffic light to isolate the issue.

Hacking device isn't being removed

This is normal if:

• Config.Hacking.takeitem = false - Item is never removed

• takeitemchance is low - Random chance means it won't always remove

If it should be removed but isn't:

• Check server console for errors

• Test with takeitemchance = 100 to confirm functionality

Getting Help

Where can I report bugs?

Contact me through:

• Discord server

• Tebex tickets

How do I update the resource?

1. Backup your config.lua

2. Stop the resource: stop trafficlights

3. Replace all files except config.lua

4. Compare old and new config for new options

5. Start the resource: start trafficlights

Can I request features?

Feature requests are typically welcomed:

• Check if feature already exists in config

• Explain the use case clearly

• Understand custom features may require payment

• Be patient - updates take time

---

Still have questions? Check the Installation and Configuration guides for more detailed information.