Developers

This page contains information only useful to plugin developers

Maven details:

Repository: https://dependency.download/releases
groupId: dev.kitteh
artifactId: factionsuuid
version: 0.7.0

FLocation

FLocation is a Chunk wrapper. If you ever want to deal with the map, claimed land, or something similar, you'll need to convert a Location or Chunk into an FLocation, both of which are super easy :)

Getting from a Bukkit Location.

FLocation flocation = new FLocation(location);

Getting from a Chunk

// Broken apart just to avoid making an overly wide example
String worldName = chunk.getWorld().getName();
int x = chunk.getX();
int z = chunk.getZ();

FLocation flocation = new FLocation(worldName, x, z);

FPlayers

There is always 1 FPlayer object for each player that's been on the server, including online ones. It's very easy to get the associated FPlayer if you already have the Bukkit Player or their UUID.

By Bukkit Player

FPlayer fplayer = FPlayers.getInstance().getByPlayer(player);

By UUID

FPlayer fplayer = FPlayers.getInstance().getById(uuid.toString());

Get Role

Role fplayerRole = fplayer.getRole();

Factions

There are multiple ways you can get a Faction.

Most common is by name (aka tag)

Faction faction = Factions.getInstance().getByTag("name");

If you have a FLocation, you can get the Faction that owns it (including Wilderness, Warzone, and Safezone)

Faction faction = Board.getInstance().getFactionAt(fLocation);