ServerFactions

A GUI-driven faction system for Paper/Purpur 26.3 (Java 25).

Version 2.1.0 · Minecraft 26.3 · Server-side

ServerFactions lets players create factions, organize members with custom priority-ordered roles and granular permissions, and manage everything through inventory GUIs. It integrates optionally with MultiBank for per-faction banks, Vault for a creation cost, and PlaceholderAPI for placeholders.

Note: ServerFactions is a social/group plugin. It does not implement land claims, war, power or territory capture. For land protection, pair it with a claim plugin such as LandClaim.

Features

• Factions with identity. Name, short tag, primary/secondary colors and public/private visibility, all editable from a settings GUI.
• Custom roles. Priority-ordered roles with per-role permissions: invite, kick, edit settings, manage roles, promote, demote and access bank. The leader role (priority 0) is protected and cannot be assigned or recreated. New factions get default Officer / Member / Recruit roles.
• GUI-first management. Members, roles, invites, settings, member limit, color picker, transfer leadership, public faction browser and confirmation dialogs are all inventory GUIs; all clicks are fully cancelled server-side (no inventory duping). Text input uses a sign editor.
• Invites. Time-limited invites with a configurable expiry.
• Faction chat. Toggle faction-only chat with /fac chat.
• Optional faction bank. Auto-creates a MultiBank account per faction when MultiBank is present.
• Configurable creation cost. Charged through the economy (MultiBank or Vault).
• Friendly fire toggle, configurable action sounds, and member limits.
• Persistence. SQLite with asynchronous writes on a single-thread executor and a flushed shutdown; all SQL uses prepared statements.
• Localization. Bundled en_US, pt_PT and fr_FR (MiniMessage) for all chat messages and feedback; some GUI button labels are currently English-only.
• Integrations & API. PlaceholderAPI expansion, plus a developer API (ServerFactionsProvider) with faction lifecycle events.

Commands

Single command /fac with aliases /f and /faction.

Command	Description	Permission
/fac	Open the main faction menu.	serverfactions.use
/fac create	Start faction creation.	serverfactions.use
/fac invite <player>	Invite a player to your faction.	serverfactions.use
/fac chat	Toggle faction chat.	serverfactions.use
/fac info [faction]	Show your faction, or another faction by name.	serverfactions.use
/fac list	Browse public factions.	serverfactions.use
/fac invites	View your pending invites.	serverfactions.use
/fac leave	Leave your faction.	serverfactions.use
/fac admin disband <faction>	Force-disband a faction.	serverfactions.admin
/fac admin reload	Reload the configuration.	serverfactions.admin

Permissions

Node	Description	Default
serverfactions.use	Use the base /fac commands.	true
serverfactions.admin	Access /fac admin (disband, reload).	op

Configuration

Key config.yml settings:

faction:
  creation-cost: 100.0
  max-tag-length: 4
  max-name-length: 24
  min-name-length: 3
  invite-expiry-hours: 24
  default-member-limit: 0        # 0 = unlimited
  default-member-limit-enabled: false
  absolute-max-members: 50
  max-roles: 15                  # custom roles per faction
  friendly-fire: true

economy:
  mode: auto                     # auto (MultiBank then Vault), MultiBank, or Vault
  priority: ["MultiBank", "Vault"]

multibank:
  auto-create-bank: true
  bank-name-prefix: "Faction: "

The config.yml also exposes a full gui: section to reposition and resize every menu (sizes must be multiples of 9), plus a sounds: section for action feedback. Faction names and tags are restricted to a safe character set to prevent formatting injection in chat, tab list and GUIs.

Installation

1. Requires Paper or Purpur 26.3 and Java 25 (2.0.0 runs on 26.2, 1.x on 1.21.x).
2. Optional companions (see Dependencies): MultiBank, Vault, PlaceholderAPI, PlayerSettings.
3. Drop ServerFactions-2.0.0.jar into plugins/ and start the server to generate config.yml.
4. Tune the faction: and economy: sections and run /fac admin reload.

Dependencies

All integrations are optional (soft dependencies); the plugin runs without them.

Plugin	Purpose
MultiBank	Per-faction bank accounts and economy (companion plugin).
Vault	Economy fallback for the faction creation cost.
PlaceholderAPI	Faction placeholders (e.g. formatted tag).
PlayerSettings	Per-player language resolution (companion plugin).

Support / Source

Source and issues: https://github.com/henriquescrrrr/carrageis-serverfactions

License

Released under the GNU General Public License v3.0. See LICENSE.