# RatLock v24
**RatLock v24** is an all-in-one Roblox gameplay modification and visualization suite focused on targeting assistance, trigger automation, player awareness, movement utilities, weapon-aware behavior, and extensive customization.
The system is designed around a modular architecture with configurable settings, runtime state management, visibility caching, weapon profiles, visual overlays, and cleanup handling.
## 🎯 Aim Assistance
### Smart Target Selection
* Automatically scans eligible players for potential targets.
* Supports configurable target priorities.
* Uses distance and visibility checks when selecting targets.
* Supports multiple targeting body parts.
* Includes a **Hybrid** targeting mode for dynamic target-part selection.
* Uses configurable FOV-based target filtering.
* Supports configurable target range limits.
* Handles target switching with distance-aware logic.
### Target Parts
Supported target-part selection includes:
* Head
* Torso / Upper body
* Other supported character parts
* Hybrid selection
### Dynamic Sensitivity
* Adjustable base sensitivity.
* Dynamic sensitivity scaling based on target distance.
* Separate close-range behavior.
* Configurable close-range boost.
* Configurable very-close-range boost.
* Customizable distance thresholds.
### FOV Control
* Configurable FOV radius.
* FOV-based target filtering.
* Runtime FOV adjustment through the public API.
* Automatic validation and clamping of FOV values.
### Prediction
* Optional target movement prediction.
* Configurable bullet-speed based prediction.
* Bullet-speed validation prevents invalid values from entering the system.
### Camera / Visibility Handling
* Visibility checks use Roblox raycasting.
* Local character exclusion is handled through raycast parameters.
* Visibility results are cached to reduce repeated calculations.
* Visibility cache considers:
* Target position
* Target character reference
* Camera position
* Cache age
* Cached results automatically expire.
---
# 🔫 Trigger System
## Triggerbot
* Automatically detects when a valid target is under the crosshair.
* Supports configurable trigger range and FOV conditions.
* Performs visibility checks before triggering.
* Integrates with weapon-specific trigger profiles.
* Supports optional hold behavior.
* Automatically releases when trigger conditions are no longer valid.
## Weapon-Aware Trigger Profiles
RatLock supports different trigger configurations for different weapon types.
Profiles can contain behavior such as:
* Trigger delay
* Burst count
* Burst timing
* Hold behavior
* Weapon-specific trigger settings
The system can automatically detect the currently equipped weapon and select the corresponding profile.
## Weapon Detection
* Detects weapon changes during runtime.
* Uses deterministic weapon matching.
* Supports configurable weapon ordering.
* Polls the equipped weapon state periodically.
* Automatically updates the active trigger profile after a weapon switch.
## Weapon Switch Handling
When the equipped weapon changes, RatLock can:
* Release an active trigger state.
* Reset burst state.
* Reset reaction timing.
* Reset target acquisition state.
* Reset shot timing.
* Apply the new weapon profile.
## Reaction Delay
* Optional reaction delay before triggering.
* Tracks when a target was first detected.
* Uses target acquisition timing as part of trigger behavior.
## Burst Fire Logic
* Supports configurable burst behavior.
* Track