Skip to content

PVE ​

Description ​

Applies combat protection when players enter configured areas. It can also protect players outside those areas, show zones on the map and preserve protection for a short time after departure.

Configuration ​

Default configuration ​

PVE.json
json
{
    "m_Enable": 0,
    "m_Logging": 1,
    "m_ShowOnMap": 1,
    "m_TimeDelay": 15,
    "m_InvertZones": 0,
    "m_DisableBots": 0,
    "m_Zones": [
        {
            "m_Name": "PVE Zone",
            "m_Icon": "shield",
            "m_Color": {
                "m_A": 255,
                "m_R": 0,
                "m_G": 255,
                "m_B": 0
            },
            "m_Positions": [
                {
                    "m_X": 3726.79,
                    "m_Y": 601.6,
                    "m_Z": 6010.4,
                    "m_R": 500.0
                }
            ],
            "m_IsActive": 1,
            "m_3DMarker": 1
        }
    ],
    "m_Messages": {
        "m_Enter": "You just entered a PVE zone.",
        "m_Time": "You are leaving the zone in %TimeSeconds% seconds.",
        "m_Exit": "You just left a PVE zone."
    },
    "m_NotificationTime": 10,
    "m_NotificationInChat": 0,
    "m_DisableExitCountdownNotifications": 0
}

Options ​

OptionTypeDescription
m_EnableboolEnables the module with 1 and disables it with 0.
m_LoggingboolWith 1, records players entering and leaving protection. With 0, keeps this behavior disabled.
m_ShowOnMapboolWith 1, publishes configured zones to the Map module. With 0, keeps this behavior disabled.
m_TimeDelayintSeconds the protection remains active after leaving the protected area.
m_InvertZonesboolWith 1, protects players outside the active zones. With 0, protects them inside.
m_DisableBotsboolWith 1, skips this protection when a bot is involved. With 0, keeps this behavior disabled.
m_Zonesarray<object>Areas used to compute zone membership.
m_MessagesobjectEntry, countdown and exit message templates.
m_NotificationTimeintDisplay duration of entry or exit notifications in seconds.
m_NotificationInChatboolWith 1, sends zone messages to chat. With 0, displays them as notifications.
m_DisableExitCountdownNotificationsboolWith 1, hides the exit countdown messages while keeping the protection delay. With 0, keeps this behavior disabled.

m_Zones[] ​

OptionTypeDescription
m_NamestringLabel shown to players.
m_IconstringIcon identifier from the marker catalog.
m_ColorobjectDisplay color.
m_IsActiveboolWith 1, includes this zone in protection checks and, when enabled, map display. With 0, excludes it from both.
m_3DMarkerboolEnables the 3D marker with 1 and disables it with 0.
m_Positionsarray<object>Circular areas that make up the zone.

m_Zones[].m_Color ​

OptionTypeDescription
m_AintOpacity from 0 to 255.
m_RintRed channel from 0 to 255.
m_GintGreen channel from 0 to 255.
m_BintBlue channel from 0 to 255.

m_Zones[].m_Positions[] ​

OptionTypeDescription
m_XfloatWorld X coordinate in meters.
m_YfloatHeight in meters.
m_ZfloatWorld Z coordinate in meters.
m_RfloatHorizontal radius in meters.

m_Messages ​

OptionTypeDescription
m_EnterstringMessage when protection starts.
m_TimestringExit countdown message. %TimeSeconds% inserts the time remaining.
m_ExitstringMessage when protection ends.

The protection blocks damage between different players if the attacker or victim is protected, subject to the game's damage rules. An attacker in superadmin mode bypasses this protection when the victim is in a protected zone. It also blocks protected victims' damage from transport, traps and grenades when the attacker cannot be resolved to a player.

Released under the MIT License.