💖 Teleport

PrettyPacketAC includes a Teleport Detection system designed to catch players who are teleporting, whether on foot or in a vehicle. This detection system will also be triggered if players teleport into or out of shells (e.g., interior or hidden locations). It's recommended to either use bypasses for certain resources or set it to "WARN" to monitor and adjust before taking more severe actions.

🛠️ Configuration Overview

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

PrettyPacketAC.Teleport = {
    enabled = false,
    method_1 = {
        enabled = false,
        action = "WARN",
        max_distance = 50, -- Max Distance on Foot
    },
    method_2 = {
        enabled = false,
        action = "WARN",
        max_distance = 50, -- Max Distance In Car (Will need tweaking depending on how you have your vehicle handling setup)
    },
}

---

🔧 Available Actions

• "WARN": Logs the detection without taking any action. Useful for testing and reviewing.

• "KICK": Kicks the player from the server if teleportation is detected.

• "BAN": Bans the player from the server if teleportation is detected.

---

📝 Recommendations for Testing

• Set to "WARN": For testing, we recommend starting with "WARN" action to observe teleportation activity in the logs. This will help you identify any false positives and adjust settings accordingly.

• Adjust Max Distance: The max_distance value defines how far a player can teleport before being flagged. The default is 50 units for both on-foot and in-vehicle teleportation, but this may need adjustment based on your server’s movement system or vehicle handling.

• In Vehicle: If teleportation occurs while the player is in a vehicle, you may need to tweak method_2's max distance depending on the vehicle's handling setup.

---

🛡️ Bypass Suggestions

• Teleporting into shells (e.g., teleporting into interior areas, or using custom scripts) may trigger false positives. If you have custom scripts for teleporting, it’s highly recommended to set bypasses to avoid unnecessary detections.

💡 Pro Tip:

• Testing: If you’re unsure about how far your players can teleport (e.g., using teleporting commands or specific locations), adjust the max_distance until it best fits your server's needs. Start with "WARN" to log activity and then move to more severe actions like "KICK" or "BAN" once you're confident in the detection’s accuracy.

• Vehicle Handling: If you have unique vehicle setups, tweak the max distance in method_2 accordingly to prevent false positives in vehicles.