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
| Option | Type | Description |
|---|---|---|
m_Enable | bool | Enables the module with 1 and disables it with 0. |
m_Logging | bool | With 1, records players entering and leaving protection. With 0, keeps this behavior disabled. |
m_ShowOnMap | bool | With 1, publishes configured zones to the Map module. With 0, keeps this behavior disabled. |
m_TimeDelay | int | Seconds the protection remains active after leaving the protected area. |
m_InvertZones | bool | With 1, protects players outside the active zones. With 0, protects them inside. |
m_DisableBots | bool | With 1, skips this protection when a bot is involved. With 0, keeps this behavior disabled. |
m_Zones | array<object> | Areas used to compute zone membership. |
m_Messages | object | Entry, countdown and exit message templates. |
m_NotificationTime | int | Display duration of entry or exit notifications in seconds. |
m_NotificationInChat | bool | With 1, sends zone messages to chat. With 0, displays them as notifications. |
m_DisableExitCountdownNotifications | bool | With 1, hides the exit countdown messages while keeping the protection delay. With 0, keeps this behavior disabled. |
m_Zones[]
| Option | Type | Description |
|---|---|---|
m_Name | string | Label shown to players. |
m_Icon | string | Icon identifier from the marker catalog. |
m_Color | object | Display color. |
m_IsActive | bool | With 1, includes this zone in protection checks and, when enabled, map display. With 0, excludes it from both. |
m_3DMarker | bool | Enables the 3D marker with 1 and disables it with 0. |
m_Positions | array<object> | Circular areas that make up the zone. |
m_Zones[].m_Color
| Option | Type | Description |
|---|---|---|
m_A | int | Opacity from 0 to 255. |
m_R | int | Red channel from 0 to 255. |
m_G | int | Green channel from 0 to 255. |
m_B | int | Blue channel from 0 to 255. |
m_Zones[].m_Positions[]
| Option | Type | Description |
|---|---|---|
m_X | float | World X coordinate in meters. |
m_Y | float | Height in meters. |
m_Z | float | World Z coordinate in meters. |
m_R | float | Horizontal radius in meters. |
m_Messages
| Option | Type | Description |
|---|---|---|
m_Enter | string | Message when protection starts. |
m_Time | string | Exit countdown message. %TimeSeconds% inserts the time remaining. |
m_Exit | string | Message 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.
