Focus System
This is a step-by-step installation guide, configuration preview, and full explanation of all settings for legends_focus.
If you lack programming experience, ensure you read each step thoroughly without skipping, as all documentation is essential!
Before submitting a support ticket or following the guides in this documentation, please make sure that you are running the latest version of the resource.
What is legends_focus?
legends_focus is a lightweight FiveM resource that provides players with a zoom-in focus feature. When activated by holding a configurable key, the camera smoothly zooms in, allowing players to see distant objects more clearly. Perfect for roleplay scenarios requiring observation or simply enhancing player experience.
Key Features
- Configurable Keybind - Activate the focus feature using any key you choose
- Adjustable Zoom Level - Modify the zoom intensity through simple configuration
- Smooth Transitions - Camera zooms in and out smoothly for a polished feel
- Performance-Friendly - Minimal resource usage to ensure smooth gameplay
- Standalone - No dependencies required, works with any framework
Need help? Join our Discord (opens in a new tab) for support!
FAQ
How do I change the focus keybind to a different key (e.g. Left Shift)?
Open config.lua and change Config.Key to any FiveM input name (LSHIFT, B, CAPSLOCK). Players can also rebind it from the FiveM keybinds menu at runtime because the resource uses RegisterKeyMapping, so you do not have to force the new key on everyone.
How do I disable focus while inside a vehicle to avoid conflicts with driving cameras?
Set Config.DisableInVehicle to true. The client checks IsPedInAnyVehicle every tick and refuses to zoom when the player is seated. Useful when your server runs a custom in-car camera or a cinematic driving script.
Can I exclude focus from triggering while holding a sniper rifle or scoped weapon?
Yes. Config.BlockedWeapons accepts an array of weapon hashes or GetHashKey() names. The client checks the equipped weapon on every zoom attempt and silently refuses when it matches the list, so vanilla scopes keep working without visual stacking.
How do I tune zoom intensity without making it feel like a binocular?
Config.ZoomFov controls the target field-of-view (smaller = more zoom; 35 is a gentle magnify, 15 is binocular-like). Config.ZoomSpeed controls the lerp time to reach the target so the transition feels cinematic. Tune both together for the right balance between tactical and immersive.
How do I detect when focus is active from another resource?
Call exports.legends_focus:IsFocused() on the client to get a boolean. For server-side checks, listen to the net event legends_focus:stateChanged which fires with { source, active } on every toggle. Both paths are async-safe and cheap.