Custom Ranks

⚔️ Custom Ranks ⚔️

👉 Since MC 1.16.5 Eagle Factions gives you the ability to create custom ranks in faction and assign them faction members.

---

ℹ️ Before we start, you need to know some important things:

• There are two ranks that MUST ALWAYS EXIST in each faction. These are default and leader ranks.
• Players can have multiple ranks
• Each rank has so called ladder and ladder_position
• This is not possible to create multiple rank ladders in faction

So, rank system uses so called ladder position that is basically an importance of a rank. At this time, ladder position is used only for displaying the rank in chat and rank management.

---

Creation/Deletion of ranks 🛠️

Creation and deletion is very simple. Use following commands:

• /f create_rank <name> <ladder_position> - creates the rank
• /f delete_rank <name> - deletes the rank

---

Viewing information about ranks 🔍

/f list_ranks [<faction>] - shows the list of all ranks inside player faction or given faction. Faction parameter is optional. /f rank <rank> - shows detailed information about the rank

Editing ranks 📝

Each rank can have multiple permissions. The list of available rank permissions is located below on this page.

/f assign_rank <player> <rank> - assigns a rank to the given player

/f rank <rank> set_permission <permission> - sets the permission in given rank

/f rank <rank> set_display_name <display_name> - sets the display name of given rank

/f rank <rank> set_ladder_position <ladder_position> - sets the ladder position of given rank

/f rank <rank> set_display_in_chat <true/false> - sets rank visibility in chat

/f rank <rank> list_permissions - lists all permissions in given rank

---

Starting ranks in faction

If you would like to have a certain list of ranks in every new faction created on the server, you can do so by editing the configuration file. Search for default-ranks inside the config file.

---

Rank permissions list

Actual for 1.0.0.

Available rank permissions:

Permission	Description
INTERACT	Allows player to interact with blocks inside faction
BLOCK_PLACE	Allows player to place blocks inside faction
BLOCK_DESTROY	Allows player to destroy blocks inside faction
TERRITORY_CLAIM	Allow player to claim/unclaim territories/chunks
ATTACK	Allows player to use attack command
INVITE_PLAYERS	Allows player to invite others to faction
VIEW_FACTION_CHEST	Allows player to open faction chest
MANAGE_RANKS	Allows player to manage ranks (only those that have lower ladder position)
ASSIGN_RANKS	Allows player to assign ranks to players (only those that have lower ladder position)
MANAGE_INTERNAL_CLAIMS	Allows player to use /f access command and manage internal claim access.
KICK_MEMBERS	Allows player to kick players from faction
MANAGE_FACTION_HOME	Allows player to manage faction home location
MANAGE_MOTD	Allows player to manage faction's message of the day
MANAGE_DESCRIPTION	Allows player to manage faction's description
MANAGE_IS_PUBLIC	Allows player to manage faction being public or not
MANAGE_TAG_NAME	Allows player to manage faction's tag
MANAGE_TAG_COLOR	Allows player to manage faction's tag color
MANAGE_RELATIONS	Allows player to manage faction's relations (alliances, truces, enemies)
RENAME_FACTION	Allows player to rename faction
INTERNAL_CLAIM_BYPASS_ACCESS	Allows player to bypass internal claim protection system made by /f access (should be given to leaders)

---

Next page: Claiming Territories/Lands