Configuration

Configuring Factions is optional. The default configuration works perfectly in most cases.

Factions can be fully configured while your server is running! Use the /f config command to modify main configuration values while in-game, or you can edit and save any of the configuration files. The modifications will automatically be detected and loaded into the server after a few seconds. You don't need to run any additional reload command or restart the server for the modified settings to take effect.

Main Configuration

You can modify the main configuration settings. This configuration file is located at /mstore/factions_mconf/instance.json.

Warning

Comments have been added to the configuration examples below to explain the values, but these comments should NOT be added to your actual configuration file as it will cause errors.

Command Aliases

{
  // Don't you want "f" as the base command alias? Simply change it here.
  "aliasesF": [
    "f"
  ]
}

World Features

Use this blacklist/whitelist system to toggle features on a per world basis.

{
  "worldsClaimingEnabled": {
    "standard": true,
    "exceptions": []
  },
  "worldsPowerLossEnabled": {
    "standard": true,
    "exceptions": []
  },
  "worldsPowerGainEnabled": {
    "standard": true,
    "exceptions": []
  },
  "worldsPvpRulesEnabled": {
    "standard": true,
    "exceptions": []
  }
}

Player Management

{
  // Add player names here who should bypass all protections.
  // Should /not/ be used for admins. There is "/f admin" for that.
  "playersWhoBypassAllProtection": [],

  // Should players be kicked from their faction and their data erased when banned?
  "removePlayerWhenBanned": true,

  // After how many milliseconds should players be automatically kicked from their faction?
  "cleanInactivityToleranceMillis": 864000000, // 10 days

  // Which faction should new players be followers of?
  // "none" means Wilderness. Remember to specify the id, not the name.
  "defaultPlayerFactionId": "none",

  // What power should the player start with?
  "defaultPlayerPower": 0.0
}

Power System

{
  // What is the maximum player power?
  "powerMax": 10.0,

  // What is the minimum player power?
  "powerMin": 0.0,

  // How much power should be regained per hour online on the server?
  "powerPerHour": 2.0,

  // How much power should be lost on death?
  "powerPerDeath": -2.0,

  // Can players with negative power leave their faction?
  "canLeaveWithNegativePower": true
}

Faction Limits

{
  // Is there a maximum amount of members per faction?
  // 0 means there is not.
  "factionMemberLimit": 0,

  // Is there a maximum faction power cap?
  // 0 means there is not.
  "factionPowerMax": 0.0,

  // Limit the length of faction names here.
  "factionNameLengthMin": 3,
  "factionNameLengthMax": 16
}

Territory Claims

{
  // Must claims be connected to each other?
  "claimsMustBeConnected": true,

  // Must claims be connected to each other enforced strictly?
  "claimsMustBeConnectedStrict": false,

  // Would you like to allow unconnected claims when conquering land?
  "claimsCanBeUnconnectedIfOwnedByOtherFaction": false,

  // Is claiming from other factions even allowed?
  "claimingFromOthersAllowed": true,

  // Is it required for factions to have an inflated land/power ratio?
  "claimingFromOthersMustBeInflated": true,

  // Is a minimum distance to other factions required?
  "claimMinimumChunksDistanceToOthers": 0,

  // Do you need a minimum amount of faction members to claim land?
  "claimsRequireMinFactionMembers": 1,

  // Is there a maximum limit to chunks claimed?
  "claimedLandsMax": 0,

  // The max amount of worlds in which a player can have claims in.
  "claimedWorldsMax": -1
}

Faction Warps

{
  // Is the warps feature enabled?
  "warpsEnabled": true,

  // How many warps can they have?
  "warpsMax": 1,

  // Must warps be located inside the faction's territory?
  "warpsMustBeInClaimedTerritory": true,

  // And what faction warp should be used when a player types /f home
  "warpsHomeName": "home",

  // These options can be used to limit rights to warp under different circumstances.
  "warpsTeleportAllowedFromEnemyTerritory": true,
  "warpsTeleportAllowedFromDifferentWorld": true,
  "warpsTeleportAllowedEnemyDistance": 32.0,
  "warpsTeleportIgnoreEnemiesIfInOwnTerritory": true,

  // Should players teleport to faction warp on death?
  "warpsTeleportToOnDeathActive": false,

  // And what faction warp should it be?
  "warpsTeleportToOnDeathName": "home",

  // This value can be used to tweak compatibility with other plugins.
  "warpsTeleportToOnDeathPriority": "NORMAL"
}

Protection Settings

{
  // Protects the faction land from liquid flow
  "protectionLiquidFlowEnabled": true,

  // Protects the faction land from piston extending/retracting
  "handlePistonProtectionThroughDenyBuild": true
}

Territory Information

{
  "territoryInfoTitlesDefault": true,
  "territoryInfoTitlesMain": "{relcolor}{name}",
  "territoryInfoTitlesSub": "<i>{desc}",
  "territoryInfoTitlesTicksIn": 5,
  "territoryInfoTitlesTicksStay": 60,
  "territoryInfoTitleTicksOut": 5,
  "territoryInfoChat": "<i> ~ {relcolor}{name} <i>{desc}",
  "territoryAccessShowMessage": true
}

PvP and Combat

{
  // Set this option to true if want to block the promotion of new leaders for permanent factions.
  "permanentFactionsDisableLeaderPromotion": false,

  // How much health damage should a player take upon placing or breaking a block in a "pain build" territory?
  "actionDeniedPainAmount": 2.0,

  // If you set this option to true then factionless players cant partake in PVP.
  "disablePVPForFactionlessPlayers": false,

  // Set this option to true to create an exception to the rule above.
  "enablePVPAgainstFactionlessInAttackersLand": false,

  // Set this option to false to prevent players from hurting neutral players while they are in the neutral player's territory.
  "enablePVPAgainstNeutralInTheirTerritory": true,

  // Inside your own faction territory you take less damage.
  "territoryShieldFactor": 0.1
}

Economy Integration

{
  // Should economy features be enabled?
  // This requires that you have the external plugin called "Vault" installed.
  "econEnabled": true,

  // When paying a cost you may specify an account that should receive the money here.
  "econUniverseAccount": "",

  // What is the price per chunk when using /f set?
  "econChunkCost": {
    "BUY": 1.0,        // when claiming from wilderness
    "SELL": 0.0,       // when selling back to wilderness
    "CONQUER": 0.0,    // when claiming from another player faction
    "PILLAGE": 0.0     // when unclaiming from another player faction
  },

  // What is the price to create a faction?
  "econCostCreate": 100.0,

  // And so on and so forth...
  "econCostWarpAdd": 0.0,
  "econCostWarpRemove": 0.0,
  "econCostJoin": 0.0,
  "econCostLeave": 0.0,
  "econCostKick": 0.0,
  "econCostInvite": 0.0,
  "econCostDeinvite": 0.0,
  "econCostWarpGo": 0.0,
  "econCostName": 0.0,
  "econCostDescription": 0.0,
  "econCostTitle": 0.0,
  "econCostFlag": 0.0,

  "econRelCost": {
    "ENEMY": 0.0,
    "ALLY": 0.0,
    "TRUCE": 0.0,
    "NEUTRAL": 0.0
  },

  // Should the faction bank system be enabled?
  "bankEnabled": true,

  // What costs should the faction bank take care of?
  "bankFactionPaysCosts": true
}

Command Restrictions

{
  // A list of commands to block for members of permanent factions.
  "denyCommandsPermanentFactionMember": [],

  // Lists of commands to deny depending on your relation to the current faction territory.
  "denyCommandsTerritoryRelation": {
    "ENEMY": [
      "home", "homes", "sethome", "createhome", "tpahere", "tpaccept",
      "tpyes", "tpa", "call", "tpask", "warp", "warps", "spawn"
    ],
    "NEUTRAL": [],
    "TRUCE": [],
    "ALLY": [],
    "MEMBER": []
  },

  // The distance for denying the following commands. Set to -1 to disable.
  "denyCommandsDistance": -1,

  // Lists of commands to deny depending on your relation to a nearby enemy.
  "denyCommandsDistanceRelation": {
    "ENEMY": ["home"],
    "NEUTRAL": [],
    "TRUCE": [],
    "ALLY": [],
    "FACTION": []
  },

  // Allow bypassing the above setting when in these territories.
  "denyCommandsDistanceBypassIn": [
    "ALLY",
    "FACTION"
  ]
}

Faction Colors

{
  "colorMember": "GREEN",
  "colorAlly": "DARK_PURPLE",
  "colorTruce": "LIGHT_PURPLE",
  "colorNeutral": "WHITE",
  "colorEnemy": "RED",
  "colorNoPVP": "GOLD",
  "colorFriendlyFire": "DARK_RED"
}

Tax System

{
  // Should the tax system be enabled?
  "taxEnabled": false,

  // How much can you tax a player?
  "taxPlayerMinimum": -10,
  "taxPlayerMaximum": 10,

  // When is a player inactive?
  "taxInactiveDays": 3,

  // When the last run time was (in unix time)
  "taxTaskLastMillis": 0,

  // Tax run when?
  "taxTaskInvocationOffsetMillis": 0,

  // How often should the task be run?
  "taxTaskPeriodMillis": 86400000
}

Default Ranks

{
  "defaultRanks": [
    {
      "name": "Leader",
      "priority": 400,
      "prefix": "**"
    },
    {
      "name": "Officer",
      "priority": 300,
      "prefix": "*"
    },
    {
      "name": "Member",
      "priority": 200,
      "prefix": "+"
    },
    {
      "name": "Recruit",
      "priority": 100,
      "prefix": "-"
    }
  ]
}

Flags Configuration

You can change the defaults of faction flags. These configuration files are located at /mstore/factions_mflag/*.json.

{
  // The sort priority. Low values appear first in sorted lists.
  "priority": 1000,

  // The name of the flag.
  "name": "open",

  // The flag function described as a question.
  "desc": "Can the faction be joined without an invite?",

  // The flag function described when true.
  "descYes": "An invite is required to join.",

  // The flag function described when false.
  "descNo": "Anyone can join. No invite required.",

  // What is the standard (aka default) flag value?
  "standard": false,

  // Is this flag editable by players?
  "editable": true,

  // Is this flag visible to players?
  "visible": true
}

Permissions Configuration

You can change the defaults of faction permissions. These configuration files are located at /mstore/factions_mperm/*.json.

{
  // The sort priority. Low values appear first in sorted lists.
  "priority": 1000,

  // The name of the perm.
  "name": "build",

  // The perm function described as an "order".
  "desc": "edit the terrain",

  // Is this a territory perm?
  "territory": true,

  // Is this perm editable by players?
  "editable": true,

  // Is this perm visible to players?
  "visible": true
}

Configuration Tips

Performance Optimization

• Set reasonable limits for factionMemberLimit and claimedLandsMax
• Use cleanInactivityToleranceMillis to automatically remove inactive players

Security Settings

• Configure denyCommandsTerritoryRelation to prevent teleportation exploits
• Set up playersWhoBypassAllProtection only for trusted automation accounts

Gameplay Balance

• Adjust powerPerHour and powerPerDeath to balance power recovery vs loss
• Set territoryShieldFactor to provide home field advantage
• Configure econChunkCost to make territorial expansion meaningful

Administrative

• Use /f config command for live configuration changes
• Monitor server console for configuration validation errors
• Back up configuration files before making major changes