Custom Zones

We have updated the Killzone system so that players are now able to create custom zones, with an expanded range of options for how they want their zones to function. The following page has all the information you need to create a zone which is tailored to your needs.

Zone Creation

📟

zones.createcustomzone [0] [1] [2] [3] [4] [5] [6] [7] [8] [9]

This command creates a zone with the following 10 properties:

ID
Arguments
Input Type
Description

[0]

Zone Name

“string"

Defines the name of the generated zone.

[1]

Map Position

(x,y,z)

Defines the centre of the generated zone. Uses map co-ordinates.

[2]

Rotation

value

Defines the rotation of the generated zone. (Yaw)

[3]

Zone Shape

Sphere OR Box

Defines the shape of the generated zone.

[4]

Zone Size

IF [3] =BOX, (x,y,z) IF [3] =SPHERE, x

IF [3] =BOX, defines the width, height, and length of the box. IF [3] =SPHERE, defines the radius of the sphere.

[5]

Enable PvP?

0 or 1

Toggles whether players can damage other players within the generated zone.

[6]

Enable NPC vs Player Damage?

0 or 1

Toggles whether NPCs can damage players within the generated zone. (NOTE: Players can always damage NPCs)

[7]

Radiation Damage

value

Defines the amount of radiation to apply per server tick when within the generated zone.

[8]

Is Building Damage allowed?

0 or 1

Defines whether players can damage buildings when within the generated zone. (NOTE: Players can always damage their own buildings)

[9]

Is Building allowed?

0 or 1

Defines whether players can build within the generated zone.

Example

📟

zones.createcustomzone "Test" (500,35,90) 45 Box (225,150,150) 1 0 52 1 0

This command creates a Custom Zone with the following properties:

  • Zone Name is Test

  • Zone Position is (500,35,90)

  • Zone Rotation is 45⁰ clockwise

  • Zone is box-shaped

  • Zone size is 225m×150m×150m

  • This zone allows PvP

  • This zone does not allow NPCs to damage players

  • This zone deals 52 radiation per tick (similar to inside Launch Site)

  • This zone allows people to raid buildings but not build them


Zone Editing

So you have a zone, but you would like to change something about it without deleting and creating a new one. Use the commands below to edit the zone to your liking. You can also add features like area display and custom messaging to your zone should you see fit.

📟

zones.editcustomzone "Name" "Setting" "Value"

Where "Name" is the name of the zone you would like to edit.

"Setting" is the setting that you would like to change.

Setting
Value
Description

enabled

0 or 1

Toggles whether this zone is active.

position

(x,y,z)

Defines the centre of the generated zone. Uses map co-ordinates.

rotation

value

Defines the rotation of the generated zone.

type

sphere

or box

Defines the shape of the generated zone.

size

(x,y,z)

| IF BOX| area of effect in meters.

size

value

| IF SPHERE| radius of effect in meters.

allowpvpdamage

0 or 1

Toggles whether players can damage other players.

allownpcdamage

0 or 1

Toggles whether NPCs can damage players within the zone. (NOTE: Players will always be able to damage NPCs)

radiationdamage

value

Defines the amount of radiation to apply per server tick when within the generated zone.

allowbuildingdamage

0 or 1

Defines whether players can damage buildings when within the zone. (NOTE: Players can always damage their own buildings)

allowbuilding

0 or 1

Defines whether players can build within the generated zone.

showarea

0 or 1

Show a visible area within 100 meters of the zone.

color

(R,G,B)

Colour of the visible area, (0 -> 255 for each colour)

showchatmessage

0 or 1

Should the player receive a chat message when entering/leaving

entermessage

“string"

Message to display when entering the zone.

leavemessage

“string"

Message to display when exiting the zone.

Example

📟

zones.editcustomzone "Test" showarea 1

zones.editcustomzone "Test" color (255,0,255)

zones.editcustomzone "Test" showchatmessage 1

zones.editcustomzone "Test" entermessage "Welcome to the Test Zone!"

zones.editcustomzone "Test" leavemessage "See you later!"

The above commands have the following effects, when they are entered separately on the GPORTAL console:

  • The "Test" Zone now has a ring around it, visually defining the zone in-game

  • The ring's colour is now Magenta

  • The zone has in-game messaging enabled

  • When you enter the zone, the message "Welcome to the Test Zone!" will appear in-game

  • When you leave the zone, the message "See you later!" will appear in-game

Zone Priorities

Overlapping Custom Zones can have different effects, depending on their properties.

In general, the priority for zones is given to the non-default state of that property.

For example, in a regular server with no other settings, the following priorities apply:

Default Servers

  • PvP Damage OFF BEATS PvP Damage ON (Default)

  • NPC Damage OFF BEATS NPC Damage ON (Default)

  • Building Damage OFF BEATS Building Damage ON (Default)

  • Building Privilege OFF BEATS Building Privilege ON (Default)

Note:

Radiation damage in a zone will always apply, and will stack with other radiation sources.

For example, the overlap area between 2 Custom Zones each with 25 radiation damage will be 50 radiation damage.

PvE Servers

When the commands allowPvPDamage = 0 and allowPvBDamage = 0, the rules are slightly different.

In general, the priority for zones is given to the non-default state of that property.

  • PvP Damage ON BEATS PvP Damage OFF (Default)

  • NPC Damage ON BEATS NPC Damage OFF (Default)

The priority for building privilege remains the same.

Note: Custom Zones will not override any properties of a Monument Zone, regardless of the above priorities.


Editing Monument Killzones

Monument Killzones are part of the new Custom Zones system, meaning that you can edit some characteristics of the monument's zone using the following commands:

📟

zones.editcustomzone "Monument Name" "Setting" "Value"

Example

📟

zones.editcustomzone "gas_station_1" "radiation" "25"

zones.editcustomzone "gas_station_1" "showarea" "1"

  • This enables 25 Radiation damage at Oxum's Gas Station

  • Oxum's Gas Station now has a visual border around it, outlining the Monument Killzone

Note: You cannot disable the no-build zone of monuments.


Additional Options

There are a few more commands that come with this feature, which are listed below:

Type
Command
Input Type
Description

📟

zones.customzoneinfo “Zone Name”

“string"

Lists the following information about the specified zone. Name Enabled Position Size Type Player Damage NPC Damage Radiation Damage Player Building Damage Allow Building Show Area Show Chat Message

Enter Message Leave Message

📟

zones.listcustomzones

none

Prints a list of all zones on the server, and their current active status

📟

zones.deletecustomzone “Zone Name”

“string"

Deletes the specified zone.


Monument Killzones

Monument Killzones still function as normal, but now fall under the new Zones system.

Cargo Ship Custom Zones: Custom zones currently do not function on Cargo Ships. These zones are not saved to individual Cargo Ships and are instead generated on server boot. A default Killzone is generated, but any changes will not be saved for subsequent Cargo Ships.

Type
Command
Input
Description

📟

zones.listmonumentkillzones

none

Prints a list of all monument killzones on the server, and their current active status

📟

zones.clearmonumentkillzones

none

Deletes all monument killzones from the server

📟

zones.setmonumentkillzone

“monumentname" 0/1

Activates [1] or de-activates [0] the specified monument killzone

A list of monuments available are listed here:

airfield_1

Spawns an exclusive PvP Zone around the Airfield

cargoshipdynamic1

Spawns an exclusive PvP Zone around the Shipping Cargoship

cargoshipdynamic2

Spawns an exclusive PvP Zone around the Military Cargoship

gas_station_1

Spawns an exclusive PvP Zone around Oxum’s Gas Station

harbor_1

Spawns an exclusive PvP Zone around the Small Harbor

harbor_2

Spawns an exclusive PvP Zone around the Large Harbor

launch_site_1

Spawns an exclusive PvP Zone around the Launch Site

lighthouse

Spawns an exclusive PvP Zone around the Lighthouse

mining_quarry_a

Spawns an exclusive PvP Zone around the Sulfur Mining Quarry

mining_quarry_b

Spawns an exclusive PvP Zone around the Stone Mining Quarry

mining_quarry_c

Spawns an exclusive PvP Zone around the HQM Mining Quarry

oilrig_1

Spawns an exclusive PvP Zone around the Large Oil Rig

oilrig_2

Spawns an exclusive PvP Zone around the Small Oil Rig

powerplant_1

Spawns an exclusive PvP Zone around the Power Plant

radtown_small_3

Spawns an exclusive PvP Zone around the Sewer

satellite_dish

Spawns an exclusive PvP Zone around the Satellite Dish

sphere_tank

Spawns an exclusive PvP Zone around the Dome

supermarket_1

Spawns an exclusive PvP Zone around the Supermarket

trainyard_1

Spawns an exclusive PvP Zone around the Trainyard

underwater_lab

Spawns an exclusive PvP Zone around the Underwater Lab

water_treatment_plant_1

Spawns an exclusive PvP Zone around the Water Treatment Plant

water_well_a

Spawns an exclusive PvP Zone around Water Well A

water_well_b

Spawns an exclusive PvP Zone around Water Well B

water_well_c

Spawns an exclusive PvP Zone around Water Well C

water_well_d

Spawns an exclusive PvP Zone around Water Well D

water_well_e

Spawns an exclusive PvP Zone around Water Well E

warehouse

Spawns an exclusive PvP Zone around the Mining Outpost

Example

📟

zones.setmonumentkillzone gas_station_1 1

This command activates the classic Killzone at Oxum's Gas Station.

Last updated