Factions

BukkitDev GitHub
Player Guide Server Owner Guide Developer Guide

Introduction

This plugin allows you to create your own faction. The more followers a faction has the more land the faction can claim. The risk for griefing is low in claimed land since only the faction followers can build there. Factions can forge alliances and declare themselves enemies with others. Land may be taken from other factions through war.

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 teleport to faction home
  • /f map [on/off=once] show territory map
  • /f create <name> create new faction
  • /f name <new name> set faction name
  • /f desc <desc> change faction description
  • /f sethome [faction=you] set the faction home
  • /f open [yes/no=toggle] set if invitation is required to join
  • /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 f –> f
  • /f money fp <amount> <faction> <player> transfer f –> p
  • /f money pf <amount> <player> <faction> transfer p –> f
  • /f sc,seechunk see the chunk you stand in
  • /f claim [radius=1] [faction=you] claim land where you stand
  • /f autoclaim [faction=you] autoclaim when walking
  • /f unclaim unclaim land where you stand
  • /f unclaimall unclaim all 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 perms
  • /f flag [faction=you] [flag=all] [yes/no=read] manage faction flags
  • /f disband [faction=you] disband faction
  • /f admin [on/off=flip] enable adminmode
  • /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 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.

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 sethome [faction=you] set the 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. Finally you should set the home teleport location for your faction using /f sethome [faction=you].

Followers

This section covers these commands:

  • /f open [yes/no=toggle] set if invitation is required to join
  • /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. A faction can be either open or closed. Anyone can join an open faction whilst an invitation is required to join a closed one. Use /f open [yes/no=toggle] to set whether your faction is open or closed. 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 f –> f
  • /f money fp <amount> <faction> <player> transfer f –> p
  • /f money pf <amount> <player> <faction> transfer p –> f

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 [radius=1] [faction=you] claim land where you stand
  • /f autoclaim [faction=you] autoclaim when walking
  • /f unclaim unclaim land where you stand
  • /f unclaimall unclaim all 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.

Use the /f claim [radius=1] [faction=you] command to claim the chunk you stand in. By specifying the radius argument you can claim many chunks at once. You may also want to use the /f autoclaim [faction=you] command to claim by walking around. Use /f unclaim and /f unclaimall to unclaim land.

Land claimed by noone belongs to the faction called “Wilderness”. Claming for Wilderness is the same as unclaiming meaning that /f claim 1 Wilderness and /f unclaim has the same effect.

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.

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 THIS 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 yourfaction someperm to focus on a special permission. For example using /f perm yourperm build would display the build permission configuration for yourfaction. Add in the last two arguments to set the permission for a certain relation. For example /f perm yourfaction lever truce yes would allow those in truce to use levers within your faction territory.

Here’s all the permissions. In parentheses are the default allowed relations.

  • BUILD: edit the terrain (leader, officer, member, ally)
  • PAINBUILD: edit the terrain but take damage while doing so (*none*)
  • DOOR: use doors (leader, officer, member, recruit, ally)
  • BUTTON: use stone buttons (leader, officer, member, recruit, ally)
  • LEVER: use levers (leader, officer, member, recruit, ally)
  • CONTAINER: use containers (leader, officer, member)
  • INVITE: invite players (leader, officer)
  • KICK: kick members (leader, officer)
  • SETHOME: set the home (leader, officer)
  • WITHDRAW: withdraw money (leader, officer)
  • TERRITORY: claim or unclaim (leader, officer)
  • ACCESS: grant territory (leader, officer)
  • DISBAND: disband the faction (leader)
  • PERMS: manage permissions (leader)

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 somefaction. Faction flags can however only be edited by server staff. These are the flags and their default values.

  • PERMANENT: A permanent faction will never be deleted. (no)
  • PEACEFUL: Allways in truce with other factions (no)
  • INFPOWER: This flag gives the faction infinite power. (no)
  • POWERLOSS: Is power lost on death in this territory? (yes)
  • PVP: Can you PVP in territory? (yes)
  • FRIENDLYFIRE: Can friends hurt eachother here? (no)
  • MONSTERS: Can monsters spawn in this territory? (yes)
  • EXPLOSIONS: Can explosions occur in this territory? (yes)
  • OFFLINEEXPLOSIONS: Can explosions occur if faction is offline? (no)
  • FIRESPREAD: Can fire spread in territory? (yes)
  • ENDERGRIEF: Can endermen grief in this territory? (no)

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.

Admin

This section covers these commands:

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

The /f disband [faction=you] command can be used to forcefully disband/delete a faction. The most important admin command however 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 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.