Config

Factions mod is completely configurable, allowing server admins to customize the values to best adapt to their server. The following options can be changed by creating a config.json file in the factions directory of your server root directory. Note that if no configuration file is found, Factions Mod will simply warn you in the logs and fallback to all default values.

If a value is not specified or is invalid (a word instead of a number etc.) then it will revert back to it's default value.

Options

Value	Description	Default
basePower	Power that every faction starts off with	20
memberPower	Power gained per member in a faction	20
claimWeight	Power required to hold one chunk	5
maxFactionSize	Maximum number of members allowed in a faction (-1 for no limit)	-1
safeTicksToWarp	Minimum number of ticks to allow a player to warp home after taking damage (1 second = 20 ticks)	1000 (5 sec)
powerDeathPenalty	Power lost when killed by another player	10
ticksForPower	The number of ticks a player must survive to recover their power	12000 (10 min)
ticksForPowerReward	Power recovered after ticksForPower survival time	1
requiredBypassLevel	Required server permission level to access the /f adminBypass command	2
home	Options for /f home command: ANYWHERE (homes can be set anywhere), CLAIMS (homes can only exist within a factions claim), DISABLED (removes the command completely)	CLAIMS

⚠️ A config version number must be specified, the current config version number is 1 as at v1.2.0. This feature has been introduced to ensure that users are alerted to future config updates that may break their existing configuration file.

Example

An example factions/config.json file that sets all values to the default.

{
    "version": 1,
    "basePower": 20,
    "memberPower": 20,
    "claimWeight": 5,
    "maxFactionSize": -1,
    "safeTicksToWarp": 1000,
    "powerDeathPenalty": 10,
    "ticksForPower": 12000,
    "ticksForPowerReward": 1,
    "requiredBypassLevel": 2,
    "home": "CLAIMS"
}