Damage Protection - nrlulz/ACF GitHub Wiki

Damage Protection (aka DP) gives servers the ability to decide who gets to damage props using ACF (an admin panel is included to help with this).

DP is disabled by default and will not appear unless enabled in the user configuration. You can do this with the following steps:

  • Open your ACF addon folder and go to the 'lua/autorun/' folder.
  • Find and open the acf_globals.lua file.
  • This file contains instructions on how to customize ACF's settings.
  • Follow the instructions in that file, and make sure "ACF.EnableDefaultDP = true" is included in your new user settings file.
  • DP will be enabled the next time your server is started or map is changed.

Add a safezone with the command:

acf_addsafezone airbase -500 -500 0 500 500 1000 default

Creates a safezone called "airbase" between the coordinates (-500 -500 0) and (500 500 1000). Adding default at the end makes the safezone uneditable. Only add default at the end when you're sure the safezone is perfect. You can use E2 to find map coordinates, or use a measuring script.

Remove a safezone with the command:

acf_removesafezone airbase

This will remove any safezone with the name airbase. This won't work on the airbase above because it's been set as a default safezone! Removing a safezone won't take effect until you use acf_savesafezones. This is in case you accidentally remove one.

Save all your safezones with the command:

acf_savesafezones

This will save all your safezones to a file so they can be automatically restored the next time you load this map (or when you use the acf_reloadsafezones command). If you add, remove or edit safezones make sure you use this command when you're done or they won't be saved!

Reload all safezones on the map with the command:

acf_reloadsafezones

If you've accidentally used acf_removesafezone, you can use this to restore the safezone. This only reloads safezones which have been saved before.

Set the permission mode with the command:

acf_setpermissionmode battle

This sets the permissions to battle mode. ACF has 5 standard modes:

  • build: You can't damage other people's props unless they've added you to ACF damage permission. You can still die to ACF, and NPCs can too.
  • safebuild: Just like build, but players and NPCs are protected too.
  • battle: You can damage everything that isn't inside a safezone. There may be some exceptions like players and npcs.
  • safe: No damage is allowed.
  • none: All damage is allowed.

'none' is the default mode, but this can be changed with acf_setpermissionmode. If you put this command in server.cfg or autoexec.cfg, it will set the permission mode every time the server starts or the map is changed.

Be aware: all of these modes rely on special ACF functions to work. If you use any unofficial ACF addons, they might not comply with damage permission.

Set the map's DEFAULT permission mode with the command:

acf_setdefaultpermissionmode battle

This sets the server to start with the battle mode enabled, but only when this map is played. this is useful for servers which play on build maps and battle maps.

Reload the permission modes with the command:

acf_reloadpermissionmodes

This is only really useful if you're making your own permission modes.

If you want to set your server's default permission mode to something other than build, use acf_setpermissionmode in your server config.

We're working on moving these commands into tools eventually, so you won't have to mess with coordinates and stuff.