Zum Hauptinhalt springen

πŸ‘» 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.

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.