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 factions.json file in the config directory of your server root directory. Note that if no configuration file is found, Factions mod will create one and fill it in with the default values seen below.

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

Options

This is an example of the default config, annotated to tell what each value means.

{
  "version": 3, // Version of the file (alerts you when the config is changed)
  "power": { // Config values related to power
    "base": 20, // The amount of power each faction gets by default
    "member": 20, // The amount of power each faction gets for each member
    "claimWeight": 5, // The amount of power each claim requires
    "deathPenalty": 10, // The amount of power to be removed when someone dies
    "powerTicks": {
      "ticks": 12000, // The number of ticks a player must survive to recover some of their power
      "reward": 1 // The amount of power to be given after a player has survived after the above amount of ticks
    }
  },
  "safe": { // Faction safe config, if false the safe is disabled
    "enderChest": true, // If enderchests go to the faction safe
    "double": true // If the faction safe is a double chest
  },
  "home": { // Faction home config, if set to false the home command will be disabled
    "claimOnly": true, // If the home must be set in a claimed chunk
    "damageTickCooldown": 100 // The number of ticks since a player last took damage before they can warp home
  },
  "display": { // Config related to displayed information
    "factionNameMaxLength": -1, // The max length of a faction name, -1 for no limit
    "changeChat": true, // Whether or not to modify chat
    "tabMenu": true, // Whether or not the tab menu should be modified
    "nameBlackList": [ // A list of all faction names to blacklisted
      "wilderness", // Both of these are used for labels and could lead to confusion if they are used as faction names
      "factionless"
    ]
  },
  "relationships": {
    "allyOverridesPermissions": true, // Whether or not allied factions are affected by permissions
    "defaultGuestPermissions": ["USE_BLOCKS", "USE_ENTITIES"] // Default guest permissions
  },
  "maxFactionSize": -1, // The maximum number of people in a faction, -1 for infinity
  "friendlyFire": false, // Whether or not faction members can hurt each other
  "requiredBypassLevel": 2 // The required admin level to use admin commands
}