feat: Add FactionsBridge integration.

[CallumJohnson]

FactionsBridge <> libreforge Integration

Triggers

ID	Event	Dispatches	TriggerData
faction_create	FactionCreateEvent	Creator	PLAYER, TEXT (faction tag)
faction_join	FactionJoinEvent	Joining player	PLAYER, TEXT (faction tag)
faction_leave	FactionLeaveEvent	Leaving/kicked player	PLAYER, TEXT (faction tag)
faction_claim	FactionClaimEvent	Player who claimed	PLAYER, LOCATION (chunk centre)
faction_unclaim	FactionUnclaimEvent	Player who unclaimed	PLAYER, LOCATION (chunk centre)
faction_rename	FactionRenameEvent	All online members (fan-out)	PLAYER, TEXT (new name), VALUE 1.0 if leader
faction_disband	FactionDisbandEvent	All online members (fan-out)	PLAYER, TEXT (faction tag), VALUE 1.0 if executor
faction_unclaim_all	FactionUnclaimAllEvent	All online members (fan-out)	PLAYER, TEXT (faction tag), VALUE 1.0 if executor

Effects

ID	Arguments	Behaviour
faction_add_power	power	Adds to faction total power
faction_set_power	power	Sets faction total power
player_add_power	power	Adds to player's individual power
player_set_power	power	Sets player's individual power
faction_add_bank	amount	Adds to faction bank balance
faction_set_bank	amount	Sets faction bank balance
faction_add_tnt	amount	Adds TNT to TNT bank (no-ops if unsupported)
faction_remove_tnt	amount	Removes TNT from TNT bank (no-ops if unsupported)
faction_add_points	points	Adds to faction points
faction_set_points	points	Sets faction points
faction_set_title	title	Sets player's in-faction title
faction_add_strike	reason (optional)	Adds a strike to the faction
faction_remove_strike	reason (optional)	Removes a matching strike from the faction

Conditions

ID	Arguments	Checks
has_faction	...	Player is in a faction
faction_power_above	power	Faction power > threshold
faction_power_below	power	Faction power < threshold
is_faction_role	role	Player's role exactly matches
faction_role_at_least	role	Player's role => rank (RECRUIT < NORMAL < OFFICER < CO_LEADER < LEADER)
in_faction_territory	...	Player's location is claimed by their own faction
faction_relation_is	faction, relation	Player's faction relation to a named faction matches

Filters

ID	Values	Used with
leave_reason	LEAVE, KICK, UNKNOWN	faction_leave
disband_reason	COMMAND, PLUGIN, INACTIVITY, LEAVE, UNKNOWN	faction_disband
faction_role	LEADER, CO_LEADER, OFFICER, NORMAL, RECRUIT	Any trigger with PLAYER
faction_role_at_least	LEADER, CO_LEADER, OFFICER, NORMAL, RECRUIT	Any trigger with PLAYER
owner_only	true / false	faction_rename: restrict to leader only
executor_only	true / false	faction_disband, faction_unclaim_all: restrict to executor only
faction_relation	ENEMY, TRUCE, ALLY, MEMBER, NONE	Triggers with PLAYER + VICTIM

Mutators

ID	Behaviour
faction_leader_as_player	Replaces PLAYER with the faction leader of the dispatcher's faction
victim_faction_leader_as_player	Replaces PLAYER with the faction leader of the victim's faction