💖 Freecam

PrettyPacketAC includes a Freecam Detection system that aims to detect users who are exploiting cheats to fly around the map in Freecam mode. We’ve gone above and beyond to ensure this system can detect even stealth cheats. Method 4 is particularly useful and reliable, but requires additional configuration.

🛠️ Configuration Overview

In your config.lua file, you can configure the Freecam detection like this:

PrettyPacketAC.Freecam = {
    enabled = false,
    method_1 = {
        enabled = false,
        action = "WARN",
    },
    method_2 = {
        enabled = false,
        action = "WARN",
    },
    method_3 = {
        enabled = false,
        action = "WARN",
    },
    method_4 = { -- BEST METHOD
        enabled = false,
        action = "WARN",
        maxCamDistance = 50.0,
        maxMovingSpeed = 0.5,
    }
}

-- Resources that use scripted cameras to not get flagged (FreeCam Related)
PrettyPacketAC.ScriptedCameraWhitelist = {
    ["qb-multicharacter"] = true,
}

---

🔧 Available Detection Methods

• Method 1: Basic detection for Freecam, can be set to "WARN", "KICK", or "BAN".

• Method 2: Another method for detecting Freecam usage, can also be configured for "WARN", "KICK", or "BAN".

• Method 3: Similar to Method 2, provides an additional detection layer, and can be set to "WARN", "KICK", or "BAN".

• Method 4: The best method for detecting Freecam, even stealth cheats! It’s the most reliable but requires some additional configuration, including max camera distance and max movement speed. We recommend using Method 4 for the most accurate detection.

---

📝 Method 4 Configuration Details

Method 4 is the most advanced and accurate detection system, but it does require some configuration:

• maxCamDistance: Defines the maximum distance a player's camera can move away from their character. If the camera distance exceeds this value, Freecam will be flagged.

• maxMovingSpeed: Defines the maximum speed a player's camera can move. If the camera movement exceeds this value, it will trigger the detection.

Example:

• maxCamDistance = 50.0 (camera can only go 50 units away from the character)

• maxMovingSpeed = 0.5 (camera can only move at 0.5 units per second)

---

🔒 Scripted Camera Whitelist

To avoid false positives, especially if you’re using custom scripts that involve scripted cameras (e.g., cinematics or camera modes), we’ve included a scripted camera whitelist. Add any resources that use scripted cameras to this whitelist to prevent them from being flagged by the Freecam detection.

Example:

PrettyPacketAC.ScriptedCameraWhitelist = {
    ["qb-multicharacter"] = true,
}

---

📝 Recommendations for Testing

• Method 4 is highly recommended because it provides the most reliable detection for Freecam usage, including stealth cheats.

• Testing: Start with Method 4 set to "WARN" so you can observe logs and adjust configurations (camera distance and speed) as needed. Once you’ve confirmed it works correctly, you can change the action to "KICK" or "BAN".

• Scripted Cameras: If you have any resources that use custom scripted cameras (e.g., qb-multicharacter), make sure to add them to the ScriptedCameraWhitelist to avoid false detections.

---

💡 Pro Tip:

• Method 4 is the most reliable method to detect Freecam, including those using stealth cheats. Ensure that you test thoroughly to fine-tune the camera distance and movement speed settings, especially if you're using scripted cameras or other custom resources.

• Consider testing with "WARN" to ensure that legitimate activities are not mistakenly flagged.

---

With these settings, you'll be able to detect Freecam users and ensure a fair playing environment. Let me know if you need any more help or adjustments! 💖