[3] Blackout Location

The Blackout Location feature is set to create blackouts in preset zones. This system has FULL customization. You are able to customize what locations you want to preset as a blackout zone, the radius of the blackout, whether it has a control panel, and who can access the control panel.

Basic Configuration

-- Enable/Disable Command To Trigger Blackout For Specific Locations Listed In Config 'Main.Locations' 
Main.EnableLocationCommand = true
 
-- Command Name (If 'enableCommand' is set to true.)
Main.LocationCommandName = 'blackout' 

-- Restricted permissions through server.cfg. If true, then restricted to '5S_LocationCommand'. (More details in DOCUMENTATION)
Main.LocationPermissionsRestricted = false 

Command Permissions

To set permissions on this command using ACE Permissions,

1. Set Main.LocationPermissionsRestricted to true in the configuration.

2. Add this to the server.cfg. Make sure to change the group:

add_ace group.admin "5S_LocationCommand" allow

Preset Locations Configuration

['4024'] = { -- Name/Postal of location
    xPos = 1171.7, -- Center Of Circle Coordinate
    yPos = 2711.74, -- Center Of Circle Coordinate
    zPos = 38.09, -- Center Of Circle Coordinate
    Radius = 200.0, -- Radius of the blackout from the center coordinates
    controlPanel = { -- This is the coordinates of the control panel that will be present to enable/disable the blackout on sight. Set X,Y,Z = 0 (equal to zero) if you don't want a panel to spawn.
        permissions = 1, -- 1 = Permissions Based || 2 = Code Based || 3 = Open To Everyone ||  
        code = '4024Power', -- If 'permissions' is set to Code Based (2), then enter the code here -- OR -- If 'permissions' is set to Permissions Based (1), then enter the ACE Permissions Name here. (More details in DOCUMENTATION)
        timer = 5, -- Amount of time it will take to switch the power (in seconds). 
        x = 1204.5,
        y = 2709.62,
        z = 38.1,
        heading = 97.5, -- Heading facing the panel.
    },
},

To add locations, you can duplicate/copy this template (as shown in the config.lua). *Make sure to rename the location in the ['4024'] section (from example).

First, set the X, Y, and Z coordinates for the center of the location.

Second, set the radius of the blackout (we recommend 200.0, but this depends on the size of your location). You can see the radius size from the blip of the zone (this can be enabled in the config as Main.BlackoutBlip).

Third, you have the option to add a Control Panel. To set it up, first decide the permissions (who can access the panel). 1, 2, or 3. These options are described bellow. The timer is how long the user will need to wait at the panel to trigger the blackout (in seconds). Set the X, Y, Z, and Heading of the panel. These coordinates will be where the player needs to stand to interact with the panel.

1 - Permissions

Through ACE Permissions. Set the name of the ACE Permissions in the code = section (line right under permissions). Then, open your server.cfg and add...

2 - Code

3 - Open To Everyone

4 - Custom Permissions

What is the Control Panel?

The Control Panel is an In-Game/In-RP feature that allows a user to trigger a blackout without having to use the chat command. When standing in front of the Control Panel, the user will be prompted to interact with it. If they have the correct permissions, then they can trigger the blackout.