Factions Logotype

Factions Tax Dynmap Restore Download Configure Develop

What is Factions?

dynmap-screenshot

With this plugin players group up in Factions.
You claim land as your own and build your base.
Factions is a self serve anti griefing system.
Leaders control who can can edit their faction land.

Factions is also about diplomacy and war.
You declare wars and forge alliances.
You fight over land and manage your monetary expenses.

  • Create your Faction!
  • Invite your Friends!
  • Claim your Land!
  • Build your Home!
  • Protect your Allies!
  • Fight your Enemies!

Since 2011

Factions was released February 6, 2011 and is the original plugin of it’s kind.

It has since undergone a multitude of changes and improvements.

0+
Over two and a half million downloads!
0+
Over a thousand source code changes!

New in Factions 2.7

Released: 19 November, 2014

  • UUID support! Has actually been in Factions since 2.4.0.
  • Over 50 issues fixed! Thanks for reporting your bugs on GitHub.
  • /f motd – Message of the Day for your Faction only.
  • /f claim - Instant claiming with radius. Square, Circle, Fill and Transfer tools.
  • /f tax – Brand new taxation system as an expansion plugin.
  • /f dynmap – Dynmap integration as an expansion plugin.
  • /f seechunk – See chunks using particle effects as you move around.
  • /f flag – Faction flags modifiable by leader. Toggle on monster spawning!
  • /f home [faction] – Teleport to the homes of your allies!

Download

Download

Download Factions for Free.
Download Expansions for 10$ a piece.

Download

Commands

This is the complete list of commands. This documentation will teach you how to use them all.

  • /f the factions base command
  • /f l,list [page=1] list all factions
  • /f f,faction [faction=you] show faction information
  • /f p,player [player=you] show player information
  • /f join <faction> [player=you] join faction
  • /f leave leave your faction
  • /f home [faction=you] teleport to faction home
  • /f map [on/off=once] show territory map
  • /f create <name> create new faction
  • /f name <new name> [faction=you] set faction name
  • /f desc <desc> change faction description
  • /f motd [new=read] faction motd
  • /f sethome [faction=you] set the faction home
  • /f unsethome [faction=you] unset faction home
  • /f inv,invite <player> [yes/no=toggle] set if player is invited
  • /f kick <player> kick player from faction
  • /f title <player> <title> set player title
  • /f promote <player> promote lesser members in your faction
  • /f demote <player> demote lesser members in your faction
  • /f officer <player> make player officer
  • /f leader <player> [faction=you] set leader for faction
  • /f money manage faction money
  • /f money b,balance [faction=you] show faction money
  • /f money d,deposit <amount> [faction=you] deposit to faction
  • /f money w,withdraw <amount> [faction=you] withdraw from faction
  • /f money ff <amount> <faction> <faction> transfer faction –> faction
  • /f money fp <amount> <faction> <player> transfer faction –> player
  • /f money pf <amount> <player> <faction> transfer player –> faction
  • /f sc,seechunk [active=toggle] see the chunk you stand in
  • /f sco,seechunkold see the chunk you stand in
  • /f claim claim faction territory
  • /f claim o,one [faction=you] claim a single chunk
  • /f claim a,auto [faction=you] claim as you walk around
  • /f claim f,fill [faction=you] claim by filling
  • /f claim s,square [radius=1] [faction=you] claim by square and radius
  • /f claim c,circle [radius=1] [faction=you] claim by circle and radius
  • /f claim all <all|map> <faction> <newfaction> claim all faction land
  • /f unclaim unclaim faction territory
  • /f unclaim o,one unclaim a single chunk
  • /f unclaim a,auto unclaim as you walk around
  • /f unclaim f,fill unclaim by filling
  • /f unclaim s,square [radius=1] unclaim by square and radius
  • /f unclaim c,circle [radius=1] unclaim by circle and radius
  • /f unclaim all <all|map> <faction> unclaim all faction land
  • /f access manage access
  • /f access v,view view access
  • /f access p,player <player> [yes/no=toggle] grant player access
  • /f access f,faction <faction> [yes/no=toggle] grant faction access
  • /f ally <faction> set relation wish to another faction
  • /f truce <faction> set relation wish to another faction
  • /f neutral <faction> set relation wish to another faction
  • /f enemy <faction> set relation wish to another faction
  • /f perm [faction=you] [perm=all] [relation=read] [yes/no=read] change faction permissions
  • /f flag [faction=you] [flag=all] [yes/no=read] manage faction flags
  • /f e,expansions list expansions
  • /f r,restore Use FactionsRestore
  • /f r,restore s,show [world=you] show world info
  • /f r,restore l,list [page=1] list restoring worlds
  • /f r,restore log [page=1] [world=you] display world log
  • /f r,restore v,version display plugin version
  • /f tax Use FactionsTax
  • /f tax i,info overview tax info
  • /f tax f,faction [faction=you] faction tax info
  • /f tax p,player [player=you] player tax info
  • /f tax s,set <amount|none> [default|rank|player|all=default] [faction=you] set tax
  • /f tax run run taxation task
  • /f tax v,version display plugin version
  • /f dynmap Use FactionsDynmap
  • /f dynmap v,version display plugin version
  • /f admin [on/off=flip] enable adminmode
  • /f disband [faction=you] disband faction
  • /f powerboost <p|f|player|faction> <name> <#> set powerboost
  • /f v,version display plugin version

Overview

This section covers these commands:

  • /f the factions base command
  • /f l,list [page=1] list all factions
  • /f f,faction [faction=you] show faction information
  • /f p,player [player=you] show player information
  • /f join <faction> [player=you] join faction
  • /f leave leave your faction
  • /f home [faction=you] teleport to faction home
  • /f map [on/off=once] show territory map

Joining a faction is one of the first things you should do as a new player. Use the /f l,list [page=1] command to list the factions. To learn more about a certain faction you can use the /f p,player [player=you] command which for example will display all the followers. To learn more about a certain follower you can use the /f p,player [player=you] command.

Once you decided what faction to join you can use the /f join <faction> [player=you] command to do so. If you change your mind you can use /f leave to leave.

Your faction may have a special home location. You can teleport there using /f home. You can also teleport to the homes of your allied factions using /f home <faction>.

Use the /f map [on/off=once] command to see the territorial land map and get an understanding for what factions own the land around yourself.

When using a commands that takes a faction as an argument you can actually specify a player name instead. That faction that player belongs to will then be used.

Create

This section covers these commands:

  • /f create <name> create new faction
  • /f name <new name> set faction name
  • /f desc <desc> change faction description
  • /f motd [new=read] faction motd
  • /f sethome [faction=you] set the faction home
  • /f unsethome [faction=you] unset faction home

You can use /f create <name> to create your own faction. If you later on decide you want a different name for your faction you can rename it using /f name <new name>.

Use the /f desc <desc> command to set the description for your faction. The description is shown when walking into the faction territory or when using the /f f,faction [faction=you] command.

Use the /f desc motd [new=read] command to set the faction message of the day. This message will only be displayed to your faction members as they join the server. This can be used as a simple news system.

Finally you should set the home teleport location for your faction using /f sethome [faction=you]. If you for some reason would like to remove the home location later you can do so using /f unsethome [faction=you].

Followers

This section covers these commands:

  • /f inv,invite <player> [yes/no=toggle] set if player is invited
  • /f kick <player> kick player from faction
  • /f title <player> <title> set player title
  • /f promote <player> promote lesser members in your faction
  • /f demote <player> demote lesser members in your faction
  • /f officer <player> make player officer
  • /f leader <player> [faction=you] set leader for faction

Now it’s time to get some followers for your faction. Use /f inv,invite <player> [yes/no=toggle] to invite a player to your faction. The same command can be used to revoke invitations.

If a faction follower is misbehaving you can kick them using /f kick <player>. If they are doing great you might want to reward them with a custom title using the /f title <player> <title> command (ampersand color codes work).

There are four different faction ranks. They are **Leader, *Officer, +Member and -Recruit. Use the /f promote <player> and /f demote <player> commands to modify someones rank. There is also the dedicated /f officer <player> command to make someone an officer. There can be many officers but only one leader. Use the /f leader <player> [faction=you] command to resign your leader role and faction ownership to someone else.

The higher your rank is the more permissions you get to manage the faction. For example anyone may deposit money into the faction but only officers and above may withdraw.

Make sure to promote some trusted faction followers to officers. This way the faction can still be managed even if the leader goes on vacation.

Money

This section covers these commands:

  • /f money manage faction money
  • /f money b,balance [faction=you] show faction money
  • /f money d,deposit <amount> [faction=you] deposit to faction
  • /f money w,withdraw <amount> [faction=you] withdraw from faction
  • /f money ff <amount> <faction> <faction> transfer faction –> faction
  • /f money fp <amount> <faction> <player> transfer faction –> player
  • /f money pf <amount> <player> <faction> transfer player –> faction

Each faction has a money account. The money commands can be used to check and transfer money in various ways. Certain actions like renaming the faction or claiming land may cost money. The faction money will be used for this.

Land

This section covers these commands:

  • /f sc,seechunk see the chunk you stand in
  • /f claim claim faction territory
  • /f claim o,one [faction=you] claim a single chunk
  • /f claim a,auto [faction=you] claim as you walk around
  • /f claim f,fill [faction=you] claim by filling
  • /f claim s,square [radius=1] [faction=you] claim by square and radius
  • /f claim c,circle [radius=1] [faction=you] claim by circle and radius
  • /f claim all <all|map> <faction> <newfaction> claim all faction land
  • /f unclaim unclaim faction territory
  • /f unclaim o,one unclaim a single chunk
  • /f unclaim a,auto unclaim as you walk around
  • /f unclaim f,fill unclaim by filling
  • /f unclaim s,square [radius=1] unclaim by square and radius
  • /f unclaim c,circle [radius=1] unclaim by circle and radius
  • /f unclaim all <all|map> <faction> unclaim all faction land
  • /f access manage access
  • /f access v,view view access
  • /f access p,player <player> [yes/no=toggle] grant player access
  • /f access f,faction <faction> [yes/no=toggle] grant faction access

Faction land is claimed chunk-wise. A chunk is 16×16 blocks spanning all the way from bedrock to sky. Use the /f sc,seechunk command to see the chunk you are currently standing in.

A faction can claim as many chunks as it has power. The faction power is the sum of all followers individual power. Each player has 10 power meaning that a faction with 10 followers would have 100 power. A player looses 2 power on death and regains 2 power per hour.

Use the /f claim command to claim chunks for your faction. Use /f claim one to claim the one chunk you stand in. Use /f claim auto to claim by walking around. After you have walked around your base you can use /f claim fill. You can also stand in the middle of the base and claim a 3 radius square using /f claim square 3 or circle using /f claim circle 3.

To unclaim land you use the similar /f unclaim command. For example /f unclaim one or /f unclaim auto or /f unclaim fill or /f unclaim squre 3 or /f unclaim circle 3.

There is also the advanced /f claim all and /f unclaim all commands. You can transfer all land from OldFaction to NewFaction using /f claim all OldFaction NewFaction. Use /f claim map OldFaction NewFaction if you only want to transfer chunks on the current map. Or specify the map name like /f claim MapName OldFaction NewFaction. Likewise you can unclaim all land for YourFaction using /f unclaim all YourFaction or /f unclaim map YourFaction or /f unclaim all MapName YourFaction.

In factions with many followers you may want to hand out private chunks where only certain players can build. This can be done using the /f access commands. Here are some common cases:

  • “My officers should not be able to build in this chunk.”
    This is not possible. Choose your officers wisely.
  • “Only officers and leaders should be able to build in this chunk.”
    Use /f access f yourfaction no to remove build rights for normal faction followers.
  • “Only one certain player should be able to build in this chunk.”
    Use /f access f yourfaction no and then /f access p playername yes.
  • “All allied factions should be able to build but not THIS faction.”
    First consider downgrading that relation to a truce. If that’s not an option you can remove them using /f access f <faction> no.

Relations

This section covers these commands:

  • /f ally <faction> set relation wish to another faction
  • /f truce <faction> set relation wish to another faction
  • /f neutral <faction> set relation wish to another faction
  • /f enemy <faction> set relation wish to another faction

The default relation wish towards another faction is neutral. This wish can be changed using the relation commands. The ally and truce relations need to be mutual to take effect. The enemy relation is however one-sided. If another faction wants to be your enemy you will be enemies whether you want it or not.

Friendly fire is blocked for followers of the same faction as you, factions in truce or factions you are allied to. Additionally you can not hurt neutrals in their own territory. If you want to attack someones faction base you must declare your faction as an enemy to theirs. Damage from enemies is reduced by a certain percentage while inside your own territory.

The difference between ally and truce is that allies are allowed to do about the same things as normal faction members. Allies can build in your territory, open containers etc. For this reason you should use truce instead of ally unless you really really trust the other faction.

Territorial warfare between enemies may be possible unless the server owner disabled it. Kill followers of your enemy faction so they loose power. After a while the faction power will have dropped below the amount of chunks they claimed. When that is the case you can start unclaiming, or even claim, their chunks at the edge of their territory.

Safezone and Warzone faction can be created where the rules are different. Safezones can not be claimed by other factions. PVP is turned off and monsters may not spawn or hurt players there. Warzones however are not safe from PVP and monsters. Further, they can be configured to have friendly fire enabled so that PVP between allies and faction members is possible. These two factions are created by default but additional ones can be created and configured using faction flags (further down in this documentation).

Permissions

This section covers these commands:

  • /f perm [faction=you] [perm=all] [relation=read] [yes/no=read] change perms

Who is allowed to do what within a faction can be managed by the faction leader using the /f perm command. Anyone can type /f perm or /f perm yourfaction to show the permission configuration for yourfaction. Use /f perm <faction> <perm> to focus on a special permission. For example using /f perm <faction> build would display the build permission configuration in the faction. Add in the last two arguments to set the permission for a certain relation. For example /f perm <faction> lever truce yes would allow those in truce to use levers within the faction territory.

NameDescriptionDefault
Buildedit the terrainleader, officer, member
PainBuildedit the terrain but take damage while doing so
Dooruse doorsleader, officer, member, recruit, ally
Buttonuse stone buttonsleader, officer, member, recruit, ally
Leveruse leversleader, officer, member, recruit, ally
Containeruse containersleader, officer, member
Nameset nameleader
Descset descriptionleader, officer
Motdset motdleader, officer
Inviteinvite playersleader, officer
Kickkick membersleader, officer
Titleset titlesleader, officer
Hometeleport homeleader, officer, member, recruit, ally
SetHomeset the homeleader, officer
Depositdeposit moneyleader, officer, member, recruit, ally, truce, neutral, enemy
Withdrawwithdraw moneyleader
Territoryclaim or unclaimleader, officer
Accessgrant territoryleader, officer
ClaimNearclaim nearbyleader, officer, member, recruit, ally
Relchange relationsleader, officer
Disbanddisband the factionleader
Flagsmanage flagsleader
Permsmanage permissionsleader

Flags

This section covers these commands:

  • /f flag [faction=you] [flag=all] [yes/no=read] manage faction flags

A faction flag is a boolean (yes or no). Any player can display the flags of a faction by using /f flag [factionname]. Some but not all flags can be edited by the faction leader. As an exercise I suggest you run /f flag safezone and /f flag warzone. The flags for these factions is what makes them work in that special way they do.

NameEditableDescriptionDefault
OpenyesCan the faction be joined without an invite?no
MonstersyesCan monsters spawn in this territory?no
PowerlossnoIs power lost on death in this territory?yes
PVPnoCan you PVP in territory?yes
FriendlyFirenoCan friends hurt eachother in this territory?no
ExplosionsnoCan explosions occur in this territory?yes
OfflineExplosionsnoCan explosions occur if faction is offline?no
FireSpreadnoCan fire spread in territory?yes
EnderGriefnoCan endermen grief in this territory?no
PermanentnoIs the faction immune to deletion?no
PeacefulnoIs the faction in truce with everyone?no
InfPowernoDoes the faction have infinite power?no

Expansions

This section covers these commands:

  • /f e,expansions list expansions
  • /f r,restore Use FactionsRestore
  • /f r,restore s,show [world=you] show world info
  • /f r,restore l,list [page=1] list restoring worlds
  • /f r,restore log [page=1] [world=you] display world log
  • /f r,restore v,version display plugin version
  • /f tax Use FactionsTax
  • /f tax i,info overview tax info
  • /f tax f,faction [faction=you] faction tax info
  • /f tax p,player [player=you] player tax info
  • /f tax s,set <amount|none> [default|rank|player|all=default] [faction=you] set tax
  • /f tax run run taxation task
  • /f tax v,version display plugin version
  • /f dynmap Use FactionsDynmap
  • /f dynmap v,version display plugin version

Factions is open source and free. You can however support the development by purchasing optional expansion plugins.
Use /f expansions to list the available expansions and see which are installed on the server.

Admin

This section covers these commands:

  • /f admin [on/off=flip] enable adminmode
  • /f disband [faction=you] disband faction
  • /f powerboost <p|f|player|faction> <name> <#> set powerboost
  • /f v,version display plugin version

The most important admin command is /f admin [on/off=flip]. When in admin mode you bypass all restrictions. You can build anywhere, change the faction leader without being leader yourself, claim and unclaim anywhere etc.

The /f disband [faction=you] command can be used to forcefully disband/delete a faction.
The /f powerboost command can be used to grant extra power to a certain faction or player.
The /f v,version command can be used to check what version the plugin is.