Skip to main content

Troubleshooting

Contractor NPC doesn't spawn​

Check that fr_interact is running. Look for errors in the client F8 console with the [fr_hitman] prefix. If the NPC appears but the prompt doesn't, verify fr_interact loads before fr_hitman in server.cfg.

"Framework not detected" in the console​

es_extended or qb-core must start before fr_hitman. If the problem persists, force the framework manually:

Config.Framework = 'esx'   -- or 'qb'

No reward after killing the target​

Kill validation is server-side. Make sure you:

  1. Eliminate the exact ped marked on the GPS (not a guard).
  2. Return to the fixer and press E after the elimination.
  3. Config.RequirePlayerKill = true and you deliver the final blow.

If the game cannot resolve the killer entity (returns 0), the fallback is Config.KillFallbackRange — increase it if needed.

Target spawns underground or mid-air​

Adjust the Z coordinate of the affected entry in Config.TargetLocations. The resource logs the exact spawn coordinates used to the server console with a [fr_hitman] prefix — use those to fine-tune.

Fixer blip missing​

Run restart fr_hitman from the console / txAdmin. If it persists, check Config.Contractor.Blip.sprite and color.

Notifications not appearing​

If fr_notify is not installed, FR Hitman automatically uses the framework's native notifications (ESX.ShowNotification / QBCore:Notify). Install fr_notify and ensure it before fr_hitman to get modern toasts.