Factions
Group players into factions for community identity, friendly fire awareness, and zone protection.
What are factions?
Factions let you group players on your server into named teams or clans. They're useful for community servers that want to organise players into groups, but they also have practical in-game integrations with several Vigil modules.
Creating and managing factions
From your server dashboard, go to Factions to:
- Create a faction with a name, tag, and colour
- Add players to a faction by their gamertag
- Remove players or disband factions
Faction membership is stored in Vigil and doesn't require anything in-game.
How factions affect modules
Kill Feed & Achievements
Vigil is aware of faction membership. Kills between members of the same faction are treated as friendly fire. This affects:
- Achievements — friendly fire kills don't count towards kill-based achievements (e.g. kill streaks)
- Kill Feed can optionally label or suppress friendly fire kills
Zone Alerts
When a faction creates a zone, faction members inside that zone do not trigger alerts. Only players outside the faction entering the zone trigger a notification. This makes zone alerts practical for base protection — your own teammates won't set off your own alerts.
Player-facing faction pages
Factions have a public-facing page where faction members can see their roster, stats, and zone configurations. The page is accessible to anyone with the link, making it easy to share with your community.
Player-created factions
When allow_player_factions is enabled in your faction settings, players can create and manage their own factions directly from the Vigil player profile page (/me/[serverId]). No admin involvement required.
Players can:
- Create a faction with a name, tag, and colour
- Set the join mode: Open (anyone can join), Application Required (leader approves), or Invite Only
- Invite players by gamertag
- Accept or reject incoming applications
- View their faction bank balance and deposit funds
Player-created factions go through the same bot provisioning as admin-created factions — a Discord role, private category, and general channel are created automatically once the faction is set up.
Faction bank
Every faction has a shared bank balance. Faction members can deposit currency from their own Economy balance into the faction bank from the faction settings page. The faction leader can view the current balance at any time.
The faction bank is separate from individual player balances. It's intended for shared faction expenses — such as funding a communal raid or splitting economy rewards among the group.
Applications
When a faction's join mode is set to Application Required, players browsing the faction page can submit an application to join. The faction leader sees pending applications listed on their faction settings page and can accept or reject each one individually.
Accepted applicants are added to the faction immediately. Rejected applicants are notified and can reapply unless the leader blocks them.
Raid alerts for factions
Faction leaders can create faction-level raid alerts using the Raid Alerts module. When a faction-level raid alert fires, all faction members receive the notification through their shared faction channel. See the Raid Alerts module page for full setup details.
Faction vs no factions
Factions are entirely optional. If your server doesn't use them, no modules are affected. They're simply an additional layer of organisation and integration available if you want it.