👻 Safe Zones Pro

This is the Safe Zones Pro documentation.

👻 Safe Zones Pro

Safe Zones Pro allows you to define specific areas where player-versus-player (PVP) combat is disabled, ensuring a safe environment for players. This script is highly configurable, allowing you to set multiple zones with different properties.

Links

• FiveM Forum Post: Safe Zones Pro in the Forums
• YouTube Video: Watch the Demo
• Download: Get Safe Zones Pro

About the config.json

{
    "License": "Enter License here",
    "Zones": [
        {
            "Name": "Test",
            "Position": {
                "X": 0.0,
                "Y": 0.0,
                "Z": 0.0
            },
            "Range": 12.0,
            "Height": 120.0,
            "UseHeight": false,
            "DisablePVP": true
        }
    ],
    "RenderingRange": 120.0,
    "Opacity": 155,
    "ShowNotifications": true,
    "NotificationEnteredText": "You entered the zone %zone%",
    "NotificationLeftText": "You left the zone %zone%"
}

Verification

• License: A unique identifier for each transaction. This field is used for tracking and verification purposes. Learn more

Zone Configuration

• Zones: Define multiple safe zones.
  • Name: The name of the zone.
  • Position: The coordinates (X, Y, Z) of the zone's center.
  • Range: The radius of the zone in meters.
  • Height: The height of the zone, useful for multi-level areas.
  • UseHeight: If set to true, the zone will use the specified height to define its vertical boundaries.
  • DisablePVP: If set to true, PVP is disabled in the zone.

Rendering and Notifications

• RenderingRange: The distance at which the safe zone is rendered.
• Opacity: The opacity level of the zone's rendering (0-255).
• ShowNotifications: Set to true to show notifications when entering or leaving a zone.
• NotificationEnteredText: The message displayed when a player enters a zone. %zone% will be replaced with the zone's name.
• NotificationLeftText: The message displayed when a player leaves a zone. %zone% will be replaced with the zone's name.

Example Zone Configuration

Below is an example of how to configure a zone:

{
    "Name": "Central Park",
    "Position": {
        "X": 135.0,
        "Y": -1075.0,
        "Z": 29.0
    },
    "Range": 50.0,
    "Height": 20.0,
    "UseHeight": true,
    "DisablePVP": true
}

In this example, a safe zone named "Central Park" is created with a radius of 50 meters and a height of 20 meters, centered at the coordinates (135.0, -1075.0, 29.0).

Notifications

When players enter or leave a safe zone, notifications can be shown to inform them of the change. These notifications can be customized using the NotificationEnteredText and NotificationLeftText settings. For example:

• NotificationEnteredText: "You entered the zone %zone%"
• NotificationLeftText: "You left the zone %zone%"

These placeholders will be dynamically replaced with the actual zone name when displayed to the player.