Buildable Factions 0.76

Native Minecraft Version:

1.16

Tested Minecraft Versions:

• 1.16

Contributors:

Ferthor

What is it?

Buildable factions is a plugin that allows players to create or join factions and claim territory using CCs. This claimed lands will have certain protections that can be edit at any given time by someone with permission.

Features

Worlds
-In order to work in a specific world, it needs to be activated first. This can be done by typing /world add <WorldName>.

-This requires the "bf.console" permission.

Configuration
-All the configuration is done in the /f panel. Every player has access to it, so they can see all the information.

Create/Join faction
-You can create a faction by typing /f create <FactionTag> <Color> <FactionName>. You can join a faction by typing /f join <FactionName>.

This can be also done using the /f panel.

CCs
-This is the currency used to claim territory, create factions and set homes. It can be obtained by doing advancements.

The amount of CCs given is configurable for each type of advancement in the /f panel:
-Main Menu -> Config Menu -> Advancements

Claim/Abandon territory
-There's two ways you can do this, using commands or by placing banners.

Spoiler: Commands

Spoiler: Banners

Place a green banner to claim territory or a red banner to abandon it. After a certain duration, the territory will be claimed/abandoned in the predefined range.

This can be disabled, and the duration and range of claiming/abandon is configurable in the /f panel:
-Main Menu -> World Information (-> Chunk Settings )

-This requires the "bf.console" permission.

Note: players can only abandon other's faction claimed territory if they have the "bf.dcc" permission.

Protections
-You can configure it for each world, each area, inside or outside of claimed territory.

Everything can be disabled and its configurable in the /f panel:
-Main Menu -> World Information -> Chunk Settings

-This requires the "bf.console" permission.

Roles
-Any player in a faction can add, remove or edit roles. This roles contain access and command permissions, restraining players from doing certain actions and commands, accordingly to the role they have.

This is configurable in the /f panel:
-Main Menu -> Faction Info -> Roles

Default Roles
-When you can create a faction, it will also create default roles. You can add, remove or edit this roles.

This is configurable in the /f panel:
-Main Menu -> Config Menu -> Default Roles

-This requires the "bf.console" permission.

Disable Chunks per Death
-On a player death, a percentage of the total chunks of his faction get disabled, meaning, those chunks will have the same protection as the unclaimed chunks.

This is disabled by default and its configurable in the /f panel:
-Main Menu -> Config Menu -> Disable Chunks per Death

Areas
-You can define a region in the world you are in by typing /area add <1ºChunkX> <1ºChunkZ> <2ºChunkX> <2ºChunkZ> <AreaName>. It will have separated chunk and home settings.

This is configurable in the /f panel:
-Main Menu -> World Information -> Areas -> (AreaName)

bStats
-This will collect some server data and it will help me with future improvements. It can be disabled on the bStats config file.

Commands
Typing this commands on the chat will show all the possible sub-commands and their descriptions:
-/faction or /f, /cc, /area, /world.

All the commands have TAB auto-complete implemented.
Almost all the /faction and /cc commands can be disabled in the /f panel:
-Main Menu -> World Information -> Allowed Commands

Permissions
-"bf.dcc", bypass factions protections;
-"bf.console", edit settings;
-"bf.cc", add ccs to players;
-"bf.areas", allows players to always see areas coordinates;
-"bf.info", view certain player and faction information.

By default, only operators have this permissions.

Spoiler: Events API

Events you can listen to:
-ClaimEvent;
-AbandonEvent;
-CreateFactionEvent;
-CreateHomeEvent;
-RemoveHomeEvent;
-AdvancementEvent.

Maven dependency:
<groupId>lunar.bf</groupId>
<artifactId>BuildableFactions</artifactId>
<version>1.00</version>

Feedback
If you encounter any errors, have some idea you would like to share or just want to leave a thought, comment here bellow.
This will be very useful to future improvements and i really appreciate it.
___________________________________________________________
Have fun!